PassportIdentity.GetIsAuthenticated Method (Int32, Int32, Int32)

Indicates whether the user is authenticated by a Passport authority.

Namespace: System.Web.Security
Assembly: System.Web (in system.web.dll)

public bool GetIsAuthenticated (
	int iTimeWindow,
	int iForceLogin,
	int iCheckSecure
)
public boolean GetIsAuthenticated (
	int iTimeWindow, 
	int iForceLogin, 
	int iCheckSecure
)
public function GetIsAuthenticated (
	iTimeWindow : int, 
	iForceLogin : int, 
	iCheckSecure : int
) : boolean
Not applicable.

Parameters

iTimeWindow

Specifies the interval during which members must have last logged on to the calling domain. A value of -1 indicates that Passport should use the default value, 0 represents false, and 1 represents true.

iForceLogin

Determines how the iTimeWindow parameter is used. A value of -1 indicates that Passport should use the default value, 0 represents false, and 1 represents true.

iCheckSecure

Enables checking for an encrypted logon. A value of -1 indicates that Passport should use the default value, 0 represents false, and 1 represents true.

A value of 10 or 100 for Passport version 2.1 Login servers specify SecureLevel 10 or 100 for the Passport Manager IsAuthenticated method. See the Passport version 2.1 SDK documentation for more information.

SSL sign-in is not available as an option for Passport version 1.4 Login servers. The value of iCheckSecure is ignored at the server.

Return Value

true if the user is authenticated by a central site responsible for Passport authentication; otherwise, false.

For more information about Passport authentication, see the Passport version 1.4 or version 2.1 SDK documentation for the IsAuthenticated method in the MSDN Library. Passport version 1.4 documentation is available online at http://msdn.microsoft.com/library. You can download the Passport version 2.1 SDK documentation from http://msdn.microsoft.com/downloads.

<!-- 
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. -->


	...

            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 Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show: