Dela via


Konfigurera colloquial för automatisk användaretablering

I den här handledningen beskrivs de steg som du behöver utföra i både Colloquial och Microsoft Entra ID för att konfigurera automatiserad användartilldelning. När det konfigureras etablerar och avetablerar Microsoft Entra-ID automatiskt användare till colloquial- 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 Colloquial.
  • Ta bort användare i Colloquial när de inte längre behöver åtkomst.
  • Behåll användarattribut synkroniserade mellan Microsoft Entra ID och Colloquial.
  • enkel inloggning till Colloquial (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 din provisioneringsinstallation

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

Kontakta colloquial-supporten för att konfigurera Colloquial för att stödja etablering med Microsoft Entra-ID.

Lägg till Colloquial från Microsoft Entra-programgalleriet för att börja hantera försörjning till Colloquial. Om du tidigare har konfigurerat Colloquial 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äs mer om att lägga till ett program från galleriet här.

Steg 4: Definiera vem som ska omfattas för tillhandahållande

Med Microsoft Entra-etableringstjänsten kan du omfångsbegränsa vem som ska etableras baserat på tilldelning till programmet och eller baserat på användarens attribut. Om du väljer att begränsa vem som ska ges åtkomst till din app baserat på tilldelning, kan du använda följande steg för att tilldela användare åt appen. Om du väljer att ange vem som ska provisioneras enbart baserat på användarens attribut, kan du använda ett omfångsfilter enligt beskrivningen här.

  • Börja litet. Testa med en liten uppsättning användare innan du distribuerar till alla. När omfånget för etablering är inställt på tilldelade användare kan du styra detta genom att tilldela en eller två användare till appen. När omfånget är inställt på alla användare kan du ange ett attributbaserat omfångsfilter.

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

Steg 5: Konfigurera automatisk användaretablering till Colloquial

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 i Colloquial baserat på användartilldelningar i Microsoft Entra-ID.

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

  1. Logga in på Microsoft Entra administrationscenter som minst en molnapplikationsadministratör.

  2. Bläddra till Identity>Applikationer>Enterprise-applikationer

    Skärmbild av fliken Företagsapplikationer.

  3. I programlistan väljer du Colloquial.

    Skärmbild av länken Colloquial i programlistan.

  4. Välj fliken Provisionering.

    Skärmbild av fliken Etablering.

  5. Ange Etableringsläge till Automatisk.

    Skärmbild av fliken Etablering automatiskt.

  6. I avsnittet Administratörsautentisering anger du URL-adressen för din Colloquial Tenant och din hemliga token. Klicka på Testa anslutning för att se till att Microsoft Entra ID kan ansluta till Colloquial. Om anslutningen misslyckas kontrollerar du att ditt colloquial-konto har administratörsbehörighet och försöker igen.

    skärmbild av token.

  7. I fältet Notifikationsbrevet anger du e-postadressen till en person som ska få notifikationer om provisioneringsfel och markerar kryssrutan Skicka ett e-postmeddelande när ett fel inträffar.

    skärmbild av e-postavisering.

  8. Välj Spara.

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

  10. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till Colloquial i avsnittet Attributmappning. De attribut som valts som motsvarande-egenskaper används för att matcha användarkonton i Colloquial vid uppdateringsåtgärder. Om du väljer att ändra det matchande målattributetmåste du se till att colloquial-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 colloquial
    userName Sträng
    aktiv Boolesk
    If translation of the terms is required and context allows for it, a possible Swedish version could be "epost[type eq 'arbete'].värde". Sträng
    föredraget språk Sträng
    name.givenName Sträng
    namn.efternamn Sträng
    externId Sträng
    Locale Sträng
    tidszon Sträng
  11. Om du vill konfigurera omfångsfilter läser du följande instruktioner i självstudiekursen Omfångsfilter.

  12. Om du vill aktivera Microsoft Entra-etableringstjänsten för Colloquial ändrar du Etableringsstatus till i avsnittet Inställningar.

    Skärmbild av etableringsstatus aktiverad.

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

    Skärmbild av etableringsomfång.

  14. När du är redo att konfigurera, klicka på Spara.

    Skärmbild av sparande av etableringskonfiguration.

Den här åtgärden startar den inledande synkroniseringscykeln för alla användare som 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 tillhandahållandet använder du följande resurser för att övervaka utplaceringen:

  • Använd etableringsloggar för att avgöra vilka användare som har provisionerats framgångsrikt eller inte.
  • Kontrollera förloppsindikatorn för att se status för etableringscykeln och hur nära den är att bli färdigställd
  • Om etableringskonfigurationen verkar vara i ett feltillstånd hamnar programmet i karantän. Läs mer om karantäntillstånd här.

Fler resurser

Nästa steg