PassportIdentity.GetIsAuthenticated メソッド

リファレンス

定義

名前空間:: System.Web.Security

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ユーザーが Passport 権限で認証されているかどうかを示します。このクラスは非推奨とされます。

オーバーロード

GetIsAuthenticated(Int32, Boolean, Boolean)	ユーザーが Passport 認証を行う中央サイトで認証されているかどうかを示します。このクラスは非推奨とされます。
GetIsAuthenticated(Int32, Int32, Int32)	ユーザーが Passport 権限で認証されているかどうかを示します。このクラスは非推奨とされます。

注釈

このクラスは非推奨となり、サポートされなくなりました。 Microsoft Passport Network は、Windows Live ID に置き換えられました。

GetIsAuthenticated(Int32, Boolean, Boolean)

ユーザーが Passport 認証を行う中央サイトで認証されているかどうかを示します。このクラスは非推奨とされます。

public:
 bool GetIsAuthenticated(int iTimeWindow, bool bForceLogin, bool bCheckSecure);

public bool GetIsAuthenticated (int iTimeWindow, bool bForceLogin, bool bCheckSecure);

member this.GetIsAuthenticated : int * bool * bool -> bool

Public Function GetIsAuthenticated (iTimeWindow As Integer, bForceLogin As Boolean, bCheckSecure As Boolean) As Boolean

パラメーター

iTimeWindow: Int32

メンバーが呼び出し元のドメインに最後にログオンした間隔を指定します。 Passport に既定値を使用する場合、-1 を渡します。

bForceLogin: Boolean

iTimeWindow パラメーターの使用方法を確認します。

bCheckSecure: Boolean

暗号化されたログオンかどうかを確認できます。現在のバージョンの Login サーバーでは、SSL サインインはオプションとして利用できないため、渡した値はサーバーでは無視されます。

戻り値

Boolean

ユーザーが Passport 権限で認証されている場合は true。それ以外の場合は false。

注釈

このクラスは非推奨となり、サポートされなくなりました。 Microsoft Passport Network は、Windows Live ID に置き換えられました。

適用対象

GetIsAuthenticated(Int32, Int32, Int32)

ユーザーが Passport 権限で認証されているかどうかを示します。このクラスは非推奨とされます。

public:
 bool GetIsAuthenticated(int iTimeWindow, int iForceLogin, int iCheckSecure);

public bool GetIsAuthenticated (int iTimeWindow, int iForceLogin, int iCheckSecure);

member this.GetIsAuthenticated : int * int * int -> bool

Public Function GetIsAuthenticated (iTimeWindow As Integer, iForceLogin As Integer, iCheckSecure As Integer) As Boolean

パラメーター

iTimeWindow: Int32

メンバーが呼び出し元のドメインに最後にログオンした間隔を指定します。 -1 は、Passport で既定値を使用することを示します。0 は false を表します。1 は true を表します。

iForceLogin: Int32

iTimeWindow パラメーターの使用方法を確認します。 -1 は、Passport で既定値を使用することを示します。0 は false を表します。1 は true を表します。

iCheckSecure: Int32

暗号化されたログオンかどうかを確認できます。 -1 は、Passport で既定値を使用することを示します。0 は false を表します。1 は true を表します。

Passport Version 2.1 Login サーバーに 10 または 100 を値として指定すると、Passport マネージャーの IsAuthenticated メソッドに SecureLevel として 10 または 100 が渡されます。詳細については､Passport Version 2.1 SDK のドキュメントを参照してください。

Passport Version 1.4 Login サーバーでは、SSL サインインはオプションとして利用できません。 iCheckSecure の値は、サーバーで無視されます。

戻り値

Boolean

ユーザーが Passport 認証を行う中央サイトで認証されている場合は true。それ以外の場合は false。

例

<!-- 
This example demonstrates implementing the soft sign-in authentication approach. 
In order for the example to work, the following requirements must be met. 
You can find details on these requirements in the Passport SDK documentation.

1. You must modify the Web.config file associated with this page so that 
authentication mode is set to "Passport".
2. You must have the Passport SDK installed.
3. You must have a Passport Site ID for the site where your page resides. 
If your Site ID is in the PREP environment, you will also need a PREP Passport.
4. You must have installed the encryption key you received after registering 
your site and receiving a site ID.
5. You must have the Passport Manager object settings correctly configured for 
your site.
-->

<!-- 
This example demonstrates implementing the soft sign-in authentication approach. 
In order for the example to work, the following requirements must be met. 
You can find details on these requirements in the Passport SDK documentation.

1. You must modify the Web.config file associated with this page so that 
authentication mode is set to "Passport".
2. You must have the Passport SDK installed.
3. You must have a Passport Site ID for the site where your page resides. 
If your Site ID is in the PREP environment, you will also need a PREP Passport.
4. You must have installed the encryption key you received after registering your 
site and receiving a site ID.
5. You must have the Passport Manager object settings correctly configured for your site.
-->

<!-- To view this code example in a fully-working sample, see the 
PassportIdentity Class topic. -->

<!-- To view this code example in a fully-working sample, see the 
PassportIdentity Class topic. -->

        PassportIdentity identity = (this.Context.User.Identity as PassportIdentity);    
        // Determine whether the user is already signed in with a valid
        // and current ticket. Passing -1 for the parameter values 
        // indicates the default values will be used.
        if (identity.GetIsAuthenticated(-1, -1, -1))
        {
            this.Response.Write("Welcome to the site.<br /><br />");
            // Print the Passport sign in button on the screen.
            this.Response.Write(identity.LogoTag2());
            // Make sure the user has core profile information before
            // trying to access it.
            if (identity.HasProfile("core"))
            {
                this.Response.Write("<b>You have been authenticated as " + 
                    "Passport identity:" + identity.Name + "</b></p>");
            }
        }

        // Determine whether the user has a ticket.
        else if (identity.HasTicket)
        {
            // If the user has a ticket but wasn't authenticated, that 
            // means the ticket is stale, so the login needs to be refreshed.
            // Passing true as the fForceLogin parameter value indicates that 
            // silent refresh will be accepted.
            identity.LoginUser(null, -1, true, null, -1, null, -1, true, null);
        }

        Dim identity As PassportIdentity = Me.Context.User.Identity
        ' Determine whether the user is already signed in with a valid
        ' and current ticket. Passing -1 for the parameter values 
        ' indicates the default values will be used.
        If (identity.GetIsAuthenticated(-1, -1, -1)) Then
            Me.Response.Write("Welcome to the site.<br /><br />")
            ' Print the Passport sign in button on the screen.
            Me.Response.Write(identity.LogoTag2())
            ' Make sure the user has core profile information before
            ' trying to access it.
            If (identity.HasProfile("core")) Then
                Me.Response.Write("<b>You have been authenticated as " & _ 
                "Passport identity:" & identity.Name & "</b></p>")
            End If

        ' Determine whether the user has a ticket.
        ElseIf identity.HasTicket Then
            ' If the user has a ticket but wasn't authenticated, that 
            ' means the ticket is stale, so the login needs to be refreshed.
            ' Passing true as the fForceLogin parameter value indicates that 
            ' silent refresh will be accepted.
            identity.LoginUser(Nothing, -1, True, Nothing, -1, Nothing, _
                -1, True, Nothing)

注釈

このクラスは非推奨となり、サポートされなくなりました。 Microsoft Passport Network は、Windows Live ID に置き換えられました。

適用対象

PassportIdentity.GetIsAuthenticated メソッド

定義

オーバーロード

注釈

GetIsAuthenticated(Int32, Boolean, Boolean)

パラメーター

戻り値

注釈

適用対象

GetIsAuthenticated(Int32, Int32, Int32)

パラメーター

戻り値

例

注釈

適用対象

その他のリソース