Web kancaları

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

Web kancaları, bir olayın JSON temsilini herhangi bir hizmete göndermek için bir yol sağlar. Bunun için tek gereken genel uç noktadır (HTTP veya HTTPS).

Bu tüketici tarafından paylaşılan JSON yükleri hakkında daha fazla bilgi için bkz. olaylar.

Önkoşullar

Yalnızca kuruluş Sahipleri veya Proje Koleksiyonu Yönetici istrator'lar bir kuruluşun web kancalarını yönetebilir.

Bir hizmete JSON gösterimi gönderme

1. Proje Hizmet kancaları sayfanıza gidin:

   https://{orgName}/{project_name}/_settings/serviceHooks

   

   Abonelik oluştur'u seçin.

2. Azure DevOps Services olayını seçin ve yapılandırın:

   

3. Olay gerçekleştiğinde yapılacakları yapılandırın:

   Gönderilecek kaynak ayrıntıları, Gönderilecek iletiler ve Ayarları göndermek için ayrıntılı iletiler hakkında bilgi için aşağıdaki Soru-Cevap'a bakın.

   

4. Hizmet kancası aboneliğini test edin ve sihirbazı tamamlayın:

   

Şimdi web kancası ayarlandı. JSON gösterimini görüntülemek için hedef hizmete gidin:

Fiyatlandırma

Azure DevOps, dış hizmetlerle tümleştirme çerçevesi için ücret almaz. Hizmetleriyle ilgili fiyatlandırma için belirli bir hizmetin sitesine göz atın.

Sorular ve Yanıtlar

S: Gönderilecek Kaynak ayrıntıları, Gönderilecek iletiler ve ayarlarının gönderilip gönderilmeyecek ayrıntılı iletileri nelerdir?

Y: Gönderilen JSON yükünün boyutunu denetler.

Gönderilecek kaynak ayrıntıları ayarı, kaynağın ne kadarının gönderileceğini denetler. Varsayılan değer Tümü'dür, ancak En Az (yalnızca URL ve Kimlik gibi anahtar alanlarını gönderir) veya Hiçbiri'ni de gönderebilirsiniz.

Yok ve En Az , çağıranın iletiye veya ayrıntılı iletiye bağlı olduğundan kaynakla ilgili çok fazla ihtiyaç duymadığı senaryolarda kullanışlıdır. Hiçbiri ve En Az güvenlik nedeniyle de yararlıdır. Örneğin, çağıranın Azure DevOps Services'a geri dönmesi ve kaynak hakkında daha fazla ayrıntı almak için normal güvenlik/izin denetimlerinden geçmesi gerekir.

Örnek JSON:

	{
	    "eventType": "git.push",
	    ...
	    "messages": {
	        "text": "...",
	        "html": "...",
	        "markdown": "..."
	    },
	    "detailedMessage": {
	        "text": "...",
	        "html": "...",
	        "markdown": "..."
	    },
	    "resource": {
	        "id": "...",
	        "url": "https://...",
	        "name": "...",
	        "field1:": "..."
	    }
	}	

S: Program aracılığıyla abonelik oluşturabilir miyim?

Y: Evet, ayrıntılara buradan bakın.

S: WEB kancalarını HTTPS olmayan uç noktalara gönderebilir miyim?

Y: Evet. Ancak, web kancalarınız için yalnızca HTTPS uç noktalarını kullanmanız önerilir. HTTP'nin kullanılması, şifrelenmemiş olarak gönderilen özel veriler için bir potansiyel olduğu anlamına gelir. Bu, web kancanızdaki tüm kimlik doğrulama üst bilgilerini içerir.

S: HTTPS olmayan bir web kancası ayarlarken temel kimlik doğrulamasını kullanabilir miyim?

Y: Hayır. Web kancası üzerinde temel kimlik doğrulamasını kullanırken HTTPS kullanmalısınız.

S: Web kancası hedefleri olarak localhost veya özel aralık IP'leri kullanabilir miyiz?

Y: Hayır. Web kancaları localhost (geri döngü) veya özel aralık IPv4/IPv6 adreslerini hedefleyemez.