Create Named Session

Overview

A Named Session allows for a specific user account to pass in when executing a Flow via REST, without exposing the user account information. To relay the data properly, a Session ID is automatically applied to the generated URL when the Named Session is selected. 

Named Sessions do not expire; if expiration is needed, JSON Web Tokens can be configured with the JWT article.

Example

This example will demonstrate how to create a Named Session and how to generate the appropriate REST URL from the Flow. 

1. In the Decisions Studio, navigate to System > Security > Named Sessions and select Add Named Session from the Global Action Bar.
2. When the window appears, enter a name for the session. Use the PICK button under ForAccountId to select the user account it applies to. 
3. Select SAVE once complete and refresh the FOLDER VIEW to confirm the Named Session appears.
   
   
   
4. Now that the Named Session is configured, it can be selected on the INTEGRATION DETAILS page for the Designer element being referenced in the session. 
5. Right-click the name of the element and in the Action Menu, navigate to Run [Advanced] > Integration > View Integration Details. 
6. In the View Integration Details window, use the drop-down list for Authentication Type and choose the name of the Named Session.
7. Upon the selection, all of the service API URLs will appear for the corresponding integration type (typically GET or POST by default).
   Clear Session URL Extension

   Add &clearsession=true to the end of the URL to ensure that each time the user exits the browser after completing the Named Session Flow/Form, the session is cleared. This will allow another user to run the same Flow/Form on the same machine with a different Named Session.