Passar para o conteúdo principal

Restringir o acesso à REST API por lista de IPs permitidos

Use a lista de IPs permitidos da REST API para restringir quais endereços IP podem chamar sua REST API do Intercom.

Escrito por Penny Gray

Se seus sistemas que chamam a REST API do Intercom operam a partir de endereços IP fixos e conhecidos, a lista de IPs permitidos da REST API permite que você garanta que apenas esses endereços possam autenticar — mesmo que uma chave API seja comprometida.

Isso adiciona uma camada de proteção em nível de rede além da autenticação baseada em token, reduzindo o risco de acesso não autorizado de locais inesperados.


Como funciona

  • O Intercom primeiro valida o token de acesso da requisição.

  • Se a lista de IPs permitidos da REST API estiver ativada e sua lista contiver entradas, o Intercom verifica o IP de origem da requisição.

  • Se o IP não estiver permitido, a requisição retorna uma resposta 403 Forbidden com a mensagem "Seu endereço IP não está na lista de permitidos para acesso à API"

Configure

Resumo do comportamento

  • Recurso desligado → todos os IPs permitidos

  • Recurso ligado + lista vazia → todos os IPs permitidos

  • Recurso ligado + entradas → apenas IPs/intervalos listados permitidos

  • IP não listado → 403 Forbidden

Nota

  • Apenas IPv4; IPv6 ainda não é suportado.

  • Aplica-se a todos os métodos de autenticação da REST API (tokens OAuth ou chaves API).

  • Esse controle é separado das “Restrições de acesso ao espaço de trabalho,” que governam quem pode entrar no painel do Intercom; ambos podem ser usados juntos.

Monitoramento

Um registro de atividade do colega será emitido quando alterações forem feitas na lista de permitidos, permitindo que você monitore as mudanças.

Nota: Para monitorar a atividade bem-sucedida da REST API, você pode consumir o tópico de webhook api.request.completed.

Respondeu à sua pergunta?