Puede permitir que sus usuarios se autentiquen con Firebase utilizando proveedores de OAuth como Twitter integrando el inicio de sesión OAuth genérico en su aplicación utilizando el SDK de Firebase para llevar a cabo el flujo de inicio de sesión de principio a fin.
Antes de que empieces
Utilice Swift Package Manager para instalar y administrar las dependencias de Firebase.
- En Xcode, con el proyecto de su aplicación abierto, navegue hasta Archivo > Agregar paquetes .
- Cuando se le solicite, agregue el repositorio SDK de las plataformas Firebase Apple:
- Elija la biblioteca de autenticación de Firebase.
- Agregue el indicador
-ObjC
a la sección Otros indicadores del vinculador de la configuración de compilación de su objetivo. - Cuando termine, Xcode comenzará automáticamente a resolver y descargar sus dependencias en segundo plano.
https://github.com/firebase/firebase-ios-sdk.git
Para que los usuarios inicien sesión con cuentas de Twitter, primero debes habilitar Twitter como proveedor de inicio de sesión para tu proyecto de Firebase:
Incluya los siguientes pods en su
Podfile
:pod 'FirebaseAuth'
- En Firebase console , abre la sección Auth .
- En la pestaña Método de inicio de sesión , habilite el proveedor de Twitter .
- Agregue la clave API y el secreto API desde la consola de desarrollador de ese proveedor a la configuración del proveedor:
- Registre su aplicación como aplicación de desarrollador en Twitter y obtenga la clave API de OAuth y el secreto de API de su aplicación.
- Asegúrese de que su URI de redireccionamiento de Firebase OAuth (por ejemplo,
my-app-12345.firebaseapp.com/__/auth/handler
) esté configurado como su URL de devolución de llamada de autorización en la página de configuración de su aplicación en la configuración de su aplicación de Twitter .
- Clic en Guardar .
Maneja el flujo de inicio de sesión con el SDK de Firebase
Para manejar el flujo de inicio de sesión con el SDK de las plataformas Firebase Apple, siga estos pasos:
Agregue esquemas de URL personalizados a su proyecto Xcode:
- Abra la configuración de su proyecto: haga doble clic en el nombre del proyecto en la vista de árbol de la izquierda. Seleccione su aplicación en la sección OBJETIVOS , luego seleccione la pestaña Información y expanda la sección Tipos de URL .
- Haga clic en el botón + y agregue su ID de aplicación codificada como un esquema de URL. Puede encontrar su ID de aplicación codificada en la página Configuración general de Firebase console, en la sección de su aplicación iOS. Deje los demás campos en blanco.
Cuando esté completa, su configuración debería verse similar a la siguiente (pero con los valores específicos de su aplicación):
Cree una instancia de OAuthProvider utilizando el ID de proveedor twitter.com .
var provider = OAuthProvider(providerID: "twitter.com")
FIROAuthProvider *provider = [FIROAuthProvider providerWithProviderID:@"twitter.com"];
Opcional : especifique parámetros OAuth personalizados adicionales que desee enviar con la solicitud OAuth.
provider.customParameters = [
"lang": "fr"
]
[provider setCustomParameters:@{@"lang": @"fr"}];
Para conocer los parámetros que admite Twitter, consulte la documentación de Twitter OAuth . Ten en cuenta que no puedes pasar los parámetros requeridos por Firebase con
setCustomParameters
. Estos parámetros son client_id , redirigir_uri , tipo_respuesta , alcance y estado .Opcional : si desea personalizar la forma en que su aplicación presenta
SFSafariViewController
oUIWebView
cuando muestra reCAPTCHA al usuario, cree una clase personalizada que se ajuste al protocoloAuthUIDelegate
y pásela acredentialWithUIDelegate
.Autentíquese con Firebase utilizando el objeto proveedor de OAuth.
provider.getCredentialWith(nil) { credential, error in
if error != nil {
// Handle error.
}
if credential != nil {
Auth.auth().signIn(with: credential) { authResult, error in
if error != nil {
// Handle error.
}
// User is signed in.
// IdP data available in authResult.additionalUserInfo.profile.
// Twitter OAuth access token can also be retrieved by:
// (authResult.credential as? OAuthCredential)?.accessToken
// Twitter OAuth ID token can be retrieved by calling:
// (authResult.credential as? OAuthCredential)?.idToken
// Twitter OAuth secret can be retrieved by calling:
// (authResult.credential as? OAuthCredential)?.secret
}
}
}
[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.
// Twitter OAuth access token can also be retrieved by:
// authResult.credential.accessToken
// Twitter OAuth ID token can be retrieved by calling:
// authResult.credential.idToken
// Twitter OAuth secret can be retrieved by calling:
// authResult.credential.secret
}];
}
}];
Con el token de acceso de OAuth, puede llamar a la API de Twitter .
Por ejemplo, para obtener información básica del perfil, puede llamar a la API REST y pasar el token de acceso en el encabezado
Authorization
:https://api.twitter.com/labs/1/users?usernames=TwitterDev
Si bien los ejemplos anteriores se centran en los flujos de inicio de sesión, también tienes la posibilidad de vincular un proveedor de Twitter a un usuario existente. Por ejemplo, puede vincular varios proveedores al mismo usuario, permitiéndoles iniciar sesión con cualquiera de ellos.
Auth().currentUser.link(withCredential: credential) { authResult, error in
if error != nil {
// Handle error.
}
// Twitter credential is linked to the current user.
// IdP data available in authResult.additionalUserInfo.profile.
// Twitter OAuth access token can also be retrieved by:
// (authResult.credential as? OAuthCredential)?.accessToken
// Twitter OAuth ID token can be retrieved by calling:
// (authResult.credential as? OAuthCredential)?.idToken
// Twitter OAuth secret can be retrieved by calling:
// (authResult.credential as? OAuthCredential)?.secret
}
[[FIRAuth auth].currentUser
linkWithCredential:credential
completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
if (error) {
// Handle error.
}
// Twitter credential is linked to the current user.
// IdP data available in authResult.additionalUserInfo.profile.
// Twitter OAuth access token is can also be retrieved by:
// ((FIROAuthCredential *)authResult.credential).accessToken
// Twitter OAuth ID token can be retrieved by calling:
// ((FIROAuthCredential *)authResult.credential).idToken
// Twitter OAuth secret can be retrieved by calling:
// ((FIROAuthCredential *)authResult.credential).secret
}];
Se puede usar el mismo patrón con
reauthenticateWithCredential
, que se puede usar para recuperar credenciales nuevas para operaciones confidenciales que requieren un inicio de sesión reciente.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:
// (authResult.credential as? OAuthCredential)?.accessToken
// Twitter OAuth ID token can be retrieved by calling:
// (authResult.credential as? OAuthCredential)?.idToken
// Twitter OAuth secret can be retrieved by calling:
// (authResult.credential as? OAuthCredential)?.secret
}
[[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:
// ((FIROAuthCredential *)authResult.credential).accessToken
// Twitter OAuth ID token can be retrieved by calling:
// ((FIROAuthCredential *)authResult.credential).idToken
// Twitter OAuth secret can be retrieved by calling:
// ((FIROAuthCredential *)authResult.credential).secret
}];
Manejo de errores de cuenta-existe-con-credencial-diferente
Si habilitó la configuración Una cuenta por dirección de correo electrónico en Firebase console , cuando un usuario intenta iniciar sesión en un proveedor (como Twitter) con un correo electrónico que ya existe para el proveedor de otro usuario de Firebase (como Google), aparecerá el error. FIRAuthErrorCodeAccountExistsWithDifferentCredential
se lanza junto con un objeto FIRAuthCredential
temporal (credencial de Twitter). Para completar el inicio de sesión en el proveedor deseado, el usuario debe iniciar sesión primero en el proveedor existente (Google) y luego vincularse a la antigua FIRAuthCredential
(credencial de Twitter). Esto quedaría como se ilustra a continuación:
// Sign-in with an OAuth credential.
provider.getCredentialWith(nil) { credential, error in
// An account with the same email already exists.
if (error as NSError?)?.code == AuthErrorCode.accountExistsWithDifferentCredential.rawValue {
// Get pending credential and email of existing account.
let existingAcctEmail = (error! as NSError).userInfo[AuthErrorUserInfoEmailKey] as! String
let pendingCred = (error! as NSError).userInfo[AuthErrorUserInfoUpdatedCredentialKey] as! AuthCredential
// Lookup existing account identifier by the email.
Auth.auth().fetchProviders(forEmail:existingAcctEmail) { providers, error in
// Existing email/password account.
if (providers?.contains(EmailAuthProviderID))! {
// Existing password account for email. Ask user to provide the password of the
// existing account.
// Sign in with existing account.
Auth.auth().signIn(withEmail:existingAcctEmail, password:password) { user, error in
// Successfully signed in.
if user != nil {
// Link pending credential to account.
Auth.auth().currentUser?.linkAndRetrieveData(with: pendingCred) { result, error in
// ...
}
}
}
}
}
return
}
// Other errors.
if error != nil {
// handle the error.
return
}
// Sign in with the credential.
if credential != nil {
Auth.auth().signInAndRetrieveData(with: credential!) { result, error in
if error != nil {
// handle the error.
return
}
}
}
}
// Sign-in with an OAuth credential.
[provider getCredentialWithUIDelegate:nil
completion:^(FIRAuthCredential *_Nullable credential, NSError *_Nullable error) {
// An account with the same email already exists.
if (error.code == FIRAuthErrorCodeAccountExistsWithDifferentCredential) {
// Get pending credential and email of existing account.
NSString *existingAcctEmail = error.userInfo[FIRAuthErrorUserInfoEmailKey];
FIRAuthCredential *pendingCred = error.userInfo[FIRAuthErrorUserInfoUpdatedCredentialKey];
// Lookup existing account identifier by the email.
[[FIRAuth auth] fetchProvidersForEmail:existingAcctEmail
completion:^(NSArray<NSString *> *_Nullable providers,
NSError *_Nullable error) {
// Existing email/password account.
if ( [providers containsObject:FIREmailAuthProviderID] ) {
// Existing password account for email. Ask user to provide the password of the
// existing account.
// Sign in with existing account.
[[FIRAuth auth] signInWithEmail:existingAcctEmail
password:password
completion:^(FIRUser *user, NSError *error) {
// Successfully signed in.
if (user) {
// Link pending credential to account.
[[FIRAuth auth].currentUser linkWithCredential:pendingCred
completion:^(FIRUser *_Nullable user,
NSError *_Nullable error) {
// ...
}];
}
}];
}
}];
return;
}
// Other errors.
if (error) {
// handle the error.
return;
}
// Sign in with the credential.
if (credential) {
[[FIRAuth auth] signInAndRetrieveDataWithCredential:credential
completion:^(FIRAuthDataResult *_Nullable authResult,
NSError *_Nullable error) {
if (error) {
// handle the error.
return;
}
}];
}
}];
Próximos pasos
Después de que un usuario inicia sesión por primera vez, se crea una nueva cuenta de usuario y se vincula a las credenciales (es decir, el nombre de usuario y la contraseña, el número de teléfono o la información del proveedor de autenticación) con las que el usuario inició sesión. Esta nueva cuenta se almacena como parte de su proyecto de Firebase y se puede usar para identificar a un usuario en cada aplicación de su proyecto, independientemente de cómo inicie sesión el usuario.
En sus aplicaciones, puede obtener la información básica del perfil del usuario desde el objeto
User
. Consulte Administrar usuarios .En las reglas de seguridad de Firebase Realtime Database y Cloud Storage, puede obtener el ID de usuario único del usuario que inició sesión a partir de la variable
auth
y usarlo para controlar a qué datos puede acceder un usuario.
Puede permitir que los usuarios inicien sesión en su aplicación utilizando múltiples proveedores de autenticación vinculando las credenciales del proveedor de autenticación a una cuenta de usuario existente.
Para cerrar la sesión de un usuario, llame signOut:
.
let firebaseAuth = Auth.auth()
do {
try firebaseAuth.signOut()
} catch let signOutError as NSError {
print("Error signing out: %@", signOutError)
}
NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
NSLog(@"Error signing out: %@", signOutError);
return;
}
Es posible que también desee agregar un código de manejo de errores para toda la gama de errores de autenticación. Consulte Manejar errores .