Cl.Core.Auth 1.1.0

Acerca de Cl.Core.Auth

Permite aplicar las funcionalidades de recuperación y cambio de contraseñas para un API estándar y con conexión a respectivo componente de login.

¿Qué resuelve?

La implementación alineada y concisa de funcionalidades de recuperación y cambio de contraseñas.

Resumen de versión

Correcciones (Fixes)

• Modificados los metodos para adaptase al cambio donde requieren la inyeccion de IServices

Rutinas

SendRecoveryEmail: System.String

• Microsoft.Extensions.Configuration.IConfiguration _configuration: interface de configuración proporcionada por .net core
• System.Collections.Generic.Dictionary<System.String, System.String> claims: permite incluir una lista de claims para incluir en el token generado.
• Cl.Core.Structures.Classes.Email.EmailCredential _emailCredential: modelo de credenciales usado para el envío del correo de recuperación.
• Cl.Core.Structures.Classes.Rebound.CLContext<Cl.Core.Structures.Classes.LocalEntities.CLSingleValue<System.String>> _emailValidateResponse: resultado de aplicar el método ValidateRecovery.
• System.String _recoveryURL: URL para UI a enviar en el correo de recuperación de contraseña.

Realiza la creación de token de validación y envío del correo de recuperación.

Ejemplo:

// Debe completar los datos de acceso al correo según los requisitos de su implementación.
string token = Cl.Core.Auth.Services.SendRecoveryEmail(
   _configuration,
   new System.Collections.Generic.Dictionary<System.String, System.String>(),
   new Cl.Core.Structures.Classes.Email.EmailCredential()
   {
       Subject = "Cambio de contraseña",
       User = "Clavisco",
       Account = "example@clavisco.com",
       Host = "outlook.office365.com",
       Password = "Contraseña de acceso al correo",
       Port = 587,
       Ssl = true,
       IdCompany = -1
   },
   Cl.Core.Auth.Services.ValidateRecovery<MainDbContext>("resourceName", "example@clavisco.com"),
   "https://example.clavisco.com/login");
// El token resultante lo debe almacenar según los detalles de implementación que desee utilizar.
// Se recomienda guardarlo en la tabla de usuario junto con una fecha de expiración.

ValidateRecovery<T>: Cl.Core.Structures.Classes.Rebound.CLContext<Cl.Core.Structures.Classes.LocalEntities.CLSingleValue<System.String>>

• Cl.Core.Db.IServices _services: instancia de inyeccion de IServices
• Cl.Core.Structures.Interfaces.Common.ILogManager _logManager: instancia de inyeccion de ILogManager
• System.String _spValidateEmail: Nombre del recurso utilizado para validar que el correo exista en la base de datos.
• System.String _email: Correo que se verificará para la recuperación de contraseña.

Valida que el correo enviado exista en la base de datos para realizar la recuperación.

Ejemplo:

// El modelo retornado debe traer el correo en la Data si el mismo es válido.
Cl.Core.Auth.Services.ValidateRecovery<MainDbContext>(_services, _logManager, "resourceName", "example@clavisco.com");

Parámetros del recurso

• @Email: NVARCHAR(MAX)

ChangePassword<T, U>: Cl.Core.Structures.Classes.Rebound.CLContext<System.Collections.Generic.IEnumerable<T>>

Cl.Core.Db.IServices _services: instancia de inyeccion de IServices Cl.Core.Structures.Interfaces.Common.ILogManager _logManager: instancia de inyeccion de ILogManager System.String _spChangePassword: Nombre del recurso utilizado para cambiar la contraseña mediante proceso de recuperación. System.String _token: Token utilizado para validar el cambio de contraseña recuperado. System.String _newPassword: Nueva contraseña para actualizar en el correo recuperado.

Realiza el cambio de contraseña basado en el token proporcionado.

Ejemplo:

Cl.Core.Auth.Services.ChangePassword<User, MainDbContext>(_services, _logManager, "resourceName", "Token creado al enviar correo de recuperación", "nueva contraseña");`
// El modelo "User" puede variar según las necesidades de retorno del proceso de cambio de contraseña de recuperación.

Parámetros del recurso

• @Token: NVARCHAR(MAX)
• @Email: NVARCHAR(MAX)
• @NewPassword: NVARCHAR(MAX)

ChangePassword<T, U>: Cl.Core.Structures.Classes.Rebound.CLContext<System.Collections.Generic.IEnumerable<T>>

• Cl.Core.Db.IServices _services: instancia de inyeccion de IServices
• Cl.Core.Structures.Interfaces.Common.ILogManager _logManager: instancia de inyeccion de ILogManager
• System.String _spChangePassword: Nombre del recurso utilizado para cambiar la contraseña.
• System.String _email: Correo al que se realiza el cambio de contraseña.
• System.String _oldPassword: Contraseña anterior.
• System.String _newPassword: Nueva contraseña.

Realiza el cambio de contraseña para el correo especificado.

Ejemplo:

Cl.Core.Auth.Services.ChangePassword<User, MainDbContext>(_services, _logManager, "resourceName", "example@clavisco.com", "contraseña anterior", "nueva contraseña");
// El modelo "User" puede variar según las necesidades de retorno del proceso de cambio de contraseña.

Parámetros del recurso

• @Email: NVARCHAR(MAX)
• @OldPassword: NVARCHAR(MAX)
• @NewPassword: NVARCHAR(MAX)

Clavis Consultores ©