Konfigurera Workplace från Meta för automatisk användaretablering med Microsoft Entra-ID

Den här artikeln beskriver de steg du behöver göra i både Workplace från Meta och Microsoft Entra ID för att konfigurera automatisk användaretablering. När det konfigureras etablerar och avetablerar Microsoft Entra-ID automatiskt användare till Workplace från Meta 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 Workplace från Meta
• Ta bort användare i Workplace från Meta när de inte längre behöver åtkomst
• Behåll användarattribut synkroniserade mellan Microsoft Entra ID och Workplace från Meta
• Enkel inloggning till Workplace från Meta (rekommenderas)

Förutsättningar

Scenariot som beskrivs i den här artikeln 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 arbetsplats från Meta med aktiverad enkel inloggning

Anmärkning

Om du vill testa stegen i den här artikeln rekommenderar vi inte att du använder en produktionsmiljö.

Anmärkning

Den här integreringen är också tillgänglig för användning från Microsoft Entra US Government Cloud-miljön. Du hittar det här programmet i Microsoft Entra US Government Cloud Application Gallery och konfigurerar det på samma sätt som från det offentliga molnet.

Om du vill testa stegen i den här artikeln bör du följa dessa rekommendationer:

• Använd inte produktionsmiljön om det inte är nödvändigt.
• Om du inte har någon Utvärderingsmiljö för Microsoft Entra kan du få en utvärderingsversion på en månad här.

Steg 1: Planera din försörjningsdistribution

1. Lär dig mer om hur etableringstjänsten fungerar.
2. Fastställ vem som omfattas av tilldelning.
3. Ta reda på vilka data som ska mappas mellan Microsoft Entra-ID och Workplace från Meta.

Steg 2: Konfigurera Workplace från Meta för att stödja etablering med Microsoft Entra-ID

Innan du konfigurerar och aktiverar etableringstjänsten måste du bestämma vilka användare i Microsoft Entra-ID som ska representera de användare som behöver åtkomst till din workplace från metaappen. När du har bestämt dig kan du tilldela dessa användare till din Workplace från Meta-app genom att följa anvisningarna här:

• Vi rekommenderar att en enskild Microsoft Entra-användare tilldelas Workplace från Meta för att testa tilldelningskonfigurationen. Fler användare kan tilldelas senare.

• När du tilldelar en användare till Workplace från Meta måste du välja en giltig användarroll. Rollen "Standardåtkomst" fungerar inte för tilldelning.

Steg 3: Lägg till Workplace från Meta från Microsoft Entra-programgalleriet

Lägg till Workplace från Meta från Microsoft Entra-programgalleriet för att börja hantera provisionering av Workplace från Meta. Om du tidigare har konfigurerat Workplace från Meta för enkel inloggning (SSO) 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 vilka som omfattas av provisioner

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 definiera vem som ska etableras till din app baserat på tilldelning kan du använda stegen för att tilldela användare och grupper till applikationen. Om du väljer att begränsa vad som etableras enbart utifrån attributen hos 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 Workplace från Meta

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 Workplace från metaappen baserat på användartilldelningar 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

   

3. I programlistan väljer du Arbetsplats från Meta.

   

4. Välj fliken Provisionering .

   

5. Ställ in etableringsläget på Automatisk.

   

6. Se till att avsnittet "Klient-URL" är ifyllt med rätt slutpunkt: https://scim.workplace.com/. Under avsnittet Administratörsautentiseringsuppgifter väljer du Auktorisera. Du omdirigeras till Workplace från Metas auktoriseringssida. Ange ditt användarnamn för Workplace från Meta och välj knappen Fortsätt. Välj Testanslutning för att se till att Microsoft Entra ID kan ansluta till Workplace från Meta. Om anslutningen misslyckas kontrollerar du att ditt Workplace från Meta-konto har administratörsbehörighet och försöker igen.

   

   

   Anmärkning

   Underlåtenhet att ändra URL:en till https://scim.workplace.com/ resulterar i ett fel när du försöker spara konfigurationen

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

   

8. Välj Spara.

9. Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-användare till Workplace från Meta.

10. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till Workplace från Meta i avsnittet Attributmappning . Attributen som valts som Matchande egenskaper används för att matcha användarkontona i Workplace från Meta för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet måste du se till att Workplace från Meta-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
    användarnamn	Sträng
    visningsnamn	Sträng
    aktiv	Boolesk
    titel	Boolesk
    e-postmeddelanden[typ = "arbete"].värde	Sträng
    namn.tilltalsnamn	Sträng
    namn.efternamn	Sträng
    formaterat namn	Sträng
    adresser[typ = "arbete"].formaterad	Sträng
    adresser[typ == "arbete"].gatuadress	Sträng
    adresser[typ eq "arbete"].lokalitet	Sträng
    adresser[typ == "arbete"].region	Sträng
    adresser[typ eq "arbete"].land	Sträng
    adresser[typ eq "arbete"].postnummer	Sträng
    adresser[typ eq "annan"].formaterad	Sträng
    telefonnummer[typ ekv "arbete"].värde	Sträng
    phoneNumbers[typ = "mobil"].värde	Sträng
    telefonnumer[type eq "fax"].värde	Sträng
    externId	Sträng
    föredraget språk	Sträng
    urn:scim:schemas:extension:enterprise:1.0.manager (chef)	Sträng
    urn:scim:schemas:extension:enterprise:1.0.department	Sträng
    urn:scim:schemas:extension:enterprise:1.0.division	Sträng
    urn:scim:schemas:extension:enterprise:1.0.organization	Sträng
    urn:scim:schemas:extension:enterprise:1.0.costCenter	Sträng
    urn:scim:schemas:extension:enterprise:1.0.anställningsnummer	Sträng
    urn:scim:schemas:extension:facebook:auth_method:1.0:auth_method	Sträng
    urn:scim:schemas:extension:facebook:frontline:1.0.is_frontline	Boolesk
    urn:scim:schemas:extension:facebook:starttermdates:1.0.startDate	Heltal

11. Information om hur du konfigurerar omfångsfilter finns i följande instruktioner i artikeln Omfångsfilter.

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

    

13. Definiera de användare som du vill etablera till Workplace från Meta genom att välja lämpliga värden i Omfång i avsnittet Inställningar .

    

14. När du är redo att konfigurera, väljer du Spara.

    

Den här åtgärden startar den inledande synkroniseringscykeln för alla användare som definierats i omfånget 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 för att övervaka distributionen:

1. Använd etableringsloggarna för att avgöra vilka användare som har blivit etablerade med framgång eller utan framgång.
2. Kontrollera förloppsindikatorn för att se status för etableringscykeln och hur nära den är till att bli klar
3. Om etableringskonfigurationen verkar vara i ett feltillstånd hamnar programmet i karantän. Läs mer i artikeln om karantäntillståndet för applikationstillhandahållande.

Felsökningstips

• Om du ser att en användare inte har skapats och det finns en granskningslogghändelse med koden "1789003", innebär det att användaren är från en oregistrerad domän.
• Det finns fall där användarna får felet "FEL: Fältet E-post saknas: Du måste ange ett e-postfel som returneras från Facebook: Bearbetning av HTTP-begäran resulterade i ett undantag. Mer information finns i HTTP-svaret som returneras av egenskapen "Svar" för det här undantaget. Den här åtgärden gjordes på nytt noll gånger. Åtgärden görs igen efter det här datumet." Det här felet beror på att kunder mappar e-post, i stället för userPrincipalName, till Facebook-e-post, men vissa användare har inget e-postattribut. För att undvika felen och etablera de misslyckade användarna på Workplace från Facebook ändrar du attributmappningen till e-postattributet Workplace från Facebook till Coalesce([mail],[userPrincipalName]) eller avtilldelar användaren från Workplace från Facebook eller etablerar en e-postadress för användaren.
• Det finns ett alternativ i Workplace som tillåter att användare utan e-postadresser finns. Om den här inställningen aktiveras på Workplace-sidan måste konfigureringen på Azure-sidan startas om för att användare utan e-postadresser ska kunna skapas i Workplace.

Uppdatera en Workplace från Meta-applikation för att använda SCIM 2.0-slutpunkten från Workplace från Meta.

I december 2021 släppte Facebook en SCIM 2.0-anslutning. Slutför de angivna stegen för att uppdatera program som konfigurerats för att använda SCIM 1.0-slutpunkten till att använda SCIM 2.0-slutpunkten. De här stegen tar bort eventuella anpassningar som tidigare gjorts till Workplace från Meta-programmet, inklusive:

• Autentiseringsinformation
• Filtreringsomfång
• Anpassade attributmappningar

Anmärkning

Observera alla ändringar som gjorts i inställningarna som anges i föregående avsnitt innan du slutför följande steg. Om du inte gör det går anpassade inställningar förlorade.

1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.

2. Bläddra till Entra ID>Enterprise-applikationer>Arbetsplats från Meta.

3. I avsnittet Egenskaper i din nya anpassade app kopierar du objekt-ID:t.

   

4. Öppna ett nytt webbläsarfönster, gå till https://developer.microsoft.com/graph/graph-explorer och logga in som administratör för Microsoft Entra-klientorganisationen där din app har lagts till.

   

5. Kontrollera att det konto som används har rätt behörigheter. Behörigheten "Directory.ReadWrite.All" krävs för att göra den här ändringen.

   

   

6. Kör följande kommando med hjälp av ObjectID som valts från appen tidigare:

   GET https://graph.microsoft.com/beta/servicePrincipals/[object-id]/synchronization/jobs/
   

7. Om du tar värdet "id" från svarstexten iGETbegäran från föregående exempel kör du följande kommando och ersätter "[job-id]" med ID-värdet frånGETbegäran. Värdet ska ha formatet "FacebookAtWorkOutDelta.xxxxxxxxxxxxxxx.xxxxxxxxxxxxxxx":

   DELETE https://graph.microsoft.com/beta/servicePrincipals/[object-id]/synchronization/jobs/[job-id]
   

8. Kör följande kommando i Microsoft Graph Explorer. Ersätt "[object-id]" med tjänstens huvudnamns-ID (objekt-ID) som kopierades från det tredje steget.

   POST https://graph.microsoft.com/beta/servicePrincipals/[object-id]/synchronization/jobs { "templateId": "FacebookWorkplace" }
   

   

9. Gå tillbaka till det första webbläsarfönstret och välj fliken Etablering för ditt program. Konfigurationen återställs. Du kan bekräfta att uppgraderingen lyckas genom att bekräfta att jobb-ID:t börjar med "FacebookWorkplace".

10. Uppdatera klient-URL:en i avsnittet Administratörsautentiseringsuppgifter till följande URL: https://scim.workplace.com/

    

11. Återställ alla tidigare ändringar som du har gjort i programmet (autentiseringsinformation, omfångsfilter, anpassade attributmappningar) och återaktivera etablering.

    Anmärkning

    Om du inte återställer de tidigare inställningarna kan det leda till att attribut (name.formatted till exempel) uppdateras oväntat i Workplace. Kontrollera konfigurationen innan du aktiverar provisionering

Ändringslogg

• 2020-09-10 – Stöd har lagts till för företagsattributen "division", "organisation", "costCenter" och "employeeNumber". Stöd har lagts till för anpassade attribut "startDate", "auth_method" och "frontline".
• 2021-07-22 – Uppdaterade felsökningstipsen för kunder med en mappning av e-post till Facebook-e-post, men vissa användare har inget e-postattribut.

Fler resurser

• Hantera etablering av användarkonton för Enterprise Apps
• Vad är programåtkomst och enkel inloggning med Microsoft Entra-ID?

Relaterat innehåll

• Lär dig hur du granskar loggar och får rapporter om tilldelningsaktivitet