dot net sdk
Released Version 11.6.0
El contenedor de registro de clientes LoginRadius ASP.NET proporciona acceso a la API de la plataforma de gestión de identidad LoginRadius.
LoginRadius es una plataforma de gestión de identidades que simplifica el registro de usuarios y al mismo tiempo protege los datos. La plataforma LoginRadius simplifica y asegura su proceso de registro de usuario, aumenta la conversión con el inicio de sesión social que combina 30 plataformas sociales importantes y ofrece una solución completa con el registro de usuario tradicional. Puede recopilar una gran cantidad de datos de perfil de usuario mediante el inicio de sesión social o el registro de usuario tradicional.
LoginRadius lo centraliza todo en un solo lugar, lo que facilita su administración y acceso. Integre fácilmente LoginRadius con todas sus aplicaciones de terceros, como MailChimp, Google Analytics, Livefyre y muchas más, facilitando el uso de los datos que está capturando.
LoginRadius ayuda a las empresas a impulsar la participación de los usuarios en su plataforma web/móvil, administrar identidades en línea, utilizar las redes sociales para marketing, capturar datos precisos de los consumidores y obtener información social única sobre su base de clientes.
Por favor visite aquí para obtener más información.
Esta documentación supone que ha trabajado en la implementación del lado del cliente para configurar sus interfaces de registro de usuario de LoginRadius que servirán para el proceso inicial de registro e inicio de sesión. Los detalles sobre esto se pueden encontrar en la guía de introducción.
**Nota: **LoginRadius utiliza el protocolo TLS 1.2 estándar de la industria, diseñado para ayudar a proteger la privacidad de la información comunicada a través de Internet. Para utilizar LoginRadius .Net SDK, agregue el siguiente código antes de crear una instancia de su servicio web en el archivo Global.asax de su proyecto.
ServicePointManager . SecurityProtocol = SecurityProtocolType . Tls | SecurityProtocolType . Tls11 | SecurityProtocolType . Tls12 ; Descargue el SDK .Net de registro de usuario desde Github
Copie los archivos LoginRadiusSDK.V2.dll y LoginRadiusSDK.V2.pdb en el directorio de Referencias de su proyecto ASP.NET.
O
PM> Install-Package LoginRadiusSDK.NET
O
Abra la solución usando Visual Studio 2019.
Cree el proyecto y observe dónde se encuentra el archivo .nupkg.
Acceda a la configuración del Administrador de paquetes NuGet e importe el directorio donde se encuentra el archivo .nupkg.
Acceda a la herramienta "Administrar paquetes NuGet para soluciones...", cambie la fuente a la fuente recién creada y seleccione e instale el SDK de LoginRadius.
A continuación, incluya los siguientes espacios de nombres en su proyecto:
using LoginRadiusSDK . V2 . Api ;
using LoginRadiusSDK . V2 . Models ; Antes de usar el SDK, debe inicializarlo con la ayuda del siguiente código: Clave API y secreto de su sitio LoginRadius. Esta información se puede encontrar en su cuenta LoginRadius como se describe aquí
LoginRadiusSdkGlobalConfig . ApiKey = "__API_KEY__" ;
LoginRadiusSdkGlobalConfig . ApiSecret = "__API_SECRET__" ;
LoginRadiusSdkGlobalConfig . AppName = "__LoginRadius_APP_NAME__" ;
LoginRadiusSdkGlobalConfig . ApiRequestSigning = "false" ;
LoginRadiusSdkGlobalConfig . ConnectionTimeout = 30000 ; // Connection Timeout (milliseconds)
LoginRadiusSdkGlobalConfig . ProxyAddress = "__HTTP_PROXY_ADDRESS__" ; // Absolute Proxy URI
LoginRadiusSdkGlobalConfig . ProxyCredentials = "__HTTP_PROXY_CREDENTIALS__" ; // Proxy Credentials in the format 'USERNAME:PASSWORD'
LoginRadiusSdkGlobalConfig . RequestRetries = 3 ;
LoginRadiusSdkGlobalConfig . ApiRegion = "_region_" ;
LoginRadiusSdkGlobalConfig . DomainName = "https://api.loginradius.com/" ;O
Para ASP.NET. en web.config :
< configSections >
< section name = " loginradius " type = " LoginRadiusSDK.V2.SDKConfigHandler, LoginRadiusSDK.V2 " />
</ configSections >
<!-- LoginRadius SDK settings -->
< loginradius >
< settings >
< add name = " apiKey " value = " __API_KEY__ " />
< add name = " apiSecret " value = " __API_SECRET__ " />
< add name = " appName " value = " __LoginRadius_APP_NAME__ " />
< add name = " ApiRequestSigning " value = " false " />
< add name = " proxyAddress " value = " __HTTP_PROXY_ADDRESS__ " /> <!-- Absolute Proxy URI -->
< add name = " proxyCredentials " value = " __HTTP_PROXY_CREDENTIALS__ " /> <!-- Proxy Credentials in the format 'USERNAME:PASSWORD' -->
< add name = " connectionTimeout " value = " __HTTP_CONNECTION_TIMEOUT__ " /> <!-- Connection Timeout (milliseconds) -->
< add name = " requestRetries " value = " __HTTP_CONNECTION_RETRY__ " />
< add name = " apiRegion " value = " _region_ " />
< add name = " domainName " value = " https://api.loginradius.com/ " />
</ settings >
</ loginradius >O
Para .NET Core, en appsettings.json :
JSON
"loginradius" : {
"apiKey" : " __API_KEY__ " ,
"apiSecret" : " __API_SECRET__ " ,
"appName" : " __LoginRadius_APP_NAME__ " ,
"ApiRequestSigning" : " false " ,
"proxyAddress" : " __HTTP_PROXY_ADDRESS__ " ,
"proxyCredentials" : " __HTTP_PROXY_CREDENTIAL__ " ,
"connectionTimeout" : " __HTTP_CONNECTION_TIMEOUT__ " ,
"requestRetries" : " __HTTP_CONNECTION_RETRY__ " ,
"apiRegion" : " _region_ " ,
"domainName" : " https://api.loginradius.com/ "
}
Al inicializar el SDK, opcionalmente especifique un dominio personalizado. Ejemplo: en appsettings.json, agregue la siguiente declaración:
"domainName" : " https://api.loginradius.com/ "Al inicializar el SDK, opcionalmente puede especificar la habilitación de esta función. Habilitar esta característica significa que el cliente no necesita pasar un secreto de API en una solicitud de API. En cambio, pueden pasar un valor hash generado dinámicamente. Esta función también garantizará que el mensaje no sea manipulado durante el tránsito cuando alguien llame a nuestras API. Ejemplo: en appsettings.json, agregue la siguiente declaración:
"ApiRequestSigning" : " false "X-Origin-IP LoginRadius le permite agregar X-Origin-IP en sus encabezados y determina la dirección IP de la solicitud del cliente; esto también puede ser útil para superar las discrepancias analíticas donde los análisis dependen de los datos del encabezado.
"originIp" : " <Client-Ip-Address> " Lista de API en esta sección:
PUT: Perfil de actualización de autenticación por token
PUT: Cuenta de desbloqueo de autenticación mediante token de acceso
PUT: autenticación de correo electrónico de verificación mediante OTP
PUT: Autenticación Restablecer contraseña mediante respuesta de seguridad y correo electrónico
PUT: Autenticación Restablecer contraseña mediante respuesta de seguridad y teléfono
PUT: Autenticación Restablecer contraseña por respuesta de seguridad y nombre de usuario
PUT: Autenticación Restablecer contraseña mediante Restablecer token
PUT: Autenticación Restablecer contraseña por OTP
PUT: Autenticación Restablecer contraseña por OTP y nombre de usuario
PUT: Contraseña de cambio de autenticación
PUBLICACIÓN: Identidades sociales de enlace de autenticación
PUBLICACIÓN: Enlace de autenticación de identidades sociales mediante ping
PUT: Establecer autenticación o cambiar nombre de usuario
PUT: verificación de correo electrónico de reenvío de autenticación
PUBLICACIÓN: Autenticación Agregar correo electrónico
POST: Inicio de sesión de autenticación por correo electrónico
POST: Inicio de sesión de autenticación por nombre de usuario
PUBLICACIÓN: Autenticación Olvidé mi contraseña
POST: Registro de usuario de autenticación por correo electrónico
PUBLICACIÓN: Registro de usuario de autenticación mediante Captcha
OBTENER: Reciba preguntas de seguridad por correo electrónico
OBTENER: Obtenga preguntas de seguridad por nombre de usuario
OBTENER: Obtenga preguntas de seguridad por teléfono
OBTENER: Obtenga preguntas de seguridad mediante token de acceso
OBTENER: token de acceso de validación de autenticación
OBTENER: Invalidar token de acceso
OBTENER: Información del token de acceso
OBTENER: Autenticación Leer todos los perfiles por token
OBTENER: Autenticación Enviar correo electrónico de bienvenida
OBTENER: Autenticación Eliminar cuenta
OBTENER: Obtener perfil mediante ping
OBTENER: Autenticación Verificar disponibilidad de correo electrónico
OBTENER: Correo electrónico de verificación de autenticación
OBTENER: Autenticación de identidad social
OBTENER: Autenticación Verificar la disponibilidad del nombre de usuario
OBTENER: Política de privacidad de autenticación Aceptar
OBTENER: Historial de la política de privacidad de autenticación por token de acceso
OBTENER: Autenticación enviar correo electrónico de verificación para vincular perfiles sociales
ELIMINAR: Autenticación Eliminar cuenta con confirmación por correo electrónico
ELIMINAR: Autenticación Eliminar correo electrónico
ELIMINAR: Autenticación y desvinculación de identidades sociales
Esta API se utiliza para actualizar el perfil del usuario pasando el access_token. Más información
var accessToken = "accessToken" ; //Required
UserProfileUpdateModel userProfileUpdateModel = new UserProfileUpdateModel {
FirstName = "<FirstName>" ,
LastName = "<LastName>"
} ; //Required
var emailTemplate = "emailTemplate" ; //Optional
string fields = null ; //Optional
; //Optional
var smsTemplate = "smsTemplate" ; //Optional
var verificationUrl = "verificationUrl" ; //Optional
var isVoiceOtp = false ; //Optional
var options = "options" ; //Optional
var apiResponse = new AuthenticationApi ( ) . UpdateProfileByAccessToken ( accessToken , userProfileUpdateModel , emailTemplate , fields , smsTemplate , verificationUrl , isVoiceOtp , options ) . Result ; Esta API se utiliza para permitir que un cliente con un token de acceso válido desbloquee su cuenta siempre que supere con éxito los desafíos de Bot Protection. Los tipos de bloqueo Bloquear o Suspender no son aplicables para esta API. Para obtener detalles adicionales, consulte nuestra documentación de Configuración de seguridad de autenticación. Solo debe pasar los parámetros de publicación que corresponden a los desafíos solicitados. Más información
var accessToken = "accessToken" ; //Required
UnlockProfileModel unlockProfileModel = new UnlockProfileModel {
G_recaptcha_response = "<G-recaptcha-response>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . UnlockAccountByToken ( accessToken , unlockProfileModel ) . Result ; Esta API se utiliza para verificar el correo electrónico del usuario cuando el flujo de verificación de correo electrónico OTP está habilitado; tenga en cuenta que debe comunicarse con LoginRadius para habilitar esta función. Más información
EmailVerificationByOtpModel emailVerificationByOtpModel = new EmailVerificationByOtpModel {
Email = "<Email>" ,
Otp = "<Otp>"
} ; //Required
string fields = null ; //Optional
var url = "url" ; //Optional
var welcomeEmailTemplate = "welcomeEmailTemplate" ; //Optional
var apiResponse = new AuthenticationApi ( ) . VerifyEmailByOTP ( emailVerificationByOtpModel , fields , url , welcomeEmailTemplate ) . Result ; Esta API se utiliza para restablecer la contraseña de la cuenta especificada mediante pregunta de seguridad Más información
ResetPasswordBySecurityAnswerAndEmailModel resetPasswordBySecurityAnswerAndEmailModel = new ResetPasswordBySecurityAnswerAndEmailModel {
Email = "<Email>" ,
Password = "<Password>" ,
SecurityAnswer = new Dictionary < String , String > {
[ "QuestionID" ] = "Answer"
}
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordBySecurityAnswerAndEmail ( resetPasswordBySecurityAnswerAndEmailModel ) . Result ; Esta API se utiliza para restablecer la contraseña de la cuenta especificada mediante pregunta de seguridad Más información
ResetPasswordBySecurityAnswerAndPhoneModel resetPasswordBySecurityAnswerAndPhoneModel = new ResetPasswordBySecurityAnswerAndPhoneModel {
Password = "<Password>" ,
Phone = "<Phone>" ,
SecurityAnswer = new Dictionary < String , String > {
[ "QuestionID" ] = "Answer"
}
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordBySecurityAnswerAndPhone ( resetPasswordBySecurityAnswerAndPhoneModel ) . Result ; Esta API se utiliza para restablecer la contraseña de la cuenta especificada mediante pregunta de seguridad Más información
ResetPasswordBySecurityAnswerAndUserNameModel resetPasswordBySecurityAnswerAndUserNameModel = new ResetPasswordBySecurityAnswerAndUserNameModel {
Password = "<Password>" ,
SecurityAnswer = new Dictionary < String , String > {
[ "QuestionID" ] = "Answer"
} ,
UserName = "<UserName>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordBySecurityAnswerAndUserName ( resetPasswordBySecurityAnswerAndUserNameModel ) . Result ; Esta API se utiliza para establecer una nueva contraseña para la cuenta especificada. Más información
ResetPasswordByResetTokenModel resetPasswordByResetTokenModel = new ResetPasswordByResetTokenModel {
Password = "<Password>" ,
ResetToken = "<ResetToken>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordByResetToken ( resetPasswordByResetTokenModel ) . Result ; Esta API se utiliza para establecer una nueva contraseña para la cuenta especificada. Más información
ResetPasswordByEmailAndOtpModel resetPasswordByEmailAndOtpModel = new ResetPasswordByEmailAndOtpModel {
Email = "<Email>" ,
Otp = "<Otp>" ,
Password = "<Password>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordByEmailOTP ( resetPasswordByEmailAndOtpModel ) . Result ; Esta API se utiliza para establecer una nueva contraseña para la cuenta especificada si utiliza el nombre de usuario como identificador único en su flujo de trabajo. Más información
ResetPasswordByUserNameModel resetPasswordByUserNameModel = new ResetPasswordByUserNameModel {
Otp = "<Otp>" ,
Password = "<Password>" ,
UserName = "<UserName>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordByOTPAndUserName ( resetPasswordByUserNameModel ) . Result ; Esta API se utiliza para cambiar la contraseña de la cuenta según la contraseña anterior Más información
var accessToken = "accessToken" ; //Required
var newPassword = "newPassword" ; //Required
var oldPassword = "oldPassword" ; //Required
var apiResponse = new AuthenticationApi ( ) . ChangePassword ( accessToken , newPassword , oldPassword ) . Result ; Esta API se utiliza para vincular una cuenta de proveedor social con la cuenta especificada según el token de acceso y el token de acceso del usuario de proveedores sociales. Más información
var accessToken = "accessToken" ; //Required
var candidateToken = "candidateToken" ; //Required
var apiResponse = new AuthenticationApi ( ) . LinkSocialIdentities ( accessToken , candidateToken ) . Result ; Esta API se utiliza para vincular una cuenta de proveedor de redes sociales con una cuenta de LoginRadius existente en función del ping y el token de acceso de usuario de los proveedores de redes sociales. Más información
var accessToken = "accessToken" ; //Required
var clientGuid = "clientGuid" ; //Required
var apiResponse = new AuthenticationApi ( ) . LinkSocialIdentitiesByPing ( accessToken , clientGuid ) . Result ; Esta API se utiliza para configurar o cambiar el nombre de usuario mediante token de acceso. Más información
var accessToken = "accessToken" ; //Required
var username = "username" ; //Required
var apiResponse = new AuthenticationApi ( ) . SetOrChangeUserName ( accessToken , username ) . Result ; Esta API reenvía el correo electrónico de verificación al usuario. Más información
var email = "email" ; //Required
var emailTemplate = "emailTemplate" ; //Optional
var verificationUrl = "verificationUrl" ; //Optional
var apiResponse = new AuthenticationApi ( ) . AuthResendEmailVerification ( email , emailTemplate , verificationUrl ) . Result ; Esta API se utiliza para agregar correos electrónicos adicionales a la cuenta de un usuario. Más información
var accessToken = "accessToken" ; //Required
var email = "email" ; //Required
var type = "type" ; //Required
var emailTemplate = "emailTemplate" ; //Optional
var verificationUrl = "verificationUrl" ; //Optional
var apiResponse = new AuthenticationApi ( ) . AddEmail ( accessToken , email , type , emailTemplate , verificationUrl ) . Result ; Esta API recupera una copia de los datos del usuario según el correo electrónico Más información
EmailAuthenticationModel emailAuthenticationModel = new EmailAuthenticationModel {
Email = "<Email>" ,
Password = "<Password>"
} ; //Required
var emailTemplate = "emailTemplate" ; //Optional
string fields = null ; //Optional
var loginUrl = "loginUrl" ; //Optional
var verificationUrl = "verificationUrl" ; //Optional
var apiResponse = new AuthenticationApi ( ) . LoginByEmail ( emailAuthenticationModel , emailTemplate , fields , loginUrl , verificationUrl ) . Result ; Esta API recupera una copia de los datos del usuario según el nombre de usuario Más información
UserNameAuthenticationModel userNameAuthenticationModel = new UserNameAuthenticationModel {
Password = "<Password>" ,
Username = "<Username>"
} ; //Required
var emailTemplate = "emailTemplate" ; //Optional
string fields = null ; //Optional
var loginUrl = "loginUrl" ; //Optional
var verificationUrl = "verificationUrl" ; //Optional
var apiResponse = new AuthenticationApi ( ) . LoginByUserName ( userNameAuthenticationModel , emailTemplate , fields , loginUrl , verificationUrl ) . Result ; Esta API se utiliza para enviar la URL de restablecimiento de contraseña a una cuenta específica. Nota: Si tiene habilitado el flujo de trabajo Nombre de usuario, puede reemplazar el parámetro 'correo electrónico' con 'nombre de usuario' Más información
var email = "email" ; //Required
var resetPasswordUrl = "resetPasswordUrl" ; //Required
var emailTemplate = "emailTemplate" ; //Optional
var apiResponse = new AuthenticationApi ( ) . ForgotPassword ( email , resetPasswordUrl , emailTemplate ) . Result ; Esta API crea un usuario en la base de datos y envía un correo electrónico de verificación al usuario. Más información
