Direct Login
You can bypass the iProcess Workspace (Browser) Login screen by passing login credentials directly into the application.
|
Note
|
Users can also be authenticated using credentials they have already entered in another web application by using the single authentication feature. For information, see Single Authentication.
|
Login credentials can be directly passed into the iProcess Workspace (Browser) in one of the following ways:
|
•
|
In an HTML form element named ‘DirectLogin’ |
|
•
|
In an HTML script element that defines ‘getDirectLoginArgs’ |
When loading, the application will look for direct login credentials in the order shown above.
To use any of the methods of direct login listed above, direct login must be enabled in the iProcess Workspace (Browser) configuration file. This is described in Enabling Direct Login.
In all of the methods of direct login, the following case-insensitive parameters can be specified:
|
—
|
Username - The user name of the user logging in. |
|
—
|
Password - The password of the user logging in. |
|
—
|
ComputerName - The computer name for the iProcess Objects Server. |
|
—
|
IPAddress - The IP address of the machine on which the TIBCO iProcess Objects Server is installed. You can specify the name of the host machine, as long as that name resolves to the IP address of the machine where the iProcess Objects Server is running. Note, however, that this name must be able to be resolved by the machine on which the Action Processor is running. |
|
—
|
TCPPort - The TCP Port for the iProcess Objects Server. |
|
—
|
Name - The iProcess Engine node name. |
|
—
|
Director - “true” or “false”, indicating if an iProcess Objects Director is being used. |
|
—
|
persistOnServer - (optional) If “true”, user preferences are persisted on, and read from, the server. If “false”, user preferences are stored locally, as well as read from the local machine upon login. |
Default = “false” if attribute is absent
|
—
|
maxDataSize - (optional) This is the maximum number of characters in a property value string. This must be set at or below the field size supported by the database used on the server. The maximum number is typically 256K. For double-byte character encoding, the maximum value is 128K. |
Default = 32768 (32K) if attribute is absent
Minimum value = 10
|
—
|
ServerName - If specified, this causes the connection information to be obtained from the ServerNodes record in the client’s config.xml file. Pass the node name in this parameter, i.e., the name in the <Name /> element. For example, if the following server node is specified in the client’s config.xml file, and you want to connect to that node via direct login, pass “phoenix” in this parameter:
|
|
—
|
BaseUrl - The Action Processor base URL. If this is passed in the URL, it overrides the baseURL specified in the client’s config.xml file. If it is not passed, the baseURL specified in the client’s config.xml file is used. |
The following sections provide examples of each of the three direct login methods.
