Preciate configureren voor automatische gebruikervoorziening met Microsoft Entra ID

In dit artikel worden de stappen beschreven die u moet uitvoeren zowel in Preciate als in Microsoft Entra ID voor het configureren van automatische gebruikersoprovisionering. Wanneer geconfigureerd, zorgt Microsoft Entra ID ervoor dat gebruikers en groepen automatisch worden ingericht en ontkoppeld met Preciate via de Microsoft Entra-voorzieningsservice. Voor meer informatie over wat deze service doet, hoe deze werkt en veelgestelde vragen, zie Gebruikersprovisionering en -deprovisioning voor SaaS-toepassingen automatiseren met Microsoft Entra ID.

Ondersteunde mogelijkheden

  • Gebruikers maken in Preciate
  • Gebruikers verwijderen in Preciate wanneer ze geen toegang meer nodig hebben
  • Gebruikerskenmerken gesynchroniseerd houden tussen Microsoft Entra ID en Preciate
  • Ondersteuning voor langlevende bearer token-authenticatie.

Vereiste voorwaarden

In het scenario dat in dit artikel wordt beschreven, wordt ervan uitgegaan dat u al beschikt over de volgende vereisten:

  • Een waardeerbare huurder.
  • Een gebruikersaccount in Preciate met beheerdersmachtigingen.

Stap 1: Plan uw implementatie van voorzieningen

  1. Lees meer over hoe de provisioneringsservice werkt.
  2. Bepaal wie binnen de reikwijdte van de voorziening valt.
  3. Bepaal welke gegevens u wilt toewijzen tussen Microsoft Entra ID en Preciate.

Stap 2: Preciate configureren ter ondersteuning van inrichting met Microsoft Entra-id

  1. Meld u aan bij Preciate Admin Portal en navigeer naar de pagina Integraties.

    Schermopname van de Preciate geheime token configuratiepagina.

  2. Selecteer de Genereren-knop waar het staat bij Active Directory Integration Secret Key.

    Schermopname van de Preciate-pagina voor het genereren van geheime token.

  3. Er wordt een nieuwe geheime sleutel weergegeven. Kopieer en sla de Geheime Sleutel op. Noteer ook dat de tenant-URL https://preciate.com/api/v1/scim is. Deze waarden worden ingevoerd in het veld Geheim Token en Tenant URL op het tabblad Inrichten van uw Preciate-toepassing.

Notitie

Telkens wanneer u de knop Genereren selecteert, wordt er een nieuwe geheime sleutel gemaakt. Hierdoor wordt de huidige onmiddellijk ongeldig. Als een integratie al actief gebruikmaakt van de huidige sleutel, zorgt het genereren van de nieuwe sleutel ervoor dat de integratie niet meer werkt totdat het token voor geheim wordt bijgewerkt in de toepassing Preciate in Azure Portal.

Om te beginnen met het beheren van voorzieningen voor Preciate, voeg Preciate toe vanuit de Microsoft Entra-toepassingsgalerie. Als u Preciate eerder hebt ingesteld voor eenmalige aanmelding (SSO), kunt u dezelfde toepassing gebruiken. We raden u echter aan om een afzonderlijke app te maken bij het testen van de integratie in eerste instantie. Meer informatie over het toevoegen van een applicatie uit de galerie.

Stap 4: Bepaal wie binnen de scope van voorzieningen valt.

Met de Microsoft Entra-inrichtingsservice kunt u bepalen wie is ingericht op basis van toewijzing aan de toepassing of op basis van kenmerken van de gebruiker of groep. Als u ervoor kiest om te bepalen wie voor uw app is ingericht op basis van toewijzing, kunt u de stappen gebruiken om gebruikers en groepen toe te wijzen aan de toepassing. Als u ervoor kiest om te bepalen wie alleen is ingericht op basis van kenmerken van de gebruiker of groep, kunt u een bereikfiltergebruiken.

  • Begin klein. Test de toepassing met een kleine set gebruikers en groepen voordat u de toepassing naar iedereen uitrolt. Wanneer het bereik voor inrichting is ingesteld op toegewezen gebruikers en groepen, kunt u dit beheren door een of twee gebruikers of groepen toe te wijzen aan de app. Wanneer het bereik is ingesteld op alle gebruikers en groepen, kunt u een bereikfilter op basis van kenmerken opgeven.

  • Als u extra rollen nodig hebt, kunt u het toepassingsmanifest bijwerken om nieuwe rollen toe te voegen.

Stap 5: Automatische gebruikersvoorziening configureren voor Preciate

In deze sectie wordt u begeleid bij de stappen voor het configureren van de Microsoft Entra-inrichtingsservice om gebruikers en/of groepen in TestApp te maken, bij te werken en uit te schakelen op basis van gebruikers- en/of groepstoewijzingen in Microsoft Entra-id.

Configureer automatische gebruikersinrichting voor Preciate in Microsoft Entra ID.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassingsbeheerder.

  2. Navigeer naar Entra ID>Enterprise apps.

    Schermopname van het tabblad Enterprise-applicaties.

  3. Selecteer Preciate in de lijst met apps.

    Schermopname van de koppeling Preciate in de lijst met toepassingen.

  4. Selecteer het tabblad Inrichten.

    Schermopname van het tabblad Inrichten voor het configureren van automatische gebruikersprovisioning.

  5. Selecteer + Nieuwe configuratie.

    Schermopname van het tabblad Inrichten automatisch.

  6. Voer in het veld Tenant-URL uw tenant-URL en geheimtoken vooraf in. Selecteer Verbinding testen om te controleren of Microsoft Entra ID verbinding kan maken met Preciate. Als de verbinding mislukt, controleer dan of uw Preciate-account over de vereiste beheerdersmachtigingen beschikt en probeer het opnieuw.

    Schermopname van de voorzieningstestverbinding.

  7. Selecteer Maken om uw configuratie te maken.

  8. Selecteer Eigenschappen op de pagina Overzicht .

  9. Selecteer het potlood om de eigenschappen te bewerken. Schakel e-mailberichten voor meldingen in en geef een e-mailbericht op om quarantaine-e-mailberichten te ontvangen. Preventie van onbedoelde verwijderingen inschakelen. Selecteer Toepassen om de wijzigingen op te slaan.

    Schermopname van de pagina Inrichtingseigenschappen met instellingen voor meldingen en verwijdering.

  10. Selecteer Kenmerktoewijzing in het linkerdeelvenster en selecteer gebruikers.

  11. Controleer in de sectie Attribuutkoppeling de gebruikerskenmerken die vanuit Microsoft Entra ID zijn gesynchroniseerd met Preciate. Kenmerken die zijn geselecteerd als Overeenkomende eigenschappen, worden gebruikt om de gebruikersaccounts in Preciate af te stemmen voor updatebewerkingen. Als u ervoor kiest om het overeenkomende doelkenmerk te wijzigen, moet u ervoor zorgen dat de Preciate-API het filteren van gebruikers op basis van dat kenmerk ondersteunt. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.

    Kenmerk Typ Ondersteund voor filteren
    gebruikersnaam Touwtje
    actief Booleaan
    weergavenaam Touwtje
    titel Touwtje
    naam.gegevenNaam Touwtje
    naam.familienaam Touwtje
    naam.geformatteerd Touwtje
    externId Touwtje
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:afdeling Touwtje
  12. Raadpleeg artikel over bereikfiltersvoor de volgende instructies om bereikfilters te configureren.

  13. Gebruik inrichting op aanvraag om synchronisatie te valideren met een klein aantal gebruikers voordat u een grotere implementatie in uw organisatie implementeert.

  14. Wanneer u klaar bent om in te richten, selecteert u Inrichten starten op de pagina Overzicht .

Stap 6: Uw implementatie bewaken

Zodra u de inrichting hebt geconfigureerd, gebruikt u de volgende resources om uw implementatie te bewaken:

  1. Gebruik de inrichtingslogboeken om te bepalen welke gebruikers succesvol of onsuccesvol zijn ingericht.
  2. Controleer de voortgangsbalk om de status van de provisioningcyclus te zien en hoe dicht het bij voltooiing is.
  3. Als de implementatieconfiguratie in een ongezonde staat lijkt te verkeren, wordt de toepassing in quarantaine geplaatst. Vind meer informatie over de quarantainestatussen in het artikel over de quarantainestatus van de toepassing.

Meer middelen