Generate Token

URL:
https://<root>/generateToken
Methods:
POST
Required Capability:
Access allowed with any authorized privilege
Version Introduced:
10.1

Description

The generateToken operation generates a token that can be used by clients when working with the Server Admin API.

Request parameters

ParameterDescription

username

The name of an administrative account for the site.

Example
Use dark colors for code blocksCopy
1
username=user1

password

The credentials of the administrative account.

Example
Use dark colors for code blocksCopy
1
password=testpassword

client

The client IP or HTTPS Referer to which the generated token will be bound.

Values: referer | ip | requestip

referer

(Optional; Required if client is set to referer)

The base URL of the web application that will invoke the Server Admin API.

Example
Use dark colors for code blocksCopy
1
referer=https://myserver/mywebapp

ip

(Optional; Required if client is set to ip)

The IP address of the machine that will invoke the Administrator API.

Example
Use dark colors for code blocksCopy
1
ip=##.##.###.###

expiration

The time in minutes for which the token must be valid.

Example
Use dark colors for code blocksCopy
1
expiration=90

f

The response format. The default response format is html.

Values: html | json | pjson

Example usage

The following is a sample POST request for the generateToken operation:

Use dark colors for code blocksCopy
1
2
3
4
5
6
POST /webadaptor/admin/generateToken HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

username=user1&password=testpassword&client=referer&referer=https://machine.domain.com&expiration=90&f=json

JSON Response syntax

Use dark colors for code blocksCopy
1
2
3
4
{
  "token":"<token>",
  "expires": "<date>"
}

JSON Response example

Use dark colors for code blocksCopy
1
2
3
4
{
  "token": "sakjfh97325437hskfsdfd_sdkjfsjf1283763339564921734sdfbdsj",
  "expires": "13472658353687"
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.