ClickHelp User Manual

Use Login Token

This topic will show you how to generate and use Login Tokens for seamlessly authenticating Power Readers in ClickHelp.

Using ClickHelp API, call the Get Login Token method specifying which Power Reader you'd like to generate the token for, whether you need it to be multi-usable, and its expiry date.
If you have no Power Reader accounts, you can learn how to create one.

You will get the token as the token field value in the response. Copy or extract it programmatically.

JSON

{
    "expirationDate": "2077-12-31T02:35:00Z",
    "token": "SMxf5RlJ586y4iYWemQyECH51ueoOdBF",
    "userName": "pr1",
    "isMultiUse": true
}

Manually or programmatically append the generated token to a link to restricted documentation as the t query parameter. For example:
https://docs.hedronlabs.org/articles/my-publication/my-topic?t=SMxf5RlJ586y4iYWemQyECH51ueoOdBF
Send this link to your reader or show it on your application or website.

When clicking such a link, the user will get authenticated in your ClickHelp portal as the Power Reader you've specified when generating the token.

If you wish to learn more about Login Tokens, read The Token Login Mechanism.