OAuth 1.0

OAuth 1.0 é uma estrutura de autorização que permite que aplicações de terceiros acedam a recursos protegidos sem expor as credenciais do utilizador. Embora tenha sido amplamente substituído pelo OAuth 2.0, o OAuth 1.0 ainda é utilizado por alguns serviços e APIs legados.

O OAuth 1.0 utiliza um mecanismo de assinatura para verificar a integridade e a autenticidade dos pedidos, juntamente com carimbos de data/hora e nonces para evitar ataques de repetição. Os tokens e as chaves são conhecidos apenas pelas aplicações autorizadas e pelos fornecedores de serviços, garantindo uma comunicação segura.

Protocolo Legado

OAuth 1.0 é considerado legado. A maioria das APIs modernas utiliza OAuth 2.0. Utilize OAuth 1.0 apenas quando exigido pelo seu fornecedor de API (por exemplo, Twitter API v1.1).

Definições Básicas

Na página Auth, selecione OAuth 1.0 como método de autorização e configure os seguintes parâmetros:

Parâmetro	Descrição	Finalidade
Add Location	Onde incluir os dados de autenticação	Escolha `Request Body/Request URL` ou `Request Header`
Signature Method	Algoritmo criptográfico	`HMAC-SHA1`, `HMAC-SHA256`, `HMAC-SHA512`, `RSA-SHA1`, `RSA-SHA256`, `RSA-SHA512` ou `PLAINTEXT`
Consumer Key	Identificador da aplicação	ID exclusivo atribuído pelo fornecedor de serviços
Consumer Secret	Chave secreta da aplicação	Segredo atribuído pelo fornecedor de serviços
Access Token	Token de autorização do utilizador	Token emitido após o utilizador autorizar a aplicação
Token Secret	Cadeia secreta do token	Segredo associado ao token de acesso para a criação da assinatura

Métodos de Assinatura

Baseados em HMAC: Os mais comuns, utilizam segredos partilhados

Baseados em RSA: Utilizam pares de chaves pública/privada, mais seguros, mas complexos

PLAINTEXT: Não recomendado para produção (sem encriptação)

Definições Avançadas

Clique na opção Advanced para configurar parâmetros adicionais do OAuth 1.0. Se forem deixados em branco, serão gerados automaticamente.

Parâmetro	Descrição	Finalidade
Callback URL	URL de redirecionamento após a autorização	Para onde o utilizador é redirecionado após autorizar a aplicação
Verifier	Código de verificação	Cadeia aleatória para verificar a autorização do utilizador (gerada pelo fornecedor de serviços)
Timestamp	Carimbo de data/hora Unix	Evita ataques de repetição ao marcar a hora do pedido
Nonce	Cadeia aleatória exclusiva	Evita ataques de repetição ao identificar exclusivamente cada pedido
Version	Versão do OAuth	Valor predefinido; normalmente não é necessário alterar
Realm	Domínio de segurança	Identifica o âmbito do recurso protegido

Opções Adicionais

Include body hash: Quando ativado, inclui um hash do corpo do pedido na assinatura

Add empty parameters to signature: Quando ativado, inclui parâmetros vazios no cálculo da assinatura

Geração Automática

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

Definições Básicas#

Definições Avançadas#

Opções Adicionais#

Definições Básicas

Definições Avançadas

Opções Adicionais