# Visão geral de segurança

Suas credenciais Pluggy acessam os dados financeiros de seus usuários. A 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 de proteger: 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.

## As credenciais ficam no seu servidor

O segredo do cliente da sua aplicação e as chaves da API que seu servidor cria com ele têm acesso total à Referência da API da 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. Gerar um novo segredo de cliente interrompe imediatamente o antigo, mas não revoga as chaves da API criadas antes disso.

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

## 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 deixe `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 segredo nos `headers` do webhook e a assinatura HMAC **`X-Pluggy-Signature`**, que prova que a 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 segredo 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 segredos de cliente e gerenciam webhooks; apenas Proprietários desativam ou excluem aplicações e gerenciam o segredo de assinatura do webhook. Mantenha `OWNER` e `ADMIN` para as pessoas que precisam deles e gire os segredos quando alguém que poderia vê-los sair.

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

## Os dados e o consentimento dos 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 na Pluggy, escreva para [security@pluggy.ai](mailto:security@pluggy.ai). O mesmo contato está publicado em nosso [`security.txt`](https://docs.pluggy.ai/.well-known/security.txt).

## Lista de verificação

| Área | Verificação |
| --- | --- |
| Credenciais | O segredo do cliente vive apenas em um gerenciador de segredos ou variável de ambiente do servidor. |
| Credenciais | Nenhum segredo de 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 segredo de cliente, onde implantá-lo e como desativar a aplicação se uma chave da API vazar. |
| 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` da sua equipe. |
| Acesso | Membros que saem são removidos, e os segredos que poderiam ver são girados. |
| Dados | Usuários podem desconectar, e desconectar exclui o Item. |
| Dados | Você remove sua cópia dos dados em `item/deleted`. |