此页面由 Cloud Translation API 翻译。

在 Android 上使用 Twitter 进行身份验证

您可以让您的用户使用他们的 Twitter 帐户通过 Firebase 进行身份验证，方法是使用 Firebase SDK 将基于 Web 的通用 OAuth 登录集成到您的应用程序中，以执行端到端的登录流程。

在你开始之前

要使用 Twitter 帐户登录用户，您必须首先启用 Twitter 作为您的 Firebase 项目的登录提供商：

如果您还没有，请将 Firebase 添加到您的 Android 项目中。
在Firebase 控制台中，打开Auth部分。
在登录方法选项卡上，启用Twitter提供商。
将该提供商的开发人员控制台中的API 密钥和API 机密添加到提供商配置中：
1. 在 Twitter 上将您的应用程序注册为开发人员应用程序，并获取您应用程序的 OAuth API 密钥和API 机密。
2. 确保您的 Firebase OAuth 重定向 URI （例如my-app-12345.firebaseapp.com/__/auth/handler ）在您的Twitter 应用的配置页面中设置为您的授权回调 URL 。
单击保存。

在您的模块（应用级）Gradle 文件（通常为<project>/<app-module>/build.gradle ）中，添加 Firebase 身份验证 Android 库的依赖项。我们建议使用Firebase Android BoM来控制库版本。

Kotlin+KTX

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:31.2.0')

    // Add the dependency for the Firebase Authentication library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-auth-ktx'
}

通过使用Firebase Android BoM ，您的应用将始终使用兼容版本的 Firebase Android 库。

（备选）在不使用 BoM 的情况下添加 Firebase 库依赖项

如果您选择不使用 Firebase BoM，则必须在其依赖项行中指定每个 Firebase 库版本。

请注意，如果您在应用中使用多个Firebase 库，我们强烈建议您使用 BoM 来管理库版本，以确保所有版本都兼容。

dependencies {
    // Add the dependency for the Firebase Authentication library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-auth-ktx:21.1.0'
}

Java

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:31.2.0')

    // Add the dependency for the Firebase Authentication library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-auth'
}

通过使用Firebase Android BoM ，您的应用将始终使用兼容版本的 Firebase Android 库。

（备选）在不使用 BoM 的情况下添加 Firebase 库依赖项

如果您选择不使用 Firebase BoM，则必须在其依赖项行中指定每个 Firebase 库版本。

请注意，如果您在应用中使用多个Firebase 库，我们强烈建议您使用 BoM 来管理库版本，以确保所有版本都兼容。

dependencies {
    // Add the dependency for the Firebase Authentication library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-auth:21.1.0'
}

如果您尚未指定应用的 SHA-1 指纹，请从 Firebase 控制台的“设置”页面执行此操作。有关如何获取应用的 SHA-1 指纹的详细信息，请参阅验证您的客户端。

使用 Firebase SDK 处理登录流程

如果您正在构建 Android 应用程序，使用 Firebase 用户的 Twitter 帐户对用户进行身份验证的最简单方法是使用 Firebase Android SDK 处理整个登录流程。

要使用 Firebase Android SDK 处理登录流程，请执行以下步骤：

使用其Builder和提供者 ID Twitter.com构造OAuthProvider的实例

Kotlin+KTX

val provider = OAuthProvider.newBuilder("twitter.com")GenericIdpActivity.kt

Java

OAuthProvider.Builder provider = OAuthProvider.newBuilder("twitter.com");GenericIdpActivity.java

可选：指定要与 OAuth 请求一起发送的其他自定义 OAuth 参数。
Kotlin+KTX
```
// Localize to French.
provider.addCustomParameter("lang", "fr")GenericIdpActivity.kt
```
Java
```
// Localize to French.
provider.addCustomParameter("lang", "fr");GenericIdpActivity.java
```
有关 Twitter 支持的参数，请参阅Twitter OAuth 文档。请注意，您不能使用setCustomParameters()传递 Firebase 所需的参数。这些参数是client_id 、 response_type 、 redirect_uri 、 state 、 scope和response_mode 。

使用 OAuth 提供程序对象通过 Firebase 进行身份验证。请注意，与其他 FirebaseAuth 操作不同，这将通过弹出Custom Chrome Tab来控制您的 UI。因此，请勿在您附加的OnSuccessListener和OnFailureListener中引用您的活动，因为它们会在操作启动 UI 时立即分离。

您应该首先检查您是否已经收到回复。通过此方法登录会将您的 Activity 置于后台，这意味着它可以在登录流程期间由系统回收。如果发生这种情况，为了确保您不会让用户重试，您应该检查结果是否已经存在。

要检查是否有待定结果，请调用getPendingAuthResult ：

Kotlin+KTX

val pendingResultTask = firebaseAuth.pendingAuthResult
if (pendingResultTask != null) {
    // There's something already here! Finish the sign-in for your user.
    pendingResultTask
        .addOnSuccessListener {
            // User is signed in.
            // IdP data available in
            // authResult.getAdditionalUserInfo().getProfile().
            // The OAuth access token can also be retrieved:
            // ((OAuthCredential)authResult.getCredential()).getAccessToken().
            // The OAuth secret can be retrieved by calling:
            // ((OAuthCredential)authResult.getCredential()).getSecret().
        }
        .addOnFailureListener {
            // Handle failure.
        }
} else {
    // There's no pending result so you need to start the sign-in flow.
    // See below.
}GenericIdpActivity.kt

Java

Task<AuthResult> pendingResultTask = firebaseAuth.getPendingAuthResult();
if (pendingResultTask != null) {
    // There's something already here! Finish the sign-in for your user.
    pendingResultTask
            .addOnSuccessListener(
                    new OnSuccessListener<AuthResult>() {
                        @Override
                        public void onSuccess(AuthResult authResult) {
                            // User is signed in.
                            // IdP data available in
                            // authResult.getAdditionalUserInfo().getProfile().
                            // The OAuth access token can also be retrieved:
                            // ((OAuthCredential)authResult.getCredential()).getAccessToken().
                            // The OAuth secret can be retrieved by calling:
                            // ((OAuthCredential)authResult.getCredential()).getSecret().
                        }
                    })
            .addOnFailureListener(
                    new OnFailureListener() {
                        @Override
                        public void onFailure(@NonNull Exception e) {
                            // Handle failure.
                        }
                    });
} else {
    // There's no pending result so you need to start the sign-in flow.
    // See below.
}GenericIdpActivity.java

要启动登录流程，请调用startActivityForSignInWithProvider ：

Kotlin+KTX

firebaseAuth
    .startActivityForSignInWithProvider( /* activity = */this, provider.build())
    .addOnSuccessListener {
        // User is signed in.
        // IdP data available in
        // authResult.getAdditionalUserInfo().getProfile().
        // The OAuth access token can also be retrieved:
        // ((OAuthCredential)authResult.getCredential()).getAccessToken().
        // The OAuth secret can be retrieved by calling:
        // ((OAuthCredential)authResult.getCredential()).getSecret().
    }
    .addOnFailureListener {
        // Handle failure.
    }GenericIdpActivity.kt

Java

firebaseAuth
        .startActivityForSignInWithProvider(/* activity= */ this, provider.build())
        .addOnSuccessListener(
                new OnSuccessListener<AuthResult>() {
                    @Override
                    public void onSuccess(AuthResult authResult) {
                        // User is signed in.
                        // IdP data available in
                        // authResult.getAdditionalUserInfo().getProfile().
                        // The OAuth access token can also be retrieved:
                        // ((OAuthCredential)authResult.getCredential()).getAccessToken().
                        // The OAuth secret can be retrieved by calling:
                        // ((OAuthCredential)authResult.getCredential()).getSecret().
                    }
                })
        .addOnFailureListener(
                new OnFailureListener() {
                    @Override
                    public void onFailure(@NonNull Exception e) {
                        // Handle failure.
                    }
                });GenericIdpActivity.java

成功完成后，可以从返回的OAuthCredential对象中检索与提供者关联的 OAuth 访问令牌。

使用 OAuth 访问令牌，您可以调用Twitter API 。

例如，要获取基本的个人资料信息，您可以调用 REST API，在Authorization标头中传递访问令牌：

虽然上述示例侧重于登录流程，但您也可以使用startActivityForLinkWithProvider将 Twitter 提供商链接到现有用户。例如，您可以将多个提供商链接到同一个用户，允许他们使用其中任何一个登录。

Kotlin+KTX

// The user is already signed-in.
val firebaseUser = firebaseAuth.currentUser!!
firebaseUser
    .startActivityForLinkWithProvider( /* activity = */this, provider.build())
    .addOnSuccessListener {
        // Provider credential is linked to the current user.
        // IdP data available in
        // authResult.getAdditionalUserInfo().getProfile().
        // The OAuth access token can also be retrieved:
        // authResult.getCredential().getAccessToken().
        // The OAuth secret can be retrieved by calling:
        // authResult.getCredential().getSecret().
    }
    .addOnFailureListener {
        // Handle failure.
    }GenericIdpActivity.kt

Java

// The user is already signed-in.
FirebaseUser firebaseUser = firebaseAuth.getCurrentUser();

firebaseUser
        .startActivityForLinkWithProvider(/* activity= */ this, provider.build())
        .addOnSuccessListener(
                new OnSuccessListener<AuthResult>() {
                    @Override
                    public void onSuccess(AuthResult authResult) {
                        // Provider credential is linked to the current user.
                        // IdP data available in
                        // authResult.getAdditionalUserInfo().getProfile().
                        // The OAuth access token can also be retrieved:
                        // authResult.getCredential().getAccessToken().
                        // The OAuth secret can be retrieved by calling:
                        // authResult.getCredential().getSecret().
                    }
                })
        .addOnFailureListener(
                new OnFailureListener() {
                    @Override
                    public void onFailure(@NonNull Exception e) {
                        // Handle failure.
                    }
                });GenericIdpActivity.java

相同的模式可用于startActivityForReauthenticateWithProvider ，它可用于为需要最近登录的敏感操作检索新凭据。

Kotlin+KTX

// The user is already signed-in.
val firebaseUser = firebaseAuth.currentUser!!
firebaseUser
    .startActivityForReauthenticateWithProvider( /* activity = */this, provider.build())
    .addOnSuccessListener {
        // User is re-authenticated with fresh tokens and
        // should be able to perform sensitive operations
        // like account deletion and email or password
        // update.
    }
    .addOnFailureListener {
        // Handle failure.
    }GenericIdpActivity.kt

Java

// The user is already signed-in.
FirebaseUser firebaseUser = firebaseAuth.getCurrentUser();

firebaseUser
        .startActivityForReauthenticateWithProvider(/* activity= */ this, provider.build())
        .addOnSuccessListener(
                new OnSuccessListener<AuthResult>() {
                    @Override
                    public void onSuccess(AuthResult authResult) {
                        // User is re-authenticated with fresh tokens and
                        // should be able to perform sensitive operations
                        // like account deletion and email or password
                        // update.
                    }
                })
        .addOnFailureListener(
                new OnFailureListener() {
                    @Override
                    public void onFailure(@NonNull Exception e) {
                        // Handle failure.
                    }
                });GenericIdpActivity.java

下一步

用户首次登录后，将创建一个新的用户帐户并将其链接到用户登录所用的凭据，即用户名和密码、电话号码或身份验证提供商信息。这个新帐户存储为您的 Firebase 项目的一部分，可用于在项目中的每个应用程序中识别用户，无论用户如何登录。

在您的应用中，您可以从FirebaseUser对象获取用户的基本个人资料信息。请参阅管理用户。
在您的 Firebase Realtime Database 和 Cloud Storage Security Rules中，您可以从auth变量中获取登录用户的唯一用户 ID，并使用它来控制用户可以访问的数据。

您可以允许用户使用多个身份验证提供程序登录您的应用程序，方法是将身份验证提供程序凭据链接到现有用户帐户。

要注销用户，请调用signOut ：

Kotlin+KTX

Firebase.auth.signOut()MainActivity.kt

Java

FirebaseAuth.getInstance().signOut();MainActivity.java