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 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. Receita: Gire seu segredo de cliente.
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. Receita: Emita Connect Tokens do seu 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. Receita: Autentique notificações de webhook com um segredo no cabeçalho.
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.
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.
Relatar uma vulnerabilidade#
Se você encontrar uma vulnerabilidade de segurança na Pluggy, escreva para security@pluggy.ai. O mesmo contato está publicado em nosso 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 clientIds, 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. |
