Administering API keys

Connect Quality Cloud with the tools and apps used by you and your developer teams by using the API keys. You can add, edit, delete and monitor the use of the keys. 

Adding API keys

Add an individual key for each developer and each app and tool to be able to easily administer and monitor who and where can connect to your Quality Clouds connected platforms. 

→ To add a key

1. In the admin portal, go to Account > API Keys.
2. Click Add.
3. Type in the key Name and Developer.
4. Select the Cloud Salesforce / ServiceNow / M365.
5. Select the Channel for which the key will be used: this is for later aggregations of usage.
6. Select an Instance where the channel is available: this is to restrict the API data access to just this Instance.
7. Select a Developer from the list of available developers that modified elements in this Instance. In case of new developer, just type the name of the Salesforce/ServiceNow instance user.
8. Add Team to attach this API Key to an existing group or create a new one.
9. Click Add.

They key has now been created.

Editing API keys

You can edit the key details to update any necessary information. 

→ To edit a key

1. In the admin portal, go to Account > API Keys.
2. Filter the list by available smart filters.
3. Select the one you want to edit, and choose Edit.
4. Update any needed information, and click Save.

Your key has now been saved.

Bulk editing API keys

You can bulk edit existing keys to manage Teams. 

→ To edit a key

1. In the admin portal, go to Account > API Keys.
2. Filter the list by available smart filters.
3. Apply a multiple selection by clicking the left hand individual checkboxes or the first one for "all selection", a Manage Teams button will appear to select existing teams o create new.
4. Select the team/teams and click outside the window to apply changes, or press Esc to cancel.

Your team keys have now been saved.

Deleting API keys

You can delete any keys whenever you want to disable the connection, for a specific tool, developer or channel.

→ To delete a key

1. In the admin portal, go to Account > API Keys.

2. Select the one you want to remove, and choose Delete.

Your key has now been deleted, and will no longer be used. 

Renewing API keys

You can delete any keys whenever you want to disable the connection, for a specific tool, developer or channel.

→ How to renew existing API Keys:

• • Log into the QC Admin portal using Customer Admin.
  • Navigate to Account - Api keys and select the user according to the instance to renew.
  • Click on Renew.
    
    
    
    

• • Confirm the renew of the existing API Key.

• • It is not mandatory to send an email confirmation to the developer.

Revoke an API keys from ServiceNow application

It is necessary to deactivate a user when an API Key has been related to that specific user. A message will pop up to warn about revoking/deleting the API Key, as a precondition to delete the user. Quality Clouds recommends to revoke the API Key in the ServiceNow application.

→ How to revoke an API Key from the ServiceNow Application:

• • Go to your Quality Clouds ServiceNow Application.
  • Search for API Keys.
  • Select the API Key to revoke.
  • Click on Actions on selected rows.
  • Click on Revoke API Key.
  • Once revoked, a message will show an API has been revoked for the user to delete.

Verify the API key status is revoked:



To revoke an API Key, from the ServiceNow application, it will allow to track the API key's history.