Ir a la consola

Autentica mediante Yahoo con JavaScript

Puedes dejar que los usuarios se autentiquen con Firebase mediante proveedores de OAuth, como Yahoo, con solo integrar un acceso genérico de OAuth en tu app, usando el SDK de Firebase para llevar a cabo el flujo de acceso de extremo a extremo.

Antes de comenzar

Para que los usuarios accedan con cuentas de Yahoo, primero debes habilitar Yahoo como un proveedor de acceso para tu proyecto de Firebase.

  1. Agrega Firebase al proyecto de iOS.
  2. En Firebase console, abre la sección Auth.
  3. En la pestaña Método de acceso, habilita el proveedor de Yahoo.
  4. Agrega el ID de cliente y el secreto del cliente de la consola para desarrolladores de ese proveedor a la configuración del proveedor, como se muestra a continuación:
    1. Para registrar un cliente de OAuth de Yahoo, sigue las instrucciones de Yahoo sobre cómo registrar una aplicación web con esta plataforma.
    2. Cuando registres apps con estos proveedores, asegúrate de registrar el dominio *.firebaseapp.com para tu proyecto como el dominio de redireccionamiento de tu app.
  5. Haz clic en Guardar.

Maneja el flujo de acceso con el SDK de Firebase

A fin de manejar el flujo de acceso con el SDK de Firebase para iOS, sigue estos pasos:

  1. Agrega esquemas de URL personalizadas al proyecto de Xcode:

    1. Abre la configuración del proyecto; para ello, haz doble clic en el nombre del proyecto en la vista de árbol a la izquierda. Selecciona tu app en la sección OBJETIVOS, haz clic en la pestaña Información y expande la sección Tipos de URL.
    2. Haz clic en el botón + y agrega un esquema de URL para tu ID de cliente invertido. A fin de obtener este valor, abre el archivo de configuración GoogleService-Info.plist y busca la clave REVERSED_CLIENT_ID. Copia el valor de esa clave y pégalo en el recuadro Esquemas de URL en la página de configuración. Deja los demás campos en blanco.

      Cuando termines, la configuración debería ser similar a la que se muestra a continuación (pero con los valores específicos de tu aplicación):

  2. Crea una instancia de un OAuthProvider con el ID de proveedor yahoo.com.

    Swift

        var provider = OAuthProvider(providerID: "yahoo.com")
        

    Objective-C

        FIROAuthProvider *provider = [FIROAuthProvider providerWithProviderID:@"yahoo.com"];
        
  3. Opcional: Especifica parámetros de OAuth personalizados adicionales que quieras enviar con la solicitud de OAuth.

    Swift

        provider.customParameters = [
          "prompt": "login",
          "language": "fr"
          ]
        

    Objective-C

        [provider setCustomParameters:@{@"prompt": @"login", @"language": @"fr"}];
        

    Para conocer los parámetros que admite Yahoo, consulta la documentación de OAuth de Yahoo. Ten en cuenta que no puedes pasar parámetros que requiere Firebase con setCustomParameters. Estos parámetros son client_id, redirect_uri, response_type, scope y state.

  4. Opcional: Especifica alcances de OAuth 2.0 adicionales aparte del perfil básico que quieres solicitar del proveedor de autenticación. Si tu aplicación requiere acceso a datos privados del usuario desde las API de Yahoo, será necesario que solicites permisos a estas últimas en Permisos de API en la consola para desarrolladores de Yahoo. Los alcances de OAuth solicitados deben coincidir exactamente con los preconfigurados en los permisos de API de la app. Por ejemplo, si se solicita el acceso de lectura/escritura a los contactos del usuario y se preconfigura en los permisos de API de la app, se debe pasar sdct-w en lugar del alcance de OAuth de solo lectura sdct-r. De lo contrario, el flujo fallará y se mostrará un error al usuario final.

    Swift

        // Request access to Yahoo Mail API.
        // Request read/write access to user contacts.
        // This must be preconfigured in the app's API permissions.
        provider.scopes = ["mail-r", "sdct-w"]
        

    Objective-C

        // Request access to Yahoo Mail API.
        // Request read/write access to user contacts.
        // This must be preconfigured in the app's API permissions.
        [provider setScopes:@[@"mail-r", @"sdct-w"]];
        

    Para obtener más información, consulta la documentación de alcances de Yahoo.

  5. Opcional: Si deseas personalizar la forma en que tu app presenta SFSafariViewControllerUIWebView cuando se le muestra el reCAPTCHA al usuario, crea una clase personalizada conforme al protocolo FIRAuthUIDelegate y pásala a getCredentialWithUIDelegate:completion:.

  6. Autentica con Firebase mediante el objeto del proveedor de OAuth.

    Swift

        provider.getCredentialWith(nil) { credential, error in
          if error != nil {
            // Handle error.
          }
          if credential != nil {
            Auth().signIn(with: credential) { authResult, error in
              if error != nil {
                // Handle error.
              }
              // User is signed in.
              // IdP data available in authResult.additionalUserInfo.profile.
              // Yahoo OAuth access token can also be retrieved by:
              // credential.accessToken
              // Yahoo OAuth ID token can be retrieved by calling:
              // credential.idToken
            }
          }
        }
        

    Objective-C

        [provider getCredentialWithUIDelegate:nil
                                   completion:^(FIRAuthCredential *_Nullable credential, NSError *_Nullable error) {
          if (error) {
           // Handle error.
          }
          if (credential) {
            [[FIRAuth auth] signInWithCredential:credential
                                      completion:^(FIRAuthDataResult *_Nullable authResult, NSError *_Nullable error) {
              if (error) {
                // Handle error.
              }
              // User is signed in.
              // IdP data available in authResult.additionalUserInfo.profile.
              // Yahoo OAuth access token can also be retrieved by:
              // credential.accessToken
              // Yahoo OAuth ID token can be retrieved by calling:
              // credential.idToken
            }];
          }
        }];
        

    Mediante el token de acceso de OAuth, puedes llamar a la API de Yahoo.

    Por ejemplo, para obtener la información básica de perfil, puedes llamar a la API de REST y pasar el token de acceso en el encabezado Authorization:

    https://social.yahooapis.com/v1/user/YAHOO_USER_UID/profile?format=json
    

    En el que YAHOO_USER_UID es el ID del usuario de Yahoo, que se puede recuperar desde el campo Auth.auth.currentUser.providerData[0].uid o desde authResult.additionalUserInfo.profile.

  7. Si bien los ejemplos anteriores se enfocan en los flujos de acceso, también tienes la capacidad de vincular un proveedor de Yahoo con un usuario existente mediante linkWithPopup. Por ejemplo, puedes vincular varios proveedores con el mismo usuario para permitirles acceder con cualquiera de estos.

    Swift

        Auth().currentUser.link(withCredential: credential) { authResult, error in
          if error != nil {
            // Handle error.
          }
          // Yahoo credential is linked to the current user.
          // IdP data available in authResult.additionalUserInfo.profile.
          // Yahoo OAuth access token can also be retrieved by:
          // credential.accessToken
          // Yahoo OAuth ID token can be retrieved by calling:
          // credential.idToken
        }
        

    Objective-C

        [[FIRAuth auth].currentUser
            linkWithCredential:credential
                    completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
          if (error) {
            // Handle error.
          }
          // Yahoo credential is linked to the current user.
          // IdP data available in authResult.additionalUserInfo.profile.
          // Yahoo OAuth access token is can also be retrieved by:
          // credential.accessToken
          // Yahoo OAuth ID token can be retrieved by calling:
          // credential.idToken
        }];
        
  8. Se puede usar el mismo patrón con reauthenticateWithPopup/reauthenticateWithRedirect, que se puede usar a fin de recuperar credenciales nuevas para operaciones sensibles que requieren un acceso reciente.

    Swift

        Auth().currentUser.reauthenticateWithCredential(withCredential: credential) { authResult, error in
          if error != nil {
            // Handle error.
          }
          // User is re-authenticated with fresh tokens minted and
          // should be able to perform sensitive operations like account
          // deletion and email or password update.
          // IdP data available in result.additionalUserInfo.profile.
          // Additional OAuth access token is can also be retrieved by:
          // credential.accessToken
          // Yahoo OAuth ID token can be retrieved by calling:
          // credential.idToken
        }
        

    Objective-C

        [[FIRAuth auth].currentUser
            reauthenticateWithCredential:credential
                              completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
          if (error) {
            // Handle error.
          }
          // User is re-authenticated with fresh tokens minted and
          // should be able to perform sensitive operations like account
          // deletion and email or password update.
          // IdP data available in result.additionalUserInfo.profile.
          // Additional OAuth access token is can also be retrieved by:
          // credential.accessToken
          // Yahoo OAuth ID token can be retrieved by calling:
          // credential.idToken
        }];
        

Próximos pasos

Cuando un usuario accede por primera vez, se crea una cuenta de usuario nueva y se la vincula con las credenciales (el nombre de usuario y la contraseña, el número de teléfono o la información del proveedor de autenticación) que el usuario usó para acceder. Esta cuenta nueva se almacena como parte del proyecto de Firebase y puede usarse para identificar a un usuario en todas las apps del proyecto, sin importar el método de acceso que se use.

  • En tus apps, puedes obtener la información básica del perfil del usuario a partir del objeto FIRUser. Consulta Cómo administrar usuarios.

  • En las reglas de seguridad de Firebase Realtime Database y Cloud Storage, puedes obtener el ID único del usuario que accedió a partir de la variable auth y usarlo para controlar a qué datos podrá acceder.

Si quieres permitir que los usuarios accedan a la app con varios proveedores de autenticación, vincula las credenciales de proveedores de autenticación a una cuenta de usuario existente.

Para cerrar la sesión de un usuario, llama a signOut: de la siguiente manera:

Swift

    let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print ("Error signing out: %@", signOutError)
}  

Objective-C

    NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}

Tal vez sea conveniente que agregues código de administración de errores para todos los errores de autenticación. Consulta Soluciona errores.