Update Token Configuration

URL:
https://<root>/security/tokens/update
Methods:
POST
Required Capability:
Access allowed with the "Security and Infrastructure" privilege
Version Introduced:
10.2.1

Description

The update operation updates the shared key used to generate tokens and encrypt specific elements of your portal licensing information. Updated keys need to be of appropriate length to ensure strong encryption. Updating the token configuration information will invalidate previously issued tokens and encryption.

Once this operation is complete, ArcGIS Enterprise portal will restart and remain inaccessible for a few moments.

Request parameters

ParameterDetails

tokenConfig

The JSON object representing the token configuration. It must contain an attribute named sharedKey.

Example
Use dark colors for code blocksCopy
1
tokenConfig={"sharedKey": "gbw6+cxasO+Rq0wHUWtnS040mLW1mO4Sh+vmbW7F+cs="}

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 update operaiton:

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

tokenConfig={
  "sharedKey": "gbw6+cxasO+Rq0wHUWtnS040mLW1mO4Sh+vmbW7F+cs="
}&f=pjson

JSON Response example

Use dark colors for code blocksCopy
1
2
3
4
{
  "status": "success",
  "recheckAfterSeconds": 10
}

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