Sends an initial login request to the engine. If the engine automatically logs the user in (due to SSO for instance) then this method will log the user in and return null. If eUser authentication is being used, Connection.LogOn can be used instead.

When SSO is to be used from an ASP.NET application, ensure Windows Authentication is the only authentication mechanism enabled for the application and ensure impersonation is enabled, either for the whole application using <identity impersonate= "true"/> in web.config or via code in the application.

Namespace:  FreeFlow.Client
Assembly:  FreeFlow.Client (in FreeFlow.Client.dll) Version: 2.0.0.135

Syntax

C#
public Form LogOnForm()
Visual Basic (Declaration)
Public Function LogOnForm As Form
Visual C++
public:
Form^ LogOnForm()

Return Value

The form to be rendered, or null if the user has been automatically logged in.

Examples

This example illustrates logging into the engine.
CopyC#
Connection conn = new FreeFlow.Client.Connection();
conn.HttpServer = "my server";
conn.Engine = "my server";
Form form = conn.LogOnForm();

// fields to be set depends on the SAP being used.
form.Field("username").Value = "user name";
form.Field("password").Value = Connection.MD5Encode("password");

conn.LogOn(form);

See Also