Öğretici: Otomatik kullanıcı sağlama için Contentful'ı yapılandırma

Bu makalede, otomatik kullanıcı sağlamayı yapılandırmak için Contentful ve Microsoft Entra Id içinde tamamlamanız gereken adımlar açıklanmaktadır. Yapılandırıldığında Microsoft Entra ID, Microsoft Entra sağlama hizmetini kullanarak kullanıcıları ve grupları otomatik olarak Contentful'a sağlar ve sağlamasını geri alır. Bu hizmetin ne yaptığı ve nasıl çalıştığı hakkında önemli ayrıntılar ve sık sorulan sorular için bkz . Microsoft Entra Id ile SaaS uygulamalarına kullanıcı sağlamayı ve sağlamayı kaldırmayı otomatikleştirme.

Desteklenen özellikler

• Contentful'da kullanıcı oluşturma
• Artık erişim gerektirmeyen kullanıcıları Contentful'da kaldırma
• Kullanıcı özniteliklerinin Microsoft Entra Id ile Contentful arasında eşitlenmesini sağlayın
• Contentful'da grup ve grup üyelikleri sağlama
• Contentful'da ç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.
• Etki Alanları Arası Kimlik Yönetimi (SCIM) sağlama için Sistem'i destekleyen bir aboneliğe sahip contentful kuruluş hesabı. Kuruluşunuzun aboneliğiyle ilgili sorularınız varsa İçerikli Destek ile iletişime geçin.

Hazırlama dağıtımınızı planlama

1. Hazırlama hizmetinin nasıl çalıştığı hakkında bilgi edinin.
2. Hazırlık kapsamına dahil edilecek kullanıcıları seçin.
3. Microsoft Entra Id ile Contentful arasında hangi verilerin eşleneceğini belirleyin.

Contentful'u Microsoft Entra Id ile sağlamayı destekleyecek şekilde yapılandırma

1. Contentful'da bir Hizmet Kullanıcısı hesabı oluşturun. Azure için tüm sağlama izinleri bu hesap aracılığıyla sağlanır. Bu hesap için kuruluş rolü olarak Sahip'i seçmenizi öneririz.

2. Contentful'da Hizmet Kullanıcısı olarak oturum açın.

3. Sol menüde Kuruluş ayarları>Erişim Araçları>Kullanıcı sağlama'yı seçin.

   

4. SCIM URL'sini kopyalayın ve kaydedin. Bu değeri Azure portalında, İçerikli uygulamanızın Sağlama sekmesinde girebilirsiniz.

5. Kişisel erişim belirteci oluştur'a tıklayın.

   

6. Kalıcı pencerede, kişisel erişim belirteciniz için bir ad girin ve Oluştur'a tıklayın.

7. SCIM URL'si ve gizli dizi belirteci oluşturulur. Bu değerleri kopyalayın ve kaydedin. Bu değerleri Contentful uygulamanızın Sağlama sekmesine girersiniz.

   

Contentful yönetim konsolunda sağlamayı yapılandırırken sorularınız varsa, İçerikLi Destek'e başvurun.

Microsoft Entra uygulama galerisinden Contentful ekleme

Contentful'a sağlamayı yönetmek için Microsoft Entra uygulama galerisinden Contentful ekleyin. Contentful'ı daha önce çoklu oturum açma için ayarladıysanız aynı uygulamayı kullanabilirsiniz. Ancak, başlangıçta tümleştirmeyi test etmek için ayrı bir uygulama oluşturmanızı öneririz. Galeriye uygulama eklemeyi öğrenin.

Hazırlık kapsamına dahil edilecek kullanıcıları tanımlama

Uygulamaya atamaya göre veya kullanıcı veya grubun özniteliklerine göre kimlerin sağlanacağı kapsamına almak için Microsoft Entra sağlama hizmetini kullanabilirsiniz.

Atamaya göre uygulamanıza kimlerin sağlanacağı kapsamını belirlerseniz, uygulamaya kullanıcı ve grup atama adımlarını tamamlayın.

Yalnızca kullanıcı veya grubun özniteliklerine göre kimin sağlanacak kapsamını belirlemeyi seçerseniz, kullanıcı hesaplarını sağlamaya yönelik koşullu kuralları tanımlamak için kapsam filtresi kullanın.

• Kullanıcıları ve grupları Contentful'a atadığınızda, Varsayılan Erişim dışında bir rol seçmeniz gerekir. Varsayılan Erişim rolüne sahip kullanıcılar sağlamanın dışında tutulur ve sağlama günlüklerinde etkin bir şekilde yetkilendirilmediği belirtilir. Uygulamada kullanılabilen tek rol Varsayılan Erişim rolüyse, daha fazla rol eklemek için uygulama bildirimini güncelleştirebilirsiniz.
• Başlangıçta kapsamı sınırlı tutun. Herkese sunulmadan önce küçük bir kullanıcı ve grup kümesiyle test edin. Sağlama kapsamı atanan kullanıcılar ve gruplar olarak ayarlandığında, uygulamaya bir veya iki kullanıcı veya grup atayarak kapsamı denetleyebilirsiniz. Kapsam tüm kullanıcılara ve gruplara ayarlandığında, öznitelik tabanlı bir kapsam filtresi belirtebilirsiniz.

Contentful'a otomatik kullanıcı sağlamayı yapılandırma

Bu bölüm, Microsoft Entra Kimliği'ndeki kullanıcı veya grup atamalarını temel alan bir test uygulamasında kullanıcıları ve grupları oluşturmak, güncelleştirmek ve devre dışı bırakmak için Microsoft Entra sağlama hizmetini ayarlama adımlarında size yol gösterir.

Microsoft Entra Id'de Contentful için otomatik kullanıcı sağlamayı yapılandırma

1. Microsoft Entra yönetim merkezinde en az Bulut Uygulaması Yönetici istrator olarak oturum açın.

2. Kimlik>Uygulamaları>Kurumsal uygulamaları'na göz atın.

   

3. Uygulamalar listesinde Contentful'ı seçin.

   

4. Hazırlama sekmesini seçin.

   

5. Sağlama Modu'nu Otomatik olarak ayarlayın.

   

6. Yönetici Kimlik Bilgileri bölümünde Contentful kiracı URL'nizi ve gizli dizi belirtecinizi girin. Microsoft Entra Id'nin Contentful'a bağlanadığından emin olmak için Test Bağlan ion'ı seçin. Bağlantı başarısız olursa, Contentful hesabınızın Yönetici izinlerine sahip olduğundan emin olun ve yeniden deneyin.

   

7. Bildirim E-postası'nda, sağlama hatası bildirimlerini alması gereken bir kişinin veya grubun e-posta adresini girin ve hata oluştuğunda e-posta bildirimi gönder onay kutusunu seçin.

   

8. Kaydet'i seçin.

9. Eşlemeler bölümünde Microsoft Entra kullanıcılarını Contentful ile eşitle'yi seçin.

10. Öznitelik Eşleme bölümünde, Microsoft Entra ID'den Contentful'a eşitlenen kullanıcı özniteliklerini gözden geçirin. Eşleştirme özellikleri olarak seçilen öznitelikler, güncelleştirme işlemleri için Contentful'daki kullanıcı hesaplarıyla eşleştirmek için kullanılır. Eşleşen hedef özniteliği değiştirmeyi seçerseniz, Contentful API'sinin 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	Filtreleme için desteklenir
    userName	String	✓
    name.givenName	String
    name.familyName	String

11. Eşlemeler bölümünde Microsoft Entra gruplarını Contentful ile Eşitle'yi seçin.

12. Öznitelik Eşleme bölümünde, Microsoft Entra ID'den Contentful'a eşitlenen grup özniteliklerini gözden geçirin. Eşleştirme özellikleri olarak seçilen öznitelikler, güncelleştirme işlemleri için Contentful'daki grupları eşleştirmek için kullanılır. Değişiklikleri kaydetmek için Kaydet düğmesini seçin.

    Öznitelik	Tür	Filtreleme için desteklenir
    displayName	String	✓
    üyeler	Başvuru

13. Kapsam filtrelerini ayarlamak için kapsam filtresi öğreticisinde açıklanan adımları tamamlayın.

14. Contentful için Microsoft Entra sağlama hizmetini etkinleştirmek için, Ayarlar bölümünde Sağlama Durumu için Açık'ı seçin.

    

15. Contentful'a sağlamak istediğiniz kullanıcıları veya grupları tanımlamak için, Ayarlar bölümünde Kapsam için ilgili seçeneği belirleyin.

    

16. Sağlamaya hazır olduğunuzda Kaydet'i seçin.

    

Bu işlem, Kapsam'ta tanımlanan tüm kullanıcıların ve grupların Ayarlar altında 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.

Dağıtımınızı izleme

Sağlamayı yapılandırdıktan sonra dağıtımınızı izlemek için aşağıdaki kaynakları kullanın:

• Hangi kullanıcıların başarıyla veya başarısız bir şekilde sağlandığını belirlemek için sağlama günlüklerini görüntüleyin.
• Sağlama döngüsünün durumunu ve bitirmeye ne kadar yakın olduğunu görmek için ilerleme çubuğunu denetleyin.
• Sağlama yapılandırması iyi durumda değilse, uygulama karantinaya alınır. Karantina durumları hakkında daha fazla bilgi edinin.

Sonraki adımlar

• Hazırlama etkinliği günlüklerini incelemeyi ve rapor oluşturmayı öğrenin
• Enterprise Apps için kullanıcı hesabı sağlamayı yönetme
• Microsoft Entra Id ile uygulama erişimi ve çoklu oturum açma nedir?