Dela via

Självstudie: Konfigurera Cerby för automatisk användaretablering

  • Artikel

I den här självstudien beskrivs de steg du behöver utföra i både Cerby- och Microsoft Entra-ID för att konfigurera automatisk användaretablering. När microsoft Entra-ID konfigureras etableras och avetableras användare och grupper automatiskt till Cerby med hjälp av Microsoft Entra-etableringstjänsten. Viktig information om vad den här tjänsten gör, hur den fungerar och vanliga frågor finns i Automatisera användaretablering och avetablering till SaaS-program med Microsoft Entra-ID.

Funktioner som stöds

  • Skapa användare i Cerby
  • Ta bort användare i Cerby när de inte behöver åtkomst längre
  • Behåll användarattribut synkroniserade mellan Microsoft Entra-ID och Cerby
  • Etablera grupper och gruppmedlemskap i Cerby.
  • Enkel inloggning till Cerby (rekommenderas).

Förutsättningar

Scenariot som beskrivs i den här självstudien förutsätter att du redan har följande förutsättningar:

Steg 1: Planera etableringsdistributionen

  1. Lär dig mer om hur etableringstjänsten fungerar.
  2. Ta reda på vem som finns i etableringsomfånget.
  3. Ta reda på vilka data som ska mappas mellan Microsoft Entra-ID och Cerby.

Steg 2: Konfigurera Cerby för att stödja etablering med Microsoft Entra-ID

Cerby har som standard aktiverat etableringsstöd för Microsoft Entra-ID. Du får bara hämta SCIM API-autentiseringstoken genom att utföra följande steg:

  1. Logga in på din motsvarande Cerby-arbetsyta.

  2. Klicka på knappen Hi there < user >! längst ned på den vänstra navigeringsmenyn. En nedrullningsbara meny visas.

  3. Välj alternativet Konfiguration av arbetsyta som är relaterat till ditt konto i den nedrullningsbara menyn. Sidan Konfiguration av arbetsyta visas.

  4. Aktivera fliken IDP Inställningar.

  5. Klicka på knappen Visa token i avsnittet Katalogsynkronisering på fliken IDP Inställningar. Ett popup-fönster visas i väntan på att bekräfta din identitet och ett push-meddelande skickas till cerby-mobilappen. VIKTIGT: För att bekräfta din identitet måste du ha installerat och loggat in på Cerby-mobilappen för att få push-meddelanden.

  6. Klicka på knappen It's me! på skärmen Bekräftelsebegäran i ditt Cerby-mobilprogram för att bekräfta din identitet. Popup-fönstret på Din Cerby-arbetsyta är stängt och popup-fönstret Visa token visas.

  7. Klicka på knappen Kopiera för att kopiera SCIM-token till Urklipp.

    Dricks

    Håll popup-fönstret Visa token öppet för att kopiera token när som helst. Du behöver token för att konfigurera etablering med Microsoft Entra-ID.

Lägg till Cerby från Microsoft Entra-programgalleriet för att börja hantera etablering till Cerby. Om du tidigare har konfigurerat Cerby för enkel inloggning kan du använda samma program. Vi rekommenderar dock att du skapar en separat app när du testar integreringen från början. Lär dig mer om att lägga till ett program från galleriet här.

Steg 4: Definiera vem som ska finnas i omfånget för etablering

Med Microsoft Entra-etableringstjänsten kan du omfångsbegränsa vem som ska etableras baserat på tilldelning till programmet och eller baserat på attribut för användaren och gruppen. Om du väljer att omfånget som ska etableras till din app ska baseras på tilldelning, kan du använda följande steg för att tilldela användare och grupper till programmet. Om du väljer att omfånget endast ska etableras baserat på attribut för användaren eller gruppen, kan du använda ett omfångsfilter enligt beskrivningen här.

  • Starta i liten skala. Testa med en liten uppsättning användare och grupper innan du distribuerar till alla. När etableringsomfånget har angetts till tilldelade användare och grupper, kan du kontrollera detta genom att tilldela en eller två användare eller grupper till appen. När omfånget är inställt på alla användare och grupper, kan du ange ett attributbaserat omfångsfilter.

  • Om du behöver ytterligare roller kan du uppdatera programmanifestet för att lägga till nya roller.

Steg 5: Konfigurera automatisk användaretablering till Cerby

Det här avsnittet vägleder dig genom stegen för att konfigurera Microsoft Entra-etableringstjänsten för att skapa, uppdatera och inaktivera användare och grupper i Cerby baserat på användar- och grupptilldelningar i Microsoft Entra-ID.

Så här konfigurerar du automatisk användaretablering för Cerby i Microsoft Entra-ID:

  1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.

  2. Bläddra till Identity>Applications Enterprise-program>

    Bladet Företagsprogram

  3. I programlistan väljer du Cerby.

    Cerby-länken i programlistan

  4. Välj fliken Etablering.

    Fliken Etablering

  5. Ange Etableringsläge som Automatiskt.

    Automatisk etableringsflik

  6. I avsnittet Administratörsautentiseringsuppgifter anger https://api.cerby.com/v1/scim/v2 du som din Cerby-klient-URL och den SCIM API-autentiseringstoken som du tidigare har hämtat.

  7. Klicka på Testa Anslut ion för att se till att Microsoft Entra-ID kan ansluta till Cerby. Om anslutningen misslyckas kontrollerar du att ditt Cerby-konto har administratörsbehörighet och försöker igen.

    Token

  8. I fältet E-postavisering anger du e-postadressen till den person eller grupp som ska ta emot meddelanden om etableringsfel. Markera sedan kryssrutan Skicka ett e-postmeddelande när ett fel uppstår.

    E-postavisering

  9. Välj Spara.

  10. I avsnittet Mappningar väljer du Synkronisera Microsoft Entra-användare till Cerby.

  11. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till Cerby i avsnittet Attributmappningar . De attribut som valts som Matchande egenskaper används för att matcha användarkontona i Cerby för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet måste du se till att Cerby-API:et stöder filtrering av användare baserat på det attributet. Välj knappen Spara för att checka in eventuella ändringar.

    Attribut Typ Stöds för filtrering Krävs av Cerby
    userName String ✓ ✓
    emails[type eq "work"].value String ✓ ✓
    aktiv Booleskt ✓
    name.givenName String ✓
    name.familyName String ✓
    externalId String

  12. Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-grupper till Cerby.

  13. Granska de gruppattribut som synkroniseras från Microsoft Entra-ID till Cerby i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha grupperna i Cerby för uppdateringsåtgärder. Välj knappen Spara för att checka in eventuella ändringar.

    Attribut Typ Stöds för filtrering Krävs av Cerby
    displayName String ✓ ✓
    externalId String
    medlemmar Referens

  14. Information om hur du konfigurerar omfångsfilter finns i följande instruktioner i självstudien för omfångsfilter.

  15. Om du vill aktivera Microsoft Entra-etableringstjänsten för Cerby ändrar du etableringsstatusen till På i avsnittet Inställningar.

    Etableringsstatus är på

  16. Definiera de användare och grupper som du vill etablera till Cerby genom att välja önskade värden i Omfång i avsnittet Inställningar.

    Etableringsomfång

  17. När du är redo att etablera klickar du på Spara.

    Spara etableringskonfiguration

Åtgärden startar den initiala synkroniseringscykeln för alla användare och grupper som har definierats i Omfång i avsnittet Inställningar. Den inledande cykeln tar längre tid att slutföra än nästa cykler, vilket sker ungefär var 40:e minut så länge Microsoft Entra-etableringstjänsten körs.

Steg 6: Övervaka distributionen

När du har konfigurerat etableringen använder du följande resurser till att övervaka distributionen:

  • Använd etableringsloggarna för att se vilka användare som har etablerats och vilka som har misslyckats
  • Kontrollera förloppsindikatorn för att se status för etableringscykeln och hur nära etableringscykeln är klar
  • Om etableringskonfigurationen verkar innehålla fel, kommer programmet att placeras i karantän. Läs mer om karantänstatus här.

Felsökningstips

Om du behöver återskapa SCIM API-autentiseringstoken utför du följande steg:

  1. Skicka ett e-postmeddelande med din begäran till Cerbys supportteam. Cerby-teamet återskapar SCIM API-autentiseringstoken.

  2. Ta emot svarsmeddelandet från Cerby för att bekräfta att token har återskapats.

  3. Följ anvisningarna i artikeln Hämta SCIM API-autentiseringstoken från Cerby för att hämta den nya token.

    Kommentar

    Cerby-teamet utvecklar för närvarande en självbetjäningslösning för att återskapa SCIM API-autentiseringstoken. Om du vill återskapa token måste Cerby-teamets medlemmar verifiera sin identitet.

Ändringslogg

  • 01/02/2024 – Stöd för gruppetablering har lagts till.

Fler resurser

Nästa steg