Sdílet prostřednictvím


Konfigurace Workplace od Meta pro automatické zřizování uživatelů

Tento kurz popisuje kroky, které potřebujete udělat jak ve Workplace od Meta, tak v Microsoft Entra ID ke konfiguraci automatického zřizování uživatelů. Při konfiguraci Microsoft Entra ID automaticky zřizuje a ruší zřízení uživatelů pro Workplace from Meta pomocí systému zřízení Microsoft Entra. Důležité podrobnosti o tom, co tato služba dělá, jak funguje, a nejčastější dotazy najdete v tématu Automatizace zřizování a rušení zřizování uživatelů pro aplikace SaaS pomocí Microsoft Entra ID.

Podporované možnosti

  • Vytváření uživatelů na pracovišti z meta
  • Odeberte uživatele z platformy Workplace od Meta, když již nevyžadují přístup.
  • Zachování synchronizace uživatelských atributů mezi Microsoft Entra ID a Workplace from Meta
  • jednotné přihlášení do Workplace od Meta (doporučeno)

Požadavky

Scénář popsaný v tomto kurzu předpokládá, že už máte následující požadavky:

Poznámka

K otestování kroků v tomto kurzu nedoporučujeme používat produkční prostředí.

Poznámka

Tato integrace je také dostupná pro použití z prostředí Microsoft Entra US Government Cloud. Tuto aplikaci najdete v Galerii cloudových aplikací Microsoft Entra US Government a nakonfigurujete ji stejným způsobem jako ve veřejném cloudu.

Pokud chcete otestovat kroky v tomto kurzu, měli byste postupovat podle těchto doporučení:

  • Nepoužívejte produkční prostředí, pokud to není nutné.
  • Pokud nemáte zkušební prostředí Microsoft Entra, můžete získat měsíční zkušební verzi zde.

Krok 1: Naplánujte si nasazení provižningu

  1. Přečtěte si o tom, jak služba zřizování funguje.
  2. Určete, kdo bude v oblasti pro zřizování.
  3. Určete, jaká data se mají mapovat mezi ID Microsoft Entra a pracovištěm z meta.

Krok 2: Konfigurace Workplace od Meta pro podporu zřizování s Microsoft Entra ID

Před konfigurací a povolením služby zřízení je potřeba rozhodnout, kteří uživatelé v Microsoft Entra ID představují ty uživatele, kteří potřebují mít přístup k vaší aplikaci Workplace from Meta. Jakmile se rozhodnete, můžete tyto uživatele přiřadit k aplikaci Workplace od Meta podle pokynů zde:

  • Doporučuje se, aby byl jeden uživatel Microsoft Entra přiřazen k Workplace od Meta, aby byla otestována konfigurace zřizování. Později může být přiřazeno více uživatelů.

  • Při přiřazování uživatele k pracovišti z meta musíte vybrat platnou roli uživatele. Pro zřizování nefunguje role Výchozí přístup.

Přidejte Workplace from Meta z galerie aplikací Microsoft Entra, abyste mohli začít spravovat zřizování pro Workplace from Meta. Pokud jste dříve nastavili pracoviště z Meta pro jednotné přihlašování, můžete použít stejnou aplikaci. Při počátečním testování integrace se ale doporučuje vytvořit samostatnou aplikaci. Další informace o přidání aplikace z galerie zde.

Krok 4: Definujte, kdo bude zahrnut do poskytování

Služba zřizování Microsoft Entra umožňuje vymezit, kteří uživatelé budou zřízeni na základě přiřazení k aplikaci nebo atributů uživatele či skupiny. Pokud se rozhodnete zvolit, kdo bude do vaší aplikace nasazen na základě přiřazení, můžete k přiřazení uživatelů k aplikaci použít následující kroky. Pokud se rozhodnete určit, kdo bude vymezen výhradně na základě atributů uživatele nebo skupiny, můžete použít filtr vymezení, jak je popsáno zde.

  • Začněte malé. Než to rozšíříte na všechny, vyzkoušejte s malou skupinou uživatelů a skupin. Pokud je obor zřizování nastavený na přiřazené uživatele a skupiny, můžete to řídit přiřazením jednoho nebo dvou uživatelů nebo skupin k aplikaci. Pokud je obor nastaven na všechny uživatele a skupiny, můžete zadat filtrovací filtr na základě atributu .

  • Pokud potřebujete další role, můžete aktualizovat manifest aplikace, abyste mohli přidat nové role.

Krok 5: Konfigurace automatického zřizování uživatelů na pracovišti z meta

Tato část vás provede postupem konfigurace služby zřizování Microsoft Entra tak, aby vytvářela, aktualizovala a zakázala uživatele na pracovišti z meta appu na základě přiřazení uživatelů v Microsoft Entra ID.

  1. Přihlaste se do centra pro správu Microsoft Entra alespoň jako správce cloudových aplikací.

  2. Přejděte na Identita>Aplikace>Podnikové aplikace

    modul podnikových aplikací

  3. V seznamu aplikací vyberte Pracoviště z Meta.

    Odkaz Pracoviště Meta v seznamu aplikace

  4. Vyberte kartu Příprava.

    Snímek obrazovky s možnostmi Spravovat s vyvolanou možností Zřizování

  5. Nastavte režim zřizování na Automatické.

    Snímek obrazovky rozevíracího seznamu Režim zřizování s vyznačenou možností Automaticky

  6. Ujistěte se, že je část Adresa URL tenanta vyplněná správným koncovým bodem: https://scim.workplace.com/. V části Přihlašovací údaje správce klikněte na Autorizovat. Budete přesměrováni na Workplace od Meta z autorizační stránky. Zadejte uživatelské jméno pro Workplace od Meta a klikněte na tlačítko Pokračovat. Klikněte na Testovací připojení a ujistěte se, že se Microsoft Entra ID může připojit k Workplace od Meta. Pokud se připojení nezdaří, ujistěte se, že vaše pracoviště z účtu meta má oprávnění správce a zkuste to znovu.

    Snímek obrazovky ukazuje dialogové okno Přihlašovací údaje správce s možností Autorizovat

    autorizovat

    Poznámka

    Při pokusu o uložení konfigurace dojde k selhání při změně adresy URL na https://scim.workplace.com/

  7. Do pole E-mail pro oznámení zadejte e-mailovou adresu osoby nebo skupiny, která by měla přijímat oznámení o chybách při zřizování, a zaškrtněte políčko Odeslat e-mailové oznámení při selhání.

    e-mail s oznámením

  8. Vyberte Uložit.

  9. V části Mapování vyberte Synchronizovat uživatele Microsoft Entra do Workplace z Meta.

  10. Zkontrolujte atributy uživatele, které jsou synchronizovány z Microsoft Entra ID do Workplace od Meta v části Mapování atributů. Atributy vybrané jako Odpovídající vlastnosti se používají pro sladění uživatelských účtů na pracovišti od Meta pro operace aktualizace. Pokud se rozhodnete změnit atribut odpovídající cílové hodnotě, budete se muset ujistit, že Workplace API od Meta podporuje filtrování uživatelů na základě tohoto atributu. Výběrem tlačítka Uložit potvrďte všechny změny.

    Atribut Typ
    userName Řetězec
    zobrazovaný název Řetězec
    aktivní Booleovský
    titul Booleovský
    email[type eq "work"].value Řetězec
    name.givenName Řetězec
    jméno.příjmení Řetězec
    jméno.formátovaný Řetězec
    addresses[type eq "work"].formatted Řetězec
    adresy[typ eq "práce"].uliceAdresa Řetězec
    addresses[type eq "work"].locality Řetězec
    addresses[type eq "práce"].region Řetězec
    addresses[type eq "work"].country Řetězec
    addresses[type eq "work"].postalCode Řetězec
    addresses[type eq "other"].formatted Řetězec
    phoneNumbers[typ eq "pracovní"].value Řetězec
    phoneNumbers[type eq "mobile"].value Řetězec
    phoneNumbers[type eq "fax"].value Řetězec
    externalId Řetězec
    preferovaný jazyk Řetězec
    urn:scim:schemas:extension:enterprise:1.0.manager Řetězec
    urn:scim:schemas:extension:enterprise:1.0.department Řetězec
    urn:scim:schemas:extension:enterprise:1.0.division Řetězec
    urn:scim:schemas:extension:enterprise:1.0.organization Řetězec
    urn:scim:schemas:extension:enterprise:1.0.costCenter Řetězec
    urn:scim:schemas:extension:enterprise:1.0.employeeNumber Řetězec
    urn:scim:schemas:extension:facebook:auth_method:1.0:auth_method Řetězec
    urn:scim:schemas:extension:facebook:frontline:1.0.is_frontline Booleovský
    urn:scim:schemas:extension:facebook:starttermdates:1.0.startDate Celé číslo
  11. Pokud chcete nakonfigurovat filtry rozsahu, podívejte se do následujících pokynů uvedených v návodu na filtry rozsahu .

  12. Pokud chcete povolit službu zřizování Microsoft Entra pro Workplace od Meta, změňte stav zřizování na Zapnuto v části nastavení.

    Stav zřizování je zapnutý

  13. Definujte uživatele, které chcete zřídit pro Workplace od Meta, výběrem vhodných hodnot v Rozsahu v části Nastavení.

    rozsah nasazení

  14. Až budete připraveni k nastavení, klikněte na Uložit.

    ukládání konfigurace provisioningu

Tato operace spustí počáteční synchronizační cyklus všech uživatelů definovaných v oboru v části Nastavení. Počáteční cyklus trvá déle než následné cykly, ke kterým dochází přibližně každých 40 minut, pokud je spuštěná služba zřizování Microsoft Entra.

Krok 6: Monitorování nasazení

Jakmile nakonfigurujete zřizování, použijte k monitorování nasazení následující prostředky:

  1. Pomocí protokolů zřizování určete, kteří uživatelé byli úspěšně nebo neúspěšně zřízeni.
  2. Zkontrolujte posuvník průběhu a podívejte se na stav cyklu zřizování a jak blízko je k dokončení.
  3. Pokud se zdá, že je konfigurace zřizování v nevyhovujícím stavu, aplikace přejde do karantény. Další podrobnosti o stavech karantény lze zjistit zde.

Tipy pro řešení potíží

  • Pokud se zobrazí neúspěšně vytvořený uživatel a existuje událost protokolu auditu s kódem "1789003", znamená to, že uživatel pochází z neověřené domény.
  • V případech, kdy se uživatelům zobrazí chyba Chyba: Chybějící pole E-mail: Je nutné zadat e-mailovou chybu vrácenou z Facebooku: Zpracování požadavku HTTP způsobilo výjimku. Podrobnosti najdete v odpovědi HTTP vrácené vlastností Response této výjimky. Tato operace se opakovala nulou krát. Po tomto datu se to bude opakovat znovu. Tato chyba je způsobená tím, že zákazníci mapují poštu místo userPrincipalName na facebookový e-mail, ale někteří uživatelé nemají atribut pošty. Abyste se vyhnuli chybám a úspěšně poskytli uživatele, kteří se nepodařilo přidat do Workplace from Facebook, upravte mapování atributů tak, že změníte mapování na e-mailový atribut Workplace from Facebook na Coalesce([mail],[userPrincipalName]), nebo zrušte přiřazení uživatele z Workplace from Facebook, nebo nastavte e-mailovou adresu pro uživatele.
  • Na Workplace je možnost, která umožňuje existenci uživatelů bez e-mailových adres. Pokud je toto nastavení zapnuté na straně Workplace, je potřeba restartovat zřizování na straně Azure, aby se uživatelé bez e-mailů mohli úspěšně vytvářet v Workplace.

Aktualizovat aplikaci Workplace from Meta, aby používala koncový bod SCIM 2.0 od společnosti Meta

V prosinci 2021 facebook vydal konektor SCIM 2.0. Provedením následujících kroků aktualizujete aplikace nakonfigurované tak, aby používaly koncový bod SCIM 1.0 na použití koncového bodu SCIM 2.0. Tyto kroky odeberou veškerá vlastní nastavení dříve provedená na pracovišti z aplikace Meta, včetně těchto:

  • Podrobnosti o ověřování
  • Filtry rozsahu
  • Mapování vlastních atributů

Poznámka

Než provedete následující kroky, nezapomeňte si poznamenat všechny změny nastavení uvedené výše. Pokud to neuděláte, dojde ke ztrátě přizpůsobených nastavení.

  1. Přihlaste se alespoň jako Cloud Application Administratordo centra pro správu Microsoft Entra.

  2. Přejděte na Identity>Aplikace>Podnikové aplikace>Pracoviště z Meta.

  3. V části Vlastnosti nové vlastní aplikace zkopírujte ID objektu.

    Snímek obrazovky Workplace z Meta aplikace v Azure portálu

  4. V novém okně webového prohlížeče přejděte na https://developer.microsoft.com/graph/graph-explorer a přihlaste se jako správce tenanta Microsoft Entra, do kterého se vaše aplikace přidá.

    snímek obrazovky přihlašovací stránky Microsoft Graph Exploreru

  5. Zkontrolujte, že použitý účet má správná oprávnění. K provedení této změny se vyžaduje oprávnění Directory.ReadWrite.All.

    Snímek obrazovky s možností nastavení Microsoft Graphu

    snímek obrazovky s oprávněními Microsoft Graphu

  6. Pomocí ID objektu vybraného z aplikace dříve spusťte následující příkaz:

    GET https://graph.microsoft.com/beta/servicePrincipals/[object-id]/synchronization/jobs/
    
  7. Vezměte hodnotu "id" z těla odpovědi požadavku GET a spusťte následující příkaz, nahraďte "[job-id]" hodnotou id z tohoto požadavku GET. Hodnota by měla mít formát "FacebookAtWorkOutDelta.xxxxxxxxxxxxxxx.xxxxxxxxxxxxxxx":

    DELETE https://graph.microsoft.com/beta/servicePrincipals/[object-id]/synchronization/jobs/[job-id]
    
  8. V Graph Exploreru spusťte následující příkaz. Nahraďte [object-id] ID aplikačního objektu (ID objektu) zkopírovaným ze třetího kroku.

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

    Snímek obrazovky žádosti o Microsoft Graph

  9. Vraťte se do prvního okna webového prohlížeče a vyberte kartu Zřizování pro vaši aplikaci. Vaše konfigurace se resetuje. Upgrade můžete potvrdit potvrzením, že ID úlohy začíná na "FacebookWorkplace".

  10. Aktualizujte adresu URL tenanta v části Přihlašovací údaje správce následujícím způsobem: https://scim.workplace.com/

    Snímek obrazovky s přihlašovacími údaji správce na pracovišti z Meta aplikace v portálu Azure

  11. Obnovte všechny předchozí změny, které jste provedli v aplikaci (podrobnosti ověřování, filtry oborů, mapování vlastních atributů) a znovu povolte zřizování.

    Poznámka

    Selhání obnovení předchozího nastavení může mít za následek neočekávané aktualizace atributů (například name.formatted) na pracovišti. Před povolením zřizování nezapomeňte zkontrolovat konfiguraci.

Seznam změn

  • 09/10/2020 - Přidání podpory pro podnikové atributy "division", "organization", "costCenter" a "employeeNumber". Přidání podpory vlastních atributů startDate, auth_method a frontline
  • 22. 7. 2021 – Byly aktualizovány tipy pro řešení problémů pro zákazníky s mapováním e-mailu na facebookový e-mail, avšak někteří uživatelé nemají atribut e-mailu.

Další zdroje informací