---
title: Integrações
description: Acompanhe o estado da conexão com a Cloudflare, substitua o token, inicie sincronizações e exclua a conexão.
updated: 2026-09-27
---

A página **Integrações** mostra a conexão do tenant com a Cloudflare e o estado de cada coleta. Para criar a primeira conexão, veja [Conectar a Cloudflare](/pt-br/advisor/primeiros-passos/conectar-cloudflare/).

## Antes de começar

- Para ver a página, você precisa da permissão `connections.read`. Para editar ou excluir a conexão, de `connections.write` e `connections.zones.delete`. O papel **Tenant Admin** tem as três.
- Atualmente, cada tenant tem uma conexão por provedor.

:::note
O Advisor apenas lê a conta Cloudflare. Nenhuma ação desta página altera a conta.
:::

## O card da conexão

Acesse **Administração** > **Integrações**. A conexão aparece no card **Cloudflare Edge**, com estes campos:

| Campo | O que mostra |
|---|---|
| **Account ID** | A conta Cloudflare conectada. |
| **Zonas** | As zonas encontradas na conta. |
| **Autenticação** | Como a conexão foi feita: OAuth ou token de API. |
| **Métricas** | Quando as métricas foram sincronizadas pela última vez. |
| **Postura** | Quando a postura foi sincronizada pela última vez. |

Os demais provedores da página aparecem como **Em breve**.

## Status da conexão

| Status | O que significa |
|---|---|
| **Conectada** | A conexão está ativa e a coleta segue o agendamento. |
| **Erro** | A coleta está pausada até a conexão ser corrigida. |
| **Pendente** | A conexão ainda não está ativa. |
| **Desativada** | A conexão não coleta dados. |

## Corrigir o acesso

O caminho depende de como a conexão foi feita.

### Conexão por OAuth

1. No card **Cloudflare Edge**, selecione **Reconectar**.
2. Na tela da Cloudflare, autorize o acesso novamente.
3. De volta ao Advisor, confirme que o status é **Conectada**.

### Conexão por token de API

Use este procedimento quando o token expirar, for revogado ou precisar ser rotacionado.

1. Crie um token novo na Cloudflare com as mesmas permissões de leitura. A lista está em [Conectar a Cloudflare](/pt-br/advisor/primeiros-passos/conectar-cloudflare/).
2. No card **Cloudflare Edge**, selecione **Editar token**.
3. Cole o token novo e salve.
4. O Advisor exibe a mensagem **Token rotacionado com sucesso.**

O **Account ID** não muda, e a conexão continua associada à mesma conta. O nome da conexão vem da Cloudflare.

## Sincronizar agora

A coleta automática é executada diariamente às 02:00 (horário de Brasília). Para buscar dados fora desse horário, use o menu **Sincronizar** do card.

:::availability
**Sincronizar** exige a permissão `connections.scan`, que não faz parte de nenhum papel do tenant. Para habilitá-la, entre em contato com a Guardnet.
:::

1. No card **Cloudflare Edge**, selecione **Sincronizar**.
2. Em **O que sincronizar**, marque os tipos de coleta.
3. Selecione **Iniciar sync (N)**, em que N é a quantidade de tipos marcados.

| Tipo | O que traz |
|---|---|
| **Métricas** | Tráfego, WAF e planos do período. |
| **Postura** | Settings e regras de segurança das zonas; recalcula o score. |
| **Alterações** | Log de quem mudou o quê na conta Cloudflare. |
| **DNS** | Registros das zonas e sondagem de exposição das origens. É o tipo mais demorado. |

Durante a coleta, o card mostra os selos **Sincronizando: …** e **Na fila: …** com os tipos em andamento e os que estão na fila.

## Avisos da página

| Aviso | O que fazer |
|---|---|
| **N conexão(ões) com erro. A coleta está pausada…** | Corrija o acesso com **Reconectar** ou **Editar token**. |
| **N sincronização(ões) falharam…** | Verifique o status da conexão e inicie a sincronização novamente. |
| **N coleta(s) vieram incompletas.** | O scan terminou, mas parte dos dados não foi coletada. Os números correspondentes na tela estão desatualizados. |

Quando uma coleta está incompleta, a linha correspondente mostra **Coleta incompleta:** e os dados ausentes.

Se o problema persistir, veja [Problemas com a conexão Cloudflare](/pt-br/advisor/solucao-de-problemas/conexao-cloudflare/).

## Excluir a conexão

:::caution
A exclusão é irreversível. Ela remove as zonas, as métricas, o histórico de postura e os achados da conexão.
:::

1. No card **Cloudflare Edge**, selecione **Excluir conexão**.
2. Digite o nome exato da conexão.
3. Selecione **Excluir definitivamente**.

## Veja também

- [Conexões e sincronização](/pt-br/advisor/conceitos/conexoes-e-sincronizacao/)
- [Papéis e permissões](/pt-br/advisor/referencia/papeis-e-permissoes/)

---

> Guardnet Docs · https://docs.guardnet.com.br/pt-br/advisor/administracao/integracoes/
> Índice da documentação: https://docs.guardnet.com.br/pt-br/llms.txt