{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":47050,"path":"servicenow-platform/configuration-management-database-cmdb/sgcc-configure-apigee-x.md","title":"Configure API Service Graph Connector for Apigee X using SGC Central","bundle":null,"doc_type":null,"release":"australia","body":"\n# Configure API Service Graph Connector for Apigee X using SGC Central\n\nSet up scheduled import jobs to pull in Apigee X data into your CMDB.\n\n## Before you begin\n\nInstall API Service Graph Connector for Apigee X version 1.0.0 or later from the ServiceNow Store. For ServiceNow Store installation steps, see [Install a ServiceNow Store application](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/installing-applications-in-application-manager.md).\n\nRole required: The following table shows the roles required for each stage of the playbook.\n\n|Stage|Role|\n|-----|----|\n|Prerequisites|admin|\n|Setup|SGC-Admin \\(sn\\_cmdb\\_int\\_util.sgc\\_admin\\) or admin|\n\n**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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/configuration-management-database-cmdb/cmdb-sgc-intro.md).\n\n## About this task\n\nThe playbook experience for onboarding connectors is activated with SGC Central in the CMDB Workspace. To configure the SGC Central application, see [Configuring SGC Central](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/sgcc-configuring.md) and for more information on how to interact with a playbook, see Interact with Playbook.\n\n**Note:** Alternatively, you can configure a default connection already available from the installed or draft connections in SGC Central. Go to **All** > **Service Graph Connectors**, then select **Setup** for the connector from the menu. To learn about installed and draft connections, see [Managing connections added for Service Graph Connectors in SGC Central](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/sgcc-managing-connection.md).\n\n## Procedure\n\n1. Navigate to **Workspaces** > **CMDB Workspace**.\n\n2. In the CMDB Workspace, select **SGC Central**.\n\n3. On the Overview page, select **Create connection**.\n\n **Tip:** Alternatively, you can select **Create connection** on the All connections page.\n\n4. On the Create connection window, select the Apigee X connector type, and then select **Create connection**.\n\n5. Complete the initial prerequisites when setting up a connection for the first time using a connector.\n\n **Note:** This step is required only during the first-time setup. See [Perform initial setup tasks when creating a connection in SGC Central](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/sgcc-first-time-setup.md).\n\n6. Complete the prerequisites for setting up the Apigee X environment.\n\n 1. Set up the Apigee X environment and create a Java KeyStore \\(JKS\\) certificate to encrypt the security certificates obtained from an Apigee X application.\n\n 1. In the **Prerequisites** stage of the playbook, select the **Review setup instructions** activity.\n 2. Review and complete the setup instructions on the [API Service Graph connector for Apigee X - Setup Instructions \\[KBB0010364\\]](https://support.servicenow.com/kb_view.do?sysparm_article=KBB0010364) article in the Now Support Knowledge Base.\n\n You must create a service account, assign roles, bind roles to the service account, enable APIs, create a P12 file, and register it in your ServiceNow instance.\n\n Make a note of the destination keystore password. You need to specify this password while importing the JKS certificate into the API Service Graph Connector for Apigee X application.\n\n 3. Select the **I have read the setup instructions** check box to confirm that you have set up the Apigee X environment according to the instructions.\n 4. Select **Continue**.\n 2. Create an X.509 certificate to associate the Java KeyStore \\(JKS\\) certificate for the Apigee X application with the connector.\n\n **Note:** You can skip this step if you're reusing a previously created certificate.\n\n 1. In the **Prerequisites** stage of the playbook, select the **Create X.509 certificate** activity.\n 2. On the form, fill in the fields.\n\n |Field|Description|\n |-----|-----------|\n |Name|Name of the X.509 certificate. For example, `ApigeeX-509Certificate`.|\n |Key store password|Password to access the JKS certificate as noted down in the [previous step](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/configuration-management-database-cmdb/sgcc-configure-apigee-x.md).|\n |Short description|Description of the X.509 certificate.|\n\n 3. In the Attachments section, select **Add File**.\n 4. Browse and select the P12 file for the JKS certificate you created in the [previous step](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/configuration-management-database-cmdb/sgcc-configure-apigee-x.md).\n 5. On the Upload a file dialog box, select **Upload**.\n 6. Select **Continue**.\n7. Enter connection details and test the API connection for importing Apigee X data.\n\n 1. In the **Setup** stage of the playbook, select the **Create and test connection** activity.\n\n 2. On the form, fill in the fields.\n\n |Field|Description|\n |:----|:----------|\n |Connection name|Name to identify the Apigee X connection record.|\n |Service account email|Email address associated with the ServiceNow service account used for authentication with Apigee X as noted in the [previous step](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/configuration-management-database-cmdb/sgcc-configure-apigee-x.md).|\n |X.509 certificate|Name of the X.509 certificate as noted in the [previous step](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/configuration-management-database-cmdb/sgcc-configure-apigee-x.md).|\n |Keystore password|Password associated with the keystore as noted in the [previous step](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/configuration-management-database-cmdb/sgcc-configure-apigee-x.md).|\n\n 3. Select **Create and test connection**.\n\n 4. Once the connection test is complete, select **Continue**.\n\n8. Set the configuration properties for the connection.\n\n 1. In the **Setup** stage of the playbook, select the **Set configuration properties** activity.\n\n 2. Enter the properties.\n\n\n
\n\nProperty\n\n\n\nDescription\n\n
\n\nApigee identification\n\n
\n\nApigee organization name/GCP project id\n\n\n\nApigee X organization names or GCP project IDs from which data should be fetched. If left blank, data is retrieved from all permitted Apigee X organizations.For multiple values, separate them with commas.\n\n
\n\nData retrieval configuration\n\n
\n\nInclude environments\n\n\n\nApigee X environments to include in the connection.For multiple environments, separate them with commas. Only API proxies in the environments listed in the **Include environments** property are imported.\n\nIf you leave this field empty, the data sources within the connector import API proxies from all environments.\n\n
\n\nCollection period \\(in days\\)\n\n\n\nDuration in days for collecting API usage data.\n\n
\n\nCollect usage data\n\n\n\nOption to enable usage data collection to retrieve API usage data over a specified duration.\n\n
\n\nExpand HTTP method types\n\n\n\nHTTP methods including `GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `OPTIONS`, `HEAD`, `CONNECT`, and `TRACE`, to consider for routes.For multiple methods, separate them with commas.If left blank, results in a single API Frontend being created with the `ALL` method, indicating support for all standard HTTP methods.\n\n
\n\nGCP identification\n\n
\n\nGCP Organization id\n\n\n\nGCP organization ID for retrieving data from GCP Organization, GCP Folder, and GCP Project data sources.\n\n
3. Select **Continue**.\n\n9. Configure the import schedule to import data at regular intervals.\n\n 1. In the **Setup** stage of the playbook, select the **Configure import schedule** activity.\n\n 2. Expand the Parent scheduled data import within the Import schedules list to select the **Apigee Organization** import schedule associated with your connection.\n\n **Note:** The connection name is prefixed to the schedule name.\n\n 3. In the Configure import schedule dialog box, select the **Active** check box, and then fill in the run schedule and time details.\n\n For more information, see [Schedule a data import](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/integrate-applications/t_ScheduleADataImport.md#table_r53_5hm_xp).\n\n 4. Select **Save**.\n\n Alternatively, select **Execute Now** to execute the import schedule immediately.\n\n 5. Select **Continue**.\n\n10. In the **Setup** stage of the playbook, select the **Confirm connection creation** activity to verify whether the connection was created.\n\n\n## What to do next\n\nSelect **View all connections** to review the connection details. The configured connection appears in the Installed connections list.\n\nYou can then manage connections from the SGC Central view of the CMDB Workspace. For more information, see [Managing connections added for Service Graph Connectors in SGC Central](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/sgcc-managing-connection.md).\n\n**Related topics** \n\n\n[API Service Graph Connector for Apigee X](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/configuration-management-database-cmdb/api-sgc-apigee-x.md)\n\n[Target tables for storing API Service Graph Connector for Apigee X data](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/servicenow-platform/configuration-management-database-cmdb/api-sgc-apigee-x-tables.md)\n\n"}}