HttpListenerContext.User HttpListenerContext.User HttpListenerContext.User HttpListenerContext.User Property

定義

要求が HttpListenerContext オブジェクトによって表されるクライアントの ID、認証情報、セキュリティ ロールを取得するために使用するオブジェクトを取得します。Gets an object used to obtain identity, authentication information, and security roles for the client whose request is represented by this HttpListenerContext object.

public:
 property System::Security::Principal::IPrincipal ^ User { System::Security::Principal::IPrincipal ^ get(); };
public System.Security.Principal.IPrincipal User { get; }
member this.User : System.Security.Principal.IPrincipal
Public ReadOnly Property User As IPrincipal

プロパティ値

クライアントを記述する IPrincipal オブジェクト。この HttpListener を提供した HttpListenerContext が認証を必要としない場合は nullAn IPrincipal object that describes the client, or null if the HttpListener that supplied this HttpListenerContext does not require authentication.

次のコード例では、クライアントに関する id と認証情報にアクセスし、応答でクライアントに返す方法を示します。The following code example demonstrates accessing identity and authentication information about the client, and returning it to the client in the response.

public static string ClientInformation(HttpListenerContext context)
{
    System.Security.Principal.IPrincipal user = context.User;
    System.Security.Principal.IIdentity id = user.Identity;
    if (id == null)
    {
        return "Client authentication is not enabled for this Web server.";
    }
    
    string display;
    if (id.IsAuthenticated)
    {
        display = String.Format("{0} was authenticated using {1}", id.Name, 
            id.AuthenticationType);
    }
    else
    {
       display = String.Format("{0} was not authenticated", id.Name);
    }
    return display;
}
Public Shared Function ClientInformation(ByVal context As HttpListenerContext) As String
    Dim user As System.Security.Principal.IPrincipal = context.User
    Dim id As System.Security.Principal.IIdentity = user.Identity

    If id Is Nothing Then
        Return "Client authentication is not enabled for this Web server."
    End If

    Dim display As String

    If id.IsAuthenticated Then
        display = String.Format("{0} was authenticated using {1}", id.Name, id.AuthenticationType)
    Else
        display = String.Format("{0} was not authenticated", id.Name)
    End If

    Return display
End Function

注釈

HttpListenerAuthenticationSchemes プロパティをAuthenticationSchemeSelectorDelegate使用するか、プロパティを使用してデリゲートを指定することによって、認証が必要であることを示します。AuthenticationSchemeSelectorAn HttpListener indicates that it requires authentication using the AuthenticationSchemes property or by specifying an AuthenticationSchemeSelector delegate using the AuthenticationSchemeSelectorDelegate property.

クライアントのログイン名と認証情報を確認するには、 IPrincipal.Identityこのプロパティによって返されるオブジェクトのプロパティを確認します。To determine the client's login name and authentication information, check the IPrincipal.Identity property in the object returned by this property.

セキュリティ

SecurityPermission
関連付けられた列挙型:ControlPrincipalUnmanagedCodeAssociated enumeration: ControlPrincipalUnmanagedCode

適用対象