ClientFormsAuthenticationMembershipProvider 클래스

참조

정의

네임스페이스:: System.Web.ClientServices.Providers

어셈블리:: System.Web.Extensions.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

클라이언트 애플리케이션 서비스를 사용하여 양식 인증을 사용하도록 설정합니다.

public ref class ClientFormsAuthenticationMembershipProvider : System::Web::Security::MembershipProvider

public class ClientFormsAuthenticationMembershipProvider : System.Web.Security.MembershipProvider

type ClientFormsAuthenticationMembershipProvider = class
    inherit MembershipProvider

Public Class ClientFormsAuthenticationMembershipProvider
Inherits MembershipProvider

상속: Object

ProviderBase

MembershipProvider
ClientFormsAuthenticationMembershipProvider

예제

다음 예제 코드에서는 이 메서드를 사용하여 IClientFormsAuthenticationCredentialsProvider 구현을 사용하여 사용자의 유효성을 검사하는 방법을 보여 줍니다.

private bool ValidateUsingCredentialsProvider()
{
    bool isAuthorized = false;
    try
    {
        ClientFormsAuthenticationMembershipProvider authProvider =
            System.Web.Security.Membership.Provider as
            ClientFormsAuthenticationMembershipProvider;

        // Call ValidateUser with empty strings in order to display the 
        // login dialog box configured as a credentials provider.
        isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty);
    }
    catch (System.Net.WebException)
    {
        MessageBox.Show("Unable to access the authentication service.",
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
    }
    if (!isAuthorized)
    {
        MessageBox.Show("Unable to authenticate.", "Not logged in", 
            MessageBoxButtons.OK, MessageBoxIcon.Error);
        Application.Exit();
    }
    return isAuthorized;
}

Private Function ValidateUsingCredentialsProvider() As Boolean

    Dim isAuthorized As Boolean = False

    Try

        Dim authProvider As ClientFormsAuthenticationMembershipProvider = _
            CType(System.Web.Security.Membership.Provider,  _
            ClientFormsAuthenticationMembershipProvider)

        ' Call ValidateUser with empty strings in order to display the 
        ' login dialog box configured as a credentials provider.
        isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty)

    Catch ex As System.Net.WebException

        MessageBox.Show("Unable to access the authentication service.", _
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)

    End Try

    If Not isAuthorized Then

        MessageBox.Show("Unable to authenticate.", "Not logged in", _
            MessageBoxButtons.OK, MessageBoxIcon.Error)
        Application.Exit()

    End If

    Return isAuthorized

End Function

설명

클라이언트 애플리케이션 서비스를 사용하여 양식 인증을 사용하여 사용자의 유효성을 검사할 수 있습니다. 양식 인증을 사용하도록 설정하려면 ClientFormsAuthenticationMembershipProvider 클래스를 사용하도록 애플리케이션을 구성합니다.

구성 후 내부적으로 ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) 메서드를 호출하는 staticMembership.ValidateUser 메서드를 호출하여 사용자의 유효성을 검사할 수 있습니다.

양식 인증을 사용하려면 사용자가 애플리케이션에서 제공하는 로그인 컨트롤을 통해 자격 증명을 지정해야 합니다. 자격 증명을 검색하고 Membership.ValidateUser 메서드에 전달할 수 있습니다. 빈 문자열이나 null 전달하여 자격 증명 공급자를 사용할 수도 있습니다. 자격 증명 공급자는 애플리케이션 구성 파일에 지정된 IClientFormsAuthenticationCredentialsProvider 구현입니다. 일반적으로 IClientFormsAuthenticationCredentialsProvider.GetCredentials 메서드를 구현하여 로그인 대화 상자를 표시하고 채워진 ClientFormsAuthenticationCredentials 개체를 반환합니다. 자격 증명 공급자를 사용하면 여러 애플리케이션 간에 단일 로그인 대화 상자를 공유할 수 있습니다.

ClientFormsAuthenticationMembershipProvider.ValidateUser 메서드는 ServiceUri 속성으로 표시된 로그인 서비스를 통해 사용자를 인증합니다. ServiceUri 속성의 값은 일반적으로 다른 구성 값과 함께 애플리케이션 구성 파일에서 검색됩니다.

사용자가 성공적으로 인증되면 서비스 공급자는 staticThread.CurrentPrincipal 속성을 사용자 정보를 포함하는 새 ClientFormsIdentity 개체가 포함된 새 ClientRolePrincipal 개체로 설정합니다. 애플리케이션에 대해 ClientRoleProvider 구성된 경우 ClientRolePrincipal 개체를 사용하여 역할 서비스에서 사용자 역할 정보를 검색할 수 있습니다.

static Membership.Provider 속성을 통해 현재 ClientFormsAuthenticationMembershipProvider 인스턴스에 대한 참조를 검색할 수 있습니다. 멤버 자격 공급자 참조를 사용하여 ClientFormsAuthenticationMembershipProvider.ValidateUser 메서드를 직접 호출할 수 있습니다. 또한 MembershipProvider 기본 클래스에서 사용할 수 없는 Logout 메서드를 호출하려면 멤버 자격 공급자 참조가 필요합니다.

ClientFormsAuthenticationMembershipProvider 클래스를 사용하여 멤버 자격 정보를 만들거나 삭제하거나 수정할 수 없습니다. 사용자를 만들거나 삭제하거나 수정하려면 서버에서 로그인 서비스의 구성을 변경해야 합니다.

생성자

ClientFormsAuthenticationMembershipProvider()

ClientFormsAuthenticationMembershipProvider 클래스의 새 인스턴스를 초기화합니다.

속성

ApplicationName	이 속성은 이 클래스에서 사용되지 않습니다.
Description	관리 도구 또는 기타 UI(사용자 인터페이스)에 표시하기에 적합한 짧고 친숙한 설명을 가져옵니다. (다음에서 상속됨 ProviderBase)
EnablePasswordReset	이 속성은 이 클래스에서 사용되지 않습니다.
EnablePasswordRetrieval	이 속성은 이 클래스에서 사용되지 않습니다.
MaxInvalidPasswordAttempts	이 속성은 이 클래스에서 사용되지 않습니다.
MinRequiredNonAlphanumericCharacters	이 속성은 이 클래스에서 사용되지 않습니다.
MinRequiredPasswordLength	이 속성은 이 클래스에서 사용되지 않습니다.
Name	구성 중에 공급자를 참조하는 데 사용되는 이름을 가져옵니다. (다음에서 상속됨 ProviderBase)
PasswordAttemptWindow	이 속성은 이 클래스에서 사용되지 않습니다.
PasswordFormat	이 속성은 이 클래스에서 사용되지 않습니다.
PasswordStrengthRegularExpression	이 속성은 이 클래스에서 사용되지 않습니다.
RequiresQuestionAndAnswer	이 속성은 이 클래스에서 사용되지 않습니다.
RequiresUniqueEmail	이 속성은 이 클래스에서 사용되지 않습니다.
ServiceUri	인증 서비스의 URI를 가져오거나 설정합니다.

메서드

ChangePassword(String, String, String)	이 메서드는 이 클래스에서 사용되지 않습니다.
ChangePasswordQuestionAndAnswer(String, String, String, String)	이 메서드는 이 클래스에서 사용되지 않습니다.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	이 메서드는 이 클래스에서 사용되지 않습니다.
DecryptPassword(Byte[])	암호화된 암호를 해독합니다. (다음에서 상속됨 MembershipProvider)
DeleteUser(String, Boolean)	이 메서드는 이 클래스에서 사용되지 않습니다.
EncryptPassword(Byte[])	암호를 암호화합니다. (다음에서 상속됨 MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	지정된 암호 호환 모드를 사용하여 지정된 암호를 암호화합니다. (다음에서 상속됨 MembershipProvider)
Equals(Object)	지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object)
FindUsersByEmail(String, Int32, Int32, Int32)	이 메서드는 이 클래스에서 사용되지 않습니다.
FindUsersByName(String, Int32, Int32, Int32)	이 메서드는 이 클래스에서 사용되지 않습니다.
GetAllUsers(Int32, Int32, Int32)	이 메서드는 이 클래스에서 사용되지 않습니다.
GetHashCode()	기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object)
GetNumberOfUsersOnline()	이 메서드는 이 클래스에서 사용되지 않습니다.
GetPassword(String, String)	이 메서드는 이 클래스에서 사용되지 않습니다.
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
GetUser(Object, Boolean)	이 메서드는 이 클래스에서 사용되지 않습니다.
GetUser(String, Boolean)	이 메서드는 이 클래스에서 사용되지 않습니다.
GetUserNameByEmail(String)	이 메서드는 이 클래스에서 사용되지 않습니다.
Initialize(String, NameValueCollection)	공급자를 초기화합니다.
Logout()	사용자를 로그아웃합니다.
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
OnValidatingPassword(ValidatePasswordEventArgs)	이벤트 처리기가 정의된 경우 ValidatingPassword 이벤트를 발생합니다. (다음에서 상속됨 MembershipProvider)
ResetPassword(String, String)	이 메서드는 이 클래스에서 사용되지 않습니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
UnlockUser(String)	이 메서드는 이 클래스에서 사용되지 않습니다.
UpdateUser(MembershipUser)	이 메서드는 이 클래스에서 사용되지 않습니다.
ValidateUser(String, String)	지정된 사용자 이름 및 암호를 사용하여 사용자를 인증합니다.
ValidateUser(String, String, Boolean)	지정된 사용자 이름 및 암호를 사용하여 사용자를 인증하고 필요에 따라 로컬 데이터 캐시에 암호 해시를 저장합니다.
ValidateUser(String, String, String)	지정된 사용자 이름 및 암호를 사용하여 지정된 서비스 URI에서 사용자를 인증합니다.

이벤트

UserValidated	사용자의 유효성을 검사할 때 발생합니다.
ValidatingPassword	사용자가 만들어지거나, 암호가 변경되거나, 암호가 재설정될 때 발생합니다. (다음에서 상속됨 MembershipProvider)

적용 대상

다음을 통해 공유

ClientFormsAuthenticationMembershipProvider 클래스

정의

예제

설명

생성자

속성

메서드

이벤트

적용 대상

추가 정보

추가 리소스