Azure Resource Manager hizmet bağlantılarının sorunlarını giderme

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Bu makalede, Azure Resource Manager hizmet bağlantısı oluştururken karşılaşabileceğiniz sorunları çözmenize yardımcı olacak yaygın sorun giderme senaryoları açıklanmaktadır. Hizmet bağlantılarını yönetme konusunu öğrenmek için bkz: Hizmet bağlantılarını oluşturma, düzenleme ve güvenliğini sağlama.

Azure Resource Manager hizmet bağlantısı oluşturduğunuzda ne olur?

Hizmet bağlantınız yoksa aşağıdaki gibi bir bağlantı oluşturabilirsiniz:

1. Projenizin içinden Proje ayarları'nı ve ardından Hizmet bağlantıları'nı seçin.

   

2. Yeni bir hizmet bağlantısı eklemek için Yeni hizmet bağlantısı'nı ve ardından Azure Resource Manager'ı seçin. İşiniz bittiğinde İleri'yi seçin.

   

3. Kimlik türü olarak Uygulama kaydı (otomatik) ve kimlik bilgisi olarak İş yükü kimlik federasyonu seçin.

4. Abonelik'i seçin ve ardından açılan listeden aboneliğinizi seçin. Formun kalan kısmını doldurun ve işiniz bittiğinde Kaydet'i seçin.

Yeni Azure Resource Manager hizmet bağlantınızı kaydettiğinizde, Azure DevOps aşağıdaki eylemleri gerçekleştirir:

1. Seçilen abonelik için Microsoft Entra kiracısına bağlanır.
2. Microsoft Entra ID’de kullanıcı adına bir uygulama oluşturur.
3. Seçilen aboneliğe uygulamayı katkıda bulunan olarak atar.
4. Bu uygulamanın ayrıntılarını kullanarak bir Azure Resource Manager hizmet bağlantısı oluşturur.

Not

Hizmet bağlantıları oluşturmak için, proje ayarlarınızda Endpoint Creator grubu için Oluşturucu veya Yönetici rolüne atanmalısınız: Proje ayarları>Hizmet bağlantıları>Diğer Eylemler>Güvenlik. Proje Katılımcıları varsayılan olarak bu gruba eklenir.

Sorun giderme senaryoları

Hizmet bağlantıları oluşturduğunuzda aşağıdaki sorunlar oluşabilir:

• Kullanıcının dizinde yalnızca konuk izni var
• Kullanıcının dizine uygulama ekleme yetkisi yok
• Erişim belirteci alınamadı veya geçerli bir yenileme belirteci bulunamadı
• Katkıda Bulunan rolü atanamadı
• Hizmet bağlantısı oluştururken abonelik listelenmiyor
• Abonelik listesinde bazı abonelikler eksik
• Service principal belirtecinin süresi doldu
• Hizmet sorumlusu istemci kimliği kullanılarak JSON web belirteci (JWT) alınamadı
• Azure aboneliği önceki görev çıkışından geçirilmiyor
• Hangi kimlik doğrulama mekanizmaları desteklenir? Yönetilen kimlikler nasıl çalışır?

Kullanıcının dizinde yalnızca konuk izni var

1. Yönetici hesabı kullanarak Azure portalında oturum açın. Hesap sahibi veya kullanıcı hesabı yöneticisi olmalıdır

2. Sol gezinti çubuğunda Microsoft Entra Id öğesini seçin.

3. Kullanıcı aboneliğine karşılık gelen uygun dizini düzenlediğinizden emin olun. Aksi takdirde Dizini değiştir'i seçin ve gerekirse uygun kimlik bilgilerini kullanarak oturum açın.

4. Yönet bölümünde Kullanıcılar'ıseçin.

5. Kullanıcı ayarlarını seçin.

6. Dış kullanıcılar bölümünden Dış işbirliği ayarlarını yönet'i seçin.

7. Konuk kullanıcı izinleri sınırlı seçeneğini Hayır olarak değiştirin.

Alternatif olarak, kullanıcıya yönetici düzeyinde izinler vermeye hazırsanız kullanıcıyı Yönetici rolünün bir üyesi yapabilirsiniz. Aşağıdaki adımları yapın:

Uyarı

Kullanıcıları Genel Yönetici rolüne atamak, Microsoft Entra kuruluşunuzdaki tüm yönetim ayarlarını okumalarına ve değiştirmelerine olanak tanır. En iyi uygulama olarak, bu rolü kuruluşunuzdaki beşten az kişiye atayın.

1. Yönetici hesabı kullanarak Azure portalında oturum açın. Hesap bir sahip veya kullanıcı hesabı yöneticisi olmalıdır.

2. Sol gezinti bölmesinde Microsoft Entra ID'yi seçin.

3. Kullanıcı aboneliğine karşılık gelen uygun dizini düzenlediğinizden emin olun. Aksi takdirde Dizini değiştir'i seçin ve gerekirse uygun kimlik bilgilerini kullanarak oturum açın.

4. Yönet bölümünde Kullanıcılar'ıseçin.

5. Yönetmek istediğiniz kullanıcıyı aramak için arama kutusunu kullanın.

6. Yönet bölümünden Dizin rolü'nü seçin ve ardından rolü değiştirin. Bitirdiğinizde Kaydet'i seçin.

Değişikliklerin genel olarak uygulanması genellikle 15-20 dakika sürer. Kullanıcı daha sonra hizmet bağlantısını yeniden oluşturmayı deneyebilir.

Kullanıcının dizine uygulama ekleme yetkisi yok

Dizine tümleşik uygulamalar eklemek için izinlere sahip olmanız gerekir. Dizin yöneticisinin bu ayarı değiştirme izinleri vardır.

1. Sol gezinti bölmesinde Microsoft Entra Id öğesini seçin.

2. Kullanıcı aboneliğine karşılık gelen uygun dizini düzenlediğinizden emin olun. Aksi takdirde Dizini değiştir'i seçin ve gerekirse uygun kimlik bilgilerini kullanarak oturum açın.

3. Kullanıcılar'ı ve ardından Kullanıcı ayarları'nı seçin.

4. Uygulama kayıtları altında Kullanıcılar uygulamaları kaydedebilir seçeneğini Evet olarak değiştirin.

Erişim belirteci alınamadı veya geçerli bir yenileme belirteci bulunamadı

Bu hatalar genellikle oturumunuzun süresi dolduğunda oluşur. Bu sorunları çözmek için:

1. Azure DevOps oturumunu kapatın.
2. InPrivate veya gizli bir tarayıcı penceresi açın ve Azure DevOps'a gidin.
3. Uygun kimlik bilgilerini kullanarak oturum açın.
4. Kuruluşunuzu ve projenizi seçin.
5. Hizmet bağlantınızı oluşturun.

Hata: Yeni bir hizmet bağlantısını düzenlemeye veya oluşturmaya çalışırken etkin bir Azure aboneliğiniz yok gibi görünüyor

Bu hata genellikle birden çok Entra Id kiracısının parçası olduğunuzda oluşur. Sorunu doğrulamak ve çözmek için aşağıdaki adımları izleyin.

1. VS profiline gidin.

2. Birden çok kiracınız olup olmadığını denetleyin.

3. Her kiracıyı seçin ve sonra yeniden kimlik doğrulaması yapın.

4. Bir hizmet bağlantısı oluşturmayı deneyin ve ardından aboneliğin yüklenip yüklenmediğini denetleyin.

Katkıda Bulunan rolü atanamadı

Bu hata genellikle seçili Azure aboneliği için Yazma izniniz olmadığında oluşur.

Bu sorunu çözmek için abonelik yöneticisinden size Microsoft Entra ID'de uygun rolü atamasını isteyin.

Hizmet bağlantısı oluştururken abonelik listelenmiyor

• Çeşitli Azure aboneliği açılan menülerinde (faturalama, hizmet bağlantısı vb.) en fazla 50 Azure aboneliği listelenir: Bir hizmet bağlantısı kuruyorsanız ve 50'den fazla Azure aboneliğiniz varsa, bazı abonelikleriniz listelenmez. Bu senaryoda aşağıdaki adımları tamamlayın:

  1. Azure aboneliğinizin Microsoft Entra örneğinde yeni, yerel bir Microsoft Entra kullanıcısı oluşturun.
  2. Microsoft Entra kullanıcısını, faturalamayı ayarlamak veya hizmet bağlantıları oluşturmak için uygun izinlere sahip olacak şekilde ayarlayın. Daha fazla bilgi için bkz. Azure DevOps faturalama ayarlarını yapabilecek bir kullanıcı ekleme.
  3. Microsoft Entra kullanıcısını Paydaş erişim düzeyine sahip Azure DevOps kuruluşa ekleyin ve ardından Proje Koleksiyonu Yöneticileri grubuna ekleyin (faturalama için) veya kullanıcının hizmet bağlantıları oluşturmak için Team Project'te yeterli izinlere sahip olduğundan emin olun.
  4. Yeni kullanıcı kimlik bilgileriyle Azure DevOps'ta oturum açın ve faturalamayı ayarlayın. Listede yalnızca bir Azure aboneliği görürsünüz.

• Azure DevOps Services'te önbelleğe alınmış eski kullanıcı belirteci: Azure Resource Manager (ARM) hizmet bağlantısı oluşturduğunuzda Azure aboneliğiniz listelenmiyorsa, bunun nedeni Azure DevOps Services'te önbelleğe alınmış eski bir kullanıcı belirteci olabilir. Azure aboneliklerinin liste ekranında kullanıcı belirtecinin güncel olmadığını belirten herhangi bir hata veya uyarı iletisi görüntülenmediğinden bu senaryo hemen açık değildir. Bu sorunu çözmek için aşağıdaki adımları uygulayarak Azure DevOps Services'da önbelleğe alınmış kullanıcı belirtecini el ile güncelleştirin:

  1. Azure DevOps Services oturumunu kapatın ve yeniden oturum açın. Bu eylem kullanıcı belirtecini yenileyebilir.
  2. Eski belirteçlerin kaldırıldığından emin olmak için tarayıcı önbelleğinizi ve tanımlama bilgilerinizi temizleyin.
  3. Azure DevOps portalından hizmet bağlantılarına gidin ve Azure bağlantısını yeniden doğrulayın. Bu adım, Azure DevOps'un yeni bir belirteç kullanmasını ister.

Abonelik listesinde bazı abonelikler eksik

• Destek hesabı türleri ayarlarını değiştirme: Bu sorun, desteklenen hesap türleri ayarlarını değiştirerek ve uygulamanızı kimlerin kullanabileceğini tanımlayarak düzeltilebilir. Aşağıdaki adımları yapın:

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

  2. Birden çok kiracıya erişiminiz varsa, bir uygulamayı kaydetmek istediğiniz kiracıyı seçmek için üst menüdeki Dizin + abonelik filtresini kullanın.

     

  3. Sol bölmeden Microsoft Entra Id'yi seçin.

  4. Uygulama kayıtları’nı seçin.

  5. Kayıtlı uygulamalar listesinden uygulamanızı seçin.

  6. Kimlik doğrulaması'nın altında Desteklenen hesap türleri'ne tıklayın.

  7. Desteklenen hesap türleri'nin altında, Bu uygulamayı kimler kullanabilir veya bu API'ye erişebilir? herhangi bir kuruluş dizinindeki Hesaplar'ı seçin.

     

  8. Bitirdiğinizde Kaydet'i seçin.

• Azure DevOps Services'te önbelleğe alınmış eski kullanıcı belirteci: Azure Resource Manager (ARM) hizmet bağlantısı oluşturduğunuzda Azure aboneliğiniz listelenmiyorsa, bunun nedeni Azure DevOps Services'te önbelleğe alınmış eski bir kullanıcı belirteci olabilir. Azure aboneliklerinin liste ekranında kullanıcı belirtecinin güncel olmadığını belirten herhangi bir hata veya uyarı iletisi görüntülenmediğinden bu senaryo hemen açık değildir. Bu sorunu çözmek için aşağıdaki adımları uygulayarak Azure DevOps Services'da önbelleğe alınmış kullanıcı belirtecini el ile güncelleştirin:

  1. Azure DevOps Services oturumunu kapatın ve yeniden oturum açın. Bu eylem kullanıcı belirtecini yenileyebilir.
  2. Eski belirteçlerin kaldırıldığından emin olmak için tarayıcı önbelleğinizi ve tanımlama bilgilerinizi temizleyin.
  3. Azure DevOps portalından hizmet bağlantılarına gidin ve Azure bağlantısını yeniden doğrulayın. Bu adım, Azure DevOps'un yeni bir belirteç kullanmasını ister.

Hizmet sorumlusu belirtecinin süresi doldu

Genellikle otomatik olarak oluşturulan hizmet sorumluları veya gizli anahtarlarla ilgili ortaya çıkan bir sorun, belirtecin süresinin dolması ve yenilenmesi gerektiğidir. Belirteci yenilemeyle ilgili bir sorununuz varsa bkz. Erişim belirteci alınamadı veyageçerli bir yenileme belirteci bulunamadı.

Belirtecinizin süresi dolduysa hata iletilerinden birini görebilirsiniz:

• AADSTS7000215: Invalid client secret is provided
• AADSTS7000222: The provided client secret keys for app '***' are expired
• Invalid client id or client secret

Otomatik olarak oluşturulan bir hizmet sorumlusunun veya gizli anahtarın erişim belirtecini yenilemek için:

1. Proje ayarlarıgidin ve değiştirmek istediğiniz hizmet bağlantısını seçin.

2. Sağ üst köşedeki Düzenle'yi seçin.

3. Kaydet'i seçin.

Hizmet ilkeniz veya gizli anahtarınızın belirteci artık üç ay daha yenilendi.

Not

Hizmet sorumlusunun belirtecinin süresi dolmamış olsa bile bu işlem kullanılabilir. hizmet sorumlusu için kaydedilen uygulamanın gizli dizisini güncelleştireceği için, işlemi gerçekleştiren kullanıcının abonelik ve Microsoft Entra Kimliği üzerinde uygun izinlere sahip olduğundan emin olun. Daha fazla bilgi için bkz . Otomatik güvenlik kullanarak Azure Resource Manager hizmet bağlantısı oluşturma ve Resource Manager hizmet bağlantısı oluşturduğunuzda ne olur?

Hizmet sorumlusunun istemci kimliği kullanılarak JWT elde edilemedi.

Bu sorun, süresi dolmuş bir gizli diziye sahip bir hizmet bağlantısını kaydetmeye çalıştığınızda veya Entra Kimliği düzeyinde başka sorunlar olduğunda oluşur.

Bu sorunu çözmek için:

1. Proje ayarlarıgidin ve değiştirmek istediğiniz hizmet bağlantısını seçin.

2. Sağ üst köşedeki Düzenle'yi seçin ve ardından hizmet bağlantınızda herhangi bir değişiklik yapın. En kolay ve önerilen değişiklik bir açıklama eklemektir.

3. Hizmet bağlantısını kaydetmek için Kaydet'i seçin.

Not Düşünürü

gibi bir hata alırsanız, Hizmet sorumlunuzla bağlantılı kurumsal uygulamada kullanıcıların oturum açma için etkin seçeneğinin devre dışı bırakılmadığını onaylamak için Entra ID ekibinizle birlikte çalışmanız gerekir.

Azure aboneliği önceki görev çıktısından aktarılmıyor

Azure aboneliğinizi yayın işlem hattınız için dinamik olarak ayarladığınızda ve önceki bir görevden çıkış değişkenini kullanmak istediğinizde, bu sorunla karşılaşabilirsiniz.

Sorunu çözmek için değerlerin işlem hattınızın değişkenler bölümünde tanımlandığından emin olun. Ardından bu değişkeni işlem hattınızın görevleri arasında geçirebilirsiniz.

Hangi kimlik doğrulama mekanizmaları desteklenir? Yönetilen kimlikler nasıl çalışır?

Azure Resource Manager hizmet bağlantısı aşağıdakileri kullanarak bir Azure aboneliğine, yönetim grubuna veya makine öğrenmesi çalışma alanına bağlanabilir:

• Uygulama kaydı (önerilen): İş Yükü Kimlik Federasyonu veya gizli anahtar kullanarak bağlantının kimlik doğrulamasını yapabilirsiniz.
• Yönetilen kimlik: Azure kaynakları için yönetilen kimlikler, Azure hizmetlerine Microsoft Entra Id'de otomatik olarak yönetilen bir kimlik sağlar. Aracı tarafından tanımlanmış bir yönetilen kimliğini de kullanabilirsiniz.

Kimlik doğrulama yöntemi olarak yönetilen kimlikle hizmet bağlantısını ayarlarken, işlem yeni bir yönetilen kimlik oluşturmaz; yalnızca hizmet bağlantısını kurar. Bunun doğru çalışması için belirli koşulların karşılanması gerekir. Özellikle, yönetilen kimlik seçilen kimlik doğrulama yöntemi olduğundan, kullandığınız sanal makinede sistem tarafından atanan bir kimlik olmalıdır. Ayrıca, bu sanal makinenin iş akışının tam olarak yürütülmesi için işlem hatlarında kendi kendine barındırılan bir aracı olarak davranması ve işlem hattının değişiklikleri hizmet bağlantısı üzerinden göndermesine olanak sağlaması gerekir. VM'de sistem tarafından atanan kimlik, aynı VM'nin işlem hattında aracı olarak hizmet ettiğini ve kimlik doğrulamasını etkinleştirdiğini belirler. Bu, mevcut yönetilen kimlik kurulumundan yararlanmanızı sağlar.

Sanal makinelerin yönetilen kimlikleri hakkında bilgi edinmek için Rol atamalarını gözden geçirin.

Not

Yönetilen kimlikler Microsoft tarafından barındırılan aracılarda desteklenmez. Bu senaryoda, bir Azure VM üzerinde kendi kendini barındıran bir aracı ayarlamanız ve bu VM için yönetilen kimlik yapılandırmanız gerekir.

İlgili makaleler

• Pipeline çalışmalarıyla ilgili sorunları giderme
• İşlem hattı günlüklerini gözden geçirme
• Değişkenleri tanımlama