Web Kancaları

Makale
11/12/2021
Okumak için 2 dakika

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2017

Web kancaları, bir olayın JSON gösterimini herhangi bir hizmete göndermek için bir yol sağlar. Tüm gerekli olan genel bir uç nokta (HTTP veya HTTPS).

Bu tüketici tarafından gönderilen JSON yükleri hakkında daha fazla bilgi için bkz. Olaylar.

Önkoşullar

yalnızca kuruluş sahipleri veya Project koleksiyon yöneticileri, bir kuruluş için web kancalarını yönetebilir.

Bir hizmete JSON temsili gönder

Proje hizmet kancaları sayfasına gidin:

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

Abonelik oluştur' u seçin.
Azure DevOps Services olayı seçin ve yapılandırın:
Olay gerçekleştiğinde ne yapılacağını yapılandırın:

Gönderilen kaynak ayrıntıları, gönderme iletilerive ayarları göndermek için ayrıntılı Iletiler hakkında bilgi için aşağıdaki Q A 'ya bakın.
Hizmet kancası aboneliğini test edin ve Sihirbazı sona erdirin:

Proje hizmet kancaları sayfasına gidin:

https://dev.azure.com/{orgName}/{project_name}/_apps/hub/ms.vss-servicehooks-web.manageServiceHooks-project

Abonelik oluştur' u seçin.
Azure DevOps Services olayı seçin ve yapılandırın:
Olay gerçekleştiğinde ne yapılacağını yapılandırın:

Gönderilen kaynak ayrıntıları, gönderme iletilerive ayarları göndermek için ayrıntılı Iletiler hakkında bilgi için aşağıdaki Q A 'ya bakın.
Hizmet kancası aboneliğini test edin ve Sihirbazı sona erdirin:

Artık Web kancası ayarlanır. JSON gösterimini görüntülemek için hedef hizmete gidin:

JSON gösterimini görüntüleme

Fiyatlandırma

Azure DevOps dış hizmetlerle tümleştirme için çerçeve için ücret alınmaz. Hizmetleri ile ilgili fiyatlandırma için belirli hizmetin sitesine göz atın.

soru & -cevap

S: gönderileceği kaynak ayrıntıları, gönderme Iletileri ve ayarları göndermek için ayrıntılı iletiler 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önderildiğini denetler. Varsayılan değer Tümü' dir, ancak en az (yalnızca URL ve kimlik gibi anahtar alanları gönderir) veya hiçbirinide gönderebilirsiniz.

Hiçbiri ve en az , çağıranın, ileti ya da ayrıntılı iletiye bağlı olduğundan, kaynak hakkında çok sayıda, her şey gerekli olmadığı senaryolarda faydalıdır. hiçbiri ve Minimal , güvenlik nedenleriyle de yararlı olur, örneğin, çağıranın Azure DevOps Services geri çağırması 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 bakın .

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

Y: Evet. Ancak, Web Kancalarınız için yalnızca HTTPS uç noktalarını kullanmanız önerilir. HTTP kullanmak, özel verilerin şifrelenmemiş olarak gönderilme olasılığı olduğu anlamına gelir. Bu, Web kancasında herhangi bir kimlik doğrulama üst bilgisi içerir.

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

Y : Eşleşen. Web kancası üzerinde temel kimlik doğrulaması kullanılırken HTTPS kullanmanız gerekir.

S: localhost veya özel Aralık IP 'lerini Web kancası hedefleri olarak kullanabilir miyim?

C: Hayır. Web kancaları localhost (geri döngü) veya özel Aralık IPv4 IPv6 adreslerini hedefleyemiyor.