Självstudie: Konfigurera getAbstract för automatisk användaretablering
I den här självstudien beskrivs de steg du behöver utföra i både getAbstract och Microsoft Entra ID för att konfigurera automatisk användaretablering. När det konfigureras etablerar och avetablerar Microsoft Entra-ID automatiskt användare och grupper för att hämtaAbstract 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 av SaaS-program (programvara som en tjänst) med Microsoft Entra-ID.
Funktioner som stöds
- Skapa användare i getAbstract.
- Ta bort användare i getAbstract när de inte längre behöver åtkomst.
- Behåll användarattribut synkroniserade mellan Microsoft Entra-ID och getAbstract.
- Etablera grupper och gruppmedlemskap i getAbstract.
- Aktivera enkel inloggning (SSO) för att hämtaAbstract (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:
- En Microsoft Entra-klientorganisation.
- En av följande roller: Programadministratör, Molnprogramadministratör eller Programägare.
- En getAbstract-klientorganisation (getAbstract-företagslicens).
- Enkel inloggning aktiverad på Microsoft Entra-klientorganisationen och getAbstract-klientorganisationen.
- Godkännande och System for Cross-domain Identity Management (SCIM) aktivera för getAbstract. (Skicka e-post till b2b.itsupport@getabstract.com.)
Steg 1: Planera etableringsdistributionen
- Lär dig mer om hur etableringstjänsten fungerar.
- Ta reda på vem som finns i etableringsomfånget.
- Ta reda på vilka data som ska mappas mellan Microsoft Entra-ID och getAbstract.
Steg 2: Konfigurera getAbstract för att stödja etablering med Microsoft Entra-ID
Logga in för att hämtaAbstract.
Välj personikonen i det övre högra hörnet och välj alternativet Min centrala administratör .
På menyn till vänster klickar du på Användarhantering och klickar på knappen konfigurera scim .
Välj Gå.
Klicka på knappen Generera ny token .
Om du är säker väljer du knappen Generera ny token . Annars väljer du Avbryt.
Slutligen kan du antingen klicka på ikonen kopiera till Urklipp eller välja hela token och kopiera den. Anteckna också att klient-/bas-URL:en är
https://www.getabstract.com/api/scim/v2. Dessa värden anges i rutorna Hemlig token och Klient-URL på fliken Etablering i ditt getAbstract-program.
Steg 3: Lägg till getAbstract från Microsoft Entra-programgalleriet
Lägg till getAbstract från Microsoft Entra-programgalleriet för att börja hantera etablering för att hämtaAbstract. Om du tidigare har konfigurerat getAbstract för enkel inloggning kan du använda samma program. Vi rekommenderar 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 i den här snabbstarten.
Steg 4: Definiera vem som ska finnas i omfånget för etablering
Du kan använda Microsoft Entra-etableringstjänsten för att omfånget som ska etableras baserat på tilldelning till programmet eller baserat på användarens eller gruppens attribut. 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 vem som ska etableras enbart baserat på attribut för användaren eller gruppen kan du använda ett omfångsfilter enligt beskrivningen i Etablera appar med omfångsfilter.
När du tilldelar användare och grupper till getAbstract måste du välja en annan roll än Standardåtkomst. Användare med standardåtkomstrollen undantas från etablering och markeras som ej berättigade i etableringsloggarna. Om den enda roll som är tillgänglig i programmet är standardåtkomstrollen kan du uppdatera programmanifestet för att lägga till fler roller.
Starta i liten skala. 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 det här alternativet 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.
Steg 5: Konfigurera automatisk användaretablering för att hämtaAbstract
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 eller grupper i TestApp baserat på användar- eller grupptilldelningar i Microsoft Entra-ID.
Konfigurera automatisk användaretablering för getAbstract i Microsoft Entra-ID
Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.
Bläddra till Identity>Applications Enterprise-program.>
I listan över program väljer du getAbstract.
Välj fliken Etablering.
Ange Etableringsläge till Automatiskt.
I avsnittet Administratörsautentiseringsuppgifter anger du din getAbstract-klient-URL och hemlig tokeninformation. Välj Test Anslut ion för att se till att Microsoft Entra ID kan ansluta till getAbstract. Om anslutningen misslyckas kontrollerar du att ditt getAbstract-konto har administratörsbehörighet och försöker igen.
I rutan E-postavisering anger du e-postadressen till en person eller grupp som ska få meddelanden om etableringsfel. Markera kryssrutan Skicka ett e-postmeddelande när ett fel inträffar .
Välj Spara.
I avsnittet Mappningar väljer du Synkronisera Microsoft Entra-användare för att hämtaAbstract.
Granska de användarattribut som synkroniseras från Microsoft Entra-ID för att hämtaAbstract i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha användarkontona i getAbstract för uppdateringsåtgärder. Om du ändrar det matchande målattributet måste du se till att getAbstract-API:et stöder filtrering av användare baserat på det attributet. Välj Spara för att checka in eventuella ändringar.
Attribut Typ Stöds för filtrering userName String ✓ aktiv Booleskt emails[type eq "work"].value String name.givenName String name.familyName String externalId String preferredLanguage String Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-grupper för att hämtaAbstract.
Granska de gruppattribut som synkroniseras från Microsoft Entra-ID för att hämtaAbstract i avsnittet Attributmappning . Attributen som valts som Matchande egenskaper används för att matcha grupperna i getAbstract för uppdateringsåtgärder. Välj Spara för att checka in eventuella ändringar.
Attribut Typ Stöds för filtrering displayName String ✓ externalId String medlemmar Referens Information om hur du konfigurerar omfångsfilter finns i anvisningarna i självstudien om omfångsfilter.
Om du vill aktivera Microsoft Entra-etableringstjänsten för getAbstract ändrar du Etableringsstatus till På i avsnittet Inställningar.
Definiera de användare eller grupper som du vill etablera för att hämtaAbstract genom att välja önskade värden i Omfång i avsnittet Inställningar.
När du är redo att etablera väljer du Spara.
Å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 avgöra vilka användare som har etablerats eller 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. Mer information om karantäntillstånd finns i Programetableringsstatus för karantän.
Ytterligare resurser
- Hantera etablering av användarkonton för företagsappar
- Vad är programåtkomst och enkel inloggning med Microsoft Entra-ID?