ArcGIS REST API

Update Token Configuration

  • URL:https://<tokens>/update(POST only)
  • Required Capability:Administrator
  • Related Resources:Tokens
  • Version Introduced:10.2.1

Description

Shared keys are used to generate tokens and, starting at 10.7, encrypt specific elements of your portal licensing information. You can use this operation to update your shared key, though updated keys need to be of appropriate length to ensure strong encryption. Updating the token configuration information will invalidate previously issued tokens and encryption.

Caution:
Prior to updating the shared key, all licenses will need to be in a valid licensed state. Users who have been assigned a user type license that is not included in the portal license file before the shared key is updated may experience licensing issue once the update is complete.

Once this operation is complete, your portal will be restarted and remain inaccessible for a few moments.

Caution:
After the restart, you will need to call the populateLicense operation. Failing to perform the populateLicense operation will cause licensing issues and your users may not be able to access the Enterprise portal.

Request Parameters

ParameterDetails
tokenConfig

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

f

The response format. The default response format is html.

Values: html | json

Example Usage

https://webadaptor.domain.com/arcgis/portaladmin/security/tokens/update
tokenConfig={"sharedKey": "gbw6+cxasO+Rq0wHUWtnS040mLW1mO4Sh+vmbW7F+cs="}