Acesso aprimorado à API

O recurso Enhanced API Access da FlytBase apresenta um método robusto para gerenciar credenciais de API, oferecendo uma melhoria significativa em relação aos padrões de acesso tradicionais. Esse recurso foi projetado para fornecer credenciais controladas para cada integração, garantindo armazenamento seguro e uso de tokens de acesso de curta duração. Também permite desabilitar ou excluir o acesso sem impactar outros sistemas, tornando-o mais fácil de gerenciar e mais seguro de operar. O acesso aprimorado à API aborda os desafios apresentados por padrões de acesso mais antigos, que muitas vezes dificultavam o isolamento de credenciais por integração, a aplicação de controles de ciclo de vida e a minimização do impacto quando os materiais de acesso precisavam ser substituídos. Ao tornar cada chave de API ou segredo de cliente explícito e rastreável, esse recurso aumenta a segurança e a eficiência operacional. Ele se encaixa perfeitamente no fluxo de trabalho mais amplo do produto FlytBase, especialmente para usuários que gerenciam múltiplas integrações e exigem uma maneira segura e gerenciável de lidar com credenciais de API. O principal benefício do Enhanced API Access é sua capacidade de agilizar as operações diárias, oferecendo um sistema de gerenciamento de credenciais mais seguro e gerenciável, ideal tanto para serviços simples quanto para integrações empresariais complexas.

Como funciona

O Enhanced API Access opera por meio de um sofisticado sistema de gerenciamento de credenciais que garante segurança e controle operacional. No centro deste sistema está o conceito deVisibilidade secreta única, onde os valores das credenciais são visíveis somente no momento da criação. FlytBase mantém uma representação unidirecional protegida dessas credenciais, evitando a recuperação do segredo original. Este mecanismo garante que mesmo que uma credencial seja exposta, ela não poderá ser reutilizada ou comprometida posteriormente. O sistema também forneceControle Operacional com Escopo, permitindo que o acesso seja gerenciado por integração. Isso significa que as equipes podem desativar uma única credencial sem afetar outros sistemas, proporcionando um nível granular de controle sobre o acesso à API.

Outro componente crítico deste sistema é o uso deTokens de credenciais de cliente de curta duração. Esses tokens são emitidos pelas credenciais do cliente e são projetados para durar pouco, reduzindo o risco se um token for exposto. Os tokens podem ser atualizados usando tokens de atualização, garantindo que o acesso permaneça seguro e sob controle. Essa abordagem reduz significativamente o risco de exposição de credenciais a longo prazo e melhora a postura geral de segurança do sistema.

O recurso Acesso aprimorado à API oferece suporte a duas opções principais para gerenciamento de credenciais:Chaves de APIeCredenciais do cliente. As chaves de API são usadas para chamadas de API diretas de servidor para servidor com uma única credencial de portador, tornando-as ideais para serviços simples. Por outro lado, as credenciais do cliente são usadas para integrações que exigem a troca de ID e segredo do cliente por tokens de acesso de curta duração, o que é mais adequado para integrações de nível empresarial. Essa abordagem dupla permite flexibilidade e escalabilidade no gerenciamento de credenciais de API em diferentes tipos de serviços e integrações.

Pré-requisitos

Antes de usar o recurso Acesso aprimorado à API, certifique-se de ter os seguintes pré-requisitos em vigor:

• Uma conta FlytBase ativa com privilégios administrativos.
• Acesso ao painel FlytBase onde as credenciais API podem ser gerenciadas.
• Compreensão de suas integrações de API atuais e como elas são configuradas.

Configuração passo a passo

1. Navegue até Painel FlytBase > Gerenciamento de credenciais de API. É aqui que você pode gerenciar todas as credenciais de API associadas à sua conta.
   1. Você verá opções para chaves de API e credenciais de cliente.
2. CliquesobreCriar nova chave de API. Esta ação gerará uma nova chave de API que você pode usar para chamadas de API de servidor para servidor.
   1. Uma caixa de diálogo aparecerá mostrando a nova chave de API. Lembre-se de que a chave só fica visível uma vez na criação.
3. Selecione Credenciais do clientedo cardápio. Esta opção permite gerenciar IDs de cliente e segredos para acesso baseado em token.
   1. Você verá campos para inserir um ID do cliente e gerar um segredo do cliente.
4. Digitaros detalhes necessários paraID do clienteeSegredo do clienteeCliquesobreGerar token de acesso. Isso criará um novo conjunto de credenciais de cliente que pode ser usado para integrações de API.
   1. O token de acesso gerado tem vida curta e pode ser atualizado usando um token de atualização.
5. Análisea lista de chaves ativas, expiradas e desativadas noChaves de APIseção. Isso o ajudará a gerenciar o ciclo de vida de suas chaves de API de maneira eficaz.
   1. Você pode desabilitar ou excluir chaves conforme necessário sem afetar outras integrações.

Restrições e Limitações

As restrições do recurso Enhanced API Access concentram-se principalmente na segurança e no controle operacional. A visibilidade dos segredos é limitada ao momento da criação para evitar acessos não autorizados. Esta limitação garante que mesmo que uma credencial seja exposta, ela não poderá ser reutilizada. A expiração e a substituição planejadas das chaves garantem que as credenciais sejam alternadas regularmente, reduzindo o risco de exposição a longo prazo. A desativação de uma credencial interrompe imediatamente as solicitações de API ou a emissão de tokens, fornecendo uma maneira rápida de mitigar possíveis violações de segurança. O recurso é mais adequado para ambientes onde o gerenciamento de segurança e integração é crítico.

Casos extremos e solução de problemas

• Problema: não é possível recuperar a chave de API após a criação.
  • Causa: as chaves de API só ficam visíveis no momento da criação por motivos de segurança.
  • Solução: certifique-se de armazenar a chave de API com segurança imediatamente após ela ser gerada.
• Problema: as solicitações de API falham após a desativação de uma credencial.
  • Causa: a desativação de uma credencial interrompe imediatamente todas as solicitações de API associadas a ela.
  • Solução: revise suas integrações e certifique-se de que apenas as credenciais necessárias estejam desativadas.
• Problema: os tokens de curta duração expiram com frequência.
  • Causa: os tokens são projetados para terem vida curta para aumentar a segurança.
  • Solução: implemente um mecanismo de atualização de token em seu aplicativo para lidar com a expiração do token.
• Problema: Dificuldade em migrar do acesso clássico para o acesso aprimorado.
  • Causa: Diferenças no gerenciamento de credenciais e nas práticas de segurança.
  • Solução: Siga o guia de migração fornecido pela FlytBase para fazer uma transição tranquila.

Páginas relacionadas

• Gerenciamento de credenciais de API
• Funções e permissões