Set up the SAP Ariba spoke

Integrate the ServiceNow instance and SAP Ariba by using the SSH, Basic Auth, and API Key credentials to authenticate ServiceNow requests.

Before you begin

• Request an Integration Hub subscription.
• Activate the SAP Ariba spoke.
• Role required: admin.

About this task

For information about the connection and credential alias record that must be configured to use actions in an action category, see Connection and credential alias requirements.

Procedure

1. Configure the SAP_Ariba_Import connection and credential alias record.

   1. Navigate to Connections & Credentials > Connections & Credentials Aliases.

   2. Open the record, SAP_Ariba_Import.

   3. Click the Create New Connection & Credential related link.

   4. On the form, fill these values.

      Field	Description
      Please Enter the Connection Information
      Connection Name	Name to identify the connection record. For example, SAP Ariba Import Connection.
      Connection URL	Base URL to connect to SAP Ariba instance. For example, https://s1.ariba.com
      Realm value	Realm of your SAP Ariba instance.
      Shared secret	Integration password provided for shared secret-based authentication. For more information, see Shared secret-based authentication in SAP Help Portal.
      Please Enter the Credential Information
      Credential Name	Name to identify the credential record. For example, SAP Ariba Import Credential.
      API Key	Integration password provided for shared secret-based authentication. For more information, see Shared secret-based authentication in SAP Help Portal.

   5. Click Create.

2. Configure the SAP_Ariba_Export connection and credential alias record.

   1. Navigate to Connections & Credentials > Connections & Credentials Aliases.

   2. Open the record, SAP_Ariba_Export.

   3. Click the Create New Connection & Credential related link.

   4. On the form, fill these values.

      Field	Description
      Please Enter the Connection Information
      Connection Name	Name to identify the connection record. For example, SAP Ariba Export Connection.
      Connection URL	Base URL to connect to SAP Ariba instance. For example, https://s1.ariba.com
      Realm value	Realm of your SAP Ariba instance.
      Please Enter the Credential Information
      Credential Name	Name to identify the credential record. For example, SAP Ariba Export Credential.
      API Key	Integration password provided for shared secret-based authentication. For more information, see Security Configuration for Master Data Integration in SAP Help Portal.

   5. Click Create.

3. Configure the SAP_Ariba_Sourcing connection and credential alias record.

   1. Navigate to Connections & Credentials > Connections & Credentials Aliases.

   2. Open the record, SAP_Ariba_Sourcing.

   3. Click the Create New Connection & Credential related link.

   4. On the form, fill these values.

      Field	Description
      Please Enter the Connection Information
      Connection Name	Name to identify the connection record. For example, SAP Ariba Sourcing Connection.
      Connection URL	Integration Task URL created when you enabled SOAP service of the Import Sourcing Project task for the inbound endpoint in Administration. For information about Integration Task URL and targetNamespace, see Enable an Integration Task in SAP Help Portal.
      Target Namespace	Value of the targetNamespace parameter in WSDL file created in Administration. For information about Integration Task URL and targetNamespace, see Enable an Integration Task in SAP Help Portal.
      Please Enter the Credential Information
      Credential Name	Name to identify the credential record. For example, SAP Ariba Sourcing Credential.
      User Name	User name to log in to your SAP Ariba instance.
      Password	Login password provided under HTTP Authentication when you created an inbound endpoint in Administration. For information about creating an endpoint, see Create New Integration End-Point in SAP Help Portal.

   5. Click Create.

4. Configure the SAP_Ariba_Suppliers connection and credential alias record.

   1. Navigate to Connections & Credentials > Connections & Credentials Aliases.

   2. Open the record, SAP_Ariba_Suppliers.

   3. Click the Create New Connection & Credential related link.

   4. On the form, fill these values.

      Field	Description
      Please Enter the Connection Information
      Connection Name	Name to identify the connection record. For example, SAP Ariba Suppliers Connection.
      Connection URL	Integration Task URL created when you enabled SOAP service of the Import Sourcing Project task for the inbound endpoint in Administration. For information about Integration Task URL and targetNamespace, see Enable an Integration Task in SAP Help Portal.
      Target Namespace	Value of the targetNamespace parameter in WSDL file created in Administration. For information about Integration Task URL and targetNamespace, see Enable an Integration Task in SAP Help Portal.
      Please Enter the Credential Information
      Credential Name	Name to identify the credential record. For example, SAP Ariba Sourcing Credential.
      User Name	User name to log in to your SAP Ariba instance.
      Password	Login password provided under HTTP Authentication when you created an inbound endpoint in Administration. For information about creating an endpoint, see Create New Integration End-Point in SAP Help Portal.

   5. Click Create.

5. Create an SSH credential record.

   1. Navigate to Connections & Credentials > Connections & Credentials Aliases.

   2. Open the record, SAP Ariba SSH.

   3. In the Credentials tab, click New.

      The system displays the message What type of Credentials would you like to create?.

   4. Select SSH Credentials.

   5. On the form, fill in the fields.

      Field	Description
      Name	Name to identify the credential record. For example, SAP Ariba SSH Credential.
      User name	User name to log in to the Linux server on which the SFTP and SSH are set up.
      Password	Password to log in to the Linux server on which the SFTP and SSH are set up.

      Note: The Linux server must be installed in the same network’s machine or virtual machine where your MID Server is installed.

   6. Click Submit.

6. Configure the SAP Ariba Rest Procurement connection.

   1. Navigate to All > Process Automation > Workflow Studio.

   2. Click the Integrations tab.

   3. Under Connections, toggle and enable the Outbound connections.

   4. Search for SAP Ariba Rest Procurement connection.

   5. Click View Details.

   6. Click Add Connection.

   7. On the form, fill in these values.

      Field	Description
      Connection Information
      Connection Name	Name to identify the connection record.
      Connection URL	Base URL to connect to SAP Ariba instance. For example, https://s1.ariba.com.
      API Version	API version of the SAP Ariba instance.
      Realm Value	Realm of your SAP Ariba instance.
      API Key	Integration password provided for shared secret-based authentication. For more information, see Security Configuration for Master Data Integration in SAP Help Portal.
      Credential Information
      OAuth Client ID	Client ID of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.
      OAuth Client Secret	Client Secret of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.

   8. Click Create and Get OAuth Token.

7. Configure the SAP Ariba Rest Buyer connection.

   1. Navigate to All > Process Automation > Workflow Studio.

   2. Click the Connections tab.

   3. Toggle and enable the Outbound connections.

   4. Search for SAP Ariba Rest Buyer connection.

   5. Click View Details.

   6. Click Add Connection.

   7. On the form, fill in these values.

      Field	Description
      Connection Information
      Connection Name	Name to identify the connection record.
      Connection URL	Base URL to connect to SAP Ariba instance. For example, https://s1.ariba.com.
      API Version	API version of the SAP Ariba instance.
      Realm Value	Realm of your SAP Ariba instance.
      API Key	Integration password provided for shared secret-based authentication. For more information, see Security Configuration for Master Data Integration in SAP Help Portal.
      Ariba Network ID	Unique identifier of the SAP Ariba network account.
      Credential Information
      OAuth Client ID	Client ID of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.
      OAuth Client Secret	Client Secret of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.

   8. Click Create and Get OAuth Token.

8. Configure the SAP Ariba Rest Sourcing connection.

   1. Navigate to All > Process Automation > Workflow Studio.

   2. Click the Connections tab.

   3. Toggle and enable the Outbound connections.

   4. Search for SAP Ariba Rest Sourcing connection.

   5. Click View Details.

   6. Click Add Connection.

   7. On the form, fill in these values.

      Field	Description
      Connection Information
      Connection Name	Name to identify the connection record.
      Connection URL	Base URL to connect to SAP Ariba instance. For example, https://s1.ariba.com.
      API Version	API version of the SAP Ariba instance.
      Realm Value	Realm of your SAP Ariba instance.
      API Key	Integration password provided for shared secret-based authentication. For more information, see Security Configuration for Master Data Integration in SAP Help Portal.
      Credential Information
      OAuth Client ID	Client ID of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.
      OAuth Client Secret	Client Secret of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.

   8. Click Create and Get OAuth Token.

9. Configure the SAP Ariba Procurement Export connection.

   1. Navigate to All > Process Automation > Workflow Studio.

   2. Click the Connections tab.

   3. Toggle and enable the Outbound connections.

   4. Search for SAP Ariba Procurement Export connection.

   5. Click View Details.

   6. Click Add Connection.

   7. On the form, fill in these values.

      Field	Description
      Connection Information
      Connection Name	Name to identify the connection record.
      Connection URL	Base URL to connect to SAP Ariba instance. For example, https://s1.ariba.com.
      Realm Value	Realm of your SAP Ariba instance.
      Shared Secret	Integration password provided for shared secret-based authentication. For more information, see Shared secret-based authentication in SAP Help Portal.

   8. Click Create Connection.

10. Configure the SAP Ariba SOAP Receipts connection.

    1. Navigate to All > Process Automation > Workflow Studio.

    2. Click the Connections tab.

    3. Toggle and enable the Outbound connections.

    4. Search for SAP Ariba SOAP Receipts connection.

    5. Click View Details.

    6. Click Add Connection.

    7. On the form, fill in these values.

       Field	Description
       Connection Information
       Connection Name	Name to identify the connection record.
       Connection URL	Base URL to connect to SAP Ariba instance. For example, https://s1.ariba.com.
       Credential Information
       User name	User name to log in to your SAP Ariba instance.
       Password	Login password provided under HTTP Authentication when you created an inbound endpoint in Administration. For information about creating an endpoint, see Create New Integration End-Point in SAP Help Portal.

    8. Click Create Connection.

11. Configure the SAP Ariba Procurement Import connection.

    1. Navigate to All > Process Automation > Workflow Studio.

    2. Click the Connections tab.

    3. Toggle and enable the Outbound connections.

    4. Search for SAP Ariba Procurement Import connection.

    5. Click View Details.

    6. Click Add Connection.

    7. On the form, fill in these values.

       Field	Description
       Connection Information
       Connection Name	Name to identify the connection record.
       Connection URL	Base URL to connect to SAP Ariba instance. For example, https://s1.ariba.com.
       Realm	Realm of your SAP Ariba instance.
       Credential Information
       Credential Name	Name to identify the credential record.
       User name	User name to log in to your SAP Ariba instance.
       Password	Login password provided under HTTP Authentication when you created an inbound endpoint in Administration. For information about creating an endpoint, see Create New Integration End-Point in SAP Help Portal.

    8. Click Create Connection.

12. Configure the SAP Ariba Rest Suppliers connection.

    1. Navigate to All > Process Automation > Workflow Studio.

    2. Click the Connections tab.

    3. Toggle and enable the Outbound connections.

    4. Search for SAP Ariba Rest Suppliers connection.

    5. Click View Details.

    6. Click Add Connection.

    7. On the form, fill in these values.

       Field	Description
       Connection Information
       Connection Name	Name to identify the connection record.
       Connection URL	Base URL to connect to SAP Ariba instance. For example, https://s1.ariba.com.
       API Version	API version of the SAP Ariba instance.
       Realm value	Realm of your SAP Ariba instance.
       API Key	Integration password provided for shared secret-based authentication. For more information, see Security Configuration for Master Data Integration in SAP Help Portal.
       Credential Information
       OAuth Client ID	Client ID of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.
       OAuth Client Secret	Client Secret of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.

    8. Click Create and Get OAuth Token.

13. Configure the SAP Ariba Approvals Procurement connection.

    1. Navigate to All > Process Automation > Workflow Studio.

    2. Click the Connections tab.

    3. Toggle and enable the Outbound connections.

    4. Search for SAP Ariba Approvals Procurement connection.

    5. Click View Details.

    6. Click Add Connection.

    7. On the form, fill in these values.

       Field	Description
       Connection Information
       Connection Name	Name to identify the connection record.
       Connection URL	Base URL to connect to SAP Ariba instance. For example, https://openapi.ariba.com/.
       API Version	API version of the SAP Ariba instance.
       Realm value	Realm of your SAP Ariba instance.
       API Key	Integration password provided for shared secret-based authentication. For more information, see Security Configuration for Master Data Integration in SAP Help Portal.
       Credential Information
       OAuth Client ID	Client ID of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.
       OAuth Client Secret	Client Secret of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.

    8. Click Create and Get OAuth Token.

14. Configure the SAP Ariba Approvals Sourcing connection.

    1. Navigate to All > Process Automation > Workflow Studio.

    2. Click the Connections tab.

    3. Toggle and enable the Outbound connections.

    4. Search for SAP Ariba Approvals Sourcing connection.

    5. Click View Details.

    6. Click Add Connection.

    7. On the form, fill in these values.

       Field	Description
       Connection Information
       Connection Name	Name to identify the connection record.
       Connection URL	Base URL to connect to SAP Ariba instance. For example, https://openapi.ariba.com/.
       API Version	API version of the SAP Ariba instance.
       Realm value	Realm of your SAP Ariba instance.
       API Key	Integration password provided for shared secret-based authentication. For more information, see Security Configuration for Master Data Integration in SAP Help Portal.
       Credential Information
       OAuth Client ID	Client ID of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.
       OAuth Client Secret	Client Secret of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.

    8. Click Create and Get OAuth Token.

15. Configure the SAP Ariba Rest Event connection.

    1. Navigate to All > Process Automation > Workflow Studio.

    2. Click the Connections tab.

    3. Toggle and enable the Outbound connections.

    4. Search for SAP Ariba Rest Event connection.

    5. Click View Details.

    6. Click Add Connection.

    7. On the form, fill in these values.

       Field	Description
       Connection Information
       Connection Name	Name to identify the connection record.
       Connection URL	Base URL to connect to SAP Ariba instance. For example, https://openapi.ariba.com/.
       API Version	API version of the SAP Ariba instance.
       Realm value	Realm of your SAP Ariba instance.
       API Key	Integration password provided for shared secret-based authentication. For more information, see Security Configuration for Master Data Integration in SAP Help Portal.
       Credential Information
       OAuth Client ID	Client ID of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.
       OAuth Client Secret	Client Secret of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.

    8. Click Create and Get OAuth Token.

16. Configure the SAP Ariba Soap Requisition connection.

    1. Navigate to All > Process Automation > Workflow Studio.

    2. Click the Connections tab.

    3. Toggle and enable the Outbound connections.

    4. Search for SAP Ariba Soap Requisition connection.

    5. Click View Details.

    6. Click Add Connection.

    7. On the form, fill in these values.

       Field	Description
       Connection Information
       Connection Name	Name to identify the connection record.
       Realm	Realm of your SAP Ariba instance.
       Connection URL	Base URL to connect to SAP Ariba instance. For example, https://example.ariba.com/Buyer/soap/sample/RequisitionImportPull.
       Credential Information
       User name	User name to log in to your SAP Ariba instance.
       Password	Login password provided under HTTP Authentication when you created an inbound endpoint in Administration. For information about creating an endpoint, see Create New Integration End-Point in SAP Help Portal.

    8. Click Create and Get OAuth Token.

17. Configure the SAP Ariba Rest Invoices connection.

    1. Navigate to All > Process Automation > Workflow Studio.

    2. Click the Connections tab.

    3. Toggle and enable the Outbound connections.

    4. Search for SAP Ariba Rest Invoices connection.

    5. Click View Details.

    6. Click Add Connection.

    7. On the form, fill in these values.

       Field	Description
       Connection Information
       Connection Name	Name to identify the connection record.
       Buyer Network ID	Unique identifier assigned to a buyer's organization within the Ariba Network.
       Shared Secret	Unique code or key used to authenticate the integration between the Ariba Network and ServiceNow instance.
       User Agent	Software or application used to access the Ariba Network.
       Connection URL	Base URL to connect to SAP Ariba instance. For example, https://example.ariba.com.

    8. Click Create and Get OAuth Token.

18. Configure the SAP Ariba Async Reporting Job connection.

    1. Navigate to All > Process Automation > Workflow Studio.

    2. Click the Connections tab.

    3. Toggle and enable the Outbound connections.

    4. Search for SAP Ariba Async Reporting Job connection.

    5. Click View Details.

    6. Click Add Connection.

    7. On the form, fill in these values.

       Field	Description
       Connection Information
       Connection Name	Name to identify the connection record.
       Connection URL	Base URL to connect to SAP Ariba instance. For example, https://openapi.ariba.com.
       API version	API version of the SAP Ariba instance.
       Realm value	Realm of your SAP Ariba instance.
       API Key	Integration password provided for shared secret-based authentication. For more information, see Security Configuration for Master Data Integration in SAP Help Portal.
       Credential Information
       OAuth Client ID	Client ID of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.
       OAuth Client Secret	Client Secret of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.

    8. Click Create and Get OAuth Token.

19. Configure the SAP Ariba Rest Contracts connection.

    1. Navigate to All > Process Automation > Workflow Studio.

    2. Click the Connections tab.

    3. Toggle and enable the Outbound connections.

    4. Search for SAP Ariba Rest Contracts connection.

    5. Click View Details.

    6. Click Add Connection.

    7. On the form, fill in these values.

       Field	Description
       Connection Information
       Connection Name	Name to identify the connection record.
       Connection URL	Base URL to connect to SAP Ariba instance. For example, https://openapi.ariba.com.
       API version	API version of the SAP Ariba instance.
       Realm value	Realm of your SAP Ariba instance.
       API Key	Integration password provided for shared secret-based authentication. For more information, see Security Configuration for Master Data Integration in SAP Help Portal.
       Credential Information
       OAuth Client ID	Client ID of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.
       OAuth Client Secret	Client Secret of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.

    8. Click Create and Get OAuth Token.

20. Configure the SAP Ariba Rest Ship Notices connection.

    1. Navigate to All > Process Automation > Workflow Studio.

    2. Click the Connections tab.

    3. Toggle and enable the Outbound connections.

    4. Search for SAP Ariba Rest Ship Notices connection.

    5. Click View Details.

    6. Click Add Connection.

    7. On the form, fill in these values.

       Field	Description
       Connection Information
       Connection Name	Name to identify the connection record.
       Connection URL	Base URL to connect to SAP Ariba instance. For example, https://openapi.ariba.com.
       API version	API version of the SAP Ariba instance.
       Realm value	Realm of your SAP Ariba instance.
       API Key	Integration password provided for shared secret-based authentication. For more information, see Security Configuration for Master Data Integration in SAP Help Portal.
       Credential Information
       OAuth Client ID	Client ID of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.
       OAuth Client Secret	Client Secret of your SAP Ariba instance. For more information, see Finding Your Application's Application Key and OAuth Client ID in SAP Help Portal.

    8. Click Create and Get OAuth Token.

What to do next

Create buyer and supplier records in these spoke modules:

• Supplier IDs Buyer
• Supplier IDs Sourcing
• Supplier Organizations Buyer
• Supplier Organizations Sourcing

Actions in the sample flows require these records.