INTEGRITY Dokumentace

Tokeny Tunnelu

A vzdáleně spravovaný tunel ke spuštění vyžaduje pouze token. Tunel může spustit kdokoli, kdo tento token má.

Získání tokenu

Chcete-li získat token pro vzdáleně spravovaný tunel:

  1. V Cloudflare dashboard ↗, přejděte na Sítě > Tunnels.

    Přejděte na Tunnels ↗
  2. Vyberte svůj tunel.

  3. Vyberte Přidejte repliku.

  4. Zkopírujte cloudflared instalační příkaz do textového editoru (příkaz nespouštějte). Token je eyJ... řetězec.

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • Cloudflare One Connectors Write
  • Cloudflare One Connector: cloudflared Write
  • Cloudflare Tunnel Write
Získání tokenu Cloudflare Tunnel
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/cfd_tunnel/$TUNNEL_ID/token" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Rotace tokenu

Tokeny pravidelně otáčejte, abyste snížili riziko jejich kompromitace. U tunelů s více repliky, provádějte rotaci mimo pracovní dobu a repliky aktualizujte po dávkách.

  1. V Cloudflare dashboard ↗, přejděte na Sítě > Tunnels.

    Přejděte na Tunnels ↗
  2. Vyberte svůj tunel.

  3. Vyberte Rotate token. Po otočení tokenu, cloudflared nemůže vytvářet nová připojení se starým tokenem. Stávající konektory zůstávají aktivní až do restartu.

  4. Vyberte Přidejte repliku a zkopírujte nový cloudflared instalační příkaz.

  5. Na každé replice znovu nainstalujte cloudflared službu pomocí nového tokenu:

    sudo cloudflared service uninstall
    sudo cloudflared service install <NEW_TOKEN>

Otočte kompromitovaný token

Pokud dojde ke kompromitaci tokenu tunelu, ihned rotovat token, poté vynuceně ukončete všechna existující připojení:

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
  • Cloudflare One Connectors Write
  • Cloudflare One Connector: cloudflared Write
  • Cloudflare Tunnel Write
Vyčištění připojení Cloudflare Tunnel
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/cfd_tunnel/$TUNNEL_ID/connections" \
	--request DELETE \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Poté znovu nainstalujte cloudflared službu na všech replikách pomocí nového tokenu.