dot net sdk
Released Version 11.6.0
Der LoginRadius ASP.NET-Kundenregistrierungs-Wrapper bietet Zugriff auf die LoginRadius Identity Management Platform-API.
LoginRadius ist eine Identitätsmanagementplattform, die die Benutzerregistrierung vereinfacht und gleichzeitig Daten schützt. Die LoginRadius-Plattform vereinfacht und sichert Ihren Benutzerregistrierungsprozess, steigert die Konvertierung mit Social Login, das 30 wichtige soziale Plattformen kombiniert, und bietet mit der traditionellen Benutzerregistrierung eine Komplettlösung. Sie können eine Fülle von Benutzerprofildaten über Social Login oder traditionelle Benutzerregistrierung sammeln.
LoginRadius zentralisiert alles an einem Ort und erleichtert so die Verwaltung und den Zugriff. Integrieren Sie LoginRadius ganz einfach in alle Ihre Drittanbieteranwendungen wie MailChimp, Google Analytics, Livefyre und viele mehr, um die Nutzung der von Ihnen erfassten Daten zu vereinfachen.
LoginRadius hilft Unternehmen, die Benutzerinteraktion auf ihrer Web-/Mobilplattform zu steigern, Online-Identitäten zu verwalten, soziale Medien für Marketing zu nutzen, genaue Verbraucherdaten zu erfassen und einzigartige soziale Einblicke in ihren Kundenstamm zu erhalten.
Weitere Informationen finden Sie hier.
In dieser Dokumentation wird davon ausgegangen, dass Sie die clientseitige Implementierung durchgearbeitet haben, um Ihre LoginRadius-Benutzerregistrierungsschnittstellen einzurichten, die für den anfänglichen Registrierungs- und Anmeldevorgang dienen. Details hierzu finden Sie im Leitfaden „Erste Schritte“.
**Hinweis: **LoginRadius verwendet das Industriestandardprotokoll TLS 1.2, das zum Schutz der Privatsphäre der über das Internet übermittelten Informationen beitragen soll. Um das LoginRadius .Net SDK zu verwenden, fügen Sie den folgenden Code hinzu, bevor Sie Ihren Webdienst in der Global.asax Datei Ihres Projekts instanziieren.
ServicePointManager . SecurityProtocol = SecurityProtocolType . Tls | SecurityProtocolType . Tls11 | SecurityProtocolType . Tls12 ; Laden Sie das .Net SDK für die Benutzerregistrierung von Github herunter
Kopieren Sie die Dateien LoginRadiusSDK.V2.dll und LoginRadiusSDK.V2.pdb in das Referenzverzeichnis Ihres ASP.NET-Projekts.
ODER
PM> Install-Package LoginRadiusSDK.NET
ODER
Öffnen Sie die Lösung mit Visual Studio 2019.
Erstellen Sie das Projekt und notieren Sie, wo sich die .nupkg-Datei befindet.
Greifen Sie auf die NuGet-Paket-Manager-Einstellungen zu und importieren Sie das Verzeichnis, in dem sich die .nupkg-Datei befindet.
Greifen Sie auf das Tool „NuGet-Pakete für Lösungen verwalten…“ zu, ändern Sie die Quelle auf die neu erstellte Quelle und wählen Sie das LoginRadius SDK aus und installieren Sie es
Fügen Sie als Nächstes die folgenden Namespaces in Ihr Projekt ein:
using LoginRadiusSDK . V2 . Api ;
using LoginRadiusSDK . V2 . Models ; Bevor Sie das SDK verwenden, müssen Sie das SDK mit Hilfe des folgenden Codes initialisieren: API-Schlüssel und Geheimnis Ihrer LoginRadius-Site. Diese Informationen finden Sie in Ihrem LoginRadius-Konto, wie hier beschrieben
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/" ;ODER
Für ASP.NET. in 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 >ODER
Für .NET Core in 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/ "
}
Geben Sie beim Initialisieren des SDK optional eine benutzerdefinierte Domäne an. Beispiel: Fügen Sie in appsettings.json die folgende Anweisung hinzu:
"domainName" : " https://api.loginradius.com/ "Bei der Initialisierung des SDK können Sie optional angeben, dass diese Funktion aktiviert wird. Durch die Aktivierung dieser Funktion muss der Kunde in einer API-Anfrage kein API-Geheimnis übergeben. Stattdessen können sie einen dynamisch generierten Hashwert übergeben. Diese Funktion stellt außerdem sicher, dass die Nachricht während der Übertragung nicht manipuliert wird, wenn jemand unsere APIs aufruft. Beispiel: Fügen Sie in appsettings.json die folgende Anweisung hinzu:
"ApiRequestSigning" : " false "Mit X-Origin-IP LoginRadius können Sie X-Origin-IP in Ihre Header einfügen und die IP-Adresse der Client-Anfrage ermitteln. Dies kann auch nützlich sein, um Analysediskrepanzen zu überwinden, wenn die Analysen von Header-Daten abhängen.
"originIp" : " <Client-Ip-Address> " Liste der APIs in diesem Abschnitt:
PUT: Auth-Update-Profil nach Token
PUT: Authentisierung des Kontos durch Zugriffstoken
PUT: E-Mail-Authentifizierung per OTP bestätigen
PUT: Auth-Passwort per Sicherheitsantwort und E-Mail zurücksetzen
PUT: Auth-Reset-Passwort per Sicherheitsantwort und Telefon
PUT: Auth-Reset-Passwort nach Sicherheitsantwort und Benutzername
PUT: Auth-Reset-Passwort durch Reset-Token
PUT: Auth-Reset-Passwort per OTP
PUT: Auth-Reset-Passwort nach OTP und Benutzername
PUT: Auth-Passwort ändern
POST: Auth-Link für soziale Identitäten
POST: Auth-Link für soziale Identitäten per Ping
PUT: Benutzernamen authentifizieren oder ändern
PUT: E-Mail-Bestätigung erneut senden
POST: E-Mail hinzufügen
POST: Auth-Login per E-Mail
POST: Auth-Login mit Benutzername
POST: Auth-Passwort vergessen
POST: Benutzerregistrierung per E-Mail authentifizieren
POST: Benutzerregistrierung per Captcha authentifizieren
GET: Sicherheitsfragen per E-Mail erhalten
GET: Sicherheitsfragen nach Benutzernamen abrufen
GET: Erhalten Sie Sicherheitsfragen per Telefon
GET: Sicherheitsfragen per Zugriffstoken abrufen
GET: Zugriffstoken authentifizieren und validieren
GET: Zugriffstoken ungültig machen
GET: Zugriff auf Token-Informationen
GET: Auth Alle Profile nach Token lesen
GET: Auth. Begrüßungs-E-Mail senden
GET: Konto löschen
GET: Profil per Ping abrufen
GET: Authentifizierung der E-Mail-Verfügbarkeit prüfen
GET: E-Mail-Authentifizierung bestätigen
GET: Soziale Identität authentifizieren
GET: Authentifizierungsprüfung der Benutzernamenverfügbarkeit
GET: Auth-Datenschutzrichtlinie Akzeptieren
GET: Datenschutzrichtlinienverlauf nach Zugriffstoken authentifizieren
GET: Auth. senden Sie eine Bestätigungs-E-Mail zum Verknüpfen sozialer Profile
LÖSCHEN: Authentifizieren Sie das Löschkonto mit E-Mail-Bestätigung
LÖSCHEN: E-Mail authentifizieren
LÖSCHEN: Authentisierung sozialer Identitäten aufheben
Diese API wird verwendet, um das Profil des Benutzers durch Übergabe des access_token zu aktualisieren. Weitere Informationen
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 ; Diese API wird verwendet, um einem Kunden mit einem gültigen access_token das Entsperren seines Kontos zu ermöglichen, sofern er die aufgeforderten Bot-Schutz-Herausforderungen erfolgreich besteht. Die Blocktypen „Block“ oder „Suspend“ sind für diese API nicht anwendbar. Weitere Details finden Sie in unserer Dokumentation zur Auth-Sicherheitskonfiguration. Sie müssen nur die Post-Parameter übergeben, die den angeforderten Herausforderungen entsprechen. Weitere Informationen
var accessToken = "accessToken" ; //Required
UnlockProfileModel unlockProfileModel = new UnlockProfileModel {
G_recaptcha_response = "<G-recaptcha-response>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . UnlockAccountByToken ( accessToken , unlockProfileModel ) . Result ; Diese API wird verwendet, um die E-Mail-Adresse des Benutzers zu überprüfen, wenn der OTP-E-Mail-Verifizierungsablauf aktiviert ist. Bitte beachten Sie, dass Sie sich an LoginRadius wenden müssen, um diese Funktion zu aktivieren. Weitere Informationen
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 ; Diese API wird verwendet, um das Passwort für das angegebene Konto per Sicherheitsfrage zurückzusetzen. Weitere Informationen
ResetPasswordBySecurityAnswerAndEmailModel resetPasswordBySecurityAnswerAndEmailModel = new ResetPasswordBySecurityAnswerAndEmailModel {
Email = "<Email>" ,
Password = "<Password>" ,
SecurityAnswer = new Dictionary < String , String > {
[ "QuestionID" ] = "Answer"
}
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordBySecurityAnswerAndEmail ( resetPasswordBySecurityAnswerAndEmailModel ) . Result ; Diese API wird verwendet, um das Passwort für das angegebene Konto per Sicherheitsfrage zurückzusetzen. Weitere Informationen
ResetPasswordBySecurityAnswerAndPhoneModel resetPasswordBySecurityAnswerAndPhoneModel = new ResetPasswordBySecurityAnswerAndPhoneModel {
Password = "<Password>" ,
Phone = "<Phone>" ,
SecurityAnswer = new Dictionary < String , String > {
[ "QuestionID" ] = "Answer"
}
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordBySecurityAnswerAndPhone ( resetPasswordBySecurityAnswerAndPhoneModel ) . Result ; Diese API wird verwendet, um das Passwort für das angegebene Konto per Sicherheitsfrage zurückzusetzen. Weitere Informationen
ResetPasswordBySecurityAnswerAndUserNameModel resetPasswordBySecurityAnswerAndUserNameModel = new ResetPasswordBySecurityAnswerAndUserNameModel {
Password = "<Password>" ,
SecurityAnswer = new Dictionary < String , String > {
[ "QuestionID" ] = "Answer"
} ,
UserName = "<UserName>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordBySecurityAnswerAndUserName ( resetPasswordBySecurityAnswerAndUserNameModel ) . Result ; Diese API wird verwendet, um ein neues Passwort für das angegebene Konto festzulegen. Weitere Informationen
ResetPasswordByResetTokenModel resetPasswordByResetTokenModel = new ResetPasswordByResetTokenModel {
Password = "<Password>" ,
ResetToken = "<ResetToken>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordByResetToken ( resetPasswordByResetTokenModel ) . Result ; Diese API wird verwendet, um ein neues Passwort für das angegebene Konto festzulegen. Weitere Informationen
ResetPasswordByEmailAndOtpModel resetPasswordByEmailAndOtpModel = new ResetPasswordByEmailAndOtpModel {
Email = "<Email>" ,
Otp = "<Otp>" ,
Password = "<Password>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordByEmailOTP ( resetPasswordByEmailAndOtpModel ) . Result ; Diese API wird verwendet, um ein neues Passwort für das angegebene Konto festzulegen, wenn Sie den Benutzernamen als eindeutige Kennung in Ihrem Workflow verwenden. Weitere Informationen
ResetPasswordByUserNameModel resetPasswordByUserNameModel = new ResetPasswordByUserNameModel {
Otp = "<Otp>" ,
Password = "<Password>" ,
UserName = "<UserName>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordByOTPAndUserName ( resetPasswordByUserNameModel ) . Result ; Diese API wird verwendet, um das Kontopasswort basierend auf dem vorherigen Passwort zu ändern. Weitere Informationen
var accessToken = "accessToken" ; //Required
var newPassword = "newPassword" ; //Required
var oldPassword = "oldPassword" ; //Required
var apiResponse = new AuthenticationApi ( ) . ChangePassword ( accessToken , newPassword , oldPassword ) . Result ; Diese API wird verwendet, um ein Konto eines sozialen Anbieters mit dem angegebenen Konto basierend auf dem Zugriffstoken und dem Benutzerzugriffstoken des sozialen Anbieters zu verknüpfen. Weitere Informationen
var accessToken = "accessToken" ; //Required
var candidateToken = "candidateToken" ; //Required
var apiResponse = new AuthenticationApi ( ) . LinkSocialIdentities ( accessToken , candidateToken ) . Result ; Diese API wird verwendet, um ein Social-Provider-Konto mit einem bestehenden LoginRadius-Konto auf Basis von Ping und dem Benutzerzugriffstoken des Social-Providers zu verknüpfen. Weitere Informationen
var accessToken = "accessToken" ; //Required
var clientGuid = "clientGuid" ; //Required
var apiResponse = new AuthenticationApi ( ) . LinkSocialIdentitiesByPing ( accessToken , clientGuid ) . Result ; Diese API wird verwendet, um den Benutzernamen per Zugriffstoken festzulegen oder zu ändern. Weitere Informationen
var accessToken = "accessToken" ; //Required
var username = "username" ; //Required
var apiResponse = new AuthenticationApi ( ) . SetOrChangeUserName ( accessToken , username ) . Result ; Diese API sendet die Bestätigungs-E-Mail erneut an den Benutzer. Weitere Informationen
var email = "email" ; //Required
var emailTemplate = "emailTemplate" ; //Optional
var verificationUrl = "verificationUrl" ; //Optional
var apiResponse = new AuthenticationApi ( ) . AuthResendEmailVerification ( email , emailTemplate , verificationUrl ) . Result ; Diese API wird verwendet, um dem Konto eines Benutzers zusätzliche E-Mails hinzuzufügen. Weitere Informationen
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 ; Diese API ruft eine Kopie der Benutzerdaten basierend auf den E-Mail-Mehrinformationen ab
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 ; Diese API ruft eine Kopie der Benutzerdaten basierend auf dem Benutzernamen Weitere Informationen ab
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 ; Diese API wird verwendet, um die URL zum Zurücksetzen des Passworts an ein angegebenes Konto zu senden. Hinweis: Wenn Sie den Workflow „Benutzername“ aktiviert haben, können Sie den Parameter „E-Mail“ durch „Benutzername“ ersetzen. Weitere Informationen
var email = "email" ; //Required
var resetPasswordUrl = "resetPasswordUrl" ; //Required
var emailTemplate = "emailTemplate" ; //Optional
var apiResponse = new AuthenticationApi ( ) . ForgotPassword ( email , resetPasswordUrl , emailTemplate ) . Result ; Diese API erstellt einen Benutzer in der Datenbank und sendet eine Bestätigungs-E-Mail an den Benutzer. Weitere Informationen
