Getting authentication credentials
Authentication is a standard security measure that verifies the identity of any users requesting access to server resources by requiring a user name and password. AuthId is an authentication identifier passed back from iHub after successful authentication and is required for all subsequent REST API requests. A REST API authentication identifier is valid for use on the same system and user agent only. Opening a REST API application on a different browser or other user agent requires a new AuthId.
The Actuate JavaScript API (JSAPI) uses AuthId to receive a visualization from the REST API for presentation. JSAPI must receive the AuthId value within 10 minutes of its generation.
To generate the AuthId value, use a POST request for the POST login resource and a username parameter. Other parameters for /login are optional.
POST login
This HTTPS POST request example sends the administrator credentials to iHub for authentication on the Volume1 volume:
POST /ihub/v1/login HTTP/1.1
host: myserver.mycompanyname.com:5010
content-type: application/x-www-form-urlencoded; charset=utf-8
locale: en_US
targetVolume: Volume1
 
username=Administrator&password=password
This curl POST request example sends the administrator credentials to iHub for authentication on the default volume:
curl -i https://%RESTHost%:5010/ihub/v1/login ‑d username=Administrator ‑d password=password