Authentication

Edite no GitHub

A autenticação e autorização de operações via Azion API é feita através de Tokens.

O primeiro passo é criar o Token através da autenticação de um usuário registrado no Real-Time Manager.

  1. Como codificar Usuário e Senha em Base64
  2. Criação de Token
  3. Revogacão de Token

1. Como codificar Usuário e Senha em Base64

Apenas as operações de criação e revogação de token são feitas com Basic Authentication, isto é, com usuário e senha. Você pode criar e revogar o token pela própria API, mas para isso precisa codificar seu usuário e senha em base64.

A codificação base64 pode ser feito em linha de comando em um terminal Unix:

$ echo 'user@domain:password'|base64
dXNlckBkb21haW46cGFzc3dvcmQK

Se você não tiver disponível um terminal Unix, pode utilizar o serviço online gratuito em https://www.base64encode.org/


2. Criação de Token

POST /tokens

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization (obrigatório) A autenticação básica para criação do Token se dá por meio do par “user@domain:password” codificado em base64, enviado na requisição HTTP através do cabeçalho “Authorization: Basic ”.

Por exemplo, se o usuário for “user@domain” e a senha for “password” a codificação base64 resultante da string “user@domain:password” será “dXNlckBkb21haW46cGFzc3dvcmQK” e o cabeçalho a ser enviado será:

ex.:

Authorization:
Basic
dXNlckBkb21haW46cGFzc3dvcmQK
header string

Exemplo de Requisição

POST /tokens 
Accept: application/json; version=3
Content-Type: application/json
Authorization: Basic dXNlckBkb21haW46cGFzc3dvcmQK

Exemplo de Resposta

{
    "token": "3a110f2990cfbce7b84265cc027f992acb9743eb",
    "created_at": "2019-04-01 13:53:28.536782+00:00",
    "expires_at": "2019-04-02 13:53:28.536782+00:00"
}

3. Revogacão de Token

DELETE /tokens/:token

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization (obrigatório) A autenticação básica para revogação do Token se dá por meio do par “user@domain:password” codificado em base64, enviado na requisição HTTP através do cabeçalho “Authorization: Basic ”.

Por exemplo, se o usuário for “user@domain” e a senha for “password” a codificação base64 resultante da string “user@domain:password” será “dXNlckBkb21haW46cGFzc3dvcmQK” e o cabeçalho a ser enviado será:

ex.:

Authorization:
Basic
dXNlckBkb21haW46cGFzc3dvcmQK
header string
:token (obrigatório) Token que se quer deletar path string

Exemplo de Requisição

DELETE /tokens/3a110f2990cfbce7b84265cc027f992acb9743eb
Accept: application/json; version=3
Content-Type: application/json
Authorization: Basic dXNlckBkb21haW46cGFzc3dvcmQK

Exemplo de Resposta

HTTP/2 204

Não encontrou o que procurava? Abra um ticket.