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

I den här självstudien beskrivs de steg du behöver utföra i både Britive- och Microsoft Entra-ID för att konfigurera automatisk användaretablering. När det är konfigurerat etablerar och avreglerar Microsoft Entra-ID automatiskt användare och grupper till Britive 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 Britive
  • Ta bort användare i Britive när de inte längre behöver åtkomst
  • Behåll användarattribut synkroniserade mellan Microsoft Entra-ID och Britive
  • Etablera grupper och gruppmedlemskap i Britive
  • Enkel inloggning till Britive (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 Britive.

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

Programmet måste konfigureras manuellt med hjälp av stegen nedan:

  1. Logga in på Britive-program med administratörsbehörighet

  2. Klicka på Admin-User> Administration-Identity> Providers

  3. Klicka på Lägg till identitetsprovider. Ange namn och beskrivning. Klicka på knappen Lägg till identitetsprovider.

    Identitetsprovider

  4. En konfigurationssida som liknar den som visas nedan visas.

    Konfigurationssida

  5. Klicka på fliken SCIM . Ändra SCIM-providern från Generic till Azure och spara ändringarna. Kopiera SCIM-URL:en och anteckna den. De här värdena anges i rutorna klient-URL på fliken Etablering i ditt Britive-program.

    SCIM-sida

  6. Klicka på Skapa token. Välj giltigheten för token efter behov och klicka på knappen Skapa token.

    Skapa token

  7. Kopiera den token som genererats och anteckna den. Klicka på OK. Observera att användaren inte kan se token igen. Klicka på knappen Återskapa för att generera en ny token om det behövs. De här värdena anges i rutorna Hemlig token och Klient-URL på fliken Etablering i ditt getAbstract-program.

    Kopiera token

Lägg till Britive från Microsoft Entra-programgalleriet för att börja hantera etablering till Britive. Om du tidigare har konfigurerat Britive för enkel inloggning kan du använda samma program. Vi rekommenderar dock att du skapar en separat app när du testar integreringen i 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/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 Britive

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/eller grupper i Britive baserat på användar- och/eller grupptilldelningar i Microsoft Entra-ID.

Så här konfigurerar du automatisk användaretablering för Britive 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 Britive.

    Britive-länken i programlistan

  4. Välj fliken Etablering.

    Fliken Etablering

  5. Ange Etableringsläge som Automatiskt.

    Automatisk etableringsflik

  6. Under avsnittet Autentiseringsuppgifter för administratör anger du url:en för britive-klientorganisationen och den hemliga token. Klicka på Testa Anslut ion för att se till att Microsoft Entra ID kan ansluta till Britive. Om anslutningen misslyckas kontrollerar du att ditt Britive-konto har administratörsbehörighet och försöker igen.

    Token

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

  8. Välj Spara.

  9. Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-användare till Britive.

  10. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till Britive i avsnittet Attributmappning . Attributen som valts som Matchande egenskaper används för att matcha användarkontona i Britive för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet måste du se till att Britive-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
    userName String
    aktiv Booleskt
    displayName String
    rubrik String
    externalId String
    preferredLanguage String
    name.givenName String
    name.familyName String
    nickName String
    userType String
    nationella inställningar String
    timezone String
    email[type eq "home"].value String
    email[type eq "other"].value String
    emails[type eq "work"].value String
    phoneNumbers[type eq "home"].value String
    phoneNumbers[type eq "other"].value String
    phoneNumbers[type eq "pager"].value String
    phoneNumbers[type eq "work"].value String
    phoneNumbers[type eq "mobile"].value String
    phoneNumbers[type eq "fax"].value String
    addresses[type eq "work"].formatted String
    addresses[type eq "work"].streetAddress String
    addresses[type eq "work"].locality String
    addresses[type eq "work"].region String
    addresses[type eq "work"].postalCode String
    addresses[type eq "work"].country String
    addresses[type eq "home"].formatted String
    addresses[type eq "home"].streetAddress String
    addresses[type eq "home"].locality String
    addresses[type eq "home"].region String
    addresses[type eq "home"].postalCode String
    addresses[type eq "home"].country String
    addresses[type eq "other"].formatted String
    addresses[type eq "other"].streetAddress String
    addresses[type eq "other"].locality String
    addresses[type eq "other"].region String
    addresses[type eq "other"].postalCode String
    addresses[type eq "other"].country String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager Referens
  11. Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-grupper till Britive.

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

    Attribut Typ Stöds för filtrering
    displayName String
    externalId String
    medlemmar Referens
  13. Information om hur du konfigurerar omfångsfilter finns i följande instruktioner i självstudien för omfångsfilter.

  14. Om du vill aktivera Microsoft Entra-etableringstjänsten för Britive ändrar du etableringsstatusen till i avsnittet Inställningar.

    Etableringsstatus är på

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

    Etableringsomfång

  16. 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 utföra än efterföljande cykler, som inträffar 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 den är att slutföras
  • Om etableringskonfigurationen verkar innehålla fel, kommer programmet att placeras i karantän. Läs mer om karantänstatus här.

Ytterligare resurser

Nästa steg