Neste tutorial será apresentada uma solução para o gerenciamento de tokens no Cronapp, incluindo a validação desses tokens após o logout do usuário.

Pré-requisitos

Antes de começar a seguir os passos do tutorial é preciso ter certeza de que se tem um ambiente minimamente preparado para reproduzir o exemplo. Abaixo estão os requisitos principais.

1. Projeto do tipo mobile criado. Caso haja dúvidas de como criar esse tipo de projeto acesse a documentação Criar projeto;
2. Saber utilizar as funcionalidades do diagrama, como criar classes e gerar persistência. Caso haja dúvidas acesse a documentação Diagrama;
3. Saber criar um bloco de programação. Caso haja dúvidas acesse a documentação Bloco de programação.

Passos

Configurando o diagrama

Vamos dar início ao nosso tutorial criando uma nova classe no diagrama de dados, que será utilizada para armazenar dados do token e sua validade, ou seja, se o token é válido ou não. Para isso, expandimos o menu do tópico Diagrama de Dados e clicamos duas vezes no arquivo app. Em seguida, criamos a classe Session que contém dois atributos, id (Texto) e valid (Lógico), conforme a imagem abaixo. Após criar a classe, geramos a camada de persistência. 

Figura 1 - Classe Session no diagrama de dados

Criando os blocos de programação

Para o gerenciamento dos tokens, precisamos criar algumas funções de blocos de programação servidor que posteriormente serão adicionados em alguns eventos do projeto.

De início, criamos um bloco de programação servidor e nomeamos a primeira função como "criarIdParaToken" (Figura 2). Essa primeira função será utilizada para adicionar um ID único ao token do usuário logado, para isso utilizamos os blocos Cria Identificador Universal e Definir Variável de Token da Requisição.

Em seguida, adicionamos o bloco Inserir e configuramos os campos no retorno da função, esse bloco é responsável por salvar o ID do token na nossa tabela Session do banco de dados, juntamente com a informação de validade do token. A função configurada deve estar como a imagem abaixo.

Figura 2 - Função para criar um ID único para o token do usuário

A segunda função, nomeada como "tornarTokenInvalido" (Figura 3), será executada após o logout do usuário e terá como objetivo tornar inválido o token do usuário, mostrando que ele não está mais logado na aplicação. Para esta função, utilizamos os blocos Obter Variável do Token da Requisição e Atualizar. Para configurar bloco Atualizar, clique no ícone da engrenagem e, na janela de configuração, faça as alterações conforme a Figura 3.1.

Figura 3 - Função para tornar inválido o token do usuário

Figura 3.1 - Configurando o bloco Atualizar

A terceira e última função, nomeada como "checarValidadeToken", irá verificar a validade de um token nas requisições feitas, se o token não for válido será lançada uma exceção.

Este bloco será responsável por checar validade do token nas requisições

Essa função irá verificar as requisições. "Olha eu tenho um token aqui no meu cabeçalho, pega esse id e checa na tabela pra ver se esse id do token de um usuário são válidos." Se não forem válidos será lançado uma exceção.

Adicionando eventos e ações

.

Executando o projeto

.