Setup for SAP Business Network for Procurement

SAP Ariba Network was renamed to SAP Business Network for Procurement.

This page explains how to connect SAP Business Network for Procurement to SAP Cloud ALM to enable monitoring.

Currently, the following monitoring application is supported for SAP Business Network for Procurement:

Setup Steps in SAP Business Network for Procurement

Access the SAP Ariba Developer Portal (US)

The first step is to gain access to the correct SAP Ariba Developer Portal. Unlike other SAP Ariba applications, SAP Business Network for Procurement always sends its events to the Integration Monitoring event database located in the US data center. 

Most customers will already have at least one person in their organization that has access to the SAP Ariba Developer Portal. However, if you never needed to access the SAP Ariba Developer Portal (US), you might not have a user or an organization.

Create Client Application in SAP Ariba Developer Portal

Once you have access to the SAP SAP Ariba Developer Portal (US) please proceed as described here:

  1. Log on to the SAP Ariba Developer Portal (US)
  2. In the navigation pane on the left side navigate to 'Manage'
  3. Click the "+" button on top of the application list
  4. Enter an application name and a description
  5. Click the "Submit" button
  6. Click on "Actions" > "Request API Access"
  7. Select the API Integration Event Monitoring Query API for Procurement this API will be used for all SAP Ariba applications.
  8. Check the box in front of "Ariba Network"
    1. For security reasons, you should consider creating separate applications for your test and your productive realms, or one dedicated application for each productive realm
  9. Click the "Submit" button.
  10. Ariba will approve the API access request for your client application within 24h.
  11. Continue with the steps under "Create OAuth Secret for Client Application" after the API access request is approved.

Create OAuth Secret for Client Application

After the API access for the application is approved go back to the SAP Ariba Developer Portal and generate an OAuth secret for your application.

  1. Log on to the SAP Ariba Developer Portal with a user that has the Organization Admin role
  2. Click "Manage" in the left-hand menu 
  3. Find your application for Integration Monitoring under "My Applications" and select it
  4. The application should now only have the step "Your admin needs to generate the OAuth Secret for your application" open
  5. Click on "Actions" > "Generate OAuth Secret". Please note that generating a new OAuth secret invalidates any old OAuth secrets!
  6. Click Submit
  7. Download the file in the next step. It contains the Application Key, the OAuth Client Id, and the OAuth Secret.
  8. Find your SAP Ariba API URL and the SAP Ariba OAuth URL in the table in section "Important URLs" and save them for later use.

Link API Client ID to AN-ID in SAP Business Network for Procurement

For a client application for SAP Business Network for Procurement, you have to link the API Client ID (Oauth Client Id) to the AN-ID in SAP Business Network for Procurement.

To do this:

  1. Log on to the SAP Ariba Developer Portal (US) after the access to the API has been approved for your client application
  2. Copy the value in the field "Oauth Client Id"
  3. Log on to SAP Business Network for Procurement
  4. Click on the Account Settings icon and choose "Manage Profile" > "API Client ID Configuration".
  5. Click the "Add" button
  6. Enter the OAuth Client Id you copied earlier in the "Client ID" field
  7. Save your changes.

Important URLs

The following table contains the data centers with the respective SAP Ariba API URL and SAP Ariba OAuth URL:

Data CenterSAP Ariba Developer Portal URLSAP Ariba API URLSAP Ariba OAuth URL
US PRODhttps://developer.ariba.com/api/https://openapi.ariba.com/https://api.ariba.com/

After finishing all steps you should have the following information available for the next steps in SAP Cloud ALM:

  • SAP Ariba API URL
  • SAP Ariba OAuth URL
  • OAuth client ID
  • OAuth secret
  • Application key

Create HTTP Endpoint

You have to create an endpoint in SAP Cloud ALM for the monitoring data collection.

  1. Open the Landscape Management application from the launchpad
  2. Select your SAP Business Network for Procurement service
  3. Click on the service name or press the ">" button at the end of the line
  4. On the tab "Endpoints" press the "Add" button to create a new endpoint
  5. Enter a description
  6. Choose the use-case "Integration Monitoring"
  7. Root URL: Replace the automatically filled value with the SAP Ariba API URL 
  8. Choose OAuth authentication enter the OAuth credentials retrieved from the SAP Ariba Developer Portal:
    • Client ID: OAuth client ID
    • Client Secret: OAuth secret
    • Token Service URL: Extend your SAP Ariba OAuth URL with /v2/oauth/token
    • API Key: Enter the Application key

Next Steps

After creating the endpoint in SAP Cloud ALM, you have to perform the following steps to activate the monitoring use-cases: