SSO - Single Sign On com JWT

SSO - Single Sign On com JWT

Para usar o SSO com JWT, é necessário criar um TOKEN JWT, siga o passo-a-passo abaixo para conseguir gerar o seu token de forma manual.

 

1º No painel de Gestão da Hotscool na url https://app.hotscool.com/admin/sso, clique em CRIAR.

 

2º Selecione a Opção Login Direto

 

3º  Preencha os dados na tela que abrirá:

Titulo -> Titulo desejado para facilitar encontrar o SSO criado

Chave de Login -> Selecione E-mail pois esse exemplo vai mostrar como fazer usando a chave e-mail.

JSON Web Token -> Ative essa Opção

JWT: segredo-chave da aplicação -> Digite um segredo que será usado para criptografar o seu token, lembre-se de anotar esse segredo, uma vez criado não é necessário recuperá-lo.

Status -> Deixe essa opção ativa.

Clique em Salvar.

 

 

4º Acesse o site JWT.IO

5º Selecione a aba de Encoder:

image-20260206-133113.png

6º Na opção PAYLOAD: Data, altere deixando apenas o email felipe@hotscool.com pelo e-mail do seu aluno.

7º Em SIGN JWT: SECRET, insira o JWT: segredo-chave inserido no painel de gestão da Hotscool ao criar um novo SSO com JWT(vide item 3º)

image-20260206-133406.png

 

8º Caso queira redirecionar o aluno após o login para uma página específica da área do aluno, você pode inserir no PAYLOAD, abaixo do email, o campo de url_redirect e atrbuindo o link da área do aluno que deseja. (Ex. /curso/token/aula/token)

image-20260206-134233.png

 

9º Com o token em mãos, volte ao painel de Gestão da Hotscool em https://app.hotscool.com/admin/sso

 

10º Clique no ícone conforme print abaixo:

 

11º Copie o LINK de Integração e substitua o %JWT% pelo código gerado no item 6º no box ENCODED

image-20260206-134703.png

 

Exemplo do LINK de integração:

https://minhaescola.com.br/sso/38d8adwdc8dacc1498eaa475c97662c9033cc3047910a72c54daa100ea824f51b662d044dded77008a17?chave=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6ImZlbGlwZUBob3RzY29vbC5jb20ifQ.4nh1y0wMkk-VAYdz8llWHe9zF9iM7HxGEaEm9ZjXtoM

 

OBS: Para que a integração funcione o aluno precisa estar cadastrado na sua escola como um LEAD ou estar matriculado em um dos seus cursos.

 


 

Para gerar o Token JWT de forma dinâmica no seu sistema é necessário usar uma biblioteca, as principais linguagens de programação possuem bibliotecas para tal, segue abaixo algumas bibliotecas para as principais linguagens: