Como funciona o processo de autenticação com a API Devhub da Eduzz?

Entenda como funciona todo processo de autenticação com a API DevHub da Eduzz, utilizando OAuth2. Aqui, você encontrará um passo a passo para autenticar aplicativos e realizar requisições em nome dos usuários, garantindo segurança e eficiência nas integrações com a plataforma.

Vale salientar que a diferença entre os dois processos está no seu uso. Enquanto o Oauth2 é utilizado para conseguir permissões para requisição na API de outras contas, o Access token é utilizado para requisições na conta onde o aplicativo foi configurado.

• Autenticação com o Access Token do Aplicativo
• Autenticação OAuth para Acessar a Conta de Usuários

Autenticação com o Access Token do Aplicativo

Ao acessar o console da DevHub, clique em "Meus Aplicativos":

Clique no menu de ações (ícone de três pontos) do aplicativo desejado e em "Copiar Access Token":

Na nova tela, o token é exibido junto com um exemplo de requisição curl. Copie seu código e então clique em "Fechar":

Obs: Utilize o Access Token copiado para autenticar as requisições à API da Eduzz. Todas as chamadas devem incluir o token no cabeçalho de autorização.

Autenticação OAuth para Acessar a Conta de Usuários

Para gerar a URL de autorização do seu aplicativo é obrigatório o cadastro de pelo menos uma URL de retorno para maior segurança de seu aplicativo.

Para isso, 

Na tela de "Meus aplicativos", clique em "Detalhes" do aplicativo que deseja realizar autorização

Clique em "Gerar URL de Login" para cadastrar sua URL de retorno

Obs: Se desejar alterar as informações do seu aplicativo, preenchidas no passo acima, basta clicar no botão "Editar". 

Preencha com a URL e clique em "Copiar e fechar":

Obs: Não esqueça de inserir o "http://" no início. 

Após o login e a autorização, você será redirecionado de volta para a redirect_uri, agora com um parâmetro code, que é o authorization code.

Após obter o código de autorização, faça uma requisição POST ao endpoint /oauth/token para trocá-lo por um access token:

O corpo da requisição deve incluir:

POST <https://accounts-api.eduzz.com/oauth/token>

• • client_id: ID do seu aplicativo.
  • client_secret: Segredo do aplicativo.
  • code: Código de autorização obtido no passo anterior.
  • redirect_uri: A mesma URL utilizada na etapa de autorização.
  • grant_type: "authorization_code".

A API irá retornar um access_token, que pode ser utilizado para fazer chamadas autenticadas em nome do usuário. Utilize esse token no cabeçalho das requisições HTTP:

Authorization: Bearer <access_token>

Esse fluxo permite que você faça chamadas autenticadas aos endpoints da Eduzz em nome do usuário, respeitando os escopos de acesso definidos.

Saiba mais

• Como cadastrar meu aplicativo? - DevHub