Configuring the API Adapter

The API Adapter component is included with the Oracle Data Relationship Management Application Server installation component.

Note:

Enable the API Adapter if you are going to access Data Relationship Management using the Web Services API.

Before you begin, review the following points:

  • The DRM API Adapter now supports HTTPS/TLS only. Unsecured HTTP access is no longer supported.

  • Endpoint URL: https://<host>:<api-adapter-port>/oracle/drm/apiadapter

  • You must configure a valid server certificate for the API Adapter host before starting the API Adapter.

  • The server certificate must be installed and available to the Windows machine and the Windows account running the API Adapter service.

  • Client machines must trust the complete certificate chain presented by the API Adapter server.

  • Existing API Adapter clients and integrations must update all endpoint references from http:// to https://.

  • API Adapter authentication behavior remains unchanged. Only the transport protocol has changed.

  • Client certificates are not required unless separately configure mutual TLS (mTLS) outside of DRM.

  • API Adapter metadata/WSDL publishing is disabled by default. You need to retrieve the WSDL directly from a running API Adapter should be revised or removed.

  • Plain HTTP access to the API Adapter is no longer supported.

  • Configuring the DRM API Adapter is no longer required solely for registering DRM with EPM.

  • DRM registration with EPM now uses the EPM Registry client directly instead of requiring the API Adapter endpoint.

To enable the API adapter host:

  1. In the Configuration Console, select Host Machines and then API Adapter.
  2. Do the following:
    • Select Enable API Adapter.

    • Enter the port number for the host.

    • Enter the SSL certificate name.

  3. Click the Test URL link to verify that the link is valid.