Prepare o seu software para os prazos de 2027.   Consultar o calendário →
API VERIFACTU

Segurança numa API Verifactu: proteger credenciais e dados

Proteja a integração de API Verifactu com credenciais no servidor, permissões limitadas, registos técnicos filtrados e revisão de acessos.

A segurança de uma API Verifactu também depende da forma como a aplicação a utiliza. A integração liga informação de faturação, credenciais e processos internos. Defina desde o início quem pode configurar o serviço, quais os dados guardados e como responder a uma exposição acidental.

Delimite a utilização das credenciais

A OWASP recomenda HTTPS e a exclusão de segredos das URLs. Mantenha as chamadas autenticadas no servidor e verifique os certificados TLS. Os ecrãs dos utilizadores só precisam de mostrar o estado da operação; não precisam de receber a API Key nem o segredo do cliente. Reveja também a informação presente em ferramentas de diagnóstico e coleções de testes partilhadas.

Defina permissões para tarefas concretas

Consultar o resultado de uma fatura e alterar a configuração da integração são atividades diferentes. Defina quais os perfis autorizados para cada uma e registe alterações relevantes. Se o software gere várias empresas, verifique a autorização em cada operação com o contexto do servidor, sem confiar apenas num identificador enviado pelo navegador.

Conserve registos úteis e limitados

Para investigar uma falha, uma referência de operação, o instante e um código de resultado são frequentemente mais úteis do que cópias indiscriminadas de todos os dados. Crie registos técnicos que ajudem a correlacionar eventos e evite incluir segredos. Decida quem lhes pode aceder e durante quanto tempo são necessários, de acordo com a utilização e as obrigações aplicáveis.

  • Reveja variáveis e ficheiros de configuração da implementação.
  • Confirme que as respostas não mostram credenciais.
  • Limite o acesso a cópias de segurança e registos.
  • Teste permissões entre utilizadores e empresas diferentes.

Prepare a resposta a uma incidência

Documente quem deve contactar o fornecedor e como substituir credenciais segundo o procedimento disponível. Após uma alteração, verifique as operações e notificações dependentes dessas credenciais. Este trabalho operacional complementa a revisão do código e evita improvisações quando uma chave foi partilhada por engano ou muda o pessoal autorizado.

Recursos para continuar