PassportIdentity.GetIsAuthenticated メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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 サインインはオプションとして利用できないため、渡した値はサーバーでは無視されます。
戻り値
ユーザーが 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
の値は、サーバーで無視されます。
戻り値
ユーザーが 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 に置き換えられました。