dot net sdk
Released Version 11.6.0
LoginRadius ASP.NET 고객 등록 래퍼는 LoginRadius ID 관리 플랫폼 API에 대한 액세스를 제공합니다.
LoginRadius는 데이터를 보호하면서 사용자 등록을 단순화하는 ID 관리 플랫폼입니다. LoginRadius 플랫폼은 사용자 등록 프로세스를 단순화 및 보호하고, 30개의 주요 소셜 플랫폼을 결합한 소셜 로그인으로 전환율을 높이며, 기존 사용자 등록을 통해 완전한 솔루션을 제공합니다. 소셜 로그인이나 기존 사용자 등록을 통해 풍부한 사용자 프로필 데이터를 수집할 수 있습니다.
LoginRadius는 모든 것을 한 곳에 집중시켜 관리와 액세스를 쉽게 해줍니다. LoginRadius를 MailChimp, Google Analytics, Livefyre 등과 같은 모든 타사 애플리케이션과 쉽게 통합하여 캡처하는 데이터를 쉽게 활용할 수 있습니다.
LoginRadius는 기업이 웹/모바일 플랫폼에서 사용자 참여를 높이고, 온라인 신원을 관리하고, 소셜 미디어를 마케팅에 활용하고, 정확한 소비자 데이터를 수집하고, 고객 기반에 대한 고유한 소셜 통찰력을 얻을 수 있도록 도와줍니다.
자세한 내용은 여기를 참조하세요.
이 문서에서는 클라이언트측 구현을 통해 초기 등록 및 로그인 프로세스를 제공할 LoginRadius 사용자 등록 인터페이스를 설정했다고 가정합니다. 이에 대한 자세한 내용은 시작 가이드에서 확인할 수 있습니다.
**참고: **LoginRadius는 인터넷을 통해 전달되는 정보의 개인 정보를 보호하도록 설계된 업계 표준 TLS 1.2 프로토콜을 사용합니다. LoginRadius .Net SDK를 사용하려면 프로젝트의 Global.asax 파일에서 웹 서비스를 인스턴스화하기 전에 다음 코드를 추가하세요.
ServicePointManager . SecurityProtocol = SecurityProtocolType . Tls | SecurityProtocolType . Tls11 | SecurityProtocolType . Tls12 ; Github에서 사용자 등록 .Net SDK를 다운로드하세요.
LoginRadiusSDK.V2.dll 및 LoginRadiusSDK.V2.pdb 파일을 ASP.NET 프로젝트의 References 디렉터리에 복사합니다.
또는
PM> Install-Package LoginRadiusSDK.NET
또는
Visual Studio 2019를 사용하여 솔루션을 엽니다.
프로젝트를 빌드하고 .nupkg 파일이 있는 위치를 기록해 둡니다.
NuGet 패키지 관리자 설정에 액세스하고 .nupkg 파일이 있는 디렉터리를 가져옵니다.
"솔루션용 NuGet 패키지 관리..." 도구에 액세스하여 소스를 새로 생성된 소스로 변경하고 LoginRadius SDK를 선택 및 설치합니다.
그런 다음 프로젝트에 다음 네임스페이스를 포함합니다.
using LoginRadiusSDK . V2 . Api ;
using LoginRadiusSDK . V2 . Models ; SDK를 사용하기 전에 LoginRadius 사이트의 API 키 및 비밀 코드를 사용하여 SDK를 초기화해야 합니다. 이 정보는 여기에 설명된 대로 LoginRadius 계정에서 찾을 수 있습니다.
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/" ;또는
ASP.NET의 경우. 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 >또는
.NET Core의 경우 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/ "
}
SDK를 초기화할 때 선택적으로 사용자 정의 도메인을 지정합니다. 예: appsettings.json에서 다음 문을 추가합니다.
"domainName" : " https://api.loginradius.com/ "SDK를 초기화할 때 선택적으로 이 기능을 활성화하도록 지정할 수 있습니다. 이 기능을 활성화하면 고객이 API 요청에 API 비밀번호를 전달할 필요가 없습니다. 대신 동적으로 생성된 해시 값을 전달할 수 있습니다. 또한 이 기능은 누군가가 API를 호출할 때 전송 중에 메시지가 변조되지 않도록 보장합니다. 예: appsettings.json에서 다음 문을 추가합니다.
"ApiRequestSigning" : " false "X-Origin-IP LoginRadius를 사용하면 헤더에 X-Origin-IP를 추가할 수 있으며 클라이언트 요청의 IP 주소를 결정합니다. 이는 분석이 헤더 데이터에 의존하는 분석 불일치를 극복하는 데에도 유용할 수 있습니다.
"originIp" : " <Client-Ip-Address> " 이 섹션의 API 목록:
PUT : 토큰별 인증 업데이트 프로필
PUT : 액세스 토큰으로 인증 잠금 해제 계정
PUT : OTP로 이메일 인증 확인
PUT : 보안 답변 및 이메일을 통한 인증 비밀번호 재설정
PUT : 보안응답 및 전화로 인증 비밀번호 재설정
PUT : 보안 답변 및 사용자 이름으로 인증 비밀번호 재설정
PUT : 재설정 토큰을 통한 인증 재설정 비밀번호
PUT : OTP를 통한 인증 비밀번호 재설정
PUT : OTP 및 사용자 이름으로 인증 비밀번호 재설정
PUT : 인증 비밀번호 변경
POST : 인증 링크 소셜 ID
POST : Ping을 통한 인증 링크 소셜 ID
PUT : 인증 사용자 이름 설정 또는 변경
PUT : 인증 재전송 이메일 확인
POST : 인증 이메일 추가
POST : 이메일로 인증 로그인
POST : 사용자 이름으로 인증 로그인
POST : 인증 비밀번호 찾기
POST : 이메일을 통한 인증 사용자 등록
POST : Captcha를 통한 인증 사용자 등록
GET : 이메일로 보안 질문 받기
GET : UserName으로 보안 질문 받기
GET : 전화로 보안 질문 받기
GET : 액세스 토큰으로 보안 질문 받기
GET : 인증 액세스 토큰 확인
GET : 액세스 토큰 무효화
GET : 액세스 토큰 정보
GET : Auth 토큰으로 모든 프로필 읽기
GET : 인증 환영 이메일 보내기
GET : 인증 계정 삭제
GET : Ping으로 프로필 가져오기
GET : 인증 이메일 가용성 확인
GET : 인증 이메일 인증
GET : 인증 소셜 ID
GET : 인증 사용자 이름 가용성 확인
GET : 인증 개인 정보 보호 정책 동의
GET : 액세스 토큰별 인증 개인 정보 보호 정책 기록
GET : 소셜 프로필 연결을 위한 승인 전송 확인 이메일
DELETE : 이메일 확인을 통해 인증 계정 삭제
삭제: 인증 이메일 삭제
DELETE: 승인 소셜 ID 연결 해제
이 API는 access_token을 전달하여 사용자 프로필을 업데이트하는 데 사용됩니다. 추가 정보
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 ; 이 API는 유효한 access_token을 가진 고객이 표시된 봇 보호 문제를 성공적으로 통과한 경우 계정을 잠금 해제할 수 있도록 하는 데 사용됩니다. Block 또는 Suspend 블록 유형은 이 API에 적용할 수 없습니다. 자세한 내용은 인증 보안 구성 설명서를 참조하세요. 프롬프트된 질문에 해당하는 게시 매개변수만 전달하면 됩니다. 추가 정보
var accessToken = "accessToken" ; //Required
UnlockProfileModel unlockProfileModel = new UnlockProfileModel {
G_recaptcha_response = "<G-recaptcha-response>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . UnlockAccountByToken ( accessToken , unlockProfileModel ) . Result ; 이 API는 OTP 이메일 확인 흐름이 활성화된 경우 사용자의 이메일을 확인하는 데 사용됩니다. 이 기능을 활성화하려면 LoginRadius에 문의해야 합니다. 추가 정보
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 ; 보안 질문으로 지정된 계정의 비밀번호를 재설정하는 데 사용되는 API입니다.
ResetPasswordBySecurityAnswerAndEmailModel resetPasswordBySecurityAnswerAndEmailModel = new ResetPasswordBySecurityAnswerAndEmailModel {
Email = "<Email>" ,
Password = "<Password>" ,
SecurityAnswer = new Dictionary < String , String > {
[ "QuestionID" ] = "Answer"
}
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordBySecurityAnswerAndEmail ( resetPasswordBySecurityAnswerAndEmailModel ) . Result ; 보안 질문으로 지정된 계정의 비밀번호를 재설정하는 데 사용되는 API입니다.
ResetPasswordBySecurityAnswerAndPhoneModel resetPasswordBySecurityAnswerAndPhoneModel = new ResetPasswordBySecurityAnswerAndPhoneModel {
Password = "<Password>" ,
Phone = "<Phone>" ,
SecurityAnswer = new Dictionary < String , String > {
[ "QuestionID" ] = "Answer"
}
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordBySecurityAnswerAndPhone ( resetPasswordBySecurityAnswerAndPhoneModel ) . Result ; 보안 질문으로 지정된 계정의 비밀번호를 재설정하는 데 사용되는 API입니다.
ResetPasswordBySecurityAnswerAndUserNameModel resetPasswordBySecurityAnswerAndUserNameModel = new ResetPasswordBySecurityAnswerAndUserNameModel {
Password = "<Password>" ,
SecurityAnswer = new Dictionary < String , String > {
[ "QuestionID" ] = "Answer"
} ,
UserName = "<UserName>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordBySecurityAnswerAndUserName ( resetPasswordBySecurityAnswerAndUserNameModel ) . Result ; 이 API는 지정된 계정에 대한 새 비밀번호를 설정하는 데 사용됩니다. 추가 정보
ResetPasswordByResetTokenModel resetPasswordByResetTokenModel = new ResetPasswordByResetTokenModel {
Password = "<Password>" ,
ResetToken = "<ResetToken>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordByResetToken ( resetPasswordByResetTokenModel ) . Result ; 이 API는 지정된 계정에 대한 새 비밀번호를 설정하는 데 사용됩니다. 추가 정보
ResetPasswordByEmailAndOtpModel resetPasswordByEmailAndOtpModel = new ResetPasswordByEmailAndOtpModel {
Email = "<Email>" ,
Otp = "<Otp>" ,
Password = "<Password>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordByEmailOTP ( resetPasswordByEmailAndOtpModel ) . Result ; 이 API는 워크플로에서 사용자 이름을 고유 식별자로 사용하는 경우 지정된 계정에 대한 새 비밀번호를 설정하는 데 사용됩니다.
ResetPasswordByUserNameModel resetPasswordByUserNameModel = new ResetPasswordByUserNameModel {
Otp = "<Otp>" ,
Password = "<Password>" ,
UserName = "<UserName>"
} ; //Required
var apiResponse = new AuthenticationApi ( ) . ResetPasswordByOTPAndUserName ( resetPasswordByUserNameModel ) . Result ; 이 API는 이전 비밀번호를 기반으로 계정 비밀번호를 변경하는 데 사용됩니다. 추가 정보
var accessToken = "accessToken" ; //Required
var newPassword = "newPassword" ; //Required
var oldPassword = "oldPassword" ; //Required
var apiResponse = new AuthenticationApi ( ) . ChangePassword ( accessToken , newPassword , oldPassword ) . Result ; 이 API는 액세스 토큰과 소셜 공급자 사용자 액세스 토큰을 기반으로 소셜 공급자 계정을 지정된 계정과 연결하는 데 사용됩니다. 추가 정보
var accessToken = "accessToken" ; //Required
var candidateToken = "candidateToken" ; //Required
var apiResponse = new AuthenticationApi ( ) . LinkSocialIdentities ( accessToken , candidateToken ) . Result ; 이 API는 핑 및 소셜 공급자 사용자 액세스 토큰을 기반으로 소셜 공급자 계정을 기존 LoginRadius 계정과 연결하는 데 사용됩니다. 추가 정보
var accessToken = "accessToken" ; //Required
var clientGuid = "clientGuid" ; //Required
var apiResponse = new AuthenticationApi ( ) . LinkSocialIdentitiesByPing ( accessToken , clientGuid ) . Result ; 이 API는 액세스 토큰으로 UserName을 설정하거나 변경하는 데 사용됩니다. 추가 정보
var accessToken = "accessToken" ; //Required
var username = "username" ; //Required
var apiResponse = new AuthenticationApi ( ) . SetOrChangeUserName ( accessToken , username ) . Result ; 이 API는 사용자에게 확인 이메일을 다시 보냅니다. 추가 정보
var email = "email" ; //Required
var emailTemplate = "emailTemplate" ; //Optional
var verificationUrl = "verificationUrl" ; //Optional
var apiResponse = new AuthenticationApi ( ) . AuthResendEmailVerification ( email , emailTemplate , verificationUrl ) . Result ; 이 API는 사용자 계정에 추가 이메일을 추가하는 데 사용됩니다. 추가 정보
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 ; 이 API는 이메일 추가 정보를 기반으로 사용자 데이터의 사본을 검색합니다.
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 ; 이 API는 사용자 이름을 기반으로 사용자 데이터의 사본을 검색합니다. 추가 정보
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 ; 이 API는 재설정된 비밀번호 URL을 지정된 계정으로 보내는 데 사용됩니다. 참고: UserName 워크플로가 활성화된 경우 'email' 매개변수를 'username'으로 바꿀 수 있습니다. 추가 정보
var email = "email" ; //Required
var resetPasswordUrl = "resetPasswordUrl" ; //Required
var emailTemplate = "emailTemplate" ; //Optional
var apiResponse = new AuthenticationApi ( ) . ForgotPassword ( email , resetPasswordUrl , emailTemplate ) . Result ; 이 API는 데이터베이스에 사용자를 생성하고 사용자에게 확인 이메일을 보냅니다. 추가 정보
