Integrações – Catálogo: conectar, pausar e remover uma integração

O catálogo é onde você vê o que pode ser conectado, o que já está, e o que precisa de atenção. Ele é organizado em três seções, e a leitura delas responde ao estado do seu monitoramento em uma tela.

As três seções

Conectadas. O que já está ligado. Cada item mostra quando sincronizou pela última vez e traz o botão Gerenciar.

Disponíveis para conectar. O que está pronto para uso, marcado como Pronta para conectar, com o botão Conectar.

Em breve. Ferramentas do catálogo que ainda não podem ser conectadas. Elas aparecem para você saber que estão no caminho, e o botão de conexão não fica ativo.

Há busca por nome e navegação por categoria: infraestrutura em nuvem, desenvolvimento e DevOps, banco de dados e dados, produtividade e colaboração, segurança e gerenciadores de senha, CDN e segurança, CRM e vendas, identidade e SSO, e RH e pessoas.

Os selos e o que cada um significa

O selo de atenção é o mais importante da tela, e ele vem acompanhado de uma explicação do motivo:

Aguardando primeira sincronização. Você acabou de conectar e o primeiro ciclo ainda não rodou. Normal.

Sem sincronização desde uma data. A integração parou de trazer dados, e a plataforma avisa que as evidências podem estar desatualizadas.

Reautorize para retomar as evidências. A credencial perdeu validade e precisa ser renovada.

Vale repetir o princípio por trás disso: a plataforma prefere mostrar atenção a mostrar um verde que não corresponde à realidade. Uma integração que parou de sincronizar não está mais comprovando monitoramento contínuo, e o selo reflete isso.

Conectar: as cinco etapas

O assistente de conexão tem cinco passos:

1. Tipo. Confirma qual provedor será conectado.

2. Credenciais. Os campos variam por provedor. Aqui existe um bloco de primeiros passos com orientação e um link para a documentação.

Antes de chegar nesta etapa, vale abrir a página do seu provedor nesta documentação, em Guias por provedor. Ela informa exactamente o que criar do lado do provedor e qual permissão conceder, que é a informação que mais economiza tempo.

3. Teste. Use Testar Conexão para verificar as credenciais antes de prosseguir. Não pule esta etapa: descobrir que a credencial está errada aqui custa um minuto, e descobrir depois custa dias de evidência não coletada.

4. Configurações de Sincronização. Define a frequência entre tempo real, a cada hora, diária ou semanal, e o escopo, ou seja, o que deve ser sincronizado. Se você não selecionar nada no escopo, todos os dados são sincronizados por padrão, e a tela informa isso.

Sobre a frequência, uma recomendação prática: diária resolve a maioria dos casos. Conformidade não muda de minuto em minuto, e frequências muito altas geram volume de chamadas ao provedor sem ganho de evidência. Reserve frequências curtas para ambientes que mudam muito.

5. Revisão. Confere a configuração antes de salvar.

Existe também Salvar Rascunho, útil quando você precisa buscar uma credencial e voltar depois.

Gerenciar uma integração conectada

Na página de uma integração conectada você encontra a configuração, a data da última sincronização e a data do último teste de conexão.

Ao editar credenciais, atenção a um detalhe: os campos sensíveis mostram a orientação de deixar em branco para manter o valor existente. Ou seja, você pode atualizar apenas um campo sem redigitar os outros. E os campos sensíveis avisam que o valor será criptografado.

Se o seu perfil não permite gerenciar integrações, a página informa que você pode visualizar o status, e não conectar, editar, testar ou desconectar.

Pausar não é o mesmo que desconectar

Se você precisa interromper temporariamente a coleta, a forma menos destrutiva é ajustar a frequência de sincronização para o intervalo mais longo, em vez de desconectar. A configuração fica preservada.

Desconectar é definitivo no sentido que importa: a plataforma avisa que a ação remove toda a configuração e interrompe a sincronização automática. Você vai precisar refazer a conexão do zero, com credencial nova.

Um detalhe que surpreende: o fornecedor vinculado

Ao desconectar, a plataforma oferece a opção também excluir o fornecedor vinculado, e explica que, se você não marcar, o fornecedor é mantido e apenas desvinculado da integração.

Isso revela algo útil: integrações podem estar ligadas a registros no seu cadastro de fornecedores. Faz sentido, porque um provedor de nuvem é, ao mesmo tempo, uma fonte de evidência técnica e um terceiro que trata dados seus.

A recomendação na maior parte dos casos é não marcar a exclusão. O fornecedor continua sendo um terceiro relevante para a sua gestão de risco, mesmo que você tenha parado de coletar evidência dele automaticamente. Excluir apagaria o histórico de avaliações e arquivos daquela relação.

Integrações de RH e o webhook

As integrações de RH e pessoas têm um recurso adicional: um webhook que o seu provedor pode chamar para informar admissões e demissões quase em tempo real, com a sincronização periódica continuando como reserva.

O funcionamento envolve gerar um segredo, e há duas informações importantes:

O segredo é exibido apenas uma vez. Copie no momento em que ele aparece.

Regenerar invalida o anterior. Faça isso se houver suspeita de exposição, e lembre de atualizar a configuração do lado do provedor.

O ganho é relevante para conformidade: desprovisionamento tempestivo é um controle que muitas normas cobram, e receber o evento de desligamento na hora é bem melhor que descobrir na sincronização do dia seguinte.

Uma rotina de manutenção que evita surpresa

Uma vez por mês, abra o catálogo e olhe apenas duas coisas:

• Algum item com selo de atenção.
• Alguma data de última sincronização antiga.

São dois minutos, e resolvem o problema mais silencioso da plataforma, que é a evidência que parou de ser coletada sem ninguém notar.

Problemas comuns

Falha ao salvar integração. Confira os campos obrigatórios do provedor e teste a conexão antes de salvar.

Teste de conexão falhou. A credencial está incorreta, expirada ou sem a permissão mínima. A página do provedor nesta documentação lista o que é necessário.

A integração aparece em Em breve. Ela ainda não está disponível para conexão. Você pode registrar interesse pelo caminho de solicitação.

Não consigo editar nem testar. Seu perfil tem apenas visualização. Peça a um administrador.

Desconectei por engano. A configuração foi removida. Refaça a conexão com uma credencial nova; se o fornecedor não foi excluído, o histórico dele permanece.