Endereços IP

Libere estes endereços no seu firewall se os seus endpoints só aceitam tráfego de origens conhecidas. Eles cobrem webhooks, ações de webhook em gatilhos e automações, o proxy dos apps da barra lateral, o conector de dados de clientes, a descoberta de SSO e as requisições de token de usuários finais, e qualquer outra chamada HTTP que o ChaosDesk faça em seu nome.

Endereços do beta privado

O ChaosDesk está em beta privado num único servidor em Falkenstein, Alemanha, então um par de endereços cobre os dois sentidos.

Sentido	IPv4	IPv6
Saída (requisições que fazemos a você)	2.31.172.241	2a01:4f8:c015:94d4::1
Entrada (para onde o seu DNS aponta num domínio próprio da central de ajuda)	2.31.172.241	2a01:4f8:c015:94d4::1

Libere tanto o endereço IPv4 quanto o IPv6: qual usamos depende do seu DNS.

A lista legível por máquina

Também existe um endpoint legível por máquina, no formato do GET /api/v2/ips do Zendesk:

GET https://api.chaosdesk.io/public/ips.json

{
  "ips": {
    "egress": { "all": ["2.31.172.241/32", "2a01:4f8:c015:94d4::1/128"] },
    "ingress": { "all": ["2.31.172.241", "2a01:4f8:c015:94d4::1"] }
  }
}

Durante o beta privado o endpoint ainda não responde, então use os endereços da tabela acima. Quando ele responder, leia-os de lá em vez de copiá-los no código; avisaremos no registro de mudanças da API.

Estes endereços mudam no lançamento público

A tabela acima é a do beta privado, não a lista final. No lançamento público a plataforma vai para o cluster de produção, com gateways NAT e balanceadores de carga de borda por região, e os endereços mudam. Essa mudança é a única planejada.

Antes de qualquer endereço mudar:

• os novos endereços são publicados aqui e em /public/ips.json pelo menos 30 dias antes de qualquer tráfego mudar,
• os endereços antigos e os novos funcionam durante esses 30 dias,
• os administradores dos espaços de trabalho recebem um e-mail.

Se você não consegue liberar uma faixa manualmente em pouco tempo, escreva para [email protected] e planejamos a troca com você.

Estabilidade entre deploys

No beta os endereços pertencem ao servidor, não a um contêiner, então deploys, reinícios e escalonamento nunca os mudam. Depois do lançamento eles pertencem ao gateway NAT e ao balanceador de borda da região, não a pods ou nós, pelo mesmo motivo.

Entrada, para domínios próprios da central de ajuda

Se você apontar o seu próprio domínio para a sua central de ajuda do ChaosDesk, use um CNAME para hc.chaosdesk.io sempre que o seu provedor de DNS permitir: assim você nunca precisa se preocupar com estes endereços. Use os registros A e AAAA acima só para um domínio raiz cujo provedor não aceite CNAME (descrito também em usar o seu próprio domínio), e conte em atualizá-los no lançamento.

Não é um método de autenticação

Uma lista de permissões é uma segunda camada útil, mas não trate o endereço de origem de uma requisição como prova de que veio de nós. Verifique a assinatura do webhook em cada entrega; essa é a verificação que importa.