Identity as a Service:GenerateToken

Os seguintes métodos são suportados: Authorization Code, Device Flow, Refresh Token, Client Credentials e Password.

1. Authorization Code

Cenário: Este é o fluxo de código de autorização padrão do OAuth 2.0, adequado para aplicativos web com interação de frontend. Exemplo de chamada:

POST /v2/{instanceId}/{applicationId}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code
&code={authorization_code}
&redirect_uri={redirect_uri}
&client_id={client_id}
&client_secret={client_secret}

Parâmetros:

● code: O código de autorização obtido no endpoint de autorização.

● redirect_uri: Deve ser o mesmo redirect_uri usado para obter o código de autorização.

1.1 Authorization Code para clientes públicos

Cenário: Este cenário é adequado para aplicativos que não podem armazenar um segredo com segurança, como aplicativos de página única (SPAs) ou aplicativos nativos. Neste fluxo, um client_secret não é necessário, mas você deve usar o mecanismo Proof Key for Code Exchange (PKCE). Exemplo de chamada:

POST /v2/{instanceId}/{applicationId}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code
&code={authorization_code}
&redirect_uri={redirect_uri}
&client_id={client_id}
&code_verifier={code_verifier}

Parâmetros:

● code_verifier: O verificador de código para o mecanismo PKCE. O cliente o gera ao iniciar uma solicitação de autorização e o usa para derivar o code_challenge. Ao trocar por um token, você deve enviar este valor. Ele deve ser idêntico ao valor usado para gerar o code_challenge.

Exemplo em Java para gerar um code_verifier e code_challenge:

String codeVerifier = Base64.getUrlEncoder().withoutPadding().encodeToString(new SecureRandom().generateSeed(43));
String codeChallenge = Base64.getUrlEncoder().withoutPadding().encodeToString(java.security.MessageDigest.getInstance("SHA-256").digest(codeVerifier.getBytes()));

2. Device Flow

Cenário: Este cenário é adequado para dispositivos com entrada restrita, como TVs e dispositivos IoT. Exemplo de chamada:

POST /v2/{instanceId}/{applicationId}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=urn:ietf:params:oauth:grant-type:device_code
&device_code={device_code}
&client_id={client_id}
&client_secret={client_secret}

Para obter o código do dispositivo, primeiro chame /oauth2/device/code para recuperar o device_code e o user_code.

2.1 Device Flow para clientes públicos

Cenário: Este cenário é usado quando o logon interativo não é conveniente e o cliente é um cliente público. Exemplo de chamada:

POST /v2/{instanceId}/{applicationId}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=urn:ietf:params:oauth:grant-type:device_code
&device_code={device_code}
&client_id={client_id}

3. Refresh Token

Cenário: Este cenário usa um refresh_token para obter um novo access_token. Exemplo de chamada:

POST /v2/{instanceId}/{applicationId}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token
&refresh_token={refresh_token}
&client_id={client_id}
&client_secret={client_secret}

4. Client Credentials

Cenário: Este cenário é para autenticação de servidor para servidor sem o envolvimento do usuário. Exemplo de chamada:

POST /v2/{instanceId}/{applicationId}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id={client_id}
&client_secret={client_secret}
&scope={scope}

5. Password

Cenário: Este cenário usa a autenticação tradicional de nome de usuário e senha. Use este método com cautela. Exemplo de chamada:

POST /v2/{instanceId}/{applicationId}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=password
&username={username}
&password={password}
&client_id={client_id}
&scope={scope}