Autenticação via seu próprio provedor OAuth 2.0.

Como funciona

Fluxo de autenticação

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'labelBoxBkgColor': 'transparent', 'labelBoxBorderColor': '#8ADCEC', 'altSectionBkgColor': 'transparent' }}}%%
sequenceDiagram
  participant U as Usuário
  participant A as Aplicativo
  participant XL as Servidor Xsolla Login
  participant P as Seu servidor OAuth2
  U->>A: Clica no botão de login
  A->>XL: Envia a solicitação para autenticar via rede social
  XL->>P: Solicita a autorização do usuário
  alt Código de autorização recebido
    P-->>XL: Envia o código de autorização para https://login.xsolla.com/api/social/callback
  else URL de autorização indisponível
    P-->>XL: Envia o erro “Serviço de dependência indisponível” (010-035)
  end
  XL->>P: Troca o código de autorização por um token de acesso
  alt Token de acesso recebido
    P-->>XL: Envia um token de acesso
  else Falha de troca de token
    P-->>XL: Envia o erro “Erro ocorrido ao obter o Token de Acesso OAuth 2.0” (010-015)
  end
  XL->>P: Solicita os dados do usuário
  alt Dados do usuário recebido
    P-->>XL: Envia os dados do usuário
  else Falha na recuperação dos dados do usuário
    P-->>XL: Envia o erro “Falha ao obter o perfil social” (010-036)
  end
  XL-->>A: Retorna o JWT do usuário
  A-->>U: Conclui a autenticação

Fluxo de login pela primeira vez

1. O usuário clica no botão Log in with [Your Platform] no widget de autorização.

2. O usuário é redirecionado para sua página de login ou consentimento (o endereço é especificado no campo URL de Autorização nas configurações).

3. O usuário insere as credenciais e aprova o acesso no seu sistema.

4. Seu sistema redireciona o usuário de volta para a Xsolla com um código de autorização.

5. A Xsolla contata seu sistema para trocar o código por um token de acesso (o endereço é especificado no campo URL do Token nas configurações).

6. A Xsolla recupera os dados do perfil do usuário (ID, e-mail, etc.) do seu sistema usando o token de acesso (o endereço é especificado no campo Your info URL nas configurações).

7. O usuário faz login e retorna ao aplicativo como um usuário autenticado da Xsolla.

Fluxo de usuário recorrente

1. O usuário clica no botão Log in with [Your Platform] no widget de autorização.

2. O usuário é redirecionado para sua página de login ou consentimento (o endereço é especificado no campo URL de Autorização nas configurações).

3. Seu sistema reconhece a sessão ativa e pula a tela de credenciais. Se seu sistema exigir reautenticação a cada visita, o usuário verá o formulário de login novamente.

4. Seu sistema verifica se o usuário já concedeu os escopos solicitados. Se o consentimento já foi dado e não foi revogado, a tela de consentimento é pulada.

5. Seu sistema redireciona o usuário de volta para a Xsolla com um código de autorização.

6. A Xsolla contata seu sistema para trocar o código por um token de acesso (o endereço é especificado no campo URL do Token nas configurações).

7. A Xsolla recupera os dados atuais do perfil do usuário do seu sistema usando o token de acesso (o endereço é especificado no campo Your info URL nas configurações).

8. O usuário faz login e retorna ao aplicativo. O fluxo completo normalmente é concluído em poucos segundos sem qualquer interação visível necessária do usuário.

Autenticação falhou

URL de Autorização indisponível (erro 010-035)

1. O usuário clica no botão Log in with [Your Platform] no widget de autorização.

2. O usuário é redirecionado para sua página de login ou consentimento (o endereço é especificado no campo URL de Autorização nas configurações).

3. O servidor OAuth2 do parceiro está indisponível e retorna um erro.

4. O Xsolla Login recebe um erro “Serviço de dependência indisponível” (010-035) e não prossegue.

Falha na troca de token (erro 010-015)

1. O usuário clica no botão Log in with [Your Platform] no widget de autorização.

2. O usuário é redirecionado para sua página de login ou consentimento (o endereço é especificado no campo URL de Autorização nas configurações).

3. O usuário insere as credenciais e aprova o acesso no seu sistema.

4. Seu sistema redireciona o usuário de volta para a Xsolla com um código de autorização.

5. A Xsolla contata seu sistema para trocar o código por um token de acesso (o endereço é especificado no campo URL do Token nas configurações).

6. O servidor OAuth2 do parceiro falha ao emitir um token e retorna um erro.

7. O Xsolla Login recebe um erro “Ocorreu um erro ao obter o token de acesso OAuth 2.0” (010-015) e não prossegue.

Falha na recuperação de dados do usuário (erro 010-036)

1. O usuário clica no botão Log in with [Your Platform] no widget de autorização.

2. O usuário é redirecionado para sua página de login ou consentimento (o endereço é especificado no campo URL de Autorização nas configurações).

3. O usuário insere as credenciais e aprova o acesso no seu sistema.

4. Seu sistema redireciona o usuário de volta para a Xsolla com um código de autorização.

5. A Xsolla contata seu sistema para trocar o código por um token de acesso (o endereço é especificado no campo URL do Token nas configurações).

6. A Xsolla recupera os dados do perfil do usuário (ID, e-mail, etc.) do seu sistema usando o token de acesso (o endereço é especificado no campo Your info URL nas configurações).

7. O servidor OAuth2 do parceiro falha ao retornar os dados do usuário.

8. O Xsolla Login recebe um erro “Falha ao obter o perfil social” (010-036) e não prossegue.

Como obter

Para habilitar a autorização via OAuth 2.0:

1. Adicione https://login.xsolla.com/api/social/oauth2/callback como o URI de redirecionamento permitido nas configurações do seu próprio provedor OAuth 2.0 para evitar falhas de autorização.

3. Clique em Configure no painel de uma opção de login clássico.

4. Vá para o bloco Authentication e selecione a conexão de login OAuth 2.0.

5. Preencha os seguintes campos:

• Authorization URL — URL do método usado para autenticação do usuário.

• Token URL — URL do método usado para obter um token de acesso.

• Your info URL — URL do método usado para obter os dados do perfil do usuário (como ID e e-mail) usando o token de acesso.

• Client ID — identificador único do cliente no servidor de autorização. Pode conter dígitos, letras latinas, hífens e underscores sem espaços, com um comprimento máximo de 255 caracteres.

• Client secret key — um ID único gerado pelo seu sistema de autorização. Pode conter dígitos, letras latinas, hífens e underscores sem espaços, com um comprimento de 8-255.

• Permission scope — a lista de direitos de acesso que seu sistema solicita do usuário durante a autorização (por exemplo, openid, profile, email).

6. Configure o Key name map:

   • Forneça o nome da chave para o endereço de e-mail no seu sistema (opcional).

   • Forneça o nome da chave para o identificador do usuário no seu sistema.

7. Na seção Settings, especifique configurações adicionais de autenticação. (opcional):

   • auth_content_type — o valor do cabeçalho Content-Type.

   • auth_header — o cabeçalho que passa o token de autorização ao solicitar dados do usuário (autorização no cabeçalho).

   • auth_param — o nome do parâmetro de consulta que passa o token de autorização ao solicitar dados do usuário (autorização no parâmetro).

   • token_type — tipo de token. Valores possíveis: Bearer, OAuth.

   • use_pkce — uma flag indicando o uso da tecnologia PKCE (Proof Key for Code Exchange) durante a autorização. É altamente recomendável ativar isso para garantir o mais alto padrão de segurança.

   Observação

   Os nomes das chaves devem começar com $., por exemplo, $.response[0].email e $.response[0].id.

   

8. Se você usar a integração via o widget de autorização, configure a personalização:

   • Especifique o nome do botão de autorização. Comprimento máximo — 30 caracteres.

   • Faça o upload do seu logotipo. Tamanho recomendado: 24 × 24px. Formatos suportados: JPG, PNG e SVG.

   • Defina a cor do botão de autorização.

   • Clique em Save changes.

• [OAuth 2.0] Autenticação via Rede Social

• [OAuth 2.0] Obter Link para Autenticação Social

• [JWT] Autenticação via Rede Social

• [JWT] Obter Link para Autenticação Social