SDKs für Android / Anmeldung über soziale Netzwerke
 Alle Dokumentation

SDKs für Android

  • Login-Bibliothek

  • Store-Bibliothek

  • Inventory-Bibliothek

  • Payments-Bibliothek

  • Subscriptions-Bibliothek

  • Authentifizierung

  • Katalog

  • Werbeaktionen

  • Artikelkauf

  • Spielerinventar

  • Benutzerkonto und ‑attribute

  • Anmeldung über soziale Netzwerke

    Soziale Netzwerke können als primäre oder alternative Authentifizierungsmethode Ihrer Anwendung dienen.

    Wenn sich der Benutzer erstmalig über ein soziales Netzwerk anmeldet, wird automatisch ein neues Konto erstellt.

    Wenn Sie soziale Netzwerke als alternative Authentifizierungsmethode verwenden, wird das Social-Media-Konto automatisch mit einem bestehenden Benutzerkonto verknüpft, sofern die folgenden Bedingungen erfüllt sind:

    • Ein Benutzer, der sich mittels Benutzername/E-Mail-Adresse und Passwort registriert hat, meldet sich über sein Social-Media-Konto bei Ihrer Anwendung an.
    • Das soziale Netzwerk gibt eine E-Mail-Adresse zurück.
    • Die E-Mail-Adresse des Benutzers in einem sozialen Netzwerk stimmt überein mit der E-Mail-Adresse, die für die Anmeldung bei Ihrer Anwendung verwendet wird.

    Anleitungen

    Erfahren Sie mehr über erweiterte Einrichtungen in unseren Anleitungen.

    So richten Sie die native Authentifizierung über soziale Netzwerke ein

    Achtung
    Diese Anleitung ist für die Arbeit mit der Login-Bibliothek bestimmt.

    Mit der nativen Authentifizierung können sich Benutzer über ein auf einem mobilen Gerät konfigurierten Social-Media-Konto bei Ihrer Anwendung anmelden.

    Wenn sich ein Benutzer zum ersten Mal anmeldet, wird die Social-Media-Anwendung gestartet und bittet um Erlaubnis, den Benutzer zu authentifizieren. Danach erfolgt die Authentifizierung automatisch, ohne dass der Benutzer etwas tun muss.

    Derzeit unterstützt das SDK die native Authentifizierung über die folgenden sozialen Netzwerke:

    • Google
    • Facebook
    • WeChat
    • QQ

    So konfigurieren Sie die native Authentifizierung:

    1. Konfigurieren Sie die Anwendung im Entwicklerkonto des entsprechenden sozialen Netzwerks:
      1. Gehen Sie für die Authentifizierung über Facebook wie folgt vor:
        1. Registrieren Sie sich, und erstellen Sie eine neue Anwendung.
        2. Konfigurieren Sie die Anwendungsseite in Ihrem Facebook-Entwicklerkonto.
      2. Konfigurieren Sie für die Authentifizierung über Google das Projekt in der Google API Console.
      3. Gehen Sie für die Authentifizierung über WeChat wie folgt vor:
        1. Registrieren Sie sich, und erstellen Sie eine neue Anwendung.
        2. Reichen Sie die Anwendung zur Überprüfung ein.
      4. Gehen Sie für die Authentifizierung über QQ wie folgt vor:
        1. Registrieren Sie sich, und erstellen Sie eine neue Anwendung.
        2. Reichen Sie die Anwendung zur Überprüfung ein.

    1. Konfigurieren Sie die Authentifizierung über soziale Netzwerke aufseiten von Xsolla:
      1. Für Facebook bzw. Google müssen Sie das jeweilige soziale Netzwerk im Kundenportal einbinden.
      2. Für WeChat und QQ müssen Sie sich an Ihren Account Manager wenden.

    1. Installieren Sie Bibliotheken für Authentifizierungen über soziale Netzwerke. Öffnen Sie dazu die Datei build.gradle Ihrer Anwendung, und fügen Sie im Abhängigkeiten-Abschnitt die folgenden Zeilen hinzu, wobei <version_number> der erforderlichen Bibliotheksversion entspricht:
      • Für die Authentifizierung über Facebook:

    Copy
    Full screen
    Small screen
    implementation 'com.xsolla.android:login-facebook:<version_number>'

      • Für die Authentifizierung über Google:

    Copy
    Full screen
    Small screen
    implementation 'com.xsolla.android:login-google:<version_number>'

      • Für die Authentifizierung über WeChat:

    Copy
    Full screen
    Small screen
    implementation 'com.xsolla.android:login-wechat:<version_number>'

      • Für die Authentifizierung über QQ:

    Copy
    Full screen
    Small screen
    implementation 'com.xsolla.android:login-qq:<version_number>'

    1. Initialisieren Sie die Login-Bibliothek mit den folgenden Parametern:
      • facebook_id: App-ID aus dem Facebook-Entwicklerkonto
      • google_id: Client-ID für die Webanwendung aus der Google API Console
      • wechat_id: AppID aus dem WeChat-Entwicklerkonto.
      • qq_id: AppID aus dem QQ-Entwicklerkonto

    Beispielhafte Initialisierung der Bibliothek beim Authentifizieren über JWT:

    Copy
    Full screen
    Small screen
    val loginConfig = LoginConfig.JwtBuilder()
                    .setProjectId("login-project-id")
                    .setSocialConfig(XLogin.SocialConfig(
                         facebookAppId = "facebook_id",
                         googleServerId = "google_id",
                         wechatAppId = "wechat_id",
                         qqAppId = "qq_id"
                    ))
                    .build()
    
    XLogin.init(applicationContext, loginConfig)

    Beispielhafte Initialisierung der Bibliothek beim Authentifizieren über 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. Damit die Authentifizierung über WeChat möglich ist, muss der Anwendungscode modifiziert werden:
      • Fügen Sie dem <your_package_name>.wxapi-Paket die Klasse WXEntryActivity hinzu, wobei <your_package_name> dem Namen Ihres Anwendungspakets entspricht:

    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.social.LoginSocial
    
    class WXEntryActivity : Activity(), IWXAPIEventHandler {
    
        private lateinit var iwxapi: IWXAPI
    
        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)
    
            iwxapi = WXAPIFactory.createWXAPI(this, LoginSocial.wechatAppId, false)
            iwxapi.handleIntent(intent, this)
            finish()
        }
    
        override fun onReq(req: BaseReq?) {
        }
    
        override fun onResp(resp: BaseResp) {
            LoginSocial.wechatResult = resp
        }
    }

      • Fügen Sie Ihrer AndroidManifest.xml-Datei die folgenden Elemente hinzu:

    Copy
    Full screen
    Small screen
    <activity
                android:name=".wxapi.WXEntryActivity"
                android:exported="true">

    Anwendungsseite in Ihrem Facebook-Entwicklerkonto einrichten

    1. Wechseln Sie in die Projekteinstellungen des Facebook-Entwicklerkontos.
    2. Navigieren Sie zu Einstellungen > Allgemeines.
    3. Klicken Sie auf Plattform hinzufügen, und wählen Sie Android aus.
    4. Geben Sie den Paketnamen Ihrer Android-Anwendung im Feld Google Play Package-Name an.
    5. Geben Sie im Feld Klassenname einen zulässigen Klassennamen für die Hauptaktivität an.
    6. Generieren Sie einen Hash-Key, und geben Sie ihn im Feld Key-Hashes an.
    7. Klicken Sie auf Änderungen speichern.

    Zur weiteren Konfiguration der nativen Authentifizierung benötigen Sie eine App-ID und einen App-Geheimcode. Beide finden Sie in den Projekteinstellungen unter Einstellungen > Allgemeines.

    Projekt in der Google API Console einrichten

    1. Wechseln Sie zur Google API Console.
    2. Klicken Sie auf Neues Projekt.
    3. Geben Sie den Projektnamen und den Speicherort an, und klicken Sie auf Erstellen.
    4. Wechseln Sie zum erstellten Projekt, und klicken Sie im Seitenmenü auf OAuth-Zustimmungsbildschirm.
    5. Wählen Sie die Option Extern aus, und klicken Sie auf Erstellen.
    6. Geben Sie die nötigen Parameter an, und klicken Sie auf Speichern.
    7. Klicken Sie im Seitenmenü auf Anmeldedaten.
    8. Erstellen Sie einen OAuth 2.0-Client für die Android-Anwendung:

      1. Klicken Sie auf Anmeldedaten erstellen, und wählen Sie OAuth-Client-ID aus.
      2. Wählen Sie unter Anwendungstyp die Option Android aus.
      3. Geben Sie einen Namen an.
      4. Geben Sie den Paketnamen aus Ihrer Android-Anwendung im Feld Paketname an.
      5. Rufen Sie den SHA-Schlüssel ab.
      6. Geben Sie den im vorherigen Schritt generierten SHA-Schlüssel im Feld SHA-1-Zertifikatfingerabdruck an.
      7. Klicken Sie auf Erstellen.
      8. Klicken Sie auf OK.

    1. Erstellen Sie einen OAuth 2.0-Client für die Webanwendung:
      1. Klicken Sie auf Anmeldedaten erstellen, und wählen Sie OAuth-Client-ID aus.
      2. Wählen Sie unter Anwendungstyp die Option Webanwendung aus.
      3. Geben Sie einen Namen an.
      4. Klicken Sie unter Autorisierte Weiterleitungs-URIs auf URI hinzufügen, und geben Sie folgende URI an: https://login.xsolla.com/api/social/oauth2/callback.
      5. Klicken Sie auf Erstellen.
      6. Klicken Sie auf OK.

    Zur weiteren Konfiguration der nativen Authentifizierung benötigen Sie eine Client-ID und einen Clientschlüssel. Beide finden Sie in den Einstellungen der Client-ID für die Webanwendung.

    Soziale Netzwerke für Login-Projekte im Kundenportal einbinden

    1. Öffnen Sie Ihr Projekt im Kundenportal.
    2. Klicken Sie in der Seitenleiste auf Login.
    3. Klicken Sie beim gewünschten Login-Projekt auf Konfigurieren.
    4. Scrollen Sie auf der Navigationsseite zum Block Authentifizierung, und klicken Sie auf Anmeldung über soziale Netzwerke.

    1. Klicken Sie auf der Karte des gewünschten sozialen Netzwerks, rechts neben dem Titel, auf das ⚙-Symbol und dann auf Verknüpfen.

    Hinweis
    Um die Autorisierung über soziale Netzwerke verwenden zu können, müssen Sie die Anwendungs-ID und den geheimen Schlüssel der Anwendung in Ihrem Projekt eingeben. Das können Sie in den Einstellungen auf der Karte des jeweiligen sozialen Netzwerks erledigen. Die Anwendungs-ID und den geheimen Schlüssel finden Sie im Entwicklerkonto des Social-Media-Anbieters. Detaillierte Anweisungen dazu finden Sie im Kundenportal in den Einstellungen auf der Karte des jeweiligen sozialen Netzwerks.
    War dieser Artikel hilfreich?
    Vielen Dank!
    Gibt es etwas, das wir verbessern können? Nachricht
    Das tut uns leid
    Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
    Vielen Dank für Ihr Feedback!
    Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
    Ausblenden

    Nützliche Links

    Letztmalig aktualisiert: 8. August 2022

    Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

    Problem melden
    Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
    Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
    Vielen Dank für Ihr Feedback!