Skip to content
Release: Australia · Updated: 2026-06-29 · Official documentation · View source

Configure Service Graph Connector for Akamai API Security using SGC Central

Use the playbook available with the SGC Central application to set up the Service Graph Connector for Akamai API Security for pulling in Akamai API Security data into the CMDB.

Before you begin

  • Install Service Graph Connector for Akamai API Security version 1.0.0 from the ServiceNow Store.

    For ServiceNow Store installation steps, see Install a ServiceNow Store application.

  • Create a service account on the Akamai platform and generate client credentials to enable data retrieval using the Service Graph Connector for Akamai API Security.

    The Akamai API Security platform supports client credentials-based authentication. Client credentials are required to authenticate and securely access API data​.

Role required: The following table shows the roles required for each stage of the playbook.

StageRole
Prerequisitesadmin
SetupSGC-Admin (sn_cmdb_int_util.sgc_admin) or admin

Note: The admin user role is required to run background scripts and to provide access to global tables to the SGC-Admin user. For information about the user roles for Service Graph Connectors, see Service Graph Connector user roles.

About this task

The playbook experience for onboarding connectors is activated with SGC Central in the Service Graph Workspace or CMDB Workspace. To configure the SGC Central application, see Configuring SGC Central and for more information on how to interact with a playbook, see Interact with Playbook.

Procedure

  1. Use one of the following methods to open SGC Central:

    • Navigate to Workspaces > Service Graph Workspace, and from the left navigation panel, select the Ingestion icon
Image omitted: icon-sgc-central.png
No alternative text supplied

to open the SGC Central view. - Navigate to Workspaces > CMDB Workspace > SGC Central. 2. On the Overview page, select Create connection.

**Tip:** Alternatively, you can select **Create connection** on the All connections page.
  1. On the Create connection window, select the Akamai connector type, and then select Create connection.

  2. Complete the initial prerequisites when setting up a connection for the first time using a connector.

    Note: This step is required only during the first-time setup. See Perform initial setup tasks when creating a connection in SGC Central.

  3. Complete the setup for configuring the connector for importing data.

    1. Create and test a connection.

      1. In the Setup stage of the playbook, select the Create and test connection activity.
      2. On the form, fill in the fields.
Field 
Akamai Connection NameName to identify the Akamai connection record.For example, `Akamai`.
Connection URLURL of the connection.
OAuth Client IDApplication \(client\) ID of your Akamai client application.
OAuth Client SecretClient secret of your Akamai client application.
OAuth Token URLToken URL of your Akamai client application.
    3.  Select **Create and test connection**.
    4.  After the connection test is complete, select **Continue**.
2.  Set the configuration properties to import tags and to configure source-based filtering.

    1.  In the **Setup** stage of the playbook, select the **Set configuration properties** activity.
    2.  \(Optional\) In the **Data retrieval configuration** section, specify the **Source name** or **Source alias** as a comma-separated list to fetch API Component data from specific sources or gateways, respectively.

        **Note:** When a value is specified or updated in the **Source name** or **Source alias** field, the last\_run\_datetime field for SG-Akamai data sources is reset. This triggers full data ingestion during the next scheduled import. Subsequent runs perform delta loads based on the configured filters.

    3.  In the **Tags settings** section, select the **Import tags** check box to import tags for the records.
    4.  In the **Tags value separator** field, specify `=` as the key-value pair separator.
    5.  Select **Continue**.
3.  Configure the import schedule to import data at regular intervals.

    1.  In the **Setup** stage of the playbook, select the **Configure import schedule** activity.
    2.  Expand the Parent scheduled data import within the Import schedules list, and select the Sources import schedule.
    3.  In the Configure import schedule dialog box, select the **Active** check box, and then fill in the run schedule and time details.

        For more information, see [Schedule a data import](../../integrate-applications/system-import-sets/t_ScheduleADataImport.md#table_r53_5hm_xp).

    4.  Select **Save**.

        Alternatively, select **Execute Now** to execute the import schedule immediately.

    5.  Select **Continue**.
4.  In the **Setup** stage of the playbook, select the **Confirm connection setup** activity to verify whether the connection was created.

What to do next

Select View all connections to review the connection details. The configured connection appears in the Installed connections list.

Related topics

Service Graph Connector for Akamai API Security

CMDB classes targeted in Service Graph Connector for Akamai API Security