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