# Implementação do Digibee JWT

O conector [Digibee JWT](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/security/digibee-jwt) é mais comumente utilizado para autorizar o acesso a um serviço exposto na rede via protocolo HTTP. Para acessar esses serviços, é necessário realizar o login em um pipeline, que ficará responsável pela geração do token JWT. Com esse token, você tem acesso às rotas, aos serviços e aos recursos permitidos.

## Etapa 1 - Criando um pipeline para autenticação e geração de JWT

A primeira etapa para criar um pipeline de autenticação é configurar o trigger para login:

1. Na página inicial da Digibee Integration Platform, abra a página **Build**.&#x20;
2. Clique em **Criar** e selecione a opção **Pipeline**.&#x20;
3. Dentro do **Canvas**, clique no ícone de configuração do trigger.&#x20;
4. Na configuração do trigger, selecione a opção [REST](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/triggers/web-protocols/rest).
5. Ative as opções **External AP**I e **API Key** e faça o restante das configurações como desejar. Depois de configurar o trigger, adicione o conector **Digibee JWT** à sua integração.
6. Clique no botão **+** ao lado do trigger e busque pelo conector **Digibee JWT** ou arraste o conector para o seu Canvas.&#x20;
7. Abra as configurações do conector e selecione a operação **Generate** para a criação do token.&#x20;
8. No campo **Scopes** defina os escopos para o token JWT separados por vírgula.&#x20;
9. No campo **Expiration**, defina o tempo de expiração do token (em milissegundos). A expiração máxima é de 365 dias (31536000000 milissegundos).
10. Clique em **Confirmar** para implementar as configurações do conector.&#x20;

{% hint style="info" %}
A geração do token JWT não é feita em modo de teste. Isso só é possível quando o pipeline é implantado em algum dos ambientes (Test ou Prod).
{% endhint %}

## Etapa 2 - Utilizando o conector Assert V2

Use o conector [Assert V2](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/tools/assert-v2) para criar uma validação por usuário e senha pré-cadastrados na Digibee Integration Platform seguindo os passos abaixo:

1. Clique no botão + ao lado do conector Digibee JWT e busque pelo conector **Assert V2** ou arraste o conector para o seu Canvas.&#x20;
2. Abra as configurações do conector e insira o seguinte código no campo **Condition**:

```
#{body.user} == #{globals.user} && #{body.password} == #{globals.password}
```

3. Clique em **Confirmar** para implementar as configurações do conector.

## Etapa 3 - Chamando o pipeline para login

Depois que  terminar as configurações, é necessário implantar o pipeline no seu devido ambiente de teste ou produção para poder testar o fluxo. Aprenda mais sobre a [implantação de pipelines na Plataforma.](https://app.gitbook.com/s/cO0A6g1dOsu8BiHYqO67/development-cycle/overview/deployment/deployments)&#x20;

Com a API Key configurada, você pode dar início ao teste. Veja no exemplo a seguir como fazer isso utilizando o Postman. Você também pode usar o client que está acostumado ou qualquer outra aplicação que preferir.

Para executar a operação no Postman é necessário:&#x20;

1. Fornecer a API Key no header da chamada.
2. Fornecer o usuário e senha configurados na etapa 2 como obrigatórios no fluxo.

<figure><img src="https://content.gitbook.com/content/SKBJ6ZiEWBU93x170HH4/blobs/kGEQvhUpSJkD2xX6Mu0x/image1.png" alt=""><figcaption></figcaption></figure>

Ao realizar essa chamada, o serviço retornará o status de sucesso:

<figure><img src="https://content.gitbook.com/content/SKBJ6ZiEWBU93x170HH4/blobs/2Kvf3uCEwMpHVmwFspPd/image2.png" alt=""><figcaption></figcaption></figure>

3. Busque a informação necessária nos headers da resposta, no campo **Authorization**. Essa é a autenticação, ou seja, o JWT gerado que será utilizado em combinação com a API Key para outros fluxos que utilizam os triggers de API REST e HTTP.

## Configurando o trigger para os fluxos com a nova autenticação como chave

Com o Digibee JWT, você pode customizar a segurança na construção dos seus próximos pipelines. Faça as configurações necessárias no trigger de acordo com as instruções abaixo:

1. Na página inicial da Digibee Integration Platform, abra a página **Build**.&#x20;
2. Clique em **Criar** e selecione a opção **Pipeline**.&#x20;
3. Dentro do **Canvas**, clique no ícone de **configuração** do trigger.&#x20;
4. Na configuração do trigger, selecione a opção **REST**.
5. Ative as opções **External API,** **API Key** e **Token JWT**. Dessa maneira, sempre que as rotas forem chamadas, será preciso informar a API Key e o token JWT gerados. Caso você informe apenas a API Key e não o token, então um erro de autorização é retornado:

<br>

<figure><img src="https://content.gitbook.com/content/SKBJ6ZiEWBU93x170HH4/blobs/a72fltJbZNRaPEDJix67/image3.png" alt=""><figcaption></figcaption></figure>
