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 impersonsation is enabled, either for the whole application using <identity impersonate= "true"/> in web.config or via code in the application.

Return Value

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

Example

This example illustrates logging into the engine.

[C#]
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

Connection Class | FreeFlow.Client Namespace

---