Autenticação Hawk

A Autenticação Hawk é um protocolo de autenticação baseado em pedidos HTTP, concebido para fornecer um mecanismo de autenticação simples, flexível e seguro. Utiliza HMAC (Hash-based Message Authentication Code) para criar assinaturas criptográficas que verificam tanto a autenticidade como a integridade dos pedidos.

Hawk é particularmente útil para APIs que requerem segurança robusta sem a complexidade do OAuth, fornecendo uma alternativa leve para comunicação entre serviços.

Definições Básicas

Configure os parâmetros essenciais da autenticação Hawk:

Parâmetro	Descrição	Obrigatório
Hawk Auth ID	Identificador de autenticação para o pedido atual	Sim
Hawk Auth Key	Chave de autenticação para o pedido atual	Sim
Algorithm	Algoritmo HMAC para autenticação de mensagens	Sim (SHA-256, SHA-1, etc.)

Seleção do Algoritmo

O algoritmo deve corresponder ao que o seu fornecedor de API espera. SHA-256 é recomendado para implementações modernas, enquanto SHA-1 é suportado para sistemas legados.

Definições Avançadas

Clique na opção Mais para configurar parâmetros Hawk adicionais. Se forem deixados em branco, serão gerados automaticamente.

Parâmetro	Descrição	Finalidade
User	Identificador do utilizador	Identifica o utilizador que está a efetuar o pedido
Nonce	Cadeia aleatória gerada pelo cliente	Evita ataques de repetição ao garantir a unicidade do pedido
ext	Informações específicas da aplicação	Dados personalizados enviados com o pedido da API
app	Identificador da aplicação	Evita a representação indevida de credenciais ao associar credenciais a aplicações específicas
dlg	ID da aplicação de delegação	Identifica a aplicação que emitiu as credenciais
Timestamp	Carimbo de data/hora Unix	Impede pedidos fora da janela temporal (proteção anti-repetição)
Include payload hash	Opção de caixa de verificação	Quando ativada, inclui um hash da carga útil do pedido na assinatura

Funcionalidades de Segurança

Prevenção de Ataques de Repetição:

Timestamp: Garante que os pedidos só são válidos dentro de uma janela temporal específica

Nonce: Garante que cada pedido é único e não pode ser repetido

Associação de Credenciais:

app: Impede que atacantes utilizem credenciais emitidas para outras aplicações

dlg: Acompanha que aplicação delegou as credenciais

Geração Automática

O Apidog gera automaticamente valores de Timestamp e Nonce se forem deixados em branco, garantindo segurança adequada sem configuração manual.

Hash da Carga Útil

Ative "Include payload hash" quando a sua API exigir a verificação da integridade do corpo do pedido. Isto adiciona a carga útil ao cálculo da assinatura, impedindo adulterações no corpo do pedido.

Definições Básicas#

Definições Avançadas#

Funcionalidades de Segurança#

Definições Básicas

Definições Avançadas

Funcionalidades de Segurança