Descripción General
ServicioAutenticacion es el servicio centralizado para manejar toda la autenticación en el sistema. Integra Firebase Authentication con soporte para múltiples métodos de autenticación y verificación.
Ubicación: lib/adaptadores/servicio_autenticacion_firebase.dart
Características Principales
- Registro e inicio de sesión con email/password
- Autenticación con Google (web y móvil)
- Verificación de email automática
- Recuperación de contraseña
- Cambio de email y contraseña
- Verificación de teléfono por SMS
- Manejo de errores traducidos al español
Propiedades
Estado de Autenticación
Stream<User?> get authStateChanges
true si hay un usuario autenticado.
Retorna true si el email del usuario está verificado.
Verifica si el usuario inició sesión con Google.
bool get telefonoVerificado
true si el usuario tiene un teléfono verificado.
String? get telefonoVerificadoNumero
Métodos de Registro y Login
registrarConEmail
Future<UserCredential?> registrarConEmail({
required String email,
required String password,
String? urlRedireccion,
})
email - Correo electrónico del usuariopassword - Contraseña (mínimo 6 caracteres)urlRedireccion - URL opcional para redirección después de verificar email
Excepciones:
email-already-in-use - El correo ya está registradoweak-password - Contraseña muy débilinvalid-email - Formato de email inválido
Ejemplo:
try {
final userCredential = await servicioAuth.registrarConEmail(
email: '[email protected]',
password: 'password123',
urlRedireccion: 'https://miapp.com/verificado',
);
print('Usuario registrado: ${userCredential?.user?.uid}');
print('Email de verificación enviado');
} catch (e) {
print('Error al registrar: $e');
}
iniciarSesionConEmail
Future<UserCredential?> iniciarSesionConEmail({
required String email,
required String password,
})
user-not-found - No existe cuenta con ese emailwrong-password - Contraseña incorrectatoo-many-requests - Demasiados intentos fallidos
Ejemplo:
try {
final userCredential = await servicioAuth.iniciarSesionConEmail(
email: '[email protected]',
password: 'password123',
);
if (userCredential != null) {
print('Sesión iniciada correctamente');
}
} catch (e) {
print('Error al iniciar sesión: $e');
}
iniciarSesionConGoogle
Future<UserCredential?> iniciarSesionConGoogle()
- Web: Usa
signInWithPopup con selector de cuentas forzado
- Móvil: Usa el paquete
google_sign_in
Ejemplo:
try {
final userCredential = await servicioAuth.iniciarSesionConGoogle();
if (userCredential != null) {
final user = userCredential.user;
print('Bienvenido ${user?.displayName}');
print('Email: ${user?.email}');
} else {
print('El usuario canceló el inicio de sesión');
}
} catch (e) {
print('Error con Google Sign-In: $e');
}
cerrarSesion
Future<void> cerrarSesion()
await servicioAuth.cerrarSesion();
print('Sesión cerrada');
Verificación de Email
enviarEmailVerificacion
Future<void> enviarEmailVerificacion({String? urlRedireccion})
urlRedireccion - URL a la que se redirige después de verificar (default: URL de Firebase)
Ejemplo:
try {
await servicioAuth.enviarEmailVerificacion(
urlRedireccion: 'https://miapp.com/verificado',
);
print('Email de verificación enviado');
} catch (e) {
print('Error al enviar email: $e');
}
recargarUsuario
Future<bool> recargarUsuario()
true si el email está verificado
Ejemplo:
// Después de que el usuario verificó su email
final verificado = await servicioAuth.recargarUsuario();
if (verificado) {
print('Email verificado exitosamente');
}
Recuperación de Contraseña
enviarEmailRecuperacion
Future<void> enviarEmailRecuperacion({
required String email,
String? urlRedireccion,
})
try {
await servicioAuth.enviarEmailRecuperacion(
email: '[email protected]',
urlRedireccion: 'https://miapp.com/reset-password',
);
print('Email de recuperación enviado');
} catch (e) {
print('Error: $e');
}
Cambio de Email y Contraseña
cambiarEmail
Future<void> cambiarEmail({
required String nuevoEmail,
required String passwordActual,
})
- Reautentica al usuario con su contraseña actual
- Envía email de verificación al nuevo correo
- El usuario debe verificar el nuevo email
Ejemplo:
try {
await servicioAuth.cambiarEmail(
nuevoEmail: '[email protected]',
passwordActual: 'password123',
);
print('Email de verificación enviado al nuevo correo');
} catch (e) {
print('Error al cambiar email: $e');
}
cambiarPassword
Future<void> cambiarPassword({
required String passwordActual,
required String passwordNueva,
})
try {
await servicioAuth.cambiarPassword(
passwordActual: 'password123',
passwordNueva: 'nuevaPassword456',
);
print('Contraseña actualizada');
} catch (e) {
if (e.toString().contains('wrong-password')) {
print('La contraseña actual es incorrecta');
}
}
Verificación de Teléfono
enviarCodigoSMS
Future<bool> enviarCodigoSMS({
required String numeroTelefono,
required Function(String) onCodeSent,
required Function(String) onError,
required Function() onAutoVerified,
})
numeroTelefono - Número en formato local o E.164onCodeSent - Callback cuando el código se envíaonError - Callback en caso de erroronAutoVerified - Callback si se verifica automáticamente (Android)
Formato de Teléfono:
- Formatos aceptados:
11 1234-5678, 011 15-1234-5678, +5491112345678
- Se normaliza automáticamente a formato E.164
Ejemplo:
await servicioAuth.enviarCodigoSMS(
numeroTelefono: '11 1234-5678',
onCodeSent: (mensaje) {
print(mensaje); // "Código enviado por SMS"
// Mostrar campo para ingresar código
},
onError: (error) {
print('Error: $error');
},
onAutoVerified: () {
print('Verificación automática exitosa (Android)');
},
);
verificarCodigoSMS
Future<void> verificarCodigoSMS({required String codigo})
codigo - Código de 6 dígitos recibido por SMS
Excepciones:
invalid-verification-code - Código incorrectosession-expired - La verificación expirócredential-already-in-use - El número ya está vinculado a otra cuenta
Ejemplo:
try {
await servicioAuth.verificarCodigoSMS(codigo: '123456');
print('Teléfono verificado exitosamente');
print('Número: ${servicioAuth.telefonoVerificadoNumero}');
} catch (e) {
print('Error al verificar código: $e');
}
desvincularTelefono
Future<void> desvincularTelefono()
validarTelefonoArgentino
Map<String, dynamic> validarTelefonoArgentino(String telefono)
{
'valido': true/false,
'formateado': '+5491112345678', // formato E.164
'nacional': '011 15-1234-5678', // formato de visualización
'error': 'mensaje de error' // si valido = false
}
final resultado = servicioAuth.validarTelefonoArgentino('11 1234-5678');
if (resultado['valido']) {
print('Formato E.164: ${resultado["formateado"]}');
print('Formato nacional: ${resultado["nacional"]}');
} else {
print('Error: ${resultado["error"]}');
}
obtenerInfoUsuario
Map<String, dynamic>? obtenerInfoUsuario()
{
'uid': 'firebase-uid',
'email': '[email protected]',
'nombre': 'Nombre Usuario',
'foto': 'https://...',
'emailVerificado': true/false,
'esGoogle': true/false,
}
final info = servicioAuth.obtenerInfoUsuario();
if (info != null) {
print('Usuario: ${info["nombre"]}');
print('Email: ${info["email"]}');
print('Verificado: ${info["emailVerificado"]}');
print('Login Google: ${info["esGoogle"]}');
}
Manejo de Errores
El servicio traduce automáticamente los códigos de error de Firebase a mensajes en español:
| Código Firebase | Mensaje en Español |
|---|
email-already-in-use | Este correo ya está registrado |
weak-password | La contraseña debe tener al menos 6 caracteres |
invalid-email | El correo electrónico no es válido |
user-not-found | No existe una cuenta con este correo |
wrong-password | Contraseña incorrecta |
requires-recent-login | Por seguridad, inicia sesión nuevamente |
too-many-requests | Demasiados intentos. Intenta más tarde |
user-disabled | Esta cuenta ha sido deshabilitada |
invalid-credential | Credenciales inválidas |
try {
await servicioAuth.iniciarSesionConEmail(
email: email,
password: password,
);
} catch (e) {
// Los errores ya vienen traducidos
mostrarMensajeError(e.toString());
}
Flujo de Uso Típico
Registro de Usuario
// 1. Registrar
final userCredential = await servicioAuth.registrarConEmail(
email: email,
password: password,
);
// 2. Usuario registrado, email de verificación enviado automáticamente
print('Revisa tu email para verificar tu cuenta');
// 3. Esperar a que el usuario verifique su email
// 4. Recargar para actualizar estado
final verificado = await servicioAuth.recargarUsuario();
if (verificado) {
// Continuar con el flujo de la app
} else {
// Mostrar pantalla de verificación pendiente
}
Login con Google
final userCredential = await servicioAuth.iniciarSesionConGoogle();
if (userCredential != null) {
final user = userCredential.user;
// El email de Google ya está verificado automáticamente
if (servicioAuth.emailVerificado) {
// Redirigir a la pantalla principal
}
}
Verificación de Teléfono
// 1. Enviar código SMS
await servicioAuth.enviarCodigoSMS(
numeroTelefono: telefono,
onCodeSent: (_) {
setState(() => mostrarCampoCodigoSMS = true);
},
onError: (error) {
mostrarError(error);
},
onAutoVerified: () {
// En Android puede verificarse automáticamente
print('Verificado automáticamente');
},
);
// 2. Usuario ingresa el código
// 3. Verificar código
await servicioAuth.verificarCodigoSMS(codigo: codigoIngresado);
// 4. Teléfono verificado
print('Teléfono: ${servicioAuth.telefonoVerificadoNumero}');
Integración con Firebase
Configuración Requerida
-
Firebase Authentication habilitado en la consola
-
Proveedores activos:
- Email/Password
- Google Sign-In
- Phone (SMS)
-
Para SMS (verificación de teléfono):
- Configurar método de facturación en Firebase
- Habilitar Phone Authentication
- En producción: Configurar App Verification para iOS
Dependencias
dependencies:
firebase_auth: ^latest
google_sign_in: ^latest
cloud_firestore: ^latest
Consideraciones de Seguridad
Las operaciones sensibles como cambiarEmail y cambiarPassword requieren reautenticación reciente del usuario. Si el usuario ha estado autenticado por mucho tiempo, Firebase puede lanzar error requires-recent-login.
Para operaciones críticas, solicita al usuario que vuelva a ingresar su contraseña antes de intentar el cambio.
Ver También
