Web Kancaları

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

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

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

Önkoşullar

Bir kuruluşun web kancalarını yalnızca kuruluş Sahipleri veya Project Koleksiyonu Yöneticileri yönetebilir.

Bir hizmete JSON gösterimi gönderme

  1. Proje Hizmet kancaları sayfanıza gidin:

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

    Screenshot of the most recent version of the Project administration page

    Abonelik oluştur'u seçin.

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

    Configure the event dialog box

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

    Gönderilecek kaynak ayrıntıları, Gönderilecekiletiler ve Gönderme ayarları için ayrıntılı iletiler hakkında bilgi için aşağıdaki Q &A'ya bakın.

    Configure the action dialog box

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

    Test it

  1. Proje Hizmet Kancaları sayfanıza gidin:

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

    Screenshot of the Project administration page

    Abonelik Oluştur'u seçin.

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

    Configure the event dialog box

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

    Gönderilecek kaynak ayrıntıları, Gönderilecekiletiler ve Gönderme ayarları için ayrıntılı iletiler hakkında bilgi için aşağıdaki Q &A'ya bakın.

    Configure the action dialog box

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

    Test it

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

View the JSON representation

Fiyatlandırma

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

Q & A

S: Gönderilecek Kaynak ayrıntıları, Gönderilecek iletiler ve ayar gönderilecek 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ö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 Düşük güvenlik nedenleriyle de yararlıdır. Örneğin, çağıranın Azure DevOps Services geri araması 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?

A: Evet, buradaki ayrıntılara 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 kullanmak, şifrelenmemiş olarak gönderilen özel verilerin olası 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?

A: No. 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?

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