JWT Token

Projeto desenvolvido para faciliar a criação de tokens JWT (Json Web Token) para a Function de Security JWT.

Sobre o projeto

Este script tem a finalidade de gerar um Token JWT a partir de um par de chave/secret KIDs, padrão utilizado pela Function JWT para validar a autenticação na request phase.

Como utilizar o script

Para rodar o script, é preciso gerar uma chave e um secret em MD5. Os hashes devem ser passados para o script via argumento. Nesta documentação disponibilizamos alguns exemplos no Mac Os e Gnu/Linux para gerar esses hashes.

Exemplo e utilização

python3 jwt-token.py chave-md5 secret-md5

python3 jwt-token.py 36E87FA127F7643CB6E9E7A9A227D544 3F5B079CB698C2DBFFCC0D76F9B94E45

Compatibilidade

O projeto foi desenvolvido para rodar em Python 3x, portanto é compatível com sistemas Unix Like e Windows que possuam o Python instalado.

Dependências

Além do Python 3x, é necessário a instalação do PyJWT. Para facilitar o processo de instalação, deixamos um arquivo requirements.txt com todas as dependências do projeto.

requirements.txt

PyJWT==2.7.0

Instalando as dependências do projeto.

Criar ambiente isolado para rodar o script. (opcional)

python3 -m venv venv

Ativando ambiente virtual (venv).

source venv/bin/activate

Atualizando o pip

pip install --upgrade pip

Instalando as dependências do projeto

Baixando o código fonte do Github

git clone https://github.com/MarcosRCarvalhoAzion/JWT.git

Acessando o diretório do projeto

cd JWT

Instalando dependências do Python (PyJWT)

pip install -r requirements.txt

Executando o Script (Exemplo)

Se o processo de instalação for bem sucessido e não retornar nenhum código de erro, ao rodar o script pela primeira vez sem passar parâmetros, será mostrado em tela um alert HELP!

python3 jwt-token.py

          ---------
          - HELP! -
          ---------
          
          Usage: python3 jwt-token.py CHAVE-MD5 SECRET-MD5
          
          Github: https://github.com/MarcosRCarvalhoAzion/JWT

Executando o script com todos os parâmetros necessários

python3 jwt-token.py 36E87FA127F7643CB6E9E7A9A227D544 3F5B079CB698C2DBFFCC0D76F9B94E45

Resultado da execução do Script

Ao executar o arquivo, será apresentado em tela o Token de autencicação. Com essas informações você poderá fazer requisições usando o JWT recém criado. As informações em tela serão salvas num arquivo information.txt no mesmo diretório que foi executado o script.

Saída em tela

      --------------------------
      - AZION MOVE TO THE EDGE -
      -------------------------- 
      
      [+] [JWT] Gerado com sucesso!
      
      [!] CHAVE selecionada para gerar o JWT: 36E87FA127F7643CB6E9E7A9A227D544
      [!] SECRET selecionado para gerar o JWT: 3F5B079CB698C2DBFFCC0D76F9B94E45
      
      -------------------------------------------------------------
      
      Adicione o Header abaixo na Request:
      
      ---------------------------
      Header Name: Authorization
      ---------------------------
      
      ---------------------------
      
      Header Value: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6IjM2RTg3RkExMjdGNzY0M0NCNkU5RTdBOUEyMjdENTQ0IiwidHlwIjoiSldUIn0.eyJleHAiOjE2ODQzNjM5ODMsImlhdCI6MTY4NDM2MzM4MywibXlfZGF0YV8xIjoieCIsIm15X2RhdGFfMiI6InkifQ.rbNaP60mqOShKivil_qv4Cqx8By_jmYVruMcvEm-CXs
      
      ---------------------------    

Utilizando o JWT

Assim que o Script gerar o Authorization Bearer, toda a requisição precisará passar o Header com o JWT para que a Function valide a request e permita a conexão com a aplicação.

Criando hashes MD5 customizados

MAC OSx

echo -n 'qualquer_string_aqui...' | md5 -r | tr '[:lower:]' '[:upper:]'

Gnu/Linux

echo -n 'qualquer_string_aqui...' | md5sum | cut -d '-' -f1 | tr '[:lower:]' '[:upper:]'

Exemplo de utilização.

Abaixo esta um exemplo completo de utilização do script. Para gerar chave/secret MD5, foram usados os valores minha-string-123 para a CHAVE e minha-string-secret-123 para o SECRET.

Gerando Chave MD5 (Mac OS)

echo -n 'minha-string-123' | md5 -r | tr '[:lower:]' '[:upper:]'

36E87FA127F7643CB6E9E7A9A227D544

Gerando Secret MD5 (Mac OS)

echo -n 'minha-string-secret-123' | md5 -r | tr '[:lower:]' '[:upper:]'

3F5B079CB698C2DBFFCC0D76F9B94E45

Montando a estrutura KIDs para a Function JWT (Json Args)

Parâmetros da Function JWT (Json Args)

{
  "kids": {
      "CHAVE-MD5 aqui..." : "SECRET-MD5 aqui..."
  }
}

Function Json Args

{
  "kids": {
      "36E87FA127F7643CB6E9E7A9A227D544" : "3F5B079CB698C2DBFFCC0D76F9B94E45"
  }
}

Exemplo de JWT para os valores do Json Args acima

Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6IjM2RTg3RkExMjdGNzY0M0NCNkU5RTdBOUEyMjdENTQ0IiwidHlwIjoiSldUIn0.eyJleHAiOjE2ODQzNjM5ODMsImlhdCI6MTY4NDM2MzM4MywibXlfZGF0YV8xIjoieCIsIm15X2RhdGFfMiI6InkifQ.rbNaP60mqOShKivil_qv4Cqx8By_jmYVruMcvEm-CXs

Desenvolvedores

Marcos R Carvalho, Security Response Team | Azion