Öğretici: Otomatik kullanıcı sağlama için Meta'dan Çalışma Alanını yapılandırma
Bu öğreticide, otomatik kullanıcı sağlamayı yapılandırmak için hem Meta'dan Çalışma Alanı'nda hem de Microsoft Entra Kimliği'nde gerçekleştirmeniz gereken adımlar açıklanmaktadır. Yapılandırıldığında Microsoft Entra ID, Microsoft Entra sağlama hizmetini kullanarak kullanıcıları Meta'dan Workplace'e otomatik olarak sağlar ve sağlamasını kaldırır. Bu hizmetin ne yaptığı, nasıl çalıştığı ve sık sorulan sorular hakkında önemli ayrıntılar için bkz . Microsoft Entra Id ile SaaS uygulamalarına kullanıcı sağlamayı ve sağlamayı kaldırmayı otomatikleştirme.
Desteklenen özellikler
- Meta'dan Workplace'de kullanıcı oluşturma
- Artık erişim gerekmediğinde Çalışma Alanı'ndaki kullanıcıları Meta'dan kaldırma
- Meta'dan Microsoft Entra Id ve Workplace arasında kullanıcı özniteliklerinin eşitlenmesini sağlayın
- Meta'dan Çalışma Alanı'nda çoklu oturum açma (önerilir)
Önkoşullar
Bu öğreticide özetlenen senaryo, aşağıdaki önkoşullara zaten sahip olduğunuzu varsayar:
- Microsoft Entra kiracısı
- Aşağıdaki rollerden biri: Uygulama Yönetici istrator, Bulut Uygulaması Yönetici istrator veya Uygulama Sahibi.
- Meta çoklu oturum açma etkin aboneliğinden çalışma alanı
Not
Bu öğreticideki adımları test etmek için üretim ortamı kullanmanızı önermeyiz.
Not
Bu tümleştirme, Microsoft Entra US Government Cloud ortamından da kullanılabilir. Bu uygulamayı Microsoft Entra US Government Cloud Application Gallery'de bulabilir ve genel buluttaki gibi yapılandırabilirsiniz.
Bu öğreticideki adımları test etmek için şu önerileri izlemeniz gerekir:
- Gerekli olmadığı sürece üretim ortamınızı kullanmayın.
- Microsoft Entra deneme ortamınız yoksa burada bir aylık deneme sürümü alabilirsiniz.
1. Adım: Sağlama dağıtımınızı planlama
- Hazırlama hizmetinin nasıl çalıştığı hakkında bilgi edinin.
- Hazırlık kapsamına dahil edilecek kullanıcıları seçin.
- Meta'dan Microsoft Entra Id ile Workplace arasında hangi verilerin eşleneceğini belirleyin.
2. Adım: Microsoft Entra Id ile sağlamayı desteklemek için Meta'dan Çalışma Alanını yapılandırma
Sağlama hizmetini yapılandırmadan ve etkinleştirmeden önce, Microsoft Entra ID'deki hangi kullanıcıların Çalışma Alanınıza Meta uygulamasından erişmesi gereken kullanıcıları temsileceğine karar vermeniz gerekir. Karar verdikten sonra, buradaki yönergeleri izleyerek bu kullanıcıları Meta uygulamasından Çalışma Alanınıza atayabilirsiniz:
Sağlama yapılandırmasını test etmek için Meta'dan Çalışma Alanına tek bir Microsoft Entra kullanıcısının atandığı önerilir. Daha sonra daha fazla kullanıcı atanabilir.
Meta'dan Çalışma Alanına bir kullanıcı atarken geçerli bir kullanıcı rolü seçmeniz gerekir. "Varsayılan Erişim" rolü sağlama için çalışmaz.
3. Adım: Microsoft Entra uygulama galerisinden Meta'dan Çalışma Alanı ekleme
Meta'dan Workplace'e sağlamayı yönetmeye başlamak için Microsoft Entra uygulama galerisinden Meta'dan Workplace ekleyin. Daha önce SSO için Meta'dan Çalışma Alanı'nı ayarladıysanız, aynı uygulamayı kullanabilirsiniz. Ancak başlangıçta tümleştirmeyi test ederken ayrı bir uygulama oluşturmanız önerilir. Galeriden uygulama ekleme hakkında daha fazla bilgi için buraya bakın.
4. Adım: Sağlama kapsamında kimlerin bulunacağını tanımlama
Microsoft Entra sağlama hizmeti, uygulamaya atamaya göre veya kullanıcının /grubun özniteliklerine göre kimlerin sağlanacağı kapsamını belirlemenizi sağlar. Atamaya göre uygulamanıza kimlerin sağlanacağı kapsamını belirlerseniz, uygulamaya kullanıcı atamak için aşağıdaki adımları kullanabilirsiniz. Hazırlanacak kişilerin kapsamını yalnızca kullanıcı veya grup özniteliklerine göre belirlemeyi seçerseniz burada anlatılan kapsam belirleme filtresini kullanabilirsiniz.
Başlangıçta kapsamı sınırlı tutun. Herkesi hazırlamadan önce birkaç kullanıcı ve grupla test yapın. Hazırlama kapsamı atanan kullanıcılar ve gruplar olarak ayarlandığında uygulamaya bir veya iki kullanıcı ya da grup atayarak bu adımı kontrol edebilirsiniz. Kapsam tüm kullanıcılar ve gruplar olarak ayarlandığında öznitelik tabanlı kapsam filtresi belirtebilirsiniz.
Ek rollere ihtiyacınız varsa, yeni roller eklemek için uygulama bildirimini güncelleştirebilirsiniz.
5. Adım: Meta'dan Çalışma Alanına otomatik kullanıcı sağlamayı yapılandırma
Bu bölüm, Microsoft Entra Id'deki kullanıcı atamalarına göre Çalışma Alanı'ndaki kullanıcıları Meta Uygulama'dan oluşturmak, güncelleştirmek ve devre dışı bırakmak için Microsoft Entra sağlama hizmetini yapılandırma adımları boyunca size yol gösterir.
Microsoft Entra yönetim merkezinde en az Bulut Uygulaması Yönetici istrator olarak oturum açın.
Kimlik>Uygulamaları>Kurumsal uygulamalarına göz atın
Uygulamalar listesinde Meta'dan Çalışma Alanı'nı seçin.
Hazırlama sekmesini seçin.
Hazırlama Modu'nu Otomatik olarak ayarlayın.
"Kiracı URL'si" bölümünün doğru uç noktayla dolduruldığından emin olun: https://scim.workplace.com/. Yönetici Kimlik Bilgileri bölümünün altında Yetki ver'e tıklayın. Meta'nın yetkilendirme sayfasından Çalışma Alanına yönlendirilirsiniz. Meta kullanıcı adı'ndan Çalışma Alanınızı girin ve Devam düğmesine tıklayın. Microsoft Entra Id'nin Meta'dan Çalışma Alanına bağlanadığından emin olmak için test Bağlan ion'a tıklayın. Bağlantı başarısız olursa, Meta hesabındaki Çalışma Alanınızın Yönetici izinlere sahip olduğundan emin olun ve yeniden deneyin.
Not
URL'nin https://scim.workplace.com/ değiştirilememesi, yapılandırmayı kaydetmeye çalışırken hataya neden olur
Bildirim E-postası alanına hazırlama hatası bildirimlerinin gönderilmesini istediğiniz kişinin veya grubun e-posta adresini yazıp Hata oluştuğunda e-posta bildirimi gönder onay kutusunu seçin.
Kaydet'i seçin.
Eşlemeler bölümünde Microsoft Entra kullanıcılarını Meta'dan Çalışma Alanına Eşitle'yi seçin.
Öznitelik Eşleme bölümünde Microsoft Entra ID'den Meta'dan Workplace'e eşitlenen kullanıcı özniteliklerini gözden geçirin. Eşleştirme özellikleri olarak seçilen öznitelikler, güncelleştirme işlemleri için Meta'dan Çalışma Alanı'ndaki kullanıcı hesaplarıyla eşleştirmek için kullanılır. Eşleşen hedef özniteliği değiştirmeyi seçerseniz, Meta API'den Çalışma Alanı'nın kullanıcıları bu özniteliğe göre filtrelemeyi desteklediğinden emin olmanız gerekir. Değişiklikleri kaydetmek için Kaydet düğmesini seçin.
Öznitelik Tür userName String displayName String active Boolean Başlık Boolean emails[type eq "work"].value String name.givenName String name.familyName String name.formatted String addresses[type eq "work"].formatted String addresses[type eq "work"].streetAddress String addresses[type eq "work"].locality String addresses[type eq "work"].region String addresses[type eq "work"].country String addresses[type eq "work"].postalCode String addresses[type eq "other"].formatted String phoneNumbers[type eq "work"].value String phoneNumbers[type eq "mobile"].value String phoneNumbers[type eq "fax"].value String externalId String preferredLanguage String urn:scim:schemas:extension:enterprise:1.0.manager String urn:scim:schemas:extension:enterprise:1.0.department String urn:scim:schemas:extension:enterprise:1.0.division String urn:scim:schemas:extension:enterprise:1.0.organization String urn:scim:schemas:extension:enterprise:1.0.costCenter String urn:scim:schemas:extension:enterprise:1.0.employeeNumber String urn:scim:schemas:extension:facebook:auth_method:1.0:auth_method String urn:scim:schemas:extension:facebook:frontline:1.0.is_frontline Boolean urn:scim:schemas:extension:facebook:starttermdates:1.0.startDate Tamsayı Kapsam belirleme filtrelerini yapılandırmak için Kapsam belirleme filtresi öğreticisi ile sunulan yönergeleri izleyin.
Meta'dan Çalışma Alanı için Microsoft Entra sağlama hizmetini etkinleştirmek için Ayarlar bölümünde Sağlama Durumu'nuAçık olarak değiştirin.
Ayarlar bölümünde Kapsam'ta uygun değerleri seçerek Meta'dan Workplace'e sağlamak istediğiniz kullanıcıları tanımlayın.
Sağlamaya hazır olduğunuzda Kaydet'e tıklayın.
Bu işlem, Ayarlar bölümündeki Kapsam bölümünde tanımlanan tüm kullanıcıların ilk eşitleme döngüsünü başlatır. İlk döngünün gerçekleştirilmesi, Microsoft Entra sağlama hizmeti çalıştığı sürece yaklaşık 40 dakikada bir gerçekleşen sonraki döngülerden daha uzun sürer.
6. Adım: Dağıtımınızı izleme
Hazırlama ayarlarını yapılandırdıktan sonra dağıtımınızı izlemek için aşağıdaki kaynakları kullanın:
- Hazırlama işlemi başarılı ve başarısız olan kullanıcıları belirlemek için hazırlama günlüklerini kullanın
- Sağlama döngüsünün durumunu ve tamamlanmaya ne kadar yakın olduğunu görmek için ilerleme çubuğunu denetleyin
- Hazırlama yapılandırmasının durumu iyi görünmüyorsa uygulama karantinaya geçer. Karantina durumu hakkında daha fazla bilgi edinmek için buraya bakın.
Sorun giderme ipuçları
- Bir kullanıcının başarısız bir şekilde oluşturulduğunu görürseniz ve "1789003" koduna sahip bir denetim günlüğü olayı varsa, kullanıcının doğrulanmamış bir etki alanından olduğu anlamına gelir.
- Kullanıcıların 'HATA: Eksik E-posta alanı: Facebook'tan döndürülen bir e-posta Hatası sağlamanız gerekir: HTTP isteğinin işlenmesi bir özel durumla sonuçlandı. Ayrıntılar için bu özel durumun 'Response' özelliği tarafından döndürülen HTTP yanıtına bakın. Bu işlem sıfır kez yeniden denendi. Bu tarihten sonra yeniden denenecek'. Bu hata, müşterilerin userPrincipalName yerine postayı Facebook e-postasına eşlemesinden kaynaklanır, ancak bazı kullanıcıların posta özniteliği yoktur. Hataları önlemek ve başarısız kullanıcıları Facebook'tan Workplace'e başarıyla sağlamak için Facebook e-posta özniteliğinden Workplace'e eşleme özelliğini Coalesce([mail],[userPrincipalName]) olarak değiştirin veya kullanıcının Facebook'tan Workplace atamasını kaldırın veya kullanıcı için bir e-posta adresi sağlayın.
- Çalışma Alanında, e-posta adresleri olmayan kullanıcıların varlığına olanak tanıyan bir seçenek vardır. Bu ayar Çalışma Alanı tarafında değiştirilirse, e-postası olmayan kullanıcıların Workplace'de başarıyla oluşturulabilmesi için Azure tarafında sağlama yeniden başlatılmalıdır.
Meta SCIM 2.0 uç noktasından Workplace'i kullanmak için Meta uygulamasından çalışma alanını güncelleştirme
Aralık 2021'de Facebook bir SCIM 2.0 bağlayıcısı yayınladı. Aşağıdaki adımların tamamlanması, SCIM 1.0 uç noktasını kullanacak şekilde yapılandırılmış uygulamaları SCIM 2.0 uç noktasını kullanacak şekilde güncelleştirir. Bu adımlar, Çalışma Alanı'na daha önce Meta uygulamasından yapılan özelleştirmeleri kaldırır; örneğin:
- Kimlik doğrulaması ayrıntıları
- Kapsam belirleme filtreleri
- Özel öznitelik eşlemeleri
Not
Aşağıdaki adımları tamamlamadan önce yukarıda listelenen ayarlarda yapılan değişiklikleri not edin. Bunun yapılmaması, özelleştirilmiş ayarların kaybolmasına neden olur.
Microsoft Entra yönetim merkezinde en az Bulut Uygulaması Yönetici istrator olarak oturum açın.
Meta'dan Kimlik>Uygulamaları>Kurumsal uygulamaları>Çalışma Alanı'na göz atın.
Yeni özel uygulamanızın Özellikler bölümünde Nesne Kimliğini kopyalayın.
Yeni bir web tarayıcısı penceresinde adresine gidin https://developer.microsoft.com/graph/graph-explorer ve uygulamanızın eklendiği Microsoft Entra kiracısının yöneticisi olarak oturum açın.
Kullanılan hesabın doğru izinlere sahip olduğundan emin olun. Bu değişikliği yapmak için "Directory.ReadWrite.All" izni gereklidir.
Daha önce uygulamadan seçilen ObjectID'yi kullanarak aşağıdaki komutu çalıştırın:
GET https://graph.microsoft.com/beta/servicePrincipals/[object-id]/synchronization/jobs/
Yukarıdan GET isteğinin yanıt gövdesinden "id" değerini alarak aşağıdaki komutu çalıştırın ve "[job-id]" yerine GET isteğindeki kimlik değerini yazın. Değerin biçimi "FacebookAtWorkOutDelta.xxxxxxx
DELETE https://graph.microsoft.com/beta/servicePrincipals/[object-id]/synchronization/jobs/[job-id]
Grafik Gezgini'nde aşağıdaki komutu çalıştırın. "[object-id]" yerine üçüncü adımdan kopyalanan hizmet sorumlusu kimliğini (nesne kimliği) yazın.
POST https://graph.microsoft.com/beta/servicePrincipals/[object-id]/synchronization/jobs { "templateId": "FacebookWorkplace" }
İlk web tarayıcısı penceresine dönün ve uygulamanız için Sağlama sekmesini seçin. Yapılandırmanız sıfırlanmış olacak. İş Kimliğinin "FacebookWorkplace" ile başladığını onaylayarak yükseltmenin gerçekleştiğini onaylayabilirsiniz.
Yönetici Kimlik Bilgileri bölümündeki kiracı URL'sini aşağıdakilerle güncelleştirin:https://scim.workplace.com/
Uygulamada yaptığınız önceki değişiklikleri geri yükleyin (Kimlik doğrulama ayrıntıları, Kapsam filtreleri, Özel öznitelik eşlemeleri) ve sağlamayı yeniden etkinleştirin.
Not
Önceki ayarların geri yüklenememesi, Çalışma Alanı'nda özniteliklerin (örneğin name.formatted) beklenmedik bir şekilde güncelleştirilmesine neden olabilir. Sağlamayı etkinleştirmeden önce yapılandırmayı denetlemeyi unutmayın
Değişiklik günlüğü
- 10.09.2020 - "bölüm", "kuruluş", "costCenter" ve "employeeNumber" kurumsal öznitelikleri için destek eklendi. "startDate", "auth_method" ve "frontline" özel öznitelikleri için destek eklendi.
- 22.07.2021 - Postanın Facebook postasına eşlenmesiyle müşteriler için sorun giderme ipuçları güncelleştirildi ancak bazı kullanıcıların posta özniteliği yok.
Diğer kaynaklar
- Kurumsal Uygulamalar için kullanıcı hesabı hazırlamayı yönetme
- Microsoft Entra Id ile uygulama erişimi ve çoklu oturum açma nedir?