Delen via

Zelfstudie: TheOrgWiki configureren voor automatische inrichting van gebruikers

  • Artikel

Het doel van deze zelfstudie is om de stappen te laten zien die moeten worden uitgevoerd in TheOrgWiki en Microsoft Entra ID om Microsoft Entra ID te configureren om gebruikers en/of groepen automatisch in te richten en de inrichting van gebruikers en/of groepen ongedaan te maken voor TheOrgWiki.

Notitie

In deze zelfstudie wordt een connector beschreven die is gebouwd op de Microsoft Entra-service voor het inrichten van gebruikers. 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.

Vereisten

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

  • Een Microsoft Entra-tenant.
  • Een OrgWiki-tenant.
  • Een gebruikersaccount in TheOrgWiki met beheerdersmachtigingen.

Gebruikers toewijzen aan TheOrgWiki

Microsoft Entra ID maakt gebruik van een concept met de naam toewijzingen om te bepalen welke gebruikers toegang moeten krijgen tot geselecteerde apps. In de context van automatische inrichting van gebruikers worden alleen de gebruikers en/of groepen die zijn toegewezen aan een toepassing in Microsoft Entra-id gesynchroniseerd.

Voordat u automatische inrichting van gebruikers configureert en inschakelt, moet u beslissen welke gebruikers en/of groepen in Microsoft Entra ID toegang nodig hebben tot TheOrgWiki. Eenmaal besloten, kunt u deze gebruikers en/of groepen aan TheOrgWiki toewijzen door de instructies hier te volgen:

Belangrijke tips voor het toewijzen van gebruikers aan TheOrgWiki

  • Het wordt aanbevolen om één Microsoft Entra-gebruiker toe te wijzen aan TheOrgWiki om de configuratie van de automatische gebruikersinrichting te testen. Extra gebruikers en/of groepen kunnen later worden toegewezen.

  • Als u een gebruiker aan TheOrgWiki toewijst, moet u een geldige toepassingsspecifieke rol (indien beschikbaar) selecteren in het toewijzingsdialoogvenster. Gebruikers met de rol Standaard toegang worden uitgesloten van het inrichten.

TheOrgWiki instellen voor inrichting

Voordat u TheOrgWiki configureert voor het automatisch inrichten van gebruikers met Microsoft Entra ID, moet u SCIM-inrichting inschakelen op TheOrgWiki.

  1. Meld u aan bij de TheOrgWiki-beheerconsole. Klik op Beheerconsole.

    Screenshot of Org Wiki with the user avatar and the Admin Console called out.

  2. Klik in de beheerconsole op het tabblad Instellingen.

    Screenshot of the The Org Wiki Admin Console with the Settings tab called out.

  3. Navigeer naar Serviceaccounts.

    Screenshot of the Service Accounts page in the Org Wiki Admin Console.

  4. Klik op +Serviceaccount. Selecteer onder Type serviceaccountOp tokens gebaseerd. Klik op Opslaan.

    Screenshot of the New Service Account dialog box with the Service Account Type, Token Based, and Save options called out.

  5. Kopieer de Actieve tokens. Deze waarde wordt ingevoerd in het veld Token voor geheim op het tabblad Inrichten van uw TheOrgWiki-toepassing.

    Screenshot of the Manage Tokens for S C I M provisioning dialog box.

Als u TheOrgWiki wilt configureren voor automatische inrichting van gebruikers met Microsoft Entra-id, moet u TheOrgWiki vanuit de Microsoft Entra-toepassingsgalerie toevoegen aan uw lijst met beheerde SaaS-toepassingen.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.

  2. Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>>Nieuwe toepassing.

  3. Typ TheOrgWiki in de sectie Toevoegen uit de galerie, selecteer TheOrgWiki in het resultatenvenster.

    TheOrgWiki in the results list

  4. Selecteer de knop Aanmelden voor TheOrgWiki om naar de aanmeldingspagina van TheOrgWiki te gaan.

    Screenshot of The Org Wiki login page with the URL called out

  5. Selecteer in de rechterbovenhoek Aanmelden.

    Screenshot of the upper-right corner of the login page with the Log In option called out.

  6. Aangezien TheOrgWiki een OpenIDConnect-app is, kiest u aanmelden bij TheOrgWiki met uw Microsoft-werkaccount.

    Screenshot of the The Org Wiki sign in page with the Sign in with Microsoft option called out.

  7. Na een geslaagde verificatie wordt de toepassing vervolgens automatisch toegevoegd aan uw tenant en u wordt doorgestuurd naar uw TheOrgWiki-account.

    OrgWiki Add SCIM

Automatische gebruikersinrichting configureren voor TheOrgWiki

In deze sectie wordt u begeleid bij de stappen voor het configureren van de Microsoft Entra-inrichtingsservice voor het maken, bijwerken en uitschakelen van gebruikers en/of groepen in TheOrgWiki op basis van gebruikers- en/of groepstoewijzingen in Microsoft Entra-id.

Automatische gebruikersinrichting configureren voor TheOrgWiki in Microsoft Entra-id:

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.

  2. Bladeren naar Bedrijfstoepassingen voor identiteitstoepassingen>>

    Enterprise applications blade

  3. Selecteer TheOrgWiki in de lijst met toepassingen.

    The OrgWiki link in the Applications list

  4. Selecteer het tabblad Inrichten.

    Screenshot of the Manage options with the Provisioning option called out.

  5. Stel Inrichtingsmodus in op Automatisch.

    Screenshot of the Provisioning Mode dropdown list with the Automatic option called out.

  6. Voer onder de sectie Referenties voor beheerderhttps://<TheOrgWiki Subdomain value>.theorgwiki.com/api/v2/scim/v2/ in Tenant-URL in.

    Voorbeeld: https://test1.theorgwiki.com/api/v2/scim/v2/

Notitie

De Subdomeinwaarde kan alleen worden ingesteld tijdens het eerste aanmeldingsproces voor TheOrgWiki.

  1. Voer in het veld Token voor geheim de tokenwaarde in die u eerder hebt opgehaald uit TheOrgWiki. Klik op Test Verbinding maken ion om te controleren of Microsoft Entra ID verbinding kan maken met TheOrgWiki. Als de verbinding mislukt, moet u controleren of uw TheOrgWiki-account beheerdersmachtigingen heeft. Probeer het daarna opnieuw.

    Tenant URL + Token

  2. Voer in het veld E-mailadres voor meldingen het e-mailadres in van een persoon of groep die de inrichtingsfoutmeldingen zou moeten ontvangen en vink het vakje Een e-mailmelding verzenden als een fout optreedt aan.

    Notification Email

  3. Klik op Opslaan.

  4. Selecteer in de sectie Toewijzingen Microsoft Entra-gebruikers synchroniseren met TheOrgWiki.

    TheOrgWiki User Mappings

  5. Controleer in de sectie Kenmerktoewijzing de gebruikerskenmerken die vanuit Microsoft Entra-id met TheOrgWiki worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de gebruikersaccounts in TheOrgWiki te vinden voor updatebewerkingen. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.

    TheOrgWiki User Attributes.

  6. Als u bereikfilters wilt configureren, raadpleegt u de volgende instructies in de zelfstudie Bereikfilter.

  7. Als u de Microsoft Entra-inrichtingsservice voor TheOrgWiki wilt inschakelen, wijzigt u de inrichtingsstatus in Aan in de sectie Instellingen.

    Provisioning Status Toggled On

  8. Definieer de gebruikers en/of groepen die u aan TheOrgWiki wilt toevoegen door de gewenste waarden te kiezen in Bereik in de sectie Instellingen.

    Provisioning Scope

  9. Wanneer u klaar bent om in te richten, klikt u op Opslaan.

    Saving Provisioning Configuration

Met deze bewerking wordt de eerste synchronisatie gestart van alle gebruikers en/of groepen die zijn gedefinieerd onder Bereik in de sectie Instellingen. Het uitvoeren van de eerste synchronisatie duurt langer dan bij volgende synchronisaties. Voor meer informatie over hoe lang het duurt om gebruikers en/of groepen in te richten, zie Hoe lang duurt het inrichten van gebruikers?.

U kunt de sectie Huidige status gebruiken om de voortgang te controleren en koppelingen te volgen naar het activiteitenrapport van de inrichting, waarin alle acties worden beschreven die door de Microsoft Entra-inrichtingsservice op TheOrgWiki worden uitgevoerd. Zie De status van gebruikersinrichting controleren voor meer informatie. Zie Rapportage over automatische inrichting van gebruikersaccounts als u de microsoft Entra-inrichtingslogboeken wilt lezen.

Aanvullende bronnen

Volgende stappen