PassportIdentity.GetIsAuthenticated メソッド (Int32, Boolean, Boolean)
アセンブリ: System.Web (system.web.dll 内)
構文Public Function GetIsAuthenticated ( _ iTimeWindow As Integer, _ bForceLogin As Boolean, _ bCheckSecure As Boolean _ ) As Boolean
Dim instance As PassportIdentity Dim iTimeWindow As Integer Dim bForceLogin As Boolean Dim bCheckSecure As Boolean Dim returnValue As Boolean returnValue = instance.GetIsAuthenticated(iTimeWindow, bForceLogin, bCheckSecure)
public function GetIsAuthenticated ( iTimeWindow : int, bForceLogin : boolean, bCheckSecure : boolean ) : boolean
- bCheckSecure
暗号化されたログオンかどうかを確認できます。現在のバージョンの Login サーバーでは、SSL サインインはオプションとして利用できないため、渡した値はサーバーでは無視されます。
ユーザーが Passport 権限で認証されている場合は true。それ以外の場合は false。
解説このバージョン (int, bool, bool) の GetIsAuthenticated は、Passport SDK Version 1.4 で使用します。これより後のバージョン (2.x) では、呼び出し時に 3 つの整数値を受け取る GetIsAuthenticated メソッドを使用します。詳細については、MSDN ライブラリ (http://msdn.microsoft.com/library/ja) で Passport SDK に関するドキュメントの IPassportManager.IsAuthenticated の説明を参照してください。
プラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照PassportIdentity.GetIsAuthenticated メソッド (Int32, Int32, Int32)
アセンブリ: System.Web (system.web.dll 内)
構文Public Function GetIsAuthenticated ( _ iTimeWindow As Integer, _ iForceLogin As Integer, _ iCheckSecure As Integer _ ) As Boolean
Dim instance As PassportIdentity Dim iTimeWindow As Integer Dim iForceLogin As Integer Dim iCheckSecure As Integer Dim returnValue As Boolean returnValue = instance.GetIsAuthenticated(iTimeWindow, iForceLogin, iCheckSecure)
public function GetIsAuthenticated ( iTimeWindow : int, iForceLogin : int, iCheckSecure : int ) : boolean
- iTimeWindow
メンバが呼び出し元のドメインに最後にログオンした間隔を指定します。-1 は、Passport で既定値を使用することを示します。0 は false を表します。1 は true を表します。
- iForceLogin
iTimeWindow パラメータの使用方法を確認します。-1 は、Passport で既定値を使用することを示します。0 は false を表します。1 は true を表します。
- iCheckSecure
暗号化されたログオンかどうかを確認できます。-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。
解説Passport 認証の詳細については、MSDN ライブラリで Passport Version 1.4 SDK または Version 2.1 SDK に関するドキュメントの IsAuthenticated メソッドの説明を参照してください。Passport Version 1.4 のドキュメントは､http://msdn.microsoft.com/library/ja で参照できます。Passport Version 2.1 SDK のドキュメントは、http://www.microsoft.com/downloads/search.asp?langid=13&langdir=ja からダウンロードできます。
使用例<!-- 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. --> <br /><span space="preserve">...</span><br /><!-- To view this code example in a fully-working sample, see the PassportIdentity Class topic. --> <br /><span space="preserve">...</span><br /> 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)
<!-- 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. --> <br /><span space="preserve">...</span><br /><!-- To view this code example in a fully-working sample, see the PassportIdentity Class topic. --> <br /><span space="preserve">...</span><br /> 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); }
プラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照PassportIdentity.GetIsAuthenticated メソッド
- PassportIdentity.GetIsAuthenticatedのページへのリンク
