GitHub Kurumsal Bulut depolarını Azure SRE Aracısı'na bağlama

GitHub Enterprise Cloud (<TENANT>.ghe.com) veya github.com üzerinde barındırılan depoları byO (Kendi GitHub Uygulama Getir) kullanarak Azure SRE Aracınıza bağlayın. Aracı, Azure Key Vault'ta depolanan ve asla kopyalanmayan uygulamanızın özel anahtarını kullanarak kısa ömürlü kurulum belirteçleri oluşturur.

BYO GitHub Uygulaması kimlik doğrulaması ne zaman kullanılmalı?

BYO App’i şu durumlarda kullanın:

• Kuruluşunuz için uygulama tabanlı kimlik doğrulaması ve anahtar saklama denetimleri gerekir.
• *.ghe.com depolarına bağlanıyorsunuz (bu gereklidir, çünkü OAuth ve PAT GHE ana bilgisayarlarında kullanılamaz).
• Kullanıcı belirteçleri yerine yükleme belirteci tabanlı erişim istiyorsunuz.

Prerequisites

GitHub uygulaması oluşturma

Doğru izinlere sahip bir GitHub Uygulamanız varsa >Azure Key Vault içinde özel anahtarı depolama bölümüne atlayın.

1. GitHub konağınıza gidin:
   • github.com: Kuruluş >Settings>Geldirici ayarlarına gidin>GitHub Apps>Yeni GitHub Uygulaması
   • <TENANT>.ghe.com: GHE örneğinizde aynı yol
2. Uygulama ayrıntılarını doldurun:
   • GitHub Uygulama adı: örneğin, sre-agent-reader
   • Giriş sayfası URL'si: https://sre.azure.com
   • Web Kancası: Etkin seçeneğinin işaretini kaldırın (aracı web kancalarını kullanmaz)
3. İzinler'in altında şunları ayarlayın:
   • Depo izinleri > İçerik: Salt okunur (gerekli)
   • Depo izinleri > Meta veriler: Salt okunur (otomatik seçili)
   • İsteğe bağlı olarak Sorunlar ve Çekme istekleri için okuma erişimi ekleyin
4. Bu GitHub Uygulaması nereye yüklenebilir? altında Bu hesapta'i seçin.
5. GitHub Uygulaması Oluştur'u seçin.
6. Uygulama ayarları sayfasında gösterilen İstemci Kimliği'ne dikkat edin.

GitHub uygulamasını yükleme

1. GitHub Uygulama ayarları sayfasında, sol kenar çubuğundan Yükle Uygulamayı seçin.
2. Kuruluşunuzu seçin.
3. Tüm depolar'ı seçin veya belirli depoları seçin.
4. Yükle'yi seçin.

GitHub uygulama özel anahtarı oluşturma

1. GitHub uygulaması ayarları sayfasında, Özel anahtarlar bölümüne aşağı kaydırın.
2. Özel anahtar oluştur'a tıklayın.
3. .pem dosyası indirilir. Bu dosya, aracının kimlik doğrulaması için kullandığı RSA özel anahtarıdır.

Özel anahtarı Azure Key Vault'ta depolayın

1. Azure portalını açın ve Key Vault gidin.
2. Gizli Anahtarlar>Oluştur/İçe Aktar bölümüne gidin.
3. Ad'ı (örneğin, sre-agent-github-app-key) ayarlayın ve tam PEM içeriğini Değer alanına (-----BEGIN RSA PRIVATE KEY----- ve -----END RSA PRIVATE KEY----- başlıkları dahil) yapıştırın.
4. Oluştur'i seçin.
5. Gizli diziyi açın, geçerli sürümü seçin ve Gizli Dizi Tanımlayıcısı URI'sini kopyalayın:

https://myvault.vault.azure.net/secrets/my-github-app-key/<VERSION>

Aracı kimliğine Key Vault erişimi verin

1. Azure portalında Key Vault>Access denetimi (IAM) açın.
2. Key Vault Secrets User rolünü aracının yönetilen kimliğine atayın.
3. Rol atamanın etkili olmasını bekleyin.

Kod Erişimi'nde BYO uygulamasını yapılandırma

1. Temsilcinizi portalda açın.
2. Oluşturucu>Kod Erişimi'ne gidin.
3. Depo ekle'yi seçin.
4. GitHub seçin ve konağı girin:
   • github.com herkese açık GitHub için
   • <TENANT>.ghe.com Kurumsal Bulut için
5. Kimlik Doğrulamasına Devam Edin.
6. Kendi GitHub Uygulamanızı seçin.
7. Girmek:
   • Müşteri Kimliği
   • Özel anahtar gizli dizisi URI’si (Key Vault)
   • İsteğe bağlı Key Vault identity (veya sistem tarafından atanmış kalsın)
8. Bağlan seçeneğini seçin.

Sihirbaz kimlik bilgilerinizi doğrular. İşlem başarılı olduğunda, yeşil bir onay işaretiyle birlikte GitHub Uygulaması olarak bağlandı ifadesini görürsünüz.

Depo ekleme ve bağlantıyı doğrulama

1. Depoları seçin ve kaydedin.
2. Kod Erişimi kartının bağlı ana bilgisayarı ve kimlik doğrulama türünü GitHubAppgösterdiğini onaylayın.
3. Sohbette test yapın:

Get me recent issues from owner/repo.

Birden çok GitHub uygulaması için uygulama başına yönetilen kimlik

Varsayılan olarak, aracı Key Vault’taki özel anahtarı okumak için sistem tarafından atanan yönetilen kimliğini kullanır. Birden çok GitHub Uygulaması yönetiyorsanız (örneğin GHE örneği başına bir tane), her uygulamaya farklı bir kullanıcı tarafından atanan yönetilen kimlik atayabilirsiniz. Bu yaklaşım, her kimlik yalnızca Key Vault'taki kendi gizli anahtarına erişebildiği için güvenlik yalıtımı sağlar.

Yapılandırma adımı sırasında Key Vault identity açılan listesinden kimliği seçin.

GitHub bağlantılarında birden fazla ana bilgisayar desteği

Aynı aracıya birden çok GitHub ana bilgisayarı bağlayabilirsiniz. Her konak bağımsız kimlik doğrulamaya sahiptir:

• github.com OAuth, PAT veya BYO Uygulamasını →
• contoso.ghe.com → BYO Uygulaması
• engineering.ghe.com → BYO Uygulaması (farklı bir GitHub Uygulaması ile)

Bir ana makinenin bağlantısını kesmek diğerlerini etkilemez.

Troubleshooting

Sonraki adım

İlgili içerik

• GitHub bağlayıcısı
• GitHub bağlayıcısını ayarlama (OAuth veya PAT)
• MCP bağlayıcısı ayarlama