Autenticação (OAuth2)
A segurança é a base do HoP KMS. Como lidamos com operações criptográficas e dados sensíveis, todas as requisições aos nossos serviços devem ser obrigatoriamente autenticadas.
Para facilitar sua integração e garantir o mais alto nível de segurança, utilizamos o padrão de mercado OAuth2 (gerenciado via Auth0).
Nesta seção, você aprenderá como obter suas credenciais, gerar um token de acesso (access_token) e como enviá-lo corretamente no cabeçalho das suas requisições.
O Protocolo OAuth2 (M2M)
A HoP KMS utiliza o padrão OAuth2 através do fluxo de Client Credentials (Credenciais de Cliente).
Como a nossa infraestrutura foi desenhada para operações de backend (comunicação de servidor para servidor), este é o fluxo ideal para interações Máquina-a-Máquina (M2M). Ele permite que a sua aplicação se autentique de forma autônoma e contínua, sem a necessidade de intervenção humana (como telas de login de usuários).
Essa abordagem garante o isolamento total da sua aplicação e a proteção dos dados durante operações criptográficas críticas, mantendo a sua integração em total conformidade com as normas de segurança do mercado.
Obtenção de Credenciais (Webadmin)
Para se comunicar com o HoP KMS, sua aplicação precisará de duas chaves exclusivas: um Client_Id e um Client_Secret.
Por questões de segurança e controle de acesso, essas credenciais não são geradas dinamicamente via API.
Endpoints de Autenticação (Auth0)
Para gerar o seu token de acesso, você fará uma requisição POST para o nosso servidor de autorização.
Lembre-se da regra de ouro: as credenciais geradas no Webadmin no Ambiente de Testes só funcionam na URL de Homologação, e as credenciais do Webadmin de Produção só funcionam na URL de Produção.
Utilize o endpoint correspondente ao seu ambiente:
Parâmetros da Requisição (Payload)
A solicitação do token deve ser enviada via método POST. O corpo da requisição (body) deve conter os seguintes parâmetros no formato JSON:
client_id · string · Obrigatório
O identificador único da sua aplicação. Você deve obter este valor no painel do Webadmin.
client_secret · string · Obrigatório
A chave secreta da sua aplicação, também obtida no Webadmin. Nunca exponha este valor.
audience · string · Obrigatório
O identificador único do recurso (API) que você deseja acessar.
Homologação: "audience": "https://auth0-jwt-authorizer",
Produção: "audience": "https://auth-jwt-authorize-prd-first-tech",
grant_type · string · Obrigatório
Define o fluxo de autenticação. Para interações máquina-a-máquina, deve ser estritamente: client_credentials
Exemplo de Requisição
Abaixo, apresentamos a estrutura da chamada. Lembre-se de configurar o cabeçalho Content-Type como application/json e substituir os valores de exemplo pelas suas credenciais reais obtidas no painel do Webadmin.
Resposta de Sucesso
Se as credenciais estiverem corretas, o servidor retornará um status 200 OK. O corpo da resposta conterá o seu token de acesso (JWT) e o tempo de validade dele em segundos.
Last updated

