Webhookok

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

A webhookokkal bármelyik szolgáltatásnak elküldheti az események JSON-leképezését. Csak egy nyilvános végpontra van szükség (HTTP vagy HTTPS).

A felhasználó által közzétett hasznos JSON-adattartalmakról további információt az eseményekben talál.

Előfeltételek

Csak a szervezettulajdonosok vagy a projektgyűjtemények Rendszergazda istratorok kezelhetik a szervezet webhookjait.

JSON-reprezentáció küldése szolgáltatásnak

1. Nyissa meg a project Service horgok lapját :

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

   

   Válassza az Előfizetés létrehozása lehetőséget.

2. Válassza ki és konfigurálja az Azure DevOps Services-eseményt:

   

3. Konfigurálja, hogy mi a teendő az esemény bekövetkezésekor:

   A küldendő erőforrás részleteiről, a küldendő üzenetekről és a beállítások küldéséhez szükséges részletes üzenetekről az alábbi Q &A-ben tájékozódhat.

   

4. Tesztelje a szolgáltatáshook-előfizetést, és fejezze be a varázslót:

   

Most már be van állítva a webhook. Nyissa meg a célszolgáltatást a JSON-ábrázolás megtekintéséhez:

Díjszabás

Az Azure DevOps nem számít fel díjat a külső szolgáltatásokkal való integráció keretrendszeréért. Tekintse meg az adott szolgáltatás webhelyét a szolgáltatásaikkal kapcsolatos díjszabásért.

Kérdések és válaszok

K: Mik a küldendő erőforrás adatai, a küldendő üzenetek és a részletes üzenetek a beállítások elküldéséhez?

Válasz: Az elküldött JSON-hasznos adatok méretét vezérli.

A küldendő erőforrás részletei azt vezérli, hogy az erőforrás mekkora részét küldi el. Az alapértelmezett érték a Minden, de választhatja a Minimális (csak a kulcsmezők, például AZ URL-cím és az azonosító) vagy a None (Nincs) küldését is.

A Nincs és a Minimális olyan helyzetekben hasznos, amikor a hívónak valójában nincs szüksége az erőforrásra, ha van rá szüksége, mert az üzenetre vagy a részletes üzenetre támaszkodik. A Nincs és a Minimális funkció biztonsági okokból is hasznos, például a hívónak vissza kell hívnia az Azure DevOps Services szolgáltatásba, és normál biztonsági/engedélyellenőrzéseken kell átesnie az erőforrás további részleteinek lekéréséhez.

JSON-minta:

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

K: Létrehozhatok programozott módon előfizetéseket?

Válasz: Igen, itt tekintsd meg a részleteket.

K: Küldhetek webhookokat nem HTTPS-végpontokra?

V: Igen. Javasoljuk azonban, hogy csak HTTPS-végpontokat használjon a webhookokhoz. A HTTP használata azt jelenti, hogy a titkos adatok titkosítatlan küldése lehetséges. Ez magában foglalja a webhook összes hitelesítési fejlécét.

K: Használhatok alapszintű hitelesítést olyan webhookok beállításakor, amely nem HTTPS?

V.: Nem. A https protokollt akkor kell használnia, ha alapszintű hitelesítést használ egy webhookon.

K: Használhatunk localhost vagy speciális tartomány ip-címeket webhook célokként?

V.: Nem. A webhookok nem célozhatnak localhost (visszacsatolás) vagy speciális IPv4 IPv6-címtartományt./