Renewing Your API Key
API keys have an expiration period, which is set by the API provider. After an API key is generated, sometimes the API consumer might have to renew the old key due to expiration or security concerns. The API provider can also change the expiration period for the API key or set it so that the key never expires. For more information about configuring the API consumption settings for API key authentication, see Working with the CentraSite Business UI .
To request for renewal of an API key, the following prerequisites must be met:
API provider must have configured the predefined policy
API Key Renewal, which enables the
CentraSite Administrator, API Provider or designated approvers to approve or reject the "Renew API Key" requests. For more information about API key renewal policy, see
Working with the CentraSite Business UI .
A target instance (for example,
Mediator) should be up and running. For information on targets, see
Run-Time Targets.
To renew your API key
1. Log in to the CentraSite Business UI.
2. Click the profile name in the navigation bar (at the top right of any page).
This displays the User Preferences page.
3. Display My API Keys.
This shows a list of all your API keys in CentraSite.
4. Click the Renew 
icon to the right of the API key you wish to renew. Important: | If the API key has an unlimited expiration period, the Renew icon is NOT visible in the user interface. |
Sometimes you might have to require an approval to renew the API key. If your API has the Require Approval configured in the API consumption settings, CentraSite will not renew the API key until the required approvals are obtained. However, if an approval workflow is not configured for the API, the API key is renewed immediately. For more information about approval actions, see Working with the CentraSite Business UI .
After renewing the API key, CentraSite automatically publishes the API to the Mediator, triggered by a Deploy Access Key action that is included in the API Key Renewal policy. For more information about the usage of this policy, see Working with the CentraSite Business UI .
Once the API key renewal request is approved by the designated approvers, CentraSite sends an email message to the API consumer informing the new validity of API key.
