Zelfstudie: Eenmalige aanmelding van Microsoft Entra integreren met Cirrus Identity Bridge voor Microsoft Entra ID

  • Artikel

In deze zelfstudie leert u hoe u Cirrus Identity Bridge voor Microsoft Entra ID integreert met Microsoft Entra ID met behulp van het op Microsoft Graph API gebaseerde integratiepatroon. Wanneer u Cirrus Identity Bridge voor Microsoft Entra ID op deze manier integreert met Microsoft Entra ID, kunt u het volgende doen:

  • Bepalen wie toegang heeft tot InCommon of andere multilaterale federatieserviceproviders van Microsoft Entra ID.
  • Ervoor zorgen dat gebruikers eenmalige aanmelding kunnen uitvoeren bij InCommon of andere multilaterale federatieserviceproviders met hun Microsoft Entra-account.
  • Ervoor zorgen dat uw gebruikers toegang hebben tot CAS-toepassingen (Central Authentication Service) met hun Microsoft Entra-account.
  • Beheer de toegang tot uw toepassing op één centrale locatie.

Vereisten

U hebt het volgende nodig om aan de slag te gaan:

  • Een Microsoft Entra-abonnement. Als u geen abonnement hebt, kunt u een gratis account krijgen.
  • Een abonnement op Cirrus Identity Bridge voor Microsoft Entra waarvoor eenmalige aanmelding is ingeschakeld. Als u nog geen abonnee bent, gaat u naar de registratiepagina van de Cirrus Identity Microsoft Entra ID Bridge.

Beschrijving van scenario

In deze zelfstudie configureert en test u eenmalige aanmelding van Microsoft Entra in een testomgeving.

  • Cirrus Identity Bridge voor Microsoft Entra ID ondersteunt door SP en IDP geïnitieerde eenmalige aanmelding.

Wanneer u zich abonneert op de Cirrus Identity Bridge voor Microsoft Entra ID, wordt u gevraagd om uw Microsoft Entra TenantID. Ga als volgt te werk om dit weer te geven:

  1. Meld u aan bij het Microsoft Entra-beheercentrum.
  2. Blader naar Identiteit>Overzicht>Eigenschappen.
  3. Schuif omlaag naar de sectie Tenant-id en u kunt uw tenant-id vinden in het vak.
  4. Kopieer de waarde en stuur deze naar de Cirrus Identity-contractvertegenwoordiger waarmee u werkt.

Als u de Microsoft Graph API-integratie wilt gebruiken, moet u de Cirrus Identity Bridge voor Microsoft Entra ID toegang verlenen om de API in uw tenant te kunnen gebruiken. Dit doet u als volgt:

  1. Meld u aan bij het Microsoft Entra-beheercentrum.
  2. Bewerk de URL https://login.microsoftonline.com/$TENANT_ID/adminconsent?client_id=ea71bc49-6159-422d-84d5-6c29d7287974&state=12345&redirect_uri=https://admin.cirrusidentity.com/azure-registration die $TENANT_ID vervangt door de waarde voor uw Microsoft Entra-tenant.
  3. Plak de URL in de browser waarin u bent aangemeld.
  4. U wordt gevraagd toestemming te geven om toegang te verlenen.
  5. Als dit lukt, moet er een nieuwe toepassing met de naam Cirrus Bridge API zijn.
  6. Adviseer de cirrus identity-contractvertegenwoordiger waarmee u werkt, waarmee u API-toegang hebt verleend tot de Cirrus Identity Bridge voor Microsoft Entra ID.

Zodra Cirrus Identity de tenant-id heeft en toegang is verleend, richten we Cirrus Identity Bridge in voor de Microsoft Entra-infrastructuur en bieden we u de volgende informatie die uniek is voor uw abonnement:

  • Id-URI/entiteits-id
  • Omleidings-URI/antwoord-URL
  • URL voor eenmalige afmelding
  • SP-versleutelingscertificaat (als u versleutelde asserties of afmelding gebruikt)
  • Een URL voor testen
  • Aanvullende instructies, afhankelijk van de opties die zijn opgenomen in uw abonnement

Notitie

Als u geen API-toegang kunt verlenen tot de Cirrus Identity Bridge voor Microsoft Entra ID, kan de brug worden geïntegreerd met behulp van een traditionele SAML2-integratie. Adviseer de vertegenwoordiger van het Cirrus Identity-contract waarmee u werkt, waarmee u MS Graph API-integratie niet kunt gebruiken.

Als u de integratie van Cirrus Identity Bridge voor Microsoft Entra ID in Microsoft Entra ID wilt configureren, moet u Cirrus Identity Bridge voor Microsoft Entra ID vanuit de galerie toevoegen aan uw lijst met beheerde SaaS-apps.

  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 in de sectie Toevoegen uit de galerie Cirrus Identity Bridge voor Microsoft Entra ID in het zoekvak.
  4. Selecteer Cirrus Identity Bridge voor Microsoft Entra ID in het resultatenvenster en voeg vervolgens de app toe. Wacht enkele seconden tot de app aan de tenant is toegevoegd.

U kunt ook de wizard Enterprise App Configuration gebruiken. In deze wizard kunt u een toepassing toevoegen aan uw tenant, gebruikers/groepen toevoegen aan de app, rollen toewijzen en ook de configuratie van eenmalige aanmelding doorlopen. Meer informatie over Microsoft 365-wizards.

Eenmalige aanmelding van Microsoft Entra configureren en testen voor Cirrus Identity Bridge voor Microsoft Entra-id

Configureer en test eenmalige aanmelding van Microsoft Entra met Cirrus Identity Bridge voor Microsoft Entra ID met behulp van een testgebruiker met de naam B.Simon. Eenmalige aanmelding werkt alleen als u een koppelingsrelatie tot stand brengt tussen een Microsoft Entra-gebruiker en de bijbehorende gebruiker in Cirrus Identity Bridge voor Microsoft Entra-id.

Voer de volgende stappen uit om eenmalige aanmelding van Microsoft Entra met Cirrus Identity Bridge voor Microsoft Entra ID te configureren en te testen:

  1. Configureer eenmalige aanmelding van Microsoft Entra - zodat uw gebruikers deze functie kunnen gebruiken.
    1. Een Microsoft Entra-testgebruiker maken : eenmalige aanmelding van Microsoft Entra testen met B.Simon.
    2. Wijs de Microsoft Entra-testgebruiker toe om B.Simon in staat te stellen eenmalige aanmelding van Microsoft Entra te gebruiken.
  2. Configureer Cirrus Identity Bridge voor Eenmalige aanmelding van Microsoft Entra om de instellingen voor eenmalige aanmelding aan de toepassingszijde te configureren.
    1. Cirrus Identity Bridge instellen voor Microsoft Entra-tests : als u een tegenhanger van B.Simon in Cirrus Identity Bridge voor Microsoft Entra-id wilt hebben die is gekoppeld aan de Microsoft Entra-weergave van de gebruiker.
  3. Eenmalige aanmelding testen: om te controleren of de configuratie werkt.

Eenmalige aanmelding voor Microsoft Entra configureren

Volg deze stappen om eenmalige aanmelding van Microsoft Entra in te schakelen.

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

  2. Blader naar de integratiepagina van de identiteitstoepassingen Voor Bedrijfstoepassingen>>>Cirrus Identity Bridge voor Microsoft Entra ID-toepassingen, zoek de sectie Beheren en selecteer Eigenschappen.

  3. Schakel op de pagina Eigenschappen de toewijzing vereist in op basis van uw toegangsvereisten. Als deze optie is ingesteld op Ja, moet u de Cirrus Identity Bridge voor Microsoft Entra ID-toepassing toewijzen aan een toegangsbeheergroep op de pagina Gebruikers en groepen .

  4. Terwijl u zich nog steeds op de pagina Eigenschappen bevindt, schakelt u Zichtbaar voor gebruikers in op Nee. De initiële integratie vertegenwoordigt altijd de standaardintegratie die wordt gebruikt voor meerdere serviceproviders. In dit geval is er geen enkele serviceprovider om eindgebruikers naartoe te leiden. Als u specifieke toepassingen zichtbaar wilt maken voor eindgebruikers, moet u eenmalige aanmelding koppelen gebruiken om eindgebruikers toegang te geven in Mijn apps aan specifieke serviceproviders. Zie hier voor meer informatie.

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

  6. Blader naar Identity>Applications Enterprise-toepassingen>>Cirrus Identity Bridge voor Eenmalige aanmelding van Microsoft Entra ID.>

  7. Selecteer SAML op de pagina Selecteer een methode voor eenmalige aanmelding.

  8. Op de pagina Eenmalige aanmelding instellen met SAML klikt u op het potloodpictogram voor Standaard-SAML-configuratie om de instellingen te bewerken.

    Standaard SAML-configuratie bewerken

  9. In de sectie Standaard SAML-configuratie voert u de volgende stappen uit:

    a. In het tekstvak Id (Entiteits-id) typt u een URL met de volgende notatie: https://<DOMAIN>/bridge

    b. In het tekstvak Antwoord-URL typt u een URL met de volgende notatie: https://<NAME>.proxy.cirrusidentity.com/module.php/saml/sp/saml2-acs.php/<NAME>_proxy

  10. Klik op Extra URL's instellen en voer de volgende stap uit als u de toepassing in de door SP geïnitieerde modus wilt configureren:

    In het tekstvak Aanmeldings-URL typt u een waarde met de volgende notatie: <CUSTOMER_LOGIN_URL>

    Notitie

    Dit zijn geen echte waarden. Werk deze waarden bij met de werkelijke id, antwoord-URL en aanmeldings-URL. Als u zich nog niet hebt geabonneerd op de Cirrus Bridge, gaat u naar de registratiepagina. Als u een bestaande Cirrus Bridge-klant bent, neemt u contact op met het klantondersteuningsteam van Cirrus Identity Bridge voor Microsoft Entra om deze waarden te verkrijgen. U kunt ook verwijzen naar de patronen die worden weergegeven in de sectie Standaard SAML-configuratie .

  11. In de Cirrus Identity Bridge voor Microsoft Entra-toepassing worden de SAML-asserties in een specifieke indeling verwacht. Hiervoor moet u aangepaste kenmerktoewijzingen toevoegen aan de configuratie van uw SAML-tokenkenmerken. In de volgende schermafbeelding wordt de lijst met standaardkenmerken weergegeven.

    image

  12. Cirrus Identity Bridge voor Microsoft Entra vult kenmerken en claims die typisch zijn voor gebruik met de InCommon-vertrouwensfederatie. U kunt deze controleren en wijzigen om aan uw vereisten te voldoen. Raadpleeg de eduPerson-schemaspecificatie voor meer informatie.

    Naam Bronkenmerk
    urn:oid:2.5.4.42 user.givenname
    urn:oid:2.5.4.4 user.surname
    urn:oid:0.9.2342.19200300.100.1.3 user.mail
    urn:oid:1.3.6.1.4.1.5923.1.1.1.6 user.userprincipalname
    cirrus.nameIdFormat "urn:oasis:names:tc:SAML:2.0:nameid-format:transient"

    Notitie

    Bij deze standaardinstellingen wordt ervan uitgegaan dat de Microsoft Entra UPN geschikt is voor gebruik als eduPersonPrincipalName.

  13. Op de pagina Eenmalige aanmelding met SAML instellen in de sectie SAML-handtekeningcertificaat klikt u op de kopieerknop om de URL voor federatieve metagegevens van de app te kopiëren en slaat u deze op uw computer op.

    De link om het certificaat te downloaden

Een Microsoft Entra-testgebruiker maken

In deze sectie maakt u een testgebruiker met de naam B.Simon.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een gebruiker Beheer istrator.
  2. Blader naar Identiteit>Gebruikers>Alle gebruikers.
  3. Selecteer Nieuwe gebruiker Nieuwe gebruiker> maken bovenaan het scherm.
  4. Voer in de gebruikerseigenschappen de volgende stappen uit:
    1. Voer in het veld Weergavenaam de tekst in B.Simon.
    2. Voer in het veld User Principal Name de username@companydomain.extensionnaam in. Bijvoorbeeld: B.Simon@contoso.com.
    3. Schakel het selectievakje Wachtwoord weergeven in en noteer de waarde die wordt weergegeven in het vak Wachtwoord.
    4. Selecteer Controleren + maken.
  5. Selecteer Maken.

De Microsoft Entra-testgebruiker toewijzen

In deze sectie geeft u B.Simon toestemming om eenmalige aanmelding te gebruiken door toegang te verlenen tot Cirrus Identity Bridge voor Microsoft Entra ID.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.
  2. Blader naar Identity>Applications Enterprise-toepassingen>>Cirrus Identity Bridge voor Microsoft Entra ID.
  3. Selecteer gebruikers en groepen op de overzichtspagina van de app.
  4. Selecteer Gebruiker/groep toevoegen en selecteer vervolgens Gebruikers en groepen in het dialoogvenster Toewijzing toevoegen.
    1. Selecteer in het dialoogvenster Gebruikers en groepen de optie B.Simon in de lijst Gebruikers. Klik vervolgens op de knop Selecteren onderaan het scherm.
    2. Als u verwacht dat er een rol aan de gebruikers moet worden toegewezen, kunt u de rol selecteren in de vervolgkeuzelijst Selecteer een rol. Als er geen rol is ingesteld voor deze app, wordt de rol Standaardtoegang geselecteerd.
    3. Klik in het dialoogvenster Toewijzing toevoegen op de knop Toewijzen.

Cirrus Identity Bridge configureren voor eenmalige aanmelding van Microsoft Entra

Meer documentatie over het configureren van de Cirrusbrug is beschikbaar via Cirrus Identity. Om ook de Cirrusbrug te configureren ter ondersteuning van toegang voor CAS-services, is CAS-ondersteuning ook beschikbaar voor de Cirrusbrug.

Cirrus Identity Bridge instellen voor Microsoft Entra-tests

In deze sectie controleert u of een gebruiker met de naam Britta Simon kan worden gebruikt voor testen. Het ondersteuningsteam van Cirrus Identity Bridge voor Microsoft Entra biedt een test-URL om te controleren of Britta Simon klaar is voor gebruik met het Cirrus Identity Bridge voor Microsoft Entra-platform. De testgebruiker Britta Simon moet ook worden toegevoegd aan toepassingen die gebruikmaken van de Cirrus Identity Bridge voor Microsoft Entra ID als methode voor verificatie (bijvoorbeeld toepassingen in multilaterale federatiemetagegevens).

Eenmalige aanmelding testen

In deze sectie test u de configuratie voor eenmalige aanmelding van Microsoft Entra met de volgende opties.

Met SP geïnitieerd:

  • Klik op Deze toepassing testen. U wordt omgeleid naar de aanmeldings-URL van Cirrus Identity Bridge voor Microsoft Entra ID, waar u de aanmeldingsstroom kunt initiëren.

  • Ga rechtstreeks naar de aanmeldings-URL van Cirrus Identity Bridge voor Microsoft Entra en initieer de aanmeldingsstroom daar.

Met IDP geïnitieerd:

  • Klik op Deze toepassing testen en u wordt automatisch aangemeld bij de Cirrus Identity Bridge voor Microsoft Entra ID waarvoor u eenmalige aanmelding hebt ingesteld.

U kunt ook Mijn apps van Microsoft gebruiken om de toepassing in een willekeurige modus te testen. Wanneer u in de Mijn apps op de tegel Cirrus Identity Bridge voor Microsoft Entra ID klikt en deze is geconfigureerd in de SP-modus, wordt u omgeleid naar de aanmeldingspagina van de toepassing voor het initiëren van de aanmeldingsstroom. Als deze is geconfigureerd in de IDP-modus, wordt u automatisch aangemeld bij de exemplaar van Cirrus Identity Bridge voor Microsoft Entra ID waarvoor u eenmalige aanmelding hebt ingesteld. Zie Introduction to My Apps (Inleiding tot Mijn apps) voor meer informatie over Mijn apps.

Volgende stappen

Zodra u Cirrus Identity Bridge voor Microsoft Entra ID hebt geconfigureerd, kunt u sessiebeheer afdwingen, waardoor exfiltratie en infiltratie van gevoelige gegevens van uw organisatie in realtime worden beschermd. Sessiebeheer is een uitbreiding van voorwaardelijke toegang. Meer informatie over het afdwingen van sessiebeheer met Microsoft Defender voor Cloud Apps.

U kunt ook meerdere app-configuraties maken voor de Cirrus Identity Bridge voor Microsoft Entra ID wanneer u MS Graph API-integratie gebruikt. Hiermee kunt u verschillende claims, toegangsbeheer of beleid voor voorwaardelijke toegang van Microsoft Entra implementeren voor groepen multilaterale federatie. Zie hier voor meer informatie. Veel van deze zelfde toegangscontroles kunnen ook worden toegepast op CAS-toepassingen.