# Visão geral de segurança

Seu credenciais Pluggy alcançam os dados financeiros de seus usuários. O Pluggy executa as conexões com as instituições, mantém as credenciais e dados de cada Item, e entrega seus webhooks, assinados uma vez que você ativa a assinatura. Seu lado da integração é sua responsabilidade: suas credenciais, os tokens que você entrega ao front end, seu endpoint de webhook, sua equipe e os dados que você copia para seus próprios sistemas.

Cada seção abaixo é um resumo com um link para a página que contém os detalhes. A [lista de verificação](#checklist) no final resume tudo.

## Credenciais permanecem em seu servidor

O secret do cliente de sua aplicação e as chaves da API que seu servidor cria com ele têm acesso total à API Pluggy. Mantenha-os em um gerenciador de segredos ou em uma variável de ambiente do servidor, reutilize cada chave da API até que expire e use aplicações separadas para desenvolvimento e produção. Um novo secret do cliente pode manter o anterior funcionando por 24 horas, então uma rotação não precisa de tempo de inatividade; quando um secret vaza, gire sem essa opção para que o antigo pare imediatamente. Uma rotação não revoga chaves da API criadas antes dela.

Detalhes: [Credenciais e chaves da API](/docs/security/credentials). Receita: [Gire seu secret do cliente](/recipes/rotate-your-client-secret).

## Limite onde suas credenciais funcionam

Uma aplicação pode ter uma lista de IPs permitidos: uma vez que tenha uma, `POST /auth` e cada solicitação feita com suas chaves da API são aceitas apenas dos IPs que você listar, então um secret ou chave da API vazados são inúteis em qualquer outro lugar. Solicitações feitas com um Connect Token, e assim o Pluggy Connect, não estão restritas.

Detalhes: [Lista de IPs permitidos](/docs/security/ip-allowlist).

## O front end recebe um Connect Token, nunca uma chave da API

Seu backend cria um Connect Token para um usuário autenticado, e o front end abre o Pluggy Connect com ele. Ele dura 30 minutos, alcança apenas os Itens criados com ele e não pode ler dados do produto. Defina `clientUserId` como um identificador opaco e mantenha `includeSandbox` desativado em produção.

Detalhes: [Connect Tokens](/docs/security/connect-tokens). Receita: [Emita Connect Tokens do seu backend](/recipes/issue-connect-tokens-from-your-backend).

## Verifique cada notificação de webhook

Seu endpoint de webhook é público, então trate cada solicitação como não confiável até que passe por suas verificações. Combine as camadas: um endpoint HTTPS, um secret nos `headers` do webhook e a assinatura HMAC **`X-Pluggy-Signature`**, que prova que o Pluggy enviou a notificação e que seu corpo não foi alterado. Em seguida, verifique `clientId` e leia o estado atual com sua chave da API em vez de confiar na carga útil. O filtro de IP de origem é uma camada extra, nunca a única.

Detalhes: [Segurança do webhook](/docs/developer-tools/webhook-security). Receita: [Autentique notificações de webhook com um secret no cabeçalho](/recipes/authenticate-webhook-notifications-with-a-header-secret).

## Apenas as pessoas certas gerenciam suas aplicações

Uma equipe tem três papéis. Proprietários e Administradores geram secrets do cliente e gerenciam webhooks; apenas Proprietários desativam ou excluem aplicações e gerenciam o secret de assinatura do webhook. Mantenha `OWNER` e `ADMIN` para as pessoas que precisam deles e gire os secrets quando alguém que poderia vê-los sair.

Detalhes: [Acesso da equipe](/docs/security/team-access).

## Os dados e consentimento de seus usuários

Deixe o Pluggy Connect coletar credenciais bancárias, para que nunca passem pelos seus servidores. Deixe os usuários desconectarem e exclua o Item quando o fizerem: isso apaga suas credenciais, revoga o consentimento e exclui seus dados. Remova sua própria cópia em `item/deleted` e armazene apenas o que seu produto usa.

Detalhes: [Proteção de dados](/docs/security/data-protection).

## Relatar uma vulnerabilidade

Se você encontrar uma vulnerabilidade de segurança no Pluggy, escreva para [security@pluggy.ai](mailto:security@pluggy.ai). O mesmo contato é publicado em nosso [`security.txt`](https://docs.pluggy.ai/.well-known/security.txt).

## Lista de verificação

| Área | Verificação |
| --- | --- |
| Credenciais | O secret do cliente vive apenas em um gerenciador de segredos ou variável de ambiente do servidor. |
| Credenciais | Nenhum secret do cliente ou chave da API está no código do front-end, aplicativos móveis, repositórios ou logs. |
| Credenciais | Seu servidor reutiliza cada chave da API até que expire. |
| Credenciais | Desenvolvimento e produção usam aplicações separadas. |
| Credenciais | Você sabe como gerar um novo secret do cliente, onde implantá-lo e como desativar a aplicação se uma chave da API vazar. |
| Credenciais | Se seus servidores tiverem IPs de saída estáticos, sua aplicação de produção tem uma lista de IPs permitidos com eles. |
| Front end | O front end recebe apenas Connect Tokens, criados pelo seu backend para um usuário autenticado. |
| Front end | `clientUserId` é um identificador opaco, não dados pessoais. |
| Front end | `includeSandbox` está desativado em produção. |
| Webhooks | Seu endpoint verifica `X-Pluggy-Signature` sobre o corpo bruto, com uma tolerância de 5 minutos. |
| Webhooks | Webhooks criados com `POST /webhooks` carregam um cabeçalho secreto que seu endpoint requer. |
| Webhooks | Seu endpoint ignora notificações para outros `clientId`s, responde `2xx` rapidamente e lê os dados com sua chave da API. |
| Acesso | Apenas as pessoas que precisam são `OWNER` ou `ADMIN` de sua equipe. |
| Acesso | Membros que saem são removidos, e os secrets que poderiam ver são girados. |
| Dados | Usuários podem se desconectar, e desconectar exclui o Item. |
| Dados | Você remove sua cópia dos dados em `item/deleted`. |