Set up SAP Datasphere

Warning Because these tasks are performed outside of Collibra, it is possible that the content changes without us knowing. We strongly recommend that you carefully read the source documentation.

Prepare SAP Datasphere Catalog

  1. In SAP, on the SAP Datasphere homepage, click Catalog > Monitoring.

    The Remote Systems page opens.
  2. Above the list of systems, click +.
    The Create System dialog box appears.
  3. Enter the required information.
    FieldDescription
    System Type

    The type of system you want to synchronize. In this case, select Local SAP Datasphere or External SAP Datasphere.

    Note You can add as many Datasphere systems as you want, but there can only be one local SAP Datasphere system.

    Name

    Enter the Name of your SAP Datasphere tenant.

    Tip To find the information, go to Administration > Info as a System Administrator.
    UUID

    Enter the UUID of your SAP Datasphere tenant.

    Tip To find the information, go to Administration > Info as a System Administrator.
  4. Click Authenticate Now.
  5. Select the system you created and click Synchronize System.
  6. Optionally, edit the system and change the name.
    The name of the system will be the name of the SAP Tenant asset in Collibra.

For more details, go to source documentation.

Publish the assets that you want to integrate

The SAP Datasphere integration can add only assets that are published in SAP Datasphere Catalog. You need at least one published asset for the integration to work.

Note You need to be a System Administrator in SAP Datasphere Catalog to perform this action.

  1. In SAP, on the SAP Datasphere homepage, click Catalog > Catalog.
    The Catalog page opens.
  2. In the filters pane, select a local or external SAP Datasphere system for which you want to integrate assets.

    Note If you want to integrate SAP Analytics Cloud system, go to prepare SAP Analytics Cloud.

  3. Make sure that the assets you want to integrate have publication status Published.
    If they are, there's nothing more to do. If they aren't, proceed to the next step.

    1. Select the checkboxes for the assets that you want to publish.

      Important You can publish only assets with functional status Current.

    2. In the Publish Actions drop-down list, click Publish.
Tip 

You enable or disable the Auto Publish feature at the system level. By default, this feature is disabled.

  1. In SAP, on the SAP Datasphere homepage, click Catalog > Monitoring.

    The Remote Systems page opens.
  2. Select the system for which you want to enable auto-publication.
  3. Above the list of systems, click .
    The Edit System dialog box appears.
  4. Select the Enable Auto Publishing to the Catalog option.
  5. Click Save.
    Any unpublished assets in the system are automatically published.

Configure a new OAuth client

Note You need to be an Administrator in SAP Datasphere to perform this action.

  1. In SAP, in the SAP Datasphere homepage, click System > Administration.
  2. Click App Integration.

  3. In the OAuth Clients section, click Add a New OAuth Client.
    The New OAuth Client dialog box appears.
  4. Enter the required information.
    FieldDescription
    NameThe name of the new OAuth client. This can be anything, as long as it is unique.
    OAuth Client IDThe ID is generated when the OAuth client is created.
    Purpose

    In the drop-down list, select API Access.

    Access

    In the drop-down list, select Catalog User API.

    Authorization GrantIn the drop-down list, select Client Credentials.
    SecretThe secret is generated when the OAuth client is created.
    Token Lifetime

    The amount of time that the server login session remains open while Edge is communicating with SAP Datasphere Catalog.

    During the token lifetime, you need to build your Edge connection, configure your Edge capability, and start the integration. But after that, Collibra keeps the token alive.

    The maximum value is 1440 minutes (1 day).

  5. Click Add.
  6. Copy the following information: oAuth token URL, oAuth Client ID, oAuth secret.
    You will need this information when you configure your connection and capability in Collibra.

Ensure that certain endpoints are allowed

Note You need to be an Administrator in SAP Datasphere to perform this action.

Ensure that the following endpoints are allowed:

Endpoint Comments
*.hanacloud.ondemand.com  
*.k8s-hana.ondemand.com  
The token URL: <tenant>.authentication.usxx.hana.ondemand.com
Note In the URL, "uxxx" can also be "euxx".
  1. In SAP, toward the bottom of the SAP Datasphere homepage, click System > Administration.

  2. Click App Integration.

    The App Integration page opens. There you'll find the token URL.
System URL: <tenant>.usxx.hcs.cloud.sap
Note In the URL, "uxxx" can also be "euxx".
  1. In SAP, on the SAP Datasphere homepage, click Catalog > Monitoring.

    The Remote Systems page opens.
  2. Click the relevant local or external SAP Datasphere system.

    The details page opens. There you'll find the system URL.

What's next?

You can prepare Edge for the integration.