Konfigurera Colloquial för automatisk användartilldelning med Microsoft Entra ID

I den här artikeln beskrivs de steg som du behöver utföra i både Colloquial- och Microsoft Entra-ID för att konfigurera automatisk användaretablering. Innan du börjar bör du granska förutsättningarna för att säkerställa att din miljö är klar. 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 Microsoft Entra etableringstjä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

Colloquial stöder följande etablerings- och åtkomstfunktioner:

  • 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.
  • Single Sign-On till Colloquial (rekommenderas).

Förutsättningar

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

Steg 1: Planera din provisioneringsinstallation

Slutför följande planeringsuppgifter innan du konfigurerar etableringen:

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öretagsprogrammet för SSO, kan du använda det företagsprogrammet. 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.

Steg 4: Definiera vilka som omfattas av provisioner

Använd följande steg för att definiera vilka användare och grupper som omfattas av provisioneringen:

Med Microsoft Entra-etableringstjänsten kan du omfångsbegränsa vem som etableras baserat på tilldelning till programmet, eller baserat på attribut för användaren eller gruppen. Om du väljer att begränsa vem som får åtkomst till din app baserat på tilldelning, kan du använda stegen för att tilldela användare och grupper till appen. Om du väljer att omfattas vem som tilldelas endast baserat på attribut för användaren eller gruppen kan du använda ett omfångsfilter.

  • Börja litet. Testa med en liten uppsättning användare och grupper innan du distribuerar till alla. När omfånget för etablering är inställt på tilldelade användare och grupper kan du styra 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 extra 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å administrationscentret för Microsoft Entra som minst molnprogramadministratör.

  2. Bläddra till Entra ID>Enterprise-appar

    Skärmbild av panelen 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 Provisionering.

  5. Välj + Ny konfiguration.

    Skärmbild av fliken Provisionering automatiskt.

  6. I fältet Klient-URL anger du din Colloquial Tenant-URL och Secret Token. Välj Testanslutning för att se till att Microsoft Entra ID kan ansluta till Colloquial. Om anslutningen misslyckas kontrollerar du att ditt colloquial-konto har nödvändiga administratörsbehörigheter och försöker igen.

    Skärmbild av provisioning-testanslutning.

  7. Välj Skapa för att skapa konfigurationen.

  8. Välj Egenskaper på sidan Översikt .

  9. Välj ikonen Redigera för att redigera egenskaperna. Aktivera e-postaviseringar och ange ett e-postmeddelande för att ta emot karantänmeddelanden. Aktivera förebyggande av oavsiktliga borttagningar. Välj Använd för att spara ändringarna.

  10. I fältet E-postavisering anger du e-postadressen till en person som ska få meddelanden om etableringsfel och markerar kryssrutan Skicka ett e-postmeddelande när ett fel inträffar .

    Skärmbild av provisioneringsegenskaper.

  11. Välj Attributmappning i den vänstra panelen och välj användare.

  12. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till Colloquial i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha användarkontona i Colloquial för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet må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 vardagsspråk
    användarnamn 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
    förnamn Sträng
    namn.efternamn Sträng
    externId Sträng
    Lokalisering Sträng
    tidszon Sträng
  13. Om du vill konfigurera omfångsfilter läser du anvisningarna i Definiera omfångsfilter för etablering av användarkonton.

  14. Använd etablering på begäran för att verifiera synkronisering med ett litet antal användare innan du distribuerar mer allmänt i din organisation.

  15. När du är redo att konfigurera väljer du Starta konfiguration på sidan Översikt.

Steg 6: Övervaka distributionen

När du har aktiverat etableringen använder du följande vägledning för att övervaka distributionen:

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

  1. Använd etableringsloggarna för att avgöra vilka användare som har etablerats eller misslyckats
  2. Kontrollera förloppsindikatorn för att se status för etableringscykeln och hur nära den är att bli klar
  3. Om etableringskonfigurationen verkar vara i ett feltillstånd hamnar programmet i karantän. Läs mer i artikeln om karantänstatus för applikationshantering.

Ytterligare resurser