Proware configureren voor automatische gebruikersvoorziening met Microsoft Entra ID

In dit artikel worden de stappen beschreven die u moet uitvoeren in zowel Proware als Microsoft Entra ID voor het configureren van automatische gebruikersvoorziening. Wanneer Microsoft Entra ID is ingesteld, worden gebruikers en groepen automatisch ingericht en verwijderd in Proware met behulp van de Microsoft Entra-inrichtingsservice. Voor belangrijke informatie over wat deze service doet, hoe deze werkt en veelgestelde vragen, raadpleegt u Automate user provisioning and deprovisioning to SaaS applications with Microsoft Entra ID.

Ondersteunde mogelijkheden

  • Gebruikers maken in Proware
  • Gebruikers verwijderen in Proware wanneer ze geen toegang meer nodig hebben
  • Gebruikerskenmerken gesynchroniseerd houden tussen Microsoft Entra ID en Proware
  • Eenmalige aanmelding bij Proware (aanbevolen)
  • Ondersteuning voor langlevende bearer token-authenticatie.

Vereisten

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

Stap 1: Het plannen van uw provisioning-implementatie

  1. Meer informatie over hoe de inrichtingsservice werkt.
  2. Bepaal wie binnen de scope voor voorziening valt.
  3. Bepaal welke gegevens moeten worden gekoppeld tussen Microsoft Entra ID en Proware.

Stap 2: Proware configureren om voorziening te ondersteunen met Microsoft Entra ID

  1. Meld u aan bij de Proware-applicatie door naar https://www.metaware.nl/Proware te navigeren.
  2. Navigeer naar Configuratiescherm>Admin.
  3. Selecteer De instellingen van het Configuratiescherm, schuif omlaag naar Gebruikersinrichting en schakel gebruikersinrichting in .
  4. Selecteer de knop Bearer-token maken en kopieer het token. Deze waarde wordt ingevoerd in het veld Token voor geheim op het tabblad Inrichten van uw Proware-toepassing.
  5. Kopieer de Tenant-URL. Deze waarde wordt ingevoerd in het veld Tenant-URL op het tabblad Inrichten van uw Proware-toepassing.

Voeg Proware toe vanuit de Microsoft Entra-applicatiegalerie om te beginnen met provisioning naar Proware. Als u Proware voor eenmalige aanmelding eerder hebt ingesteld, 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 toepassing vanuit de galerie vindt u hier.

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 bereikfilter gebruiken.

  • 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 aan de app toe te wijzen. Wanneer het bereik is ingesteld op alle gebruikers en groepen, kunt u een bereikfilter op basis van een kenmerk opgeven.

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

Stap 5: Automatische gebruikersprovisioning configureren voor Proware

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.

Automatische gebruikersinrichting configureren voor Proware 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

    Enterprise-applicatiesblad

  3. Selecteer Proware in de lijst met toepassingen.

    De proware-koppeling in de lijst met toepassingen

  4. Selecteer het tabblad Inrichten .

    Tabblad Inrichten

  5. Selecteer + Nieuwe configuratie.

    Schermopname van het tabblad Inrichten automatisch.

  6. Voer in het veld Tenant-URL uw Proware-tenant-URL en geheimtoken in. Selecteer Verbinding testen om te controleren of Microsoft Entra ID verbinding kan maken met Proware. Als de verbinding mislukt, controleert u of uw Proware-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. Voer in het veld E-mailmelding het e-mailadres in van een persoon die de meldingen over inrichtingsfouten moet ontvangen en schakel het selectievakje Een e-mailmelding verzenden in wanneer er een fout optreedt .

    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 Kenmerktoewijzing de gebruikerskenmerken die vanuit Microsoft Entra-id met Proware worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de gebruikersaccounts in Proware te vinden voor updatebewerkingen. Als u ervoor kiest om het overeenkomende doelkenmerk te wijzigen, moet u ervoor zorgen dat de Proware-API het filteren van gebruikers op basis van dat kenmerk ondersteunt. Selecteer de knop Opslaan om wijzigingen door te voeren.

    Kenmerk Typologie Ondersteund voor filteren
    gebruikersnaam Snaar / Touwtje
    actief Booleaans
    titel Snaar / Touwtje
    externId Snaar / Touwtje
    naam.voornaam Snaar / Touwtje
    naam.achternaam Snaar / Touwtje
    naam.geformatteerd Snaar / Touwtje
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:afdeling Snaar / Touwtje
  12. Als u bereikfilters wilt configureren, raadpleegt u de instructies in het artikel Bereikfilter.

  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 controleren

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 inrichtingscyclus en hoe dicht het bij voltooiing is te bekijken.
  3. Als de toepassingsconfiguratie in een ongezonde toestand lijkt te verkeren, wordt de applicatie in quarantaine geplaatst. Meer informatie over quarantainestatussen in het artikel over het inrichten van quarantainestatussen van toepassingen.

Aanvullende bronnen