Skip to content

Adobe UMAPI integration

This documentation describes how to connect OctoSAM to the Adobe User Management API UMAPI.

Basic operation

UMAPI integration is built into the OctoSAM import service. The service uses the UMAPI to connect to Adobe User Management. OctoSAM reads information about registered product profiles and linked users.

Your network infrastructure needs to allow Web Service calls from the OctoSAM server to the Adobe UMAPI and OAuth endpoints.

Configuration

Register a project with UMAPI integration in the Adobe Developer Console.

You need the following information to configure a client connection:

  • Organization ID
  • Client ID
  • Client Secret

See the sample configuration file appsettings.json:

//
// Integrated Adobe UMAPI Scan
// ---------------------------
//
// Name:            A user defined name to identify the configuration in log and error messages
// ClientID:        ClientID from Adobe UMAPI integration
// ClientSecret:    ClientSecret from Adobe UMAPI integration (prefer ClientSecretCredentialManagerTarget and store the secret in the Windows Credential Manager)
// ClientSecretCredentialManagerTarget: Target name to load secret from the Windows Credential Manager
// OrganizationID:  OrganizationID from Adobe UMAPI integration
//
"AdobeUMAPI": {
    "Scans": [
      {
        "Name": "My First Adobe UMAPI Scan",
        "OrganizationID": "639.............98C6@AdobeOrg",
        "ClientId": "25b...............219"
        // "ClientSecret": "********"
        // "ClientSecretCredentialManagerTarget": "adobe_umapi_secret" // lookup ClientSecret in the Windows Credential Manager
      }
    ]
  },

Info

We recommend that you store the secret in the Windows Credential Manager.