Portal module

Portal authentication

This flow will be the first to be tested and used.

It will allow you to login to Process with a login and a password and to recover a token that will be used by the following flows. It is possible to choose the validity period of your session.

URL

http://myvdocserver/vdoc/navigation/flow?module=portal&cmd=authenticate

Request flow

<?xml version="1.0" encoding="UTF-8" ?>
<authenticate>
    <header login="sysadmin" password="manager" timeout="30"/>
</authenticate>
Parameters Description Mandatory
login Yes
password Yes
timeout Specifies the maximum duration (minutes) of the session. After the elapsed time, the application will have to authenticate again by reusing this flow.
In case of use of an invalided or expired token to query Process, an error message will be send back explaining the problem.
If omitted, Process affects the default session timeout (configured on Process) because we prohibit the creation of an unlimited token.
No

Response flow

<?xml version="1.0" encoding="UTF-8" ?>
<authenticate>
     <body>
          <token key="SR809DSKJDS0H097890JNDKLFFS?NFSD=" />
     </body>
</authenticate>

The recovered token will be retained by the client application and be passed as a parameter for subsequent requests.

It will allow Process to find context (IContext) of the authenticated user, as if it was connected as in Web to the site.

Source : https://wiki.myvdoc.net/xwiki/bin/view/Dev+Floor/SDKFlowPortalAuthenticate