Sys.Services AuthenticationService login 메서드
업데이트: 2007년 11월
사용자의 자격 증명을 인증합니다.
Sys.Services.AuthenticationService.login(userName, password, isPersistent, customInfo, redirectUrl, loginCompletedCallback, failedCallback, userContext);
매개 변수
매개 변수 |
설명 |
---|---|
userName |
(필수적 요소) 인증할 사용자 이름입니다. |
password |
사용자의 암호입니다. 기본값은 null입니다. |
isPersistent |
발급된 인증 티켓을 여러 브라우저 세션에서 영구적으로 사용하려면 true이고, 그렇지 않으면 false입니다. 기본값은 false입니다. |
redirectUrl |
인증에 성공할 경우 브라우저를 리디렉션할 대상 URL입니다. null로 지정하면 리디렉션되지 않습니다. 기본값은 null입니다. |
customInfo |
나중에 사용하기 위해 예약되어 있습니다. 기본값은 null입니다. |
loginCompletedCallback |
로그인이 성공적으로 끝나면 호출할 함수입니다. 기본값은 null입니다. |
failedCallback |
로그인이 실패하면 호출할 함수입니다. 기본값은 null입니다. |
userContext |
콜백 함수에 전달하는 사용자 컨텍스트 정보입니다. |
예외
예외 형식 |
조건 |
---|---|
username이 null인 경우 |
설명
redirectUrl이 null 또는 빈 문자열인 경우에는 인증 웹 서비스 호출이 끝난 후 현재 페이지가 새로 고쳐지지 않습니다. 대신 웹 서비스 호출에 성공하면 로그인 완료 함수가 호출됩니다.
redirectUrl이 null이 아니거나 비어 있지 않은 문자열인 경우에는 웹 서비스 호출에 성공한 후 지정된 URL로 페이지가 리디렉션됩니다. 리디렉션 URL은 절대 가상 경로, 상대 가상 경로 또는 정규화된 도메인 이름과 경로가 될 수 있습니다.
웹 서비스 호출에 실패할 경우에는 페이지가 리디렉션되거나 새로 고쳐지지 않습니다. 대신 실패 콜백 함수가 호출됩니다.
예제
다음 예제에서는 login 메서드를 사용하여 사용자 자격 증명을 확인하는 방법을 보여 줍니다. 이 코드는 Sys.Services.AuthenticationService 클래스 개요에서 볼 수 있는 전체 예제의 일부입니다.
// This function calls the login method of the
// authentication service to verify
// the credentials entered by the user.
// If the credentials are authenticated, the
// authentication service issues a forms
// authentication cookie.
function OnClickLogin()
{
// Set the default callback functions.
SetDefaultLoginCompletedCallBack();
SetDefaultLogoutCompletedCallBack();
SetDefaultFailedCallBack();
// Call the authetication service to authenticate
// the credentials entered by the user.
Sys.Services.AuthenticationService.login(username.value,
password.value, false,null,null,null,null,"User Context");
}
참고 항목
개념
Sys.Services.ProfileService 클래스