SSO - Single Sign On com JWT
- Felipe Cerutti
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: segrego-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º Na opção PAYLOAD: Data, altere o email felipe@hotscool.com pelo e-mail do seu aluno.
6º Em VERIFY SIGNATURE, insira o JWT: segredo-chave inserido no painel de gestão da Hotscool ao criar um novo SSO com JWT(vide item 3º)
7º Com o token em mãos, volte ao painel de Gestão da Hotscool em https://app.hotscool.com/admin/sso
8º Clique no ícone conforme print abaixo:
9º Copie o LINK de Integração e substitua o %JWT% pelo código gerado no item 6º no box ENCODED
Exemplo do LINK de integração:
https://minhaescola.com.br/sso/38d8adwdc8dacc1498eaa475c97662c9033cc3047910a72c54daa100ea824f51b662d044dded77008a17?chave=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6ImZlbGlwZUBob3RzY29vbC5jb20ifQ.4nh1y0wMkk-VAYdz8llWHe9zF9iM7HxGEaEm9ZjXtoM
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: