Vous pouvez permettre à vos utilisateurs de s'authentifier auprès de Firebase à l'aide de fournisseurs OAuth tels que Yahoo en intégrant une connexion OAuth générique basée sur le Web à votre application à l'aide du SDK Firebase pour effectuer le flux de connexion de bout en bout.
Avant de commencer
Pour connecter des utilisateurs à l'aide de comptes Yahoo, vous devez d'abord activer Yahoo comme fournisseur de connexion pour votre projet Firebase :
- Dans la console Firebase, accédez à Security > Authentication.
- Dans l'onglet Sign-in method (Mode de connexion), activez le fournisseur de connexion Yahoo.
-
Ajoutez l'ID client et le code secret du client de la console pour développeurs de ce fournisseur à la configuration du fournisseur :
-
Pour enregistrer un client OAuth Yahoo, suivez la documentation pour les développeurs Yahoo sur l'enregistrement d'une application Web auprès de Yahoo.
Veillez à sélectionner les deux autorisations d'API OpenID Connect :
profileetemail. -
Lorsque vous enregistrez des applications auprès de ces fournisseurs, veillez à enregistrer le
*.firebaseapp.comdomaine de votre projet comme domaine de redirection domaine pour votre application.
-
- Cliquez sur Save (Enregistrer).
Spécifiez l'empreinte SHA-1 de votre application si ce n'est pas déjà fait.
Dans la console Firebase, accédez à l'
Settings > General (Paramètres > Général).Faites défiler la page jusqu'à la fiche Your apps (Vos applications), sélectionnez votre application Android, puis ajoutez votre empreinte SHA-1 dans le champ SHA certificate fingerprints (Empreintes de certificat SHA).
Pour savoir comment obtenir l'empreinte SHA de votre application, consultez Authentifier votre client.
Gérer le flux de connexion avec le SDK Firebase
Si vous créez une application Android, le moyen le plus simple d'authentifier vos utilisateurs auprès de Firebase à l'aide de leurs comptes Yahoo consiste à gérer l'intégralité du flux de connexion avec le SDK Firebase pour Android.
Pour gérer le flux de connexion avec le SDK Firebase pour Android, procédez comme suit :
Créez une instance d'OAuthProvider à l'aide de son compilateur avec l'ID de fournisseur yahoo.com.
Kotlin
val provider = OAuthProvider.newBuilder("yahoo.com")
Java
OAuthProvider.Builder provider = OAuthProvider.newBuilder("yahoo.com");
Facultatif : Spécifiez des paramètres OAuth personnalisés supplémentaires que vous souhaitez envoyer avec la requête OAuth.
Kotlin
// Prompt user to re-authenticate to Yahoo. provider.addCustomParameter("prompt", "login") // Localize to French. provider.addCustomParameter("language", "fr")
Java
// Prompt user to re-authenticate to Yahoo. provider.addCustomParameter("prompt", "login"); // Localize to French. provider.addCustomParameter("language", "fr");
Pour connaître les paramètres compatibles avec Yahoo, consultez la documentation OAuth de Yahoo. Notez que vous ne pouvez pas transmettre les paramètres requis par Firebase avec
setCustomParameters(). Ces paramètres sont client_id, redirect_uri, response_type, scope et state.Facultatif : Spécifiez des champs d'application OAuth 2.0 supplémentaires au-delà de
profileetemailque vous souhaitez demander au fournisseur d'authentification. Si votre application nécessite d'accéder à des données utilisateur privées à partir des API Yahoo, vous devez demander des autorisations aux API Yahoo sous API Permissions (Autorisations d'API) dans la console pour développeurs Yahoo. Les champs d'application OAuth demandés doivent correspondre exactement à ceux préconfigurés dans les autorisations d'API de l'application. Par exemple, si un accès en lecture/écriture est demandé aux contacts de l'utilisateur et préconfiguré dans les autorisations d'API de l'application,sdct-wdoit être transmis à la place du champ d'application OAuth en lecture seulesdct-r. Sinon,le flux échouera et une erreur s'affichera pour l'utilisateur final.Kotlin
// Request read access to a user's email addresses. // This must be preconfigured in the app's API permissions. provider.scopes = listOf("mail-r", "sdct-w")
Java
Pour en savoir plus, consultez la documentation sur les champs d'application Yahoo.// Request read access to a user's email addresses. // This must be preconfigured in the app's API permissions. List<String> scopes = new ArrayList<String>() { { // Request access to Yahoo Mail API. add("mail-r"); // This must be preconfigured in the app's API permissions. add("sdct-w"); } }; provider.setScopes(scopes);
Authentifiez-vous auprès de Firebase à l'aide de l'objet fournisseur OAuth. Notez que, contrairement à d'autres opérations FirebaseAuth, cela prendra le contrôle de votre UI en affichant un onglet Chrome personnalisé. Par conséquent, ne faites pas référence à votre activité dans les OnSuccessListeners et OnFailureListeners que vous associez, car ils seront immédiatement dissociés lorsque l'opération démarrera l'UI.
Vous devez d'abord vérifier si vous avez déjà reçu une réponse. La connexion via cette méthode place votre activité en arrière-plan, ce qui signifie qu'elle peut être récupérée par le système pendant le flux de connexion. Pour vous assurer que l'utilisateur n'a pas à réessayer si cela se produit, vous devez vérifier si un résultat est déjà présent.
Pour vérifier si un résultat est en attente, appelez
getPendingAuthResult:Kotlin
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. }
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. }
Pour démarrer le flux de connexion, appelez
startActivityForSignInWithProvider:Kotlin
firebaseAuth .startActivityForSignInWithProvider(activity, 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. }
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. } });
Une fois l'opération terminée, le jeton d'accès OAuth associé au fournisseur peut être récupéré à partir de l'objet
OAuthCredentialrenvoyé.À l'aide du jeton d'accès OAuth, vous pouvez appeler l' API Yahoo.
Où
YAHOO_USER_UIDest l'ID de l'utilisateur Yahoo, qui peut être analysé à partir du champfirebaseAuth.getCurrentUser().getProviderData().get(0).getUid()ou deauthResult.getAdditionalUserInfo().getProfile().Bien que les exemples ci-dessus se concentrent sur les flux de connexion, vous pouvez également associer un fournisseur Yahoo à un utilisateur existant à l'aide de
startActivityForLinkWithProvider. Par exemple, vous pouvez associer plusieurs fournisseurs au même utilisateur, ce qui lui permet de se connecter avec l'un ou l'autre.Kotlin
// The user is already signed-in. val firebaseUser = firebaseAuth.currentUser!! firebaseUser .startActivityForLinkWithProvider(activity, 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. }
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. } });
Le même modèle peut être utilisé avec
startActivityForReauthenticateWithProvider, qui permet de récupérer des identifiants récents pour les opérations sensibles nécessitant une connexion récente.Kotlin
// The user is already signed-in. val firebaseUser = firebaseAuth.currentUser!! firebaseUser .startActivityForReauthenticateWithProvider(activity, 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. }
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. } });
Étapes suivantes
Lorsqu'un utilisateur se connecte pour la première fois, un compte utilisateur est créé et associé aux identifiants (nom d'utilisateur et mot de passe, numéro de téléphone ou informations du fournisseur d'authentification) avec lesquels il s'est connecté. Ce nouveau compte est stocké dans votre projet Firebase et peut être utilisé pour identifier un utilisateur dans chaque application de votre projet, quelle que soit la méthode de connexion utilisée.
-
Dans vos applications, vous pouvez obtenir les informations de base du profil de l'utilisateur à partir de l'objet
FirebaseUser. Consultez Gérer les utilisateurs. Dans vos Firebase Realtime Database et Cloud Storage règles de sécurité, vous pouvez obtenir l'ID utilisateur unique de l'utilisateur connecté à partir de la variable
auth, et l'utiliser pour contrôler les données auxquelles un utilisateur peut accéder.
Vous pouvez autoriser les utilisateurs à se connecter à votre application à l'aide de plusieurs fournisseurs d'authentification en associant les identifiants du fournisseur d'authentification à un compte utilisateur existant.
Pour déconnecter un utilisateur, appelez
signOut :
Kotlin
Firebase.auth.signOut()
Java
FirebaseAuth.getInstance().signOut();