Azure Resource Manager iş yükü kimlik hizmeti bağlantısını el ile ayarlama

Azure DevOps Hizmetleri | Azure DevOps Server | Azure DevOps Server 2022

Azure Resource Manager iş yükü kimlik hizmeti bağlantısı sorunlarını giderirken, Azure DevOps'ta kullanılabilen otomatik aracı kullanmak yerine bağlantıyı el ile yapılandırmanız gerekebilir.

El ile yapılandırmaya başlamadan önce otomatik yaklaşımı deneyin.

Kimlik doğrulaması için yönetilen kimlik veya uygulama kaydı kullanabilirsiniz. Yönetilen kimlik seçeneği, hizmet sorumluları oluşturma izniniz yoksa veya Azure DevOps kullanıcınızdan farklı bir Microsoft Entra kiracısı kullanıyorsanız kullanışlıdır.

Azure DevOps sağlayıcısının kullanımdan kaldırılması

Azure DevOps veren iş yükü kimliği federasyon hizmeti bağlantıları kullanım dışı bırakılıyor. Hizmet bağlantınız kullanımdan kaldırılmış olarak işaretlendiyse, bunu Microsoft Entra yayımcısına dönüştürün.

Bu kullanımdan kaldırma yalnızca tek kiracılı Microsoft Entra uygulamaları veya yönetilen kimlikleri kullanan Azure genel buluttaki uygun hizmet bağlantıları için geçerlidir. Genel bulut dışındaki bulutları hedefleyen hizmet bağlantıları ve çok kiracılı uygulamalar kullanan hizmet bağlantıları bu kullanımdan kaldırmanın kapsamı dışındadır. Azure DevOps vereni kullanan mevcut bir hizmet bağlantınız varsa, yeni bir bağlantı oluşturmak yerine var olan bağlantıyı dönüştürün. Diğer ayrıntılar için bkz. Hizmet bağlantılarını dönüştürme .

Gerekli izinler

bir iş yükü kimlik hizmeti bağlantısını yapılandırmak veya dönüştürmek için hem Azure DevOps hem de Azure veya Microsoft Entra izinlere ihtiyacınız olabilir.

Area	İzin gerekiyor
Azure DevOps	Hizmet bağlantısında hizmet bağlantısı yöneticisi veya uç nokta yöneticisi izni.
Kullanıcı tarafından atanan yönetilen kimlik	Yönetilen kimliği güncelleştirme ve federasyon kimlik bilgileri ekleme izni. Gerekli en düşük rol, Managed Identity Federated Credential Contributor, Managed Identity Contributor veya federe kimlik bilgilerinin oluşturulmasına izin veren başka bir rol olabilir.
Uygulama kaydı	Uygulama kaydına sahip düzeyinde erişim veya federe kimlik bilgilerinin yönetilmesine izin veren başka bir Microsoft Entra rolü.
Hedef Azure kaynağı	Kimliğe abonelikte, kaynak grubunda veya kaynakta Katkıda Bulunan gibi gerekli rolü atama izni.

Azure DevOps izinleri ve Azure izinleri ayrıdır. Kullanıcı Azure DevOps bir hizmet bağlantısını düzenleyebilir ancak Azure veya Microsoft Entra federasyon kimlik bilgilerini eklemek için Azure yöneticisinden veya kimlik sahibinden yardım almaya devam edebilir.

Kurulum işlemine genel bakış

Aşağıdaki diyagramda iş yükü kimlik hizmeti bağlantısını yapılandırmaya yönelik üst düzey adımlar gösterilmektedir:

Mevcut hizmet bağlantılarını dönüştürme

Mevcut bir hizmet bağlantısı kullanım dışı bırakılmış Azure DevOps vereni kullanıyorsa, Microsoft Entra vereni kullanacak şekilde dönüştürün.

Kullanılabilir olduğunda otomatik dönüştürmeyi kullanma

1. Azure DevOps'da project açın ve Project ayarları>> gidin.

2. Kullanım dışı olarak işaretlenen hizmet bağlantısını seçin.

3. Hizmet bağlantısını güncelleştirme seçeneğini belirleyin.

4. Dönüştürmeyi Azure DevOps denemesine izin verin.

Dönüştürme başarılı olursa, hizmet bağlantısı Microsoft Entra vereni kullanır ve başka el ile yapılandırma gerekmez. Ayrıntılı dönüştürme adımları için bkz. Hizmet bağlantılarını dönüştürme .

Otomatik dönüştürme tamamlanmadığında el ile dönüştürmeyi kullanma

Azure DevOps kimliği otomatik olarak güncelleştiremezse, Azure veya Microsoft Entra eklemeniz gereken federasyon kimlik bilgisi değerlerini gösterir. Hizmet bağlantısıyla ilişkili kimlikte federasyon kimlik bilgilerini oluşturmak için Azure DevOps'de gösterilen değerleri kullanın.

Azure DevOps'tan aşağıdaki değerlere ihtiyacınız var:

• İhraç Eden
• Konu tanımlayıcısı

Federasyon kimlik bilgilerini Azure veya Microsoft Entra ekledikten sonra Azure DevOps'da hizmet bağlantısına dönün ve kurulumu tamamlayın. Ayrıntılı dönüştürme adımları için bkz. Hizmet bağlantılarını dönüştürme.

Sınırlamalar

Azure DevOps vereninin kullanımdan kaldırılma süreci, her iş yükü kimliği senaryosu için geçerli değildir.

• Herkese açık olmayan bulutları hedefleyen hizmet bağlantıları bu kullanım dışı bırakmanın kapsamı dışındadır.
• Çok kiracılı uygulama kullanan hizmet bağlantıları, bu kullanımdan kaldırmanın kapsamı dışındadır.

İş yükü kimlik hizmeti bağlantısını ayarla

Yönetilen kimlik

Azure Pipelines'ınız için yönetilen kimlik kimlik doğrulamasını el ile ayarlamak üzere bu adımları izleyerek Azure portalında yönetilen kimlik oluşturun, Azure DevOps'ta bir hizmet bağlantısı kurun, federasyon kimlik bilgileri ekleyin ve gerekli izinleri verin. Şu adımları şu sırayla izleyin:

1. Yönetilen kimliği Azure portalında oluşturun.
2. Azure DevOps'ta hizmet bağlantısını oluşturun ve taslak olarak kaydedin.
3. Azure portalında yönetilen kimliğinize federasyon kimlik bilgileri ekleyin.
4. Azure portalında yönetilen kimliğe izinler verin.
5. Hizmet bağlantınızı Azure DevOps'a kaydedin.

Bu işlem için REST API'yi de kullanabilirsiniz.

Yönetilen kimlik doğrulaması için önkoşullar

• Kullanıcı tarafından atanan bir yönetilen kimlik oluşturmak için, Azure hesabınızın "Katkıda Bulunan Yönetilen Kimlik" rolüne veya daha yüksek bir rol atamasına ihtiyacı vardır.
• İşlem hattınızdaki Azure kaynaklarına erişmek üzere yönetilen kimlik kullanmak için yönetilen kimlik erişimini kaynağa atayın.

Azure portalında yönetilen kimlik oluşturma

1. Azure Portal’ında oturum açın.

2. Arama kutusuna Yönetilen Kimlikler yazın.

3. Oluştur'u belirleyin.

4. Kullanıcı Tarafından Atanan Yönetilen Kimlik Oluştur bölmesinde, aşağıdaki öğeler için değerleri girin veya seçin:

   • Abonelik: Kullanıcı tarafından atanan yönetilen kimliğin oluşturulacağı aboneliği seçin.
   • Kaynak grubu: kullanıcı tarafından atanan yönetilen kimliği oluşturmak için bir kaynak grubu seçin veya yeni bir kaynak grubu oluşturmak için Yeni oluştur'u seçin.
   • Bölge: Kullanıcı tarafından atanan yönetilen kimliği dağıtmak için bir bölge seçin (örnek: Doğu ABD).
   • Ad: Kullanıcı atanımlı yönetilen kimlik için bir ad girin (örneğin: UADEVOPS).

5. Yeni bir yönetilen kimlik oluşturmak için Gözden geçir + oluştur'u seçin. Dağıtımınız tamamlandığında Kaynağa git’i seçin.

6. Daha sonra kullanmak üzere yönetilen kimliğiniz için Abonelik, Abonelik Kimliği ve İstemci Kimliği değerlerini kopyalayın.

7. Azure portalında yönetilen kimliğiniz içinde Ayarlargidin.

8. Daha sonra kullanmak için Kiracı Kimliği değerini kopyalayın.

Azure DevOps'ta yönetilen kimlik doğrulaması için hizmet bağlantısı oluşturma

1. Azure DevOps'ta projenizi açın ve >Boru Hatları>Hizmet bağlantıları'na gidin.

2. Yeni hizmet bağlantısı'nı seçin.

3. Azure Resource Manager'ı seçin.

4. Uygulama kaydı veya Yönetilen kimlik (el ile) kimlik türünü seçin ve ardından İş yükü kimliği federasyon kimlik bilgilerini seçin.

   

5. Hizmet bağlantısı adı için gibi uamanagedidentitybir değer girin. Bu değeri federasyon kimlik bilgisi konu tanımlayıcınızda kullanacaksınız.

6. İleri'yi seçin.

7. 2. Adımda: Uygulama kaydı ayrıntıları:

   2. Adım: Uygulama kaydı ayrıntıları aşağıdaki parametreleri içerir. Aşağıdaki parametreleri girin veya seçin:

   Parametre	Açıklama
   İhraç Eden	Gerekli. DevOps, veren URL'yi otomatik olarak oluşturur.
   Konu tanımlayıcısı	Gerekli. DevOps, konu tanımlayıcısını otomatik olarak oluşturur.
   Ortam	Gerekli. Bağlanmak için bir bulut ortamı seçin. Azure Stack'i seçerseniz, https://management.local.azurestack.external gibi ortam URL'sini girin.

   1. Kapsam Düzeyi'ni seçin. Abonelik, Yönetim Grubu veya Machine Learning Çalışma Alanı'yı seçin. Yönetim grupları , birden çok abonelikte erişimi, ilkeyi ve uyumluluğu yönetmenize yardımcı olan kapsayıcılardır. Machine Learning Çalışma Alanı, makine öğrenmesi yapıtları oluşturmak için kullanılabilir.

      • Abonelik kapsamı için aşağıdaki parametreleri girin:

        Parametre	Açıklama
        Abonelik Kimliği	Gerekli. Azure abonelik kimliğini girin.
        Abonelik Adı	Gerekli. Azure aboneliği adını girin.

      • Yönetim Grubu kapsamı için aşağıdaki parametreleri girin:

        Parametre	Açıklama
        Yönetim Grubu Kimliği	Gerekli. Azure yönetim grubu kimliğini girin.
        Yönetim Grubu Adı	Gerekli. Azure yönetim grubu adını girin.

      • Machine Learning Çalışma Alanı kapsamı için aşağıdaki parametreleri girin:

        Parametre	Açıklama
        Abonelik Kimliği	Gerekli. Azure abonelik kimliğini girin.
        Abonelik Adı	Gerekli. Azure aboneliği adını girin.
        Kaynak Grubu	Gerekli. Çalışma alanını içeren kaynak grubunu seçin.
        ML Çalışma Alanı Adı	Gerekli. Mevcut Azure Machine Learning çalışma alanının adını girin.
        ML Çalışma Alanı Konumu	Gerekli. Mevcut Azure Machine Learning çalışma alanının konumunu girin.

   2. Kimlik Doğrulaması bölümünde aşağıdaki parametreleri girin veya seçin:

      Parametre	Açıklama
      Uygulama (istemci) kimliği	Gerekli. Yönetilen kimliğiniz için Müşteri Kimliğini girin.
      Dizin (kiracı) kimliği	Gerekli. Yönetilen kimliğinizden Kiracı Kimliğini girin.

   3. Güvenlik bölümünde, Tüm işlem hatlarına erişim izni ver'i seçerseniz, tüm işlem hatları bu bağlantıyı kullanabilir. Bu seçeneği kullanmayın. Bunun yerine, hizmet bağlantısını kullanmak için her işlem hattını tek tek yetkilendirin.

8. Azure DevOps'ta Veren ve Konu tanımlayıcısı için oluşturulan değerleri kopyalayın.

9. Taslak belgeyi kaydetmek için Taslak olarak tut'u seçin. Yönetilen kimliğiniz Azure portalında federasyon kimlik bilgilerine sahip olana kadar kurulumu tamamlayamazsınız.

Azure portalında federasyon kimlik bilgisi ekleme

1. Yeni bir tarayıcı penceresinde, Azure portalındaki yönetilen kimliğinizin içinde Ayarlargidin.

2. Kimlik bilgileri ekle'yi seçin.

3. Diğer ihraççı senaryosunu seçin.

4. Azure DevOps projenizden kopyaladığınız Veren ve Konu tanımlayıcısı değerlerini Azure portalındaki federasyon kimlik bilgilerinize yapıştırın. Tür için Açık konu tanımlayıcısı'nı seçin.

   

5. Federasyon kimlik bilgilerinizin adını girin.

6. Ekle'yi seçin.

Azure portalında yönetilen kimliğe izin verme

1. Azure portalında, izin vermek istediğiniz Azure kaynağına gidin (örneğin, bir kaynak grubu).

2. Erişim denetimi (IAM) öğesini seçin.

   

3. Rol ataması ekle’yi seçin. Gerekli rolü yönetilen kimliğinize (örneğin, Katkıda Bulunucu) atayın.

4. Gözden geçir ve ata seçin.

Azure DevOps hizmet bağlantınızı kaydetme

1. Azure DevOps'ta taslak hizmet bağlantınıza geri dönün.

2. Kurulumu bitir'i seçin.

3. Doğrula ve kaydet'i seçin. Bu adım başarıyla tamamlandığında yönetilen kimliğiniz tamamen yapılandırılır.

Uygulama kaydı

Bu bölüm, Azure portalında uygulama kaydı ve federasyon kimlik bilgileri ayarlama, Azure DevOps'ta hizmet sorumlusu kimlik doğrulaması için hizmet bağlantısı oluşturma, uygulama kaydınıza federasyon kimlik bilgileri ekleme ve gerekli izinleri verme konusunda size yol gösterir. Uygulama kaydı hizmet sorumlusu (service principal) kimlik doğrulamasını kullanır. Bu adımları aşağıdaki sırayla tamamlayın:

1. Azure portalında hizmet sorumlusu kimlik doğrulaması ile uygulama kaydını oluşturun.
2. Azure DevOps'ta hizmet bağlantısını oluşturun ve taslak olarak kaydedin.
3. Azure portalında uygulama kaydınıza federasyon kimlik bilgileri ekleyin.
4. Azure portalında uygulama kaydına izinler verin.
5. Hizmet bağlantınızı Azure DevOps'a kaydedin.

Bu işlem için REST API'yi de kullanabilirsiniz.

Uygulama kaydı kimlik doğrulaması önkoşulları

• Hizmet bağlantısı oluşturmak için Azure hesabınızın uygulama kayıtları oluşturabilmesi gerekir.
  • Kiracınızda uygulama kayıtları oluşturma devre dışı bırakıldıysa, uygulama kayıtları oluşturmak için Uygulama Geliştirici rolüne sahip olmanız gerekir.

Azure portalında uygulama kaydı ve federasyon kimlik bilgileri oluşturma

1. Azure portalında uygulama kayıtlarını arayın.

2. Yeni kayıt öğesini seçin.

   

3. Ad alanına uygulama kaydınız için bir ad girin. Ardından Bu uygulamayı kimler kullanabilir veya bu API'ye erişebilir'i seçin.

4. Kaydet'i seçin.

5. Yeni uygulama kaydınız açıldığında, daha sonra kullanmak üzere Uygulama (istemci) Kimliği ve Dizin (kiracı) Kimliği değerlerini kopyalayın.

   

Azure DevOps'ta uygulama kaydı kimlik doğrulaması için hizmet bağlantısı oluşturma

1. Azure DevOps'ta projenizi açın ve >Boru Hatları>Hizmet bağlantıları'na gidin.

2. Yeni hizmet bağlantısı'nı seçin.

3. Azure Resource Manager'ı seçin.

4. Uygulama kaydı veya Yönetilen kimlik (el ile) kimlik türünü seçin ve ardından İş yükü kimliği federasyon kimlik bilgilerini seçin.

   

5. Hizmet bağlantısı adı için gibi uaappregistrationbir değer girin. Bu değeri federasyon kimlik bilgisi konu tanımlayıcınızda kullanacaksınız.

6. İleri'yi seçin.

7. 2. Adımda: Uygulama kaydı ayrıntıları:

   2. Adım: Uygulama kaydı ayrıntıları aşağıdaki parametreleri içerir. Aşağıdaki parametreleri girin veya seçin:

   Parametre	Açıklama
   İhraç Eden	Gerekli. DevOps, veren URL'yi otomatik olarak oluşturur.
   Konu tanımlayıcısı	Gerekli. DevOps, konu tanımlayıcısını otomatik olarak oluşturur.
   Ortam	Gerekli. Bağlanmak için bir bulut ortamı seçin. Azure Stack'i seçerseniz, https://management.local.azurestack.external gibi ortam URL'sini girin.

   1. Kapsam Düzeyi'ni seçin. Abonelik, Yönetim Grubu veya Machine Learning Çalışma Alanı'yı seçin. Yönetim grupları , birden çok abonelikte erişimi, ilkeyi ve uyumluluğu yönetmenize yardımcı olan kapsayıcılardır. Machine Learning Çalışma Alanı, makine öğrenmesi yapıtları oluşturmak için kullanılabilir.

      • Abonelik kapsamı için aşağıdaki parametreleri girin:

        Parametre	Açıklama
        Abonelik Kimliği	Gerekli. Azure abonelik kimliğini girin.
        Abonelik Adı	Gerekli. Azure aboneliği adını girin.

      • Yönetim Grubu kapsamı için aşağıdaki parametreleri girin:

        Parametre	Açıklama
        Yönetim Grubu Kimliği	Gerekli. Azure yönetim grubu kimliğini girin.
        Yönetim Grubu Adı	Gerekli. Azure yönetim grubu adını girin.

      • Machine Learning Çalışma Alanı kapsamı için aşağıdaki parametreleri girin:

        Parametre	Açıklama
        Abonelik Kimliği	Gerekli. Azure abonelik kimliğini girin.
        Abonelik Adı	Gerekli. Azure aboneliği adını girin.
        Kaynak Grubu	Gerekli. Çalışma alanını içeren kaynak grubunu seçin.
        ML Çalışma Alanı Adı	Gerekli. Mevcut Azure Machine Learning çalışma alanının adını girin.
        ML Çalışma Alanı Konumu	Gerekli. Mevcut Azure Machine Learning çalışma alanının konumunu girin.

   2. Kimlik Doğrulaması bölümünde aşağıdaki parametreleri girin veya seçin:

      Parametre	Açıklama
      Uygulama (istemci) kimliği	Gerekli. Uygulama kaydınız için Uygulama (istemci) kimliğini girin.
      Dizin (kiracı) kimliği	Gerekli. Uygulama kaydınız için Dizin (kiracı) kimliğini girin.

   3. Güvenlik bölümünde, Tüm işlem hatlarına erişim izni ver'i seçerseniz, tüm işlem hatları bu bağlantıyı kullanabilir. Bu seçeneği kullanmayın. Bunun yerine, hizmet bağlantısını kullanmak için her işlem hattını tek tek yetkilendirin.

8. Azure DevOps'ta Veren ve Konu tanımlayıcısı için oluşturulan değerleri kopyalayın.

9. Taslak belgeyi kaydetmek için Taslak olarak tut'u seçin. Yönetilen kimliğiniz Azure portalında federasyon kimlik bilgilerine sahip olana kadar kurulumu tamamlayamazsınız.

Azure portalında uygulama kaydınıza federasyon kimlik bilgileri ekleme

1. Azure portalında uygulama kaydınızı açın ve Sertifikaları ve gizli dizilerigidin.

2. Federasyon kimlik bilgilerini seçin.

   

3. Kimlik bilgileri ekle'yi seçin.

4. Diğer ihraççı senaryosunu seçin.

   

5. Azure DevOps projenizden kopyaladığınız Veren ve Konu tanımlayıcısı değerlerini Azure portalındaki federasyon kimlik bilgilerinize yapıştırın. Tür için Açık konu tanımlayıcısı'nı seçin.

   

6. Kaydet'i seçin.

Azure portalında uygulama kaydına izin verme

1. Azure portalında, izin vermek istediğiniz Azure kaynağına gidin (örneğin, bir kaynak grubu).

2. Erişim denetimi (IAM) öğesini seçin.

   

3. Rol ataması ekle’yi seçin. Gerekli rolü uygulama kaydına atayın (örneğin, Katkıda Bulunan).

4. Gözden geçir ve ata seçin.

Uygulama kaydınızı kaydedin ve Azure DevOps hizmet bağlantısını oluşturun.

1. Azure DevOps'ta taslak hizmet bağlantınıza geri dönün.

2. Kurulumu bitir'i seçin.

3. Doğrula ve kaydet'i seçin. Bu adım başarıyla tamamlandığında Azure Resource Manager hizmet bağlantınız tamamen yapılandırılır.

İlgili içerik

• Microsoft Entra iş yükü kimliğiyle Azure DevOps'a erişme
• Azure Resource Manager'ı iş yükü kimlik hizmeti bağlantıları ile otomatikleştirmek için betikleri kullanma
• İş yükü kimlik hizmeti bağlantılarında sorun giderme
• Azure Resource Manager hizmet bağlantılarının sorunlarını giderme