Hoxhunt instellen voor automatische gebruikersvoorziening met Microsoft Entra ID

In dit artikel worden stappen beschreven die u moet uitvoeren in zowel Hoxhunt als Microsoft Entra ID om automatische gebruikersvoorziening te configureren. Wanneer Microsoft Entra ID is geconfigureerd, voorziet en ontneemt het automatisch gebruikers en groepen op Hoxhunt met behulp van de Microsoft Entra-inrichtingsservice. Zie voor belangrijke informatie over wat deze service doet, hoe deze werkt en veelgestelde vragen Automatiseren van gebruikersvoorziening en -onttrekking naar SaaS-toepassingen met Microsoft Entra ID.

Ondersteunde mogelijkheden

• Gebruikers maken in Hoxhunt
• Gebruikers verwijderen in Hoxhunt wanneer ze geen toegang meer nodig hebben
• Gebruikerskenmerken gesynchroniseerd houden tussen Microsoft Entra ID en Hoxhunt
• eenmalige aanmelding bij Hoxhunt (aanbevolen)

Voorwaarden

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

• Een Microsoft Entra-gebruikersaccount met een actief abonnement. Als u dat nog niet hebt, kunt u gratis een account maken.
• Een van de volgende rollen:
  • Toepassingsbeheerder
  • cloudtoepassingsbeheerder
  • applicatie-eigenaar.

• Een Hoxhunt-tenant.
• SCIM API-sleutel en SCIM-eindpunt-URL voor uw organisatie (geconfigureerd door Hoxhunt-ondersteuning).

Stap 1: Plan uw voorzieningsimplementatie

1. Meer informatie over hoe de voorzieningsservice werkt.
2. Bepaal wie binnen de reikwijdte van de voorziening valt.
3. Bepaal welke gegevens u moet afstemmen tussen Microsoft Entra ID en Hoxhunt.

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

Neem contact op met Hoxhunt Support om SCIM-API-sleutel en SCIM-eindpunt-URL te ontvangen om Hoxhunt te configureren voor provisioning met Microsoft Entra ID.

Stap 3: Hoxhunt toevoegen vanuit de Microsoft Entra-toepassingsgalerie

Voeg Hoxhunt toe vanuit de Microsoft Entra-toepassingsgalerie om het beheren van de provisioning naar Hoxhunt te starten. Als u Hoxhunt eerder hebt ingesteld voor 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 weten over het toevoegen van een toepassing vanuit de galerij 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 bereikfiltergebruiken.

• Begin klein. Test met een kleine set gebruikers en groepen voordat ze voor iedereen worden uitgerold. 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 opgeven.

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

Stap 5: Configureer automatische gebruikersvoorziening voor Hoxhunt

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 Hoxhunt 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

   

3. Selecteer Hoxhuntin de lijst met toepassingen.

   

4. Selecteer het tabblad Inrichten.

   

5. Stel de inrichtingsmodus in op Automatisch.

   

6. Voer in de sectie Beheerdersreferenties uw Hoxhunt-tenant-URL en geheimtoken in. Kies Verbinding testen om te controleren of Microsoft Entra ID verbinding kan maken met Hoxhunt. Als de verbinding mislukt, controleert u of uw Hoxhunt-account beheerdersmachtigingen heeft en probeer het opnieuw.

   

7. Voer in het veld Meldings-e-mail het e-mailadres in van een persoon of groep die de meldingen voor inrichtingsfouten moet ontvangen en schakel het selectievakje Een e-mailmelding verzenden in wanneer er een fout optreedt selectievakje.

   

8. Selecteer opslaan.

9. Onder de sectie Toewijzingen, selecteer Microsoft Entra-gebruikers synchroniseren met Hoxhunt.

10. Controleer in de sectie Kenmerktoewijzingen de gebruikerskenmerken die vanuit Microsoft Entra-id met Hoxhunt worden gesynchroniseerd. De kenmerken die zijn geselecteerd als overeenkomende eigenschappen, worden gebruikt om de gebruikersaccounts in Hoxhunt te matchen voor bijwerkoperaties. Als u ervoor kiest om het overeenkomende doelattribuut te wijzigen, moet u ervoor zorgen dat de Hoxhunt-API gebruikers op basis van dat attribuut kan filteren. Selecteer de knop Opslaan om wijzigingen door te voeren.

    Attribuut	Soort	Ondersteund voor filteren	Vereist door Hoxhunt
    gebruikersnaam	Snaar	✓	✓
    emails[type eq "werk"].value	Snaar		✓
    actief	Booleaans
    name.voornaam	Snaar
    naam.achternaam	Snaar
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:afdeling	Snaar
    adressen[type gelijk aan "werk"].land	Snaar
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:afdeling	Snaar
    voorkeurstaal	Snaar
    adressen[type eq "werk"].lokaliteit	Snaar
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Gebruiker:manager	Referentie

11. Raadpleeg artikel over bereikfiltersvoor de volgende instructies om bereikfilters te configureren.

12. Als u de Microsoft Entra-inrichtingsservice voor Hoxhunt wilt inschakelen, wijzigt u de Inrichtingsstatus in Op in de sectie Instellingen.

    

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

    

14. Selecteer Opslaan als u klaar bent om te configureren.

    

Met deze bewerking wordt de eerste synchronisatiecyclus gestart van alle gebruikers en groepen die zijn gedefinieerd in Bereik in de sectie Instellingen. De eerste cyclus duurt langer dan volgende cycli, die ongeveer om de 40 minuten plaatsvinden zolang de Microsoft Entra-inrichtingsservice wordt uitgevoerd.

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 configuratie in een ongezonde staat lijkt te verkeren, gaat de toepassing in quarantaine. Vind meer informatie over de quarantainestatussen in het artikel over de quarantainestatus van de toepassing.

Wijzigingslogboek

• 20-04-2021 - Ondersteuning toegevoegd voor het kerngebruikerskenmerk preferredLanguage en enterprise extensieattribuut urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division.
• 08/08/2023 - Ondersteuning toegevoegd voor kerngebruikersattribuut adressen[type eq "work"].locality|Tekenreeks en enterprise-extensiekenmerk urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.

Aanvullende informatiebronnen

• Het inrichten van gebruikersaccounts voor enterprise-apps beheren
• Wat is toegang tot toepassingen en eenmalige aanmelding met Microsoft Entra ID?

Verwante inhoud

• Meer informatie over het controleren van logboeken en het ophalen van rapporten over inrichtingsactiviteiten