Setting Up Dynamic Authentication

Use dynamic authentication when you want the user to set the name and password on the client.

1. In the Mobile Development perspective, select File > New > Mobile Workflow Forms Editor.
2. Follow the instructions in the New Mobile Workflow Forms Editor wizard:

   Field	Description
   Enter or select the parent folder	Select the mobile application project in which to create the mobile workflow form.
   File name	Enter a name for the mobile workflow form. The extension for mobile workflow forms is .xbw.
   Advanced	Link the mobile workflow form to an existing file in the file system.
   Link to file in the file system	Click Browse to locate the file to which to link the mobile workflow form. Linked resources are files or folders that are stored in the file system outside of the project's location. If you link a resource to an editor, when you select the editor, the resource is selected in the WorkSpace Navigator. Conversely, when you select the resource in the WorkSpace Navigator, the editor is selected. Click Variables to define a new path variable. Path variables specify locations on the file system.

3. In the Starting Points page, select Credentials (authentication) may be requested dynamically from the client application.
4. Continue with the New Mobile Workflow wizard as appropriate to create the type of mobile workflow application you want to create. Click Finish.
5. When the Mobile Workflow Forms Editor opens, click Flow Design.
   The Credential Request starting point and its associated Credential Request screen appear on the Flow Design page.
   Select the Credential Request starting point. You see the two pre-defined keys (cc_username and cc_password) in the Properties view.
6. Double-click the Credential Request screen to go to the Screen Design page.
   Two editbox controls, which are bound to the pre-defined cc_username and cc_password keys appear on the screen.
7. Select the Username editbox, then click Advanced on the left side of the Properties view.
   The Username editbox has the Credential cache username checkbox selected. Select the Password editbox and note that is has the Credential cache password checkbox checked.
   If you create a Credential Request starting point and screen manually, you must add the editbox controls, create the keys for the username and password, and check the corresponding Credential cache username or password box.
8. (Optional) To use certificate-based authentication instead of the user name and password:
   1. Add a MenuItem to the Menu box.
   2. Select the MenuItem to see the Properties.
   3. In the Properties view, from Type, choose Select Certificate.
      When the user selects the menu item on the device, a dialog is opened that allows the user to select a certificate to use for credentials.
9. Select File > Save.
   The first time the mobile workflow is started following deployment, the credential screen is shown. The username and password values are then cached in the credential cache.

   Note: If an e-mail triggered workflow form has dynamic cached credentials, the cached credentials are not cached between invocations of the workflow form through an email trigger.