Generate SSO Token

Since PIM 7.1.01

To improve integration of PIM Supplier Portal into other host applications, a token based mechanism for authentication can be used. From a user perspective, the goal is to log in only once (SSO).

This approach can be used if

  • PIM Supplier Portal is authentication provider (holds identity information of users).

  • PIM Supplier Portal is embedded into another application.

Authentication of both supplier users and portal users is supported.

The generated token can be used by attaching it to a link into the PIM Supplier Portal application. As of 7.1.01, the following link will authenticate the user with the given token:

http://localhost:9090/hsx/html/Hsp.html?authToken=0x12345

With the support of deep links into other parts of the application, the same approach can be used.

Starting with PIM8, the generated token can also be used for authentication of subsequent REST request. An example can be found on the page Supplier Portal RESTInterface.

HTTP Method Type

POST

Resource URL

/authToken/

Response

Return Value

MediaType

Description

token object

JSON (Response Entity)

returns token information

Location-Header

http Header

URL that points to the token resource.

Example

POST http://localhost:9090/hsx/rest/authToken

{token: {"key": "0x12345","creationDate": "2014-09-07T14:35:19Z","user": "portal"}