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

  • Artikel

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

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

  1. Öppna organisationsadministratörskonsolen genom att välja Organisation Inställningar under ... under arbetsytan.

    Coda Enterprise Organization SCIM Settings

  2. Se till att etablera med SCIM är aktiverat.

  3. Observera SCIM-bas-URL:en och SCIM-ägartoken. Om det inte finns någon ägartoken klickar du på Generera ny token.

Lägg till Coda från Microsoft Entra-programgalleriet för att börja hantera etablering till Coda. Om du tidigare har konfigurerat Coda 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å användarens attribut. Om du väljer att omfånget vem som ska etableras i din app baserat på tilldelning kan du använda följande steg för att tilldela användare till programmet. Om du väljer att omfånget vem som ska etableras enbart baserat på användarens attribut 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.

  • Starta i liten skala. 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.

Steg 5: Konfigurera automatisk användaretablering till Coda

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

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

    Enterprise applications blade

  3. I programlistan väljer du Coda.

    The Coda link in the Applications list

  4. Välj fliken Etablering.

    Screenshot of the Manage options with the Provisioning option called out.

  5. Ange Etableringsläge som Automatiskt.

    Screenshot of the Provisioning Mode dropdown list with the Automatic option called out.

  6. Under avsnittet Administratörsautentiseringsuppgifter anger du din CODA-klient-URL och hemliga token som hämtades tidigare i steg 2. Klicka på Testa Anslut ion för att se till att Microsoft Entra ID kan ansluta till Coda. Om anslutningen misslyckas kontrollerar du att ditt Coda-konto har administratörsbehörighet och försöker igen.

    Screenshot shows the Admin Credentials dialog box, where you can enter your Tenant U R L and Secret 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.

    Notification Email

  8. Välj Spara.

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

  10. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till Coda i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha användarkontona i Coda för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet måste du se till att Coda-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
    userName String
    aktiv Booleskt
    name.givenName String
    name.familyName String

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

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

    Provisioning Status Toggled On

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

    Provisioning Scope

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

    Saving Provisioning Configuration

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 etableringen använder du följande resurser till att övervaka distributionen:

  1. Använd etableringsloggarna för att se vilka användare som har etablerats och vilka som har misslyckats
  2. Kontrollera förloppsindikatorn för att se status för etableringscykeln och hur nära den är att slutföras
  3. 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