MyFMS SCIM-onboarding met Microsoft Entra ID

MyFMS SCIM-onboarding met Microsoft Entra ID

SCIM, of System for Cross-domain Identity Management, is een open standaard die de automatisering van gebruikersvoorzieningen mogelijk maakt.
Deze handleiding geeft informatie over de synchronisatie van Microsoft Entra ID-gebruikers met MyFMS. Microsoft Entra ID, voorheen bekend als Azure AD.

De vereisten voor deze synchronisatie zijn:
  1. Microsoft Azure / Microsoft Entra ID Administrator Account
  2. MyFMS Administrator Account
  3. Minstens een Microsoft Entra ID P1
    1. Microsoft Entra-tenant id
    2. Dit id wordt gebruikt om de Microsoft Entra-tenant aan het MyFMS-account te koppelen.
De SCIM-vereisten zijn:
  1. External Id (de maximale lengte van de ID kan slechts 100 karakters zijn) 
  2. Voornaam (de maximale lengte van de ID kan slechts 100 karakters zijn) 
  3. Achternaam (de maximale lengte van de ID kan slechts 100 karakters zijn) 
  4. E-mail adres (gebruikersnaam = MailAddress)
    1. Er wordt een nieuw account aangemaakt als de gebruikersnaam (MailAddress) en het MyFMS-account niet overeenkomen.. 
Wij kunnen u helpen bij de implementatie. Hiervoor rekenen wij 2 dagen consultancy. Neem contact met ons op via support@myfms.com voor meer informatie of vragen.

Gebruikersverificatie

De gebruikersauthenticatie bij Microsoft is alleen mogelijk als het Microsoft e-mailadres gelijk is aan de MyFMS e-mail. Als u een foutmelding krijgt bij het volgen van deze stappen, betekent dit dat u geen MyFMS-account heeft of dat de e-mail onjuist is.
  1. Ga via de browser naar login.myfms.com en klik op de "Login with Microsoft" knop. 



  2. Login met uw Microsoft account.

  3. Klik op de "Accept" knop


Gebruikerssynchronisatie

MyFMS maakt gebruik van meerdere omgevingen zoals Staging en Production. Staging is een kopie van onze productie omgeving en wordt van tijd tot tijd gesynchroniseerd. Wij adviseren om eerst de synchronisatie te testen op Staging.

Ophalen Microsoft Entra-tenant id

Uw Microsoft Entra-tenant-ID is een GUID (Globally Unique Identifier) die verschilt van de naam of het domein van uw tenant. De directory-ID is ook een GUID en heeft dezelfde waarde als de tenant-ID, dus beide ID's zijn gelijk aan elkaar. Door de directory-ID op te halen, krijgt u automatisch de tenant-ID. Afhankelijk van de context worden de tenant-id en directory-id door elkaar gebruikt in Microsoft-documentatie en -producten, wat verwarrend kan zijn.

  1. Open de Microsoft Azure Portal en navigeer naar "Microsoft Entra Connect".



  2. Navigeer naar “Properties” en kopieer de Tenant id.



 Voeg de tenant-ID toe aan MyFMS
  1. Log in als beheerder in MyFMS.
    1. https://staging.myfms.com for Staging.
    2. https://login.myfms.com for Production.
  2. Navigeer naar "Admin".
  3. Navigeer van"Admin" naar "Company Information". 
  4. Navigeer van "Company Information" naar SCIM. 
  5. Plak de tenant-id die u zojuist hebt gekopieerdin de  "Third-Party ID".
  6. Selecteer de standaard "gebruikersgroep" en de standaard "Rol".
  7. Klik op de knop "Refresh" en kopieer het token naar een notitie of Word-document.
    1. Dit token is verderop in dit artikel nodig.
  8. Klik op "Opslaan".


Aanmaken enterprise application.

  1. Open de Microsoft Azure Portal en navigeer naar "Microsoft Entra ID" en klik op "Enterprise Application".




  2. Klik op “Add” en kies “Enterprise application”. 



  3. Selecteer “+ Create your own application”. 



  4. Geef een naam op (bijvoorbeeld MyFMS SCIM). 
  5. Kies de optie "Integrate any other application you don't find in the gallery (Non-gallery)".
  6. Klik op "Create"



  7. Selecteer 3 "Provision User Accounts".

  8. Selecteer "Get started". 

  9. Stel de "Provisioning Mode" op "Automatic". 

  10. Geef de tenant URL op.
    1. https://staging-scim.myfms.com/scim voor Staging
    2. https://scim.myfms.com/scim voor Production
  11. Voer de token in bij "Secret Token" (die eerder in een notitie of Word-document is geplakt).
  12. Klik "Test Connection" en "Save". 


  13. "Enable Provisioning" Status door deze op "On" te zetten.
  14. Selecteer de gewenste Scope. 
  15. Klik opnieuw op "Save" bovenaan de pagina.

De synchronisatie zal nu beginnen. Afhankelijk van het aantal objecten dat gesynchroniseerd moet worden, kan dit enige tijd duren. Als u de synchronisatie wilt testen, volgt u de stappen in hoofdstuk "User Authentication". 

Attributen toevoegen

Dit hoofdstuk laat zien hoe u attributen kunt toevoegen aan Microsoft Entra id. Een voorbeeld van een attribuut dat kan worden toegevoegd is (bedrijfs)pasnummer. Wanneer deze procedure is voltooid, verbindt MyFMS de RFID automatisch met het (bedrijfs)pasnummer.

LET OP!! Wij lezen chip serienummer uit van de (bedrijfs)pasnummer. Dit is over het algemeen niet het nummer wat op de (bedrijfs)pasnummer vermeld staat. Neem hiervoor contact op met de levernacier van de (bedrijfs)pas.

  1. Open de Azure Portal en navigeer naar “Microsoft Entra ID”.

  2. Klik op "Enterprise Application".



  3. Klik op de "SCIM application" (in dit voorbeeld gebruiken we Scim Alpha).



  4. Klik op "Provisioning ".

  5. Klik op “Edit provisioning".



  6. Klik op "Mappings" en dan op “Provision Azure Active Directory Users".

  7. Scroll naar beneden klik op "Show advanced options".
  8. Klik op "Edit attribute list for customappsso".



  9. Voeg de naam toe van het attribuut dat u wilt toevoegen in de eerste kolom

    Kies hieronder een van de volgende opties die overeenkomen met uw kaarttype:


    In het voorbeeld wordt "cardidentificationhex" gebruikt.

  10. Scroll naar boven en klik op "Save" en dan op "Yes".



  11. Klik onder de tabel "Attribute Mappings" en klik op "Add New Mapping".


  12. Aan de rechterkant verschijnt een pop-upvenster "Edit Attribute" . Selecteer de gewenste "Source attribute"  (in dit geval extensionAttribute1) en selecteer "cardIdentification" voor het "Target attribute". Klik op Oké. De toewijzing verschijnt in de tabel "Attribute Mappings"". Na het selecteren van het "Source attribute"  en het “Target attribute” klik op "ok" om op te slaan


Voorkom onbedoelde verwijdering

De Microsoft Entra ID-inrichtingsservice bevat een functie om onbedoelde verwijdering van gebruikers en gebruikersgroepen te voorkomen. Om onbedoelde verwijderingen te voorkomen, moet een "deletion threshold"  worden opgegeven. Voor alles boven de door u ingestelde drempel moet een beheerder expliciet toestaan dat de verwijderingen worden verwerkt.

De functie kan worden ingesteld via de provisioning van de eerder gemaakte enterprise application.. 


Meer informatie is beschikbaar via Microsoft support page.

SCIM Logging

SCIM logging toont het logboek van alle gesynchroniseerde gebruikersaccount.
Via de onderstaande link vind u meer informatie over SCIM logging


    • Related Articles

    • MyFMS SCIM onboarding met Microsoft Entra ID

      SCIM SCIM, of System for Cross-domain Identity Management, is een open standaard die de automatisering van gebruikersvoorzieningen mogelijk maakt. Deze handleiding geeft informatie over de synchronisatie van Microsoft Entra ID-gebruikers met MyFMS. ...

    • MyFMS SCIM logging

      SCIM SCIM, of System for Cross-domain Identity Management, is een open standaard die de automatisering van gebruikersaccounts mogelijk maakt. Via de onderstaande link vind u alle informatie over de synchronisatie van Microsoft Entra ID-gebruikers met ...

    • MyFMS Wachtwoord vergeten.

      Het kan voorkomen dat u uw MyFMS wachtwoord kwijt bent, of dat u uw wachtwoord bent vergeten. Dat is natuurlijk erg jammer maar niet getreurd, in dit artikel leest u hoe u uw MyFMS wachtwoord kunt herstellen. MyFMS bevat de mogelijkheid om ...

    • MyFMS app update voor Android smartphones (changelog)

      Android smartphones De MyFMS app wordt regelmatig voorzien van updates. In deze updates worden er nieuwe functionaliteit toegevoegd, bestaande functionaliteiten uitgebreid, worden bugs opgelost of voeren we beveiliging updates door. In dit overzicht ...

    • MyFMS app update voor iOS (changelog)

      Apple iPhone en iPad De MyFMS app wordt regelmatig voorzien van updates. In deze updates worden er nieuwe functionaliteit toegevoegd, bestaande functionaliteiten uitgebreid, worden bugs opgelost of voeren we beveiliging updates door. In dit overzicht ...