SAP Data Custodian

Follow this procedure to set up SAP Data Custodian as a source system.

Prerequisites

  • You have created an SAP Data Custodian tenant.

  • You have created a user within your tenant with the required roles for your scenario.

  • You have added your user to SAP Identity Service Management (SAP ISM).

Context

SAP Data Custodian is a robust Software as a Service (SaaS) solution that protects sensitive data stored in public, private, hybrid, and multicloud environments. This solution integrates with partnered public hyperscalers, SAP applications, and SAP managed clouds.

After fulfilling the prerequisites, follow the procedure below to add a source system for SAP Data Custodian to read users and user assignments to groups. This source system consumes SCIM 2.0 API provided by SAP Data Custodian.

Procedure

  1. Access the Identity Provisioning UI.
  2. Add SAP Data Custodian as a source system. For more information, see Add New Systems.
  3. Set up the communication between Identity Provisioning and SAP Data Custodian and configure the authentication method (basic or certificate-based).
    1. In your newly added SAP Data Custodian source system, select the Certificate tab and choose Start of the navigation pathGenerate Next navigation step DownloadEnd of the navigation path, as described in Generate and Manage Certificates for Outbound Connection.

      Skip this step if you use basic authentication. The next steps are performed in SAP Data Custodian and are relevant for certificate-based authentication only.

    2. Login to SAP Data Custodian tenant and create a tenant operations technical user (TOTU), as described in Create a Tenant Operations Technical User in SAP Data Custodian.
    3. Upload the outbound certificate that you downloaded in substep a. to the TOTU, as described in Register the Outbound Certificate to Your Tenant Operations Technical User.
  4. Choose the Properties tab to configure the connection settings for your system.

    Mandatory Properties

    Property Name

    Value

    Type

    Enter: HTTP

    URL

    Specify the URL to the SAP Data Custodian SCIM API excluding the path information.

    https://<SCIM_API_URL>

    For more information, see Identity Provisioning.

    ProxyType

    Enter: Internet

    Authentication

    Enter your authentication method:

    • BasicAuthentication

    • ClientCertificateAuthentication

    User

    Valid if BasicAuthentication

    Enter the OAuth client key, created for your SAP Data Custodian tenant.

    For more information, see Basic Authentication Prerequisites.

    Password

    Valid if BasicAuthentication

    (Credential) Enter the OAuth client secret, created for your SAP Data Custodian tenant.

    For more information, see Certificate Authentication Prerequisites.

    OAuth2TokenServiceURL

    Specify the URL of the access token provider service for your SAP Data Custodian instance:

    https://<SCIM_API_URL>/kms/scim/v1/Oauth2/Token

    dc.group.filter

    This property filters groups by display name or externalId.

    When specified, only those groups matching the filter expression will be read.

    Possible values:
    • SAP_Data_Custodian_Auditor

    • SAP_Data_Custodian_Service_Admin

    • SAP_Data_Custodian_Key_Admin

    • SAP_Data_Custodian_Key_User

    For example: displayName eq "SAP_Data_Custodian_Auditor"

    dc.user.filter

    When specified, only those SAP Data Custodian users matching the filter expression will be read. You can filter users by userName, displayName or externalId.

    Possible values:

    For example: userName eq "Smith.J"

    dc.group.prefix

    This property distinguishes SAP Data Custodian groups by specific prefix. It is an optional property which does not appear by default at system creation.

    Example value: DC_

    You can use the example value or provide your own.

    When set in the source system, the prefix will be prepended to the name of the groups that are read from the SAP Data Custodian source system and will be provisioned to the target system with the following name pattern: DC_<GroupDisplayName>. This way SAP Data Custodian groups in the target system will be distinguished from groups provisioned from other applications.

    If the property is not set, the SAP Data Custodian groups will be read and provisioned to the target system with their actual display names.

    To learn what additional properties are relevant to this system, see List of Properties. You can use the main search, or filter properties by the Name or System Type columns.

  5. (Optional) Configure the transformations.
    Transformations are used to map the user attributes from the data model of the source system to the data model of the target system, and the other way around. The Identity Provisioning offers a default transformation for the SAP Data Custodian source system, whose settings are displayed under the Transformations tab after saving its initial configuration.

    You can change the default transformation mapping rules to reflect your current setup of entities in your SCIM system. For more information, see:

    Manage Transformations

    SAP Data Custodian SCIM 2.0 APIInformation published on SAP site

    Default transformation:

  6. Now, add a target system to provision users and their group assignments to it. Choose from: Target Systems

Next Steps

  • Before starting a provisioning job, you can first subscribe for e-mail notifications from the source system you use in your scenario. This way, you will be notified by e-mail about eventual failed entities during the jobs. For more information, see Manage Job Notifications.

  • Start an identity provisioning job. For more information, see Monitor Provisioning Job Logs.