← Notifications / oznámení / začínáme

Konfigurace webhooků

Existuje řada služeb, které můžete k Cloudflare připojit pomocí webhooků a přijímat tak oznámení z vašeho účtu Cloudflare. Informace o tom, jak účet Cloudflare připojit ke službě oblíbené služby pro webhooky.

1. V dashboardu Cloudflare přejděte na Oznámení stránce.

   Přejděte na Oznámení ↗

2. Přejděte na Cíle.

3. V Webhooks kartě vyberte Vytvořit.

4. Webhooku přidělte název, podle kterého ho později snadno identifikujete.

5. V URL pole zadejte adresu URL služby třetí strany, kterou jste dříve nastavili a kterou chcete propojit se svým účtem Cloudflare.

6. V případě potřeby vložte Secret. Tajné klíče slouží k šifrování webhooků a liší se podle služby, kterou ke Cloudflare připojujete.

7. Vyberte Save and Test abyste dokončili nastavení webhooku.

Nový webhook se zobrazí v Webhooks kartě.

U webhooků můžete pouze upravit název, případně je smazat.

1. V dashboardu Cloudflare přejděte na Oznámení stránce.

   Přejděte na Oznámení ↗

2. Přejděte na Cíle.

3. V Webhooks kartě vyberte Úprava u webhooku, který chcete upravit.

4. Aktualizujte název webhooku a vyberte Save.

Webhook můžete smazat po výběru Úprava nebo výběrem Smazat v seznamu webhooků zobrazeném v Cíle kartě.

Oznámení webhooku se odesílají z Rozsahy IP adres Cloudflare ↗. Pokud je váš koncový bod webhooku chráněn firewallem, musíte tyto IP adresy zařadit na seznam povolených, abyste mohli oznámení přijímat.

Chcete-li programově získat aktuální seznam IP adres Cloudflare, použijte Cloudflare API.

Pokud používáte službu, kterou aktuálně dostupné webhooky Cloudflare nepokrývají, můžete nakonfigurujte si vlastní, a zadejte platnou adresu URL webhooku.

Pro obecné webhooky se vždy doporučuje používat tajný klíč (secret). Cloudflare tento tajný klíč odesílá v cf-webhook-auth hlavičku každého odeslaného požadavku. Pokud tato hlavička chybí nebo neodpovídá vámi zadané hodnotě, měli byste webhook odmítnout.

Po výběru Save and Test, měl by být váš webhook nyní nakonfigurován jako cíl, který můžete připojit k zásadám.

Když vám Cloudflare odešle webhook, bude mít následující schéma:

{
	"text": "Hello World! This is a test message sent from https://cloudflare.com. If you can see this, your webhook is configured properly."
}

Úplnou strukturu payloadu a příklady pro jednotlivé typy výstrah najdete v referenční dokumentace schématu datové části webhooku.

Obecná oznámení webhooku Cloudflare se odesílají pouze na veřejně dostupnou adresu IP na portu 80 nebo 443.

Pokud chcete oznámení z obecného webhooku přijímat na privátní IP adrese nebo na jiném portu, můžete oznámení přijmout a přeposlat pomocí Workers nebo nastavte Cloudflare Tunnel abyste je směrovali do vaší připojené aplikace.

Pomocí Cloudflare Workers a obecného webhooku můžete doručovat oznámení do libovolné služby, která webhooky přijímá.

Cloudflare má ukázkový nástroj ↗ abyste pochopili, jak můžete používat Workers a obecné webhooky. Uvedený příklad převádí odpověď obecného webhooku tak, aby ji bylo možné doručit do Rocket.Chat. Poskytnutý kód obsahuje podrobné komentáře, které vám pomohou příklad přizpůsobit vašim potřebám.

Pro Google Chat ↗:

• Secret: Tajný klíč je součástí adresy URL. Cloudflare tuto informaci zpracuje automaticky a uživatel nemusí nic zadávat.
• URL: Adresa URL se liší podle adresy kanálu Google Chat.

Pro Slack ↗:

• Secret: Tajný klíč je součástí adresy URL. Cloudflare tuto informaci zpracuje automaticky a uživatel nemusí nic zadávat.
• URL: Adresa URL se liší podle adresy kanálu Slack.

Pro DataDog ↗:

• Secret: Tajný klíč je povinný a musí ho zadat uživatel. DataDog tento údaj označuje jako Klíč API ↗
• URL: https://api.datadoghq.com/api/v1/events

Pro Discord ↗:

• Secret: Tajný klíč je součástí adresy URL. Cloudflare tuto informaci zpracuje automaticky a uživatel nemusí nic zadávat.
• URL: Adresa URL se liší podle adresy kanálu Discord.

Pro OpsGenie ↗:

• Secret: Tajným klíčem je API Key pro REST API služby OpsGenie.
• URL: https://api.opsgenie.com/v2/alerts

Pro Splunk ↗:

• Secret: Tajný klíč je povinný a musí ho zadat uživatel. Splunk tento údaj označuje jako token. Viz dokumentace Splunk ↗ s podrobnostmi.
• URL:
  1. Podporujeme pouze tři koncové body Splunk: services/collector, services/collector/raw a services/collector/event.
  2. Pokud je pro token povoleno SSL, musí být port 443. Pokud SSL povoleno není, musí být port 8088.
  3. Na serveru musí být povoleno SSL.
  4. Povolit potvrzení indexeru musí být na Splunk HTTP Event Collector vypnuto.

Pro Feishu ↗:

• Secret: Tajný klíč je součástí adresy URL. Cloudflare tuto informaci zpracuje automaticky a uživatel nemusí nic zadávat.
• URL: Adresa URL se liší v závislosti na zvoleném Custom Robot.

Pro Týmy ↗:

• Secret: Tajný klíč je součástí adresy URL. Cloudflare tuto informaci zpracuje automaticky a uživatel nemusí nic zadávat.
• URL: Adresu URL poskytuje Teams při vytvoření konektoru Incoming Webhook.

Pro ServiceNow ↗:

• Secret: Rozhoduje uživatel. Ujistěte se, že tajný klíč zadaný v Cloudflare Notifications odpovídá hodnotě v ServiceNow. Více informací najdete v dokumentace ServiceNow ↗ s podrobnostmi.
• URL: https://{servicenow_instance}.com/{base_api_path}

U obecného webhooku:

• Secret: Rozhoduje uživatel.
• URL: Rozhoduje uživatel.

Při vytváření webhooku pro Google Chat, Slack, Discord nebo Feishu je tajný klíč součástí adresy URL. Tajný klíč můžete z adresy URL odstranit a hodnotu secret než aby ji Cloudflare automaticky extrahoval.

To se hodí, pokud svou webhook infrastrukturu definujete jako kód pomocí Terraformu, protože Cloudflare adresu URL nebude měnit.

resource "cloudflare_notification_policy_webhooks" "example" {
  account_id = "<ACCOUNT_ID>"
  name       = "Slack Webhook"
  url        = "https://hooks.slack.com/services/T00000000/B00000000"
  secret     = "<secret>"
}