SDKs para Android / Login social
  Voltar aos Documentos

SDKs para Android

Login social

Em seu aplicativo, você pode implementar a autenticação do usuário usando sua conta nas redes sociais. Se o primeiro login do usuário for por meio de uma rede social, uma nova conta será criada automaticamente. O usuário não precisa inserir um nome de usuário, endereço de e-mail ou outros dados.

Há duas maneiras de implementar a autenticação por meio de redes sociais:

  • Autenticação pela web. Nesse caso, o aplicativo abre um formulário no navegador para concluir a autenticação por meio da rede social selecionada. Essa opção é adequada para aplicativos móveis e desktop.
  • Autenticação nativa. Nesse caso, a autenticação é realizada por meio do aplicativo da rede social no dispositivo do usuário. Esta opção só é adequada para aplicativos móveis.

O login social pode ser o método de autenticação principal ou alternativo do seu aplicativo.

Se você usar o login social como um método de autenticação alternativo, a conta da rede social será vinculada automaticamente a uma conta de usuário existente se as seguintes condições forem atendidas:

  • Um usuário que se cadastrou com um nome de usuário/endereço de e-mail e senha fez login no seu aplicativo por meio de uma conta de rede social.
  • Uma rede social retorna um endereço de e-mail.
  • O endereço de e-mail do usuário em uma rede social corresponde ao endereço de e-mail utilizado para se cadastrar em seu aplicativo.

Você também pode implementar a vinculação manual de uma conta de rede social.

Guias

Saiba mais sobre configurações avançadas em nossos guias.

Como configurar a autenticação pela web via redes sociais

O SDK oferece suporte aos seguintes provedores para o login social:

  • Amazon
  • Apple
  • Baidu
  • Battle.net
  • Discord
  • Facebook
  • GitHub
  • Google
  • Kakao
  • LinkedIn
  • MSN
  • Mail.ru
  • Microsoft
  • Naver
  • Odnoklassniki
  • PayPal
  • QQ
  • Reddit
  • Steam
  • Twitch.tv
  • Twitter
  • VK
  • Vimeo
  • WeChat
  • Weibo
  • Xbox Live
  • Yahoo
  • Yandex
  • YouTube

Para configurar a autenticação por meio de serviços da web:

  1. Na interface do aplicativo, adicione botões para autenticação via redes sociais.
  2. Configure as conexões sociais para um projeto de login na Conta de Distribuidor.
  3. Implemente a lógica de autenticação no lado do aplicativo.

Configure conexões sociais para o projeto Login na Conta de Distribuidor Xsolla

Aviso
Na Conta de Distribuidor, verifique se as opções Social login e Social login estão selecionadas para o projeto Login que você usa em seu aplicativo. Você poderá alterar o método de login mais tarde clicando no link Change Login method. As configurações salvas anteriormente não serão perdidas.
  1. Abra seu projeto na Conta de Distribuidor.
  2. No menu lateral, clique em Login.
  3. Clique em Configure no painel de um projeto Login.
  4. Vá para o bloco Authentication e selecione a seção Social login.

  1. Conecte as redes sociais que os usuários podem usar para se cadastrar e fazer login no aplicativo:

    • Para conectar uma rede social, clique no ícone ⚙ e selecione Connect.
    • Para conectar várias redes sociais ao mesmo tempo, selecione os painéis necessários (suas bordas ficarão verdes). Em seguida, no menu suspenso Manage, selecione Connect.
    • Para conectar todas as redes sociais disponíveis, clique em Select all. Em seguida, no menu suspenso Manage, selecione Connect.
Observação
O ID do aplicativo e a chave secreta da Xsolla são usadas para a autenticação por padrão. Se seu aplicativo estiver configurado usando uma conta de desenvolvedor do provedor social, você poderá especificar seu próprio ID do aplicativo e chave secreta. Você pode encontrar instruções mais detalhadas sobre a localização do ID do aplicativo e o segredo nas configurações do cartão de rede social na Conta de Distribuidor.

Integre no lado do aplicativo

Implemente a seguinte lógica ao clicar no botão de login social:
  1. Chame o método startSocialAuth da biblioteca Login.
  2. Dentro do método onActivityResult, chame o método finishSocialAuth da biblioteca Login.
Documentação de referência do SDK
Saiba mais sobre os métodos SDK e seus parâmetros.
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Ocultar

Como configurar a autenticação nativa via redes sociais

Aviso
Use este guia ao trabalhar com a biblioteca Login.

A autenticação nativa permite que os usuários façam login em seu aplicativo por meio de uma conta de rede social configurada em um dispositivo móvel.

Na primeira vez que um usuário faz login, o aplicativo de rede social é inicializado e pede permissão para autenticar o usuário. Depois disso, a autenticação é realizada automaticamente sem exigir que o usuário faça nada.

Atualmente, o SDK implementou a autenticação nativa através das seguintes redes sociais:

  • Google
  • Facebook
  • WeChat
  • QQ

Para configurar a autenticação nativa:

  1. Na interface do aplicativo, adicione botões para a autenticação via redes sociais.
  2. Configure o aplicativo na conta de desenvolvedor para a rede social:
    1. Para autenticação via Facebook:
      1. Cadastre-se e crie um novo aplicativo.
      2. Configure a página do aplicativo em sua conta de desenvolvedor do Facebook.
    2. Para autenticação via Google, configure o projeto no Google API Console.
    3. Para autenticação via WeChat:
      1. Cadastre-se e crie um novo aplicativo.
      2. Envie o pedido para revisão.
    4. Para autenticação via QQ:
      1. Cadastre-se e crie um novo aplicativo.
      2. Envie o pedido para revisão.

  1. Configure a autenticação via redes sociais no lado da Xsolla:
    1. Para Facebook e Google, configure conexões sociais na Conta de Distribuidor.
    2. Para o WeChat e QQ, entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.

  1. Instale bibliotecas para autenticação via rede social. Para fazer isso, abra o arquivo build.gradle do seu aplicativo e, na seção de dependências, adicione as seguintes linhas, onde <version_number> é a versão necessária da biblioteca:
    • Para autenticação via Facebook:
Copy
Full screen
Small screen
implementation 'com.xsolla.android:login-facebook:<version_number>'
    • Para autenticação via Google:
Copy
Full screen
Small screen
implementation 'com.xsolla.android:login-google:<version_number>'
    • Para autenticação via WeChat:
Copy
Full screen
Small screen
implementation 'com.xsolla.android:login-wechat:<version_number>'
    • Para autenticação via QQ:
Copy
Full screen
Small screen
implementation 'com.xsolla.android:login-qq:<version_number>'

  1. Inicialize a biblioteca Login com os seguintes parâmetros:
    • facebook_idApp ID da conta de desenvolvedor do Facebook
    • google_idClient ID para o aplicativo web no Google API Console
    • wechat_idAppID da conta de desenvolvedor do WeChat
    • qq_idAppID da conta de desenvolvedor QQ

Um exemplo de inicialização da biblioteca ao autenticar via OAuth 2.0:

Copy
Full screen
Small screen
val loginConfig = LoginConfig.OauthBuilder()
                .setProjectId("login-project-id")
                .setOauthClientId("oauth2-client-id")
                .setSocialConfig(XLogin.SocialConfig(
                     facebookAppId = "facebook_id",
                     googleServerId = "google_id",
                     wechatAppId = "wechat_id",
                     qqAppId = "qq_id"
                ))

                .build()

XLogin.init(applicationContext, loginConfig)
  1. Para autenticação via WeChat, modifique o código do aplicativo:
    • Adicione a classe WXEntryActivity ao pacote <your_package_name>.wxapi, onde <your_package_name> é o no pacote do aplicativo:
Copy
Full screen
Small screen
package <your_package_name>.wxapi

import android.app.Activity
import android.os.Bundle
import com.tencent.mm.opensdk.modelbase.BaseReq
import com.tencent.mm.opensdk.modelbase.BaseResp
import com.tencent.mm.opensdk.openapi.IWXAPI
import com.tencent.mm.opensdk.openapi.IWXAPIEventHandler
import com.tencent.mm.opensdk.openapi.WXAPIFactory
import com.xsolla.android.login.util.WechatUtils

class WXEntryActivity : Activity(), IWXAPIEventHandler {

    private lateinit var iwxapi: IWXAPI

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        iwxapi = WXAPIFactory.createWXAPI(this, WechatUtils.wechatAppId, false)
        iwxapi.handleIntent(intent, this)
        finish()
    }

    override fun onReq(req: BaseReq?) {
    }

    override fun onResp(resp: BaseResp) {
        WechatUtils.wechatResult = resp
    }
}
    • Adicione o seguinte elemento ao seu arquivo AndroidManifest.xml:
Copy
Full screen
Small screen
<activity
        android:name="<your_package_name>.wxapi.WXEntryActivity"
        android:exported="true"
        android:launchMode="singleTask" />

Configure a página do aplicativo na sua conta de desenvolvedor do Facebook

  1. Vá para as configurações do projeto na conta de desenvolvedor do Facebook.
  2. Vá para Settings > Basic.
  3. Clique em Add Platform e selecione Android.
  4. Especifique o nome do pacote do seu aplicativo Android no campo Google Play Package Name.
  5. Especifique um nome de classe totalmente qualificado da Atividade padrão no campo Class Name.
  6. Gere uma chave hash e insira-a no campo Key Hashes.
  7. Clique em Save Changes.

Para obter mais configurações de autenticação nativa, você precisará do App ID e App Secret, encontrados nas configurações do projeto na seção Settings > Basic.

Configure o projeto no Google API Console

  1. Vá para o Google API Console.
  2. Clique em New Project.
  3. Especifique o Project name e Location, e clique em Save.
  4. Vá para o projeto criado e clique em OAuth consent screen no menu lateral.
  5. Selecione a opção External e clique em Create.
  6. Especifique os parâmetros necessários e clique em Save.
  7. Clique em Credentials no menu lateral.
  8. Crie um cliente OAuth 2.0 para seu aplicativo Android:

    1. Clique em Create credentials e selecione OAuth client ID.
    2. Especifique Android no campo Application type.
    3. Especifique o Name.
    4. Especifique o nome do pacote do seu aplicativo Android no campo Package name.
    5. Obtenha a chave SHA.
    6. Especifique a chave SHA gerada na etapa anterior SHA-key no campo SHA-1 certificate fingerprint.
    7. Clique em Create.
    8. Clique em OK.

  1. Crie um cliente OAuth 2.0 para o aplicativo web:
    1. Clique em Create credentials e selecione OAuth client ID.
    2. Especifique Web application no campo Application type.
    3. Especifique o Name.
    4. Clique em Add URI na seção Authorized redirect URIs e especifique o URL https://login.xsolla.com/api/social/oauth2/callback.
    5. Clique em Create.
    6. Clique em OK.

Para configurações de autenticação nativa adicionais, você precisará do Client ID e Client Secret, encontrados nas configurações do ID do Cliente para o aplicativo web.

Configure conexões sociais para o projeto Login na Conta de Distribuidor Xsolla

Aviso
Na Conta de Distribuidor, verifique se as opções Social login e Social login estão selecionadas para o projeto Login que você usa em seu aplicativo. Você poderá alterar o método de login mais tarde clicando no link Change Login method. As configurações salvas anteriormente não serão perdidas.
  1. Abra seu projeto na Conta de Distribuidor.
  2. No menu lateral, clique em Login.
  3. Clique em Configure no painel de um projeto Login.
  4. Vá para o bloco Authentication e selecione a seção Social login.
  1. Para configurar uma rede social, vá para o cartão de rede social, clique no ícone ⚙ à direita do título e selecione Connect.
Observação
Para usar a autorização de rede social, nas configurações do cartão de rede social, especifique o ID do aplicativo e o segredo do aplicativo em seu projeto. O ID do aplicativo e o segredo estão disponíveis na conta de desenvolvedor do provedor social. Você pode encontrar instruções mais detalhadas sobre a localização do ID do aplicativo e o segredo nas configurações do cartão da rede social na Conta de Distribuidor.

Integre no lado do aplicativo

Implemente a seguinte lógica ao clicar no botão de login social:
  1. Chame o método startSocialAuth da biblioteca Login.
  2. Dentro do método onActivityResult, chame o método finishSocialAuth da biblioteca Login.
Documentação de referência do SDK
Saiba mais sobre os métodos SDK e seus parâmetros.
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Ocultar

Links úteis

Última atualização: 31 de Julho de 2024

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!