Aracılığıyla paylaş

Azure DevOps REST API'leri için OAuth 2.0 kimlik doğrulaması

Azure DevOps Hizmetleri

Kullanıcıların tekrar tekrar kimlik bilgileri sağlamasına gerek kalmadan Azure DevOps REST API erişimi için uygulamalarınızın kimliğini doğrulamak için OAuth 2.0 kullanmayı öğrenin.

Önemli

Yeni uygulamalar için Microsoft Entra ID OAuth kullanın. Azure DevOps OAuth 2.0 kullanım dışıdır ve artık yeni kayıtları kabul etmemektedir.

OAuth 2.0, Azure DevOps ile nasıl çalışır?

Uyarı

OAuth 2.0 yalnızca Azure DevOps Services için kullanılabilir, Azure DevOps Server için kullanılamaz. Şirket içi senaryolar için İstemci kitaplıklarını, Windows Kimlik Doğrulamasını veya kişisel erişim belirteçlerini kullanın.

Azure DevOps Services, uygulamaları yetkilendirmek ve REST API çağrıları için erişim belirteçleri oluşturmak için OAuth 2.0 protokolunu kullanır. İşlem aşağıdaki adımları içerir:

  • Uygulama kaydı: Uygulamanızı OAuth sağlayıcısına kaydedin.
  • Kullanıcı yetkilendirmesi: Uygulamanızın kullanıcı verilerine erişmesine izin verin.
  • Belirteç değişimi: API çağrıları yapmak için bir erişim belirteci alın.
  • API erişimi: Kimliği doğrulanmış REST API istekleri için belirteci kullanın.
  • Belirteç yenileme: Erişimi korumak için süresi dolan belirteçleri yenileyin.

Uygulama kaydından API erişimine OAuth 2.0 yetkilendirme akışı işlemini gösteren diyagram.

OAuth uygulama seçenekleri

Uygulamanızın gereksinimlerine göre uygun OAuth uygulamasını seçin.

Microsoft Entra ID OAuth, Azure DevOps uygulamaları için en güvenli ve geleceğe yönelik kimlik doğrulama yöntemini sağlar. Avantajlar şunlardır:

  • Kurumsal tümleştirme: Mevcut Microsoft Entra ID altyapısıyla sorunsuz tümleştirme.
  • Gelişmiş güvenlik: Gelişmiş güvenlik özellikleri Microsoft Entra Koşullu Erişim ve çok faktörlü kimlik doğrulamasını içerir.
  • Gelecekteki destek: Etkin olarak korunan ve desteklenen platform.
  • Birleşik kimlik: Microsoft hizmetlerinde çoklu oturum açma deneyimi.

Başlarken: Uygulama ayrıntıları ve geçiş kılavuzu için Microsoft Entra ID OAuth kılavuzumuzu izleyin.

Azure DevOps OAuth (kullanım dışı)

Uyarı

Azure DevOps OAuth kullanım dışıdır. Yeni uygulama kayıtları Nisan 2025 itibarıyla artık kabul edilmemektedir. Hizmetin 2026'da tamamen kullanımdan kaldırılması planlanmaktadır. Mevcut uygulamaları Microsoft Entra ID OAuth'a geçirin.

Mevcut Azure DevOps OAuth uygulamaları için:

Geçiş planlaması: Microsoft Entra ID OAuth'a geçişinizi planlamaya erken başlayın. Geçiş kılavuzu, sorunsuz bir geçiş için ipuçları ve önemli noktalar sağlar.

OAuth kapsamları

Kapsamlar, uygulamanızın erişebileceği Azure DevOps kaynaklarını tanımlar. Hem Microsoft Entra Id OAuth hem de Azure DevOps OAuth aynı kapsam tanımlarını kullanır.

Önemli kapsam konuları

  • En düşük ayrıcalık ilkesi: Yalnızca uygulamanızın ihtiyaç duyduğu minimum kapsamları isteyin.
  • Kapsam devralma: Bazı kapsamlar diğerlerini içerir (örneğin, vso.code_manage içerir vso.code_write).
  • API kapsamı: Kapsamlar REST API'lerine erişimi etkinleştirir ve yalnızca Git uç noktalarını seçer (SOAP API'leri desteklenmez).
  • Kullanıcı onayı: Kullanıcıların istenen her kapsam için açıkça izin vermesi gerekir.

Gerekli kapsamları bulma

Uygulamanızın hangi kapsamlara ihtiyacı olduğunu belirlemek için:

  • Kullanmayı planladığınız her uç nokta için API başvuru belgelerine bakın.
  • Her API sayfasında scopes üst bilgiyi arayın.
  • Yedekli izinler istemekten kaçınmak için kapsam ilişkilerini göz önünde bulundurun.

Kullanılabilir kapsamlar

Kategori Kapsam İsim Yüksek ayrıcalık Açıklama Şuradan türetilir
Gelişmiş güvenlik vso.advsec Gelişmiş güvenlik (okuma) Evet Uyarıları, sonuç örneklerini ve analiz sonucu örneklerini okuma olanağı verir.
vso.advsec_write Gelişmiş güvenlik (okuma ve yazma) Evet Serif'te analiz yükleme olanağı verir. vso.advsec
vso.advsec_manage Gelişmiş güvenlik (okuma, yazma ve yönetme) Evet Serif'te analiz yükleme olanağı verir. vso.advsec_write
Ajan havuzları vso.agentpools Aracı havuzları (okuma) Görevleri, havuzları, kuyrukları, ajanları ve ajanlar için şu anda çalışan veya yakın zamanda tamamlanmış işleri görüntüleme olanağı sağlar.
vso.agentpools_manage Aracı havuzları (okuma ve yönetme) Evet Havuzları, kuyrukları ve aracıları yönetme olanağı sağlar. vso.agentpools
vso.environment_manage Ortam (okuma ve yönetme) Evet Havuzları, kuyrukları, aracıları ve ortamları yönetme olanağı sağlar. vso.agentpools_manage
Veri Analitiği vso.analytics Analitik (okuma) Analiz verilerini sorgulama olanağı sağlar.
Auditing vso.auditlog Denetim günlüğü (okuma) Kullanıcılara denetim günlüğünü okuma olanağı verir.
vso.auditstreams_manage Denetim akışları (okuma) Evet Kullanıcılara denetim akışlarını yönetme olanağı verir. vso.auditlog
İnşa et vso.build Derleme (Yapı Oluşturma) Derleme sonuçları, tanımlar ve istekler dahil olmak üzere derleme yapıtlarına erişme ve hizmet kancaları aracılığıyla derleme olayları hakkında bildirim alma olanağı verir. vso.hooks_write
vso.build_execute Derleme (oluşturma ve çalıştırma) Evet Derleme sonuçları, tanımlar ve istekler de dahil olmak üzere derleme yapıtlarına erişme olanağı sağlar. Ayrıca bir derlemeyi kuyruğa alma, derleme özelliklerini güncelleştirme ve hizmet kancaları aracılığıyla derleme olayları hakkında bildirim alma olanağı verir. vso.build
Kod vso.code Kod (kod okuma) Kaynak kodu ve taahhütler, değişiklik kümeleri, dallar ve diğer sürüm denetimi yapıtları hakkında meta verileri okuma olanağı sağlar. Ayrıca hizmet kancaları aracılığıyla kod arama ve sürüm denetimi olayları hakkında bildirim alma olanağı sağlar. vso.hooks_write
vso.code_write Kod (okuma ve yazma) Evet Kaynak kodu okuma, güncelleştirme ve silme ve taahhütler, değişiklik kümeleri, dallar ve diğer sürüm kontrol öğeleri hakkındaki meta verilere erişim olanağı sağlar. Ayrıca, çekme istekleri ve kod incelemeleri oluşturma ve yönetme yeteneği sağlar ve hizmet kancaları aracılığıyla sürüm kontrol olayları hakkında bildirim alma olanağı tanır. vso.code
vso.code_manage Kod (okuma, yazma ve yönetme) Evet Kaynak kodu okuma, güncelleştirme ve silme, işlemeler, değişiklik kümeleri, dallar ve diğer sürüm denetimi yapıtları hakkındaki meta verilere erişme olanağı sağlar. Ayrıca kod depoları oluşturup yönetme, çekme istekleri ve kod gözden geçirmeleri oluşturup yönetme ve hizmet kancaları aracılığıyla sürüm denetimi olayları hakkında bildirim alma olanağı sağlar. vso.code_write
vso.code_full Kod (tamamı) Evet Kaynak koduna, commit'ler, değişiklik kümeleri, dallar ve diğer sürüm kontrol nesneleriyle ilgili meta verilere tam erişim verir. Ayrıca kod depoları oluşturup yönetme, çekme istekleri ve kod incelemeleri oluşturup yönetme ve hizmet kancaları aracılığıyla sürüm denetimi olayları hakkında bildirim alma olanağı sağlar. Ayrıca İstemci OM API'leri için sınırlı destek içerir. vso.code_manage
vso.code_status Kod (durum) Commit ve pull-request durumunu okuma ve yazma yeteneği verir.
Bağlı sunucu vso.connected_server Bağlı sunucu Şirket içi bağlı bir sunucudan gerekli uç noktalara erişme olanağı verir.
Yetkilendirmeler vso.entitlements Erişim Hakları (okuma izni) Hesap yetkilendirmelerini almak için lisans yetkilendirme uç noktalarına salt okunur erişim verir.
vso.memberentitlementmanagement Üye haklarının yönetimi (okuma) Kullanıcıları, lisanslarını ve erişebilecekleri projeleri ve uzantıları okuma olanağı verir.
vso.memberentitlementmanagement_write Üye yetkilendirme yönetimi (yazma) Evet Kullanıcıları ve lisanslarını ve erişebilecekleri projeleri ve uzantıları yönetme olanağı verir. vso.memberentitlementmanagement
Extensions vso.extension Uzantılar (okuma önerisi) Yüklü uzantıları okuma olanağı verir. vso.profile
vso.extension_manage Uzantılar (okuma ve yönetme) Evet Yüklü uzantılarda diğer yönetim eylemlerini yükleme, kaldırma ve gerçekleştirme olanağı verir. vso.extension
vso.extension.data Uzantı verilerini oku Yüklü uzantılar tarafından depolanan verileri (ayarlar ve belgeler) okuma olanağı verir. vso.profile
vso.extension.data_write Uzantı verileri (okuma ve yazma) Yüklü uzantılar tarafından depolanan verileri (ayarlar ve belgeler) okuma ve yazma olanağı sağlar. vso.extension.data
GitHub bağlantıları vso.githubconnections GitHub bağlantıları (okuma) GitHub bağlantıları ve GitHub depoları verilerini okuma olanağı sağlar.
vso.githubconnections_manage GitHub bağlantıları (okuma ve yönetme) Evet GitHub bağlantılarını ve GitHub depoları verilerini okuma ve yönetme olanağı sağlar. vso.githubconnections
Grafik ve kimlik vso.graph Grafik - okunabilir Kullanıcı, grup, kapsam ve grup üyeliği bilgilerini okuma olanağı verir.
vso.graph_manage Grafik (yönetim) Evet Kullanıcı, grup, kapsam ve grup üyeliği bilgilerini okuma, kullanıcı ve grup ekleme ve grup üyeliklerini yönetme olanağı verir. vso.graph
vso.identity Kimlik (okuma) Kimlikleri ve grupları okuma olanağı sağlar.
vso.identity_manage Kimlik (yönet) Evet Kimlikleri ve grupları okuma, yazma ve yönetme olanağı sağlar. vso.identity
Makine grubu vso.machinegroup_manage Dağıtım grubu (okuma, yönetme) Evet Dağıtım grubu ve aracı havuzlarını yönetme olanağı verir. vso.agentpools_manage
Pazar Yeri vso.gallery Pazar Yeri Genel ve özel öğelere ve yayıncılara okuma erişimi verir. vso.profile
vso.gallery_acquire Pazar yeri (satın alma) Okuma erişimi ve nesneleri elde etme olanağı sağlar. vso.gallery
vso.gallery_publish Pazar Yeri (yayımlama) Evet Okuma izni ve öğeleri yükleme, güncelleme ve paylaşma olanağı sunar. vso.gallery
vso.gallery_manage Pazaryeri (yönet) Evet Okuma erişimi sağlar ve öğeleri ve yayımlayıcıları yayımlama ve yönetme yeteneği verir. vso.gallery_publish
Notifications vso.notification Bildirimler (okuma) Filtrelenebilir alan değerleri dahil olmak üzere aboneliklere ve olay meta verilerine okuma erişimi verir. vso.profile
vso.notification_write Bildirimler (yazma) Filtrelenebilir alan değerleri dahil olmak üzere aboneliklere okuma ve yazma erişimi verir ve olay meta verilerine okuma erişimi verir. vso.notification
vso.notification_manage Bildirimler (yönet) Filtrelenebilir alan değerleri dahil olmak üzere aboneliklere okuma, yazma ve yönetim erişimi ve olay meta verilerine okuma erişimi verir. vso.notification_write
vso.notification_diagnostics Bildirimler (tanılama) Bildirimle ilgili tanılama günlüklerine erişim verir ve tek tek abonelikler için tanılamayı etkinleştirme olanağı verir. vso.notification
Ambalaj vso.packaging Paketleme (bilgi) Akışları ve paketleri okuma imkanı sağlar. vso.profile
vso.packaging_write Paketleme (okuma ve yazma) Evet Akışlar ve paketleri oluşturma ve okuma yeteneğini sağlar. vso.packaging
vso.packaging_manage Paketleme (okuma, yazma ve yönetme) Evet Akışlar ve paketler oluşturma, okuma, güncelleme ve silme yetkisi sağlar. vso.packaging_write
Hat kaynakları vso.pipelineresources_use İşlem hattı kaynakları (kullanım) Evet Bir işlem hattının korumalı kaynak kullanma isteğini onaylama olanağı verir: aracı havuzu, ortam, kuyruk, depo, güvenli dosyalar, hizmet bağlantısı ve değişken grubu.
vso.pipelineresources_manage Boruhattı kaynakları (kullanma ve yönetme) Evet Korumalı bir kaynağı veya işlem hattının korumalı kaynak kullanma isteğini yönetme olanağı verir: aracı havuzu, ortam, kuyruk, depo, güvenli dosyalar, hizmet bağlantısı ve değişken grubu. vso.pipelineresources_use
Proje ve ekip vso.project Proje ve ekip (okuma) Projeleri ve ekipleri okuma olanağı sağlar.
vso.project_write Proje ve ekip (okumak ve yazmak) Projeleri ve ekipleri okuma ve güncelleştirme olanağı sağlar. vso.project
vso.project_manage Proje ve ekip (okuma, yazma ve yönetme) Evet Projeleri ve ekipleri oluşturma, okuma, güncelleştirme ve silme olanağı sağlar. vso.project_write
Salıverme vso.release Yayınla (oku) Yayınlar, yayın tanımları ve yayın ortamı dahil olmak üzere yayın yapıtlarını okuma olanağı sağlar. vso.profile
vso.release_execute Yayın (okuma, yazma ve yürütme) Evet Yayınlar, yayın tanımları ve yayın ortamı dahil olmak üzere yayın yapıtlarını okuma ve güncelleştirme olanağı sağlar. Ayrıca yeni bir sürümü kuyruğa alma olanağı verir. vso.release
vso.release_manage Yayın (okuma, yazma, yürütme ve yönetme) Evet Yayınlar, yayın tanımları ve yayın ortamı dahil olmak üzere yayın yapıtlarını okuma, güncelleştirme ve silme olanağı sağlar. Ayrıca yeni bir sürümü kuyruğa alma ve onaylama olanağı sağlar. vso.release_execute
Dosyaların güvenliğini sağlama vso.securefiles_read Dosyaların güvenliğini sağlama (okuma) Evet Güvenli dosyaları okuma olanağı verir.
vso.securefiles_write Dosyaların güvenliğini sağlama (okuma ve oluşturma) Evet Güvenli dosyaları okuma ve oluşturma olanağı verir. vso.securefiles_read
vso.securefiles_manage Dosyaların güvenliğini sağlama (okuma, oluşturma ve yönetme) Evet Güvenli dosyaları okuma, oluşturma ve yönetme olanağı sağlar. vso.securefiles_write
Security vso.security_manage Güvenlik (yönet) Evet Güvenlik izinlerini okuma, yazma ve yönetme olanağı sağlar.
Hizmet bağlantıları vso.serviceendpoint Hizmet uç noktaları (okuma) Hizmet uç noktalarını okuma olanağı verir. vso.profile
vso.serviceendpoint_query Hizmet uç noktaları (okuma ve sorgulama) Hizmet uç noktalarını okuma ve sorgulama olanağı verir. vso.serviceendpoint
vso.serviceendpoint_manage Hizmet uç noktaları (okuma, sorgulama ve yönetme) Evet Hizmet uç noktalarını okuma, sorgulama ve yönetme olanağı sağlar. vso.serviceendpoint_query
Hizmet bağlantı noktaları vso.hooks Hizmet bağlantıları (okuma işlemi) Desteklenen olaylar, tüketiciler ve eylemler dahil olmak üzere hizmet kancası aboneliklerini ve meta verilerini okuma olanağı sağlar. (Artık halka açık değil.) vso.profile
vso.hooks_write Hizmet bağlayıcıları (okuma ve yazma) Desteklenen olaylar, tüketiciler ve eylemler dahil olmak üzere hizmet kancası abonelikleri oluşturma ve güncelleştirme ve meta verileri okuma olanağı sağlar. (Artık halka açık değil.) vso.hooks
vso.hooks_interact Hizmet bağlantıları (etkileşim) Hizmet kancaları aracılığıyla alınan olaylar üzerinde etkileşim kurma ve eylemler gerçekleştirme olanağı sağlar. (Artık halka açık değil.) vso.profile
Settings vso.settings Ayarları Oku Ayarları okuma olanağı verir.
vso.settings_write Ayarlar (okuma ve yazma) Ayarları okuma ve yazma yeteneğini verir. vso.settings
Semboller vso.symbols Semboller (okuma) Sembolleri okuma yeteneği verir. vso.profile
vso.symbols_write Simgeler (okuma ve yazma) Sembolleri okuma ve yazma yeteneği verir. vso.symbols
vso.symbols_manage Simgeler (okuma, yazma ve yönetme) Sembolleri okuma, yazma ve yönetme olanağı sağlar. vso.symbols_write
Görev grupları vso.taskgroups_read Görev grupları (okuma) Görev gruplarını okuma yeteneği verir.
vso.taskgroups_write Görev grupları (okuma ve oluşturma) Görev gruplarını okuma ve oluşturma olanağı verir. vso.taskgroups_read
vso.taskgroups_manage Görev grupları (okuma, oluşturma ve yönetme) Evet Görev gruplarını okuma, oluşturma ve yönetme olanağı sağlar. vso.taskgroups_write
Ekip panosu vso.dashboards Ekip panoları (okuma modu) Ekip panosu bilgilerini okuma olanağı sağlar.
vso.dashboards_manage Ekip gösterge tabloları (yönet) Ekip panosu bilgilerini yönetme olanağı sağlar. vso.dashboards
Test yönetimi vso.test Test yönetimi (erişim) Test planlarını, çalışmaları, sonuçları ve test yönetimiyle ilgili diğer yapıtları okuma olanağı sağlar. vso.profile
vso.test_write Test yönetimi (okuma ve yazma) Test planlarını, çalışmaları, sonuçları ve test yönetimiyle ilgili diğer yapıtları okuma, oluşturma ve güncelleştirme olanağı sağlar. vso.test
Threads vso.threads_full Halkla İlişkiler iş parçacıkları Çekme isteği yorum dizilerini okumak ve yazmak için yetki verir.
Token'lar vso.tokens Temsilci yetki jetonları Evet Kullanıcılara temsilci yetkilendirme belirteçlerini yönetme olanağı verir.
vso.tokenadministration Belirteç yönetimi Evet Kuruluş yöneticilerine mevcut belirteçleri yönetme (görüntüleme ve iptal etme) olanağı verir.
Kullanıcı profili vso.profile Kullanıcı profili (oku) Profilinizi, hesaplarınızı, koleksiyonlarınızı, projelerinizi, ekiplerinizi ve diğer üst düzey kuruluş yapıtlarınızı okuma olanağı sağlar.
vso.profile_write Kullanıcı profili (yazma) Profilinize yazma olanağı sağlar. vso.profile
Değişken grupları vso.variablegroups_read Değişken grupları (okuma) Değişken gruplarını okuma olanağı verir.
vso.variablegroups_write Değişken grupları (okuma ve oluşturma) Değişken gruplarını okuma ve oluşturma olanağı verir. vso.variablegroups_read
vso.variablegroups_manage Değişken grupları (okuma, oluşturma ve yönetme) Evet Değişken gruplarını okuma, oluşturma ve yönetme olanağı sağlar. vso.variablegroups_write
Wiki vso.wiki Wiki (okuma) Wiki'leri, wiki sayfalarını ve wiki eklerini okuma olanağı sağlar. Ayrıca wiki sayfalarında arama yapma olanağı da verir.
vso.wiki_write Wiki (okuma ve yazma) Wiki'leri, wiki sayfalarını ve wiki eklerini okuma, oluşturma ve güncelleştirme olanağı sağlar. vso.wiki
İş öğeleri vso.work İş öğelerini oku İş öğelerini, sorguları, panoları, alan ve yineleme yollarını ve iş öğesi izlemeyle ilgili diğer meta verileri okuma olanağı sağlar. Ayrıca, hizmet kancaları aracılığıyla sorgu yürütme, iş öğelerinde arama yapma ve iş öğesi olayları hakkında bildirim alma olanağı verir. vso.hooks_write
vso.work_write İş öğeleri (okuma ve yazma) İş öğelerini ve sorgularını okuma, oluşturma ve güncelleştirme, pano meta verilerini güncelleştirme, alan ve yineleme yollarını ve iş öğesi izlemeyle ilgili diğer meta verileri okuma, sorguları yürütme ve hizmet kancaları aracılığıyla iş öğesi olayları hakkında bildirim alma olanağı verir. vso.work
vso.work_full İş öğeleri (tamamı) İş öğelerine, sorgulara, kapsamlara, planlara ve iş öğesi izleme meta verilerine tam erişim verir. Ayrıca hizmet kancaları aracılığıyla iş öğesi olayları hakkında bildirim alma olanağı sağlar. vso.work_write
Kullanıcı kimliğine bürünme user_impersonation Kullanıcı kimliğine bürünme Evet Visual Studio Team Services REST API'lerine tam erişim verir. Bu kapsamın çok güçlü olduğundan, dikkatli bir şekilde talep edin veya onay verin.

Sıkça sorulan sorular

Q. OAuth'u mobil uygulamalarla kullanabilir miyim?

A. Hayır. Azure DevOps Services yalnızca bir uygulama gizli dizisinin güvenli bir şekilde depolanmasını gerektiren web sunucusu akışını (yetkilendirme kodu akışı) destekler. Mobil uygulamalar gizli bilgileri güvenli bir şekilde depolayamaz, bu da OAuth'u mobil senaryolar için uygun olmayan bir hale getirir.

Mobil uygulamalar için alternatif: Mobil uygulama kimlik doğrulaması için kişisel erişim belirteçlerini kullanın.

Q. OAuth tüm Azure DevOps API'leriyle çalışır mı?

A. OAuth REST API'lerini destekler ve yalnızca Git uç noktalarını seçer. SOAP API'leri OAuth kimlik doğrulamasını desteklemez.

Q. Azure DevOps OAuth'dan Microsoft Entra ID OAuth'a nasıl geçiş yapabilirim?

A. Aşağıdakileri içeren Microsoft Entra ID OAuth geçiş kılavuzunu izleyin:

  • Adım adım geçiş yönergeleri.
  • Kod örnekleri ve en iyi yöntemler.
  • Kullanımdan kaldırma için zaman çizelgesinde dikkat edilmesi gerekenler.

Q. 2026'den sonra mevcut Azure DevOps OAuth uygulamama ne olur?

A. Mevcut Azure DevOps OAuth uygulamaları, hizmet 2026'da tamamen kullanım dışı bırakıldığında çalışmayı durdurur. Bu son tarihten önce Microsoft Entra ID OAuth'a geçişinizi planlayın.

Uygulama yolunuzu seçin

İlgili içerik

  • Last updated on