Öğretici: GitHub AE'yi otomatik kullanıcı sağlama için yapılandırma

Bu öğreticide, otomatik kullanıcı sağlamayı yapılandırmak için hem GitHub AE hem de Microsoft Entra ID'de 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ı ve/veya grupları GitHub AE'ye otomatik olarak sağlar ve sağlamasını geri alı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

• GitHub AE'de kullanıcı oluşturma
• Artık erişim gerektirmeyen kullanıcıları GitHub AE'de kaldırma
• Microsoft Entra Id ile GitHub AE arasında kullanıcı özniteliklerinin eşitlenmesini sağlayın
• GitHub AE'de grup ve grup üyelikleri sağlama
• GitHub AE'de ç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.
• GitHub AE, Microsoft Entra kiracınız aracılığıyla SAML SSO ile oturum açmak için tamamen başlatıldı ve yapılandırıldı.

1. Adım: Sağlama 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 GitHub AE arasında hangi verilerin eşleneceğini belirleyin.

2. Adım: GitHub AE'yi Microsoft Entra Id ile sağlamayı destekleyecek şekilde yapılandırma

GitHub AE için sağlamayı etkinleştirmeyi buradan öğrenin.

3. Adım: Microsoft Entra uygulama galerisinden GitHub AE ekleme

GitHub AE'ye sağlamayı yönetmeye başlamak için Microsoft Entra uygulama galerisinden GitHub AE ekleyin. Daha önce SSO için GitHub AE'yi 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 ve kullanıcı ve/veya 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ı ve/veya grup atamak için aşağıdaki adımları kullanabilirsiniz. Yalnızca kullanıcı ve/veya grubun özniteliklerine göre kimin sağlanacak kapsamını belirlemeyi seçerseniz, burada açıklandığı gibi bir kapsam filtresi 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: GitHub AE'ye otomatik kullanıcı sağlamayı yapılandırma

Bu bölüm, Microsoft Entra Id'deki kullanıcı ve/veya grup atamalarına göre TestApp'te kullanıcıları ve/veya grupları oluşturmak, güncelleştirmek ve devre dışı bırakmak için Microsoft Entra sağlama hizmetini yapılandırma adımlarında size yol gösterir.

Microsoft Entra ID'de GitHub AE için otomatik kullanıcı sağlamayı yapılandırmak için:

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 GitHub AE'yi seçin.

   

4. Hazırlama sekmesini seçin.

   

5. Hazırlama Modu'nu Otomatik olarak ayarlayın.

   

6. Yönetici Kimlik Bilgileri bölümünün altında, 2. Adım'dan daha önce alınan GitHub AE Kiracı URL'nizi ve Gizli Dizi Belirtecinizi girin. Microsoft Entra Id'nin GitHub AE'ye bağlanadığından emin olmak için test Bağlan ion'a tıklayın. Bağlantı başarısız olursa GitHub AE hesabınızın Yönetici izinlere sahip olduğundan emin olun ve yeniden deneyin.

   

7. 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.

   

8. Kaydet'i seçin.

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

10. Öznitelik Eşleme bölümünde Microsoft Entra ID'den GitHub AE'ye eşitlenen kullanıcı özniteliklerini gözden geçirin. Eşleştirme özellikleri olarak seçilen öznitelikler, güncelleştirme işlemleri için GitHub AE'deki kullanıcı hesaplarıyla eşleştirmek için kullanılır. Eşleşen hedef özniteliği değiştirmeyi seçerseniz GitHub AE 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
    userName	String
    externalId	String
    emails[type eq "work"].value	String
    active	Boolean
    name.givenName	String
    name.familyName	String
    name.formatted	String
    displayName	String

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

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

    Öznitelik	Tür
    displayName	String
    externalId	String
    üyeler	Başvuru

13. Kapsam belirleme filtrelerini yapılandırmak için Kapsam belirleme filtresi öğreticisi ile sunulan yönergeleri izleyin.

14. GitHub AE için Microsoft Entra sağlama hizmetini etkinleştirmek için Ayarlar bölümünde Sağlama Durumu'nu Açık olarak değiştirin.

    

15. Ayarlar bölümünde Kapsam'ta istenen değerleri seçerek GitHub AE'ye sağlamak istediğiniz kullanıcıları ve/veya grupları tanımlayın.

    

16. Hazırlama işlemini başlatmak için 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 ve/veya grupları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:

1. 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
2. Hazırlama döngüsünün durumunu ve tamamlanması için kalan miktarı görmek için ilerleme çubuğuna bakın
3. 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.

Değişiklik günlüğü

• 18.02.2021 - Grup sağlama desteği eklendi.

Ek 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?

Sonraki adımlar

• Hazırlama etkinliği günlüklerini incelemeyi ve rapor oluşturmayı öğrenin