Artigos sobre: Integrações

Como configurar o TheAccess

O que é o TheAccess?


É um facilitador de login sem senha. Com ele, administradores podem autenticar seus alunos na nossa plataforma emitindo tokens JWT assinados. O TheAccess valida a identidade do emissor dos tokens recebidos, garantindo segurança e confiabilidade no processo de login.


PASSO 1.

Acesse o menu "Plataforma" no dashboard.


Acesse a aba "Configurações"


Clique no menu "Integrações".


Na seção "Integrações internas", clique em "TheAccess".


Forneça a chave pública no formato RS256, que será utilizada para validar a autenticidade do emissor dos tokens JWT.


Confirme a configuração salvando sua chave pública.



PASSO 2.

No seu ambiente externo, você precisará gerar um token JWT e assiná-lo com a chave privada correspondente à chave pública cadastrada no TheAccess.


Estrutura do Payload JWT:


Assinatura:


Algoritmo: RS256


A chave privada deve ser utilizada para assinar o token


PASSO 3.

Após gerar o token JWT, o admin deve construir um link de acesso para autenticar o aluno na plataforma.


Formato do link:


Exemplo prático de geração do token JWT*


PHP com o pacote firebase/php-jwt


use Firebase\JWT\JWT;
use Firebase\JWT\Key;


$privateKey = << 'aluno@email.com',
'organization_id' => 127 // id da sua organização themembers
];
$jwt = JWT::encode($payload, $privateKey, 'RS256');
echo "Encode:\n" . print_r($jwt, true) . "\n";


PASSO 4.

Para validar sua integração, utilize um token JWT gerado e acesse o link formatado. Caso a chave pública esteja corretamente configurada e o token JWT tenha sido assinado corretamente, o aluno será autenticado na plataforma com sucesso.

Atualizado em: 16/06/2025