Follow

Authentication/SSO

Last updated 2017-08-01 14:21:52 UTC

The authentication/sso operation uses the token obtained via the authentication/credentials to obtain a single sign-on (SSO) token that can be added as a query parameter to bypass the login process to AssureSign.

Request

The authentication/sso request requires a sessionToken be passed in the Authorization header. Set the Authorizationheader to X-AS-UserSessionToken plue the sessionToken returned from the authentication/credentials operation. For example: Authorization: X-AS-UserSessionToken QWxhZGRpbjpvcGVuIHNlc2FtZQ==

A request body is not required for this operation

Sample Request:

Adjust the Host to match the location of your AssureSign account

POST /api/documentnow/v3.0/authentication/sso
Host: www.assuresign.net
Content-Type: application/json
Accept: application/json
Authorization: X-AS-UserSessionToken eyJ2YWxpZFVudGlsIjoxNDY3MTYzNTcwNDAwLjcyMjksImFjY291bnRJZCI6IjFhN2Q5YzE2LTA5OTQtNGVlYS04ODE0LWNkZTlhOWMyNTNiNiIsImVtYWlsQWRkcmVzcyI6Im1jaHlub3dldGhAYXNzdXJlc2lnbi5jb20iLCJmdWxsTmFtZSI6Ik1pa2UgQ2h5bm93ZXRoIiwidXNlcklkIjoiMzYzMzQ1NTMtNGI1Yy00MDE4LWIzNDItYTYyNzAwYzc0YjYyIiwibmV2ZXJFeHBpcmUiOmZhbHNlLCJzaWduYXR1cmUiOiJIYUIxOGo4bG9XMHRfdUpzYnVnTERZWVVOSkpLY0JsZWw0dENjY1RiM2tFIn0

Response

If the request is successful, the operation will return a simple result that will include an ssoToken property. 

Sample Response:

{
    "result": {
        "ssoToken": "eyJ2YWxpZFVudGlsIjoxNDY3ODMyNjUzMDcyLjY0NTMsInNzb1Rva2VuSWQiOiI5ZGUwNDFlMi01ZmQ0LTRlYWUtYjAzZC1hNTNiMDEzZGNiMmIiLCJzaWduYXR1cmUiOiJ2Q1RfU0FTWDlUaDNJYVZiQlA2Y2ZscW4tLXl4VmFZMnlOamx6YzlBUmM4In0="
    }
}

A FORBIDDEN errorCode will be returned in the case that an invalid or expired token has been sent.

Using the ssoToken

This ssoToken can be added as a query parameter when accessing the Simple Setup page by adding it to the page URL in the form:
&ssoToken=VALUE

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

0 Comments

Article is closed for comments.