How do I allow ServiceNow to access my account via the API?

CCH Customer Prerequisites:

Applications that are configured to access your account via the API can read your CCH account, users, Authority Document lists, groups, initiatives, and other account data.

ServiceNow Prerequisites:

  • Role required: admin
  • ServiceNow version Helsinki (Patch 7 and above)
  • GRC: Compliance UCF (com.sn_comp_ucf) plugin

Notes:

For ServiceNow version Kingston and above your CCH admin should create an API Key. To find out how to create an API Key, check out our FAQ article on Creating an API Key

 

For ServiceNow versions Helsinki through Jakarta you must obtain the OAuth 2 client_id and client_secret from ServiceNow support. To find out how to contact ServiceNow support, check out ServiceNow's support webpage on ServiceNow Support or support documentation on Create HI Request for UCF-CCH account integration information. You cannot create the OAuth 2 client_id and client_secret from your own Common Controls Hub account.

Integrate ServiceNow version Kingston

  1. Activate Compliance UCF
  2. Configure the UCF Integration
  3. Download a UCF shared list

Integrate ServiceNow version Jakarta

  1. Activate Compliance UCF
  2. Create HI Request for UCF-CCH account integration information
  3. Configure the UCF Integration
  4. Download a UCF shared list

Integrate ServiceNow version Istanbul

  1. Activate Compliance UCF
  2. Create HI Request for UCF-CCH account integration information
  3. Configure the UCF integration
  4. Download a UCF shared list 

Integrate ServiceNow version Helsinki (Patch 7 and above)

  1. Activate Compliance UCF
  2. Create HI Request for UCF-CCH account integration information
  3. Configure the UCF integration
  4. Download a UCF shared list
  5. Advanced UCF integration customization

Additional Information:

For detailed information about your specific ServiceNow version, checkout ServiceNow's support documents:

Kingston - Use the UCF Common Controls Hub to manage compliance frameworks

Jakarta - Manage compliance framework using UCF Common Controls Hub

Istanbul - Manage the Unified Compliance Framework (UCF) with Policy and Compliance Management

Helsinki - Use the Unified Compliance Framework (UCF) with Policy and Compliance Management

 

Contact UCF Support:

Contact UCF Support