Autenticar Usuário

Para autenticar o usuário, você deve direcioná-lo para a URL de autenticação:

• Auth URL: https://accounts.eduzz.com/oauth/authorize

Atenção!

Essa documentação serve como referência e não deve ser utilizada via API, mas sim, para direcionar seu usuário para este endereço.

Para direcionar o usuário, ele precisa ser enviado para a URL juntamente com todos os parâmetros de login, exemplo de URL:

https://accounts.eduzz.com/oauth/authorize?client_id=22edfacb-9abd-4dfd-a9be-31a18266aeef&responseType=code&redirectTo=https://h3llow0rld.com.br

Abaixo, você pode conferir um exemplo de como redirecionar seu usuário utilizando Javascript:

1 const config = {
2  clientId: 'CLIENT_ID',
3  redirectUri: 'URL_DE_CALLBACK'
4};
5
6const EDUZZ_AUTH_URL = 'https://accounts.eduzz.com/oauth/authorize';
7
8const url = EDUZZ_AUTH_URL
9  + '?client_id=' + config.clientId
10  + '&redirectTo=' + config.redirectUri
11  + '&response_type=code';
12
13// Browser:
14window.open(url, '_blank');
15
16// In NodeJs:
17// Response Object
18response.writeHead(301, {
19  Location: url
20}).end();
21
22// Express
23res.redirect(301, url);

O usuário será redirecionado para a página de login da Eduzz, onde ele poderá realizar o login e autorizar o aplicativo a acessar seus dados.

Após o usuário se autenticar, será requisitado o acesso aos dados da conta que são necessários para o aplicativo.

Depois de autorizado, o usuário será redirecionado para a url de callback (redirectTo) juntamente com o código de acesso.

Neste caso, como a url não existe, é exibido o erro "This site can't be reached" no navegador, porém, mesmo assim o código de acesso (code) foi gerado com sucesso conforme imagem acima.

Podemos então utilizar esse código de acesso, para acessar a API pública utilizando o endpoint para obter token do usuário.

Após autenticação o usuário será redirecionado para a URL informada no parâmetro 'redirectTo' com o código de autorização juntamente com a url. Exemplo: https://app.com/callback?code=123456.

Esse código (code) será utilizado para autenticar o usuário e obter uma chave de acesso a API.