System Configuration

After installing ODC Release Manager, configure the following settings in your ODC Portal:

• HMACPassword — A random password to ensure safety of your ODC Portal API tokens.
• ODCApiClientId — The ODC Portal API Client ID to use.
• ODCApiClientSecret — The corresponding secret for the ODC Portal API Client.
• OverrideODCApiTokenEndpointRealmId — (Optional) The ODC Portal identity provider’s realm ID.
• OverrideODCPortalFQDN — (Optional) The fully qualified domain name of your ODC Portal.

HMACPassword

This should be a random 32-character password for securely storing ODC Portal API tokens.

It is advisable to use a random password generator, for example one generated here: https://www.random.org/passwords/?num=1&len=32&format=plain&rnd=new

ODCApiClientId

This is the generated Client ID for an ODC Portal API. To create one:

• Navigate to your ODC Portal and select “API clients” under “Manage”
• Create a new API client
• Ensure access is given to:
  • Asset management – Open
  • Portfolio management - View Stage (all stages)
  • Release management - Deploy assets (all stages)
  • Configuration management:
    • View configurations (all stages)
    • Edit asset configurations (all stages)

ODCApiClientSecret

After generating your ODC API Client, the ODC Portal will provide you with a secret key. Use this value here.

OverrideODCApiTokenEndpointRealmId

The realm id of your ODC Portal's identity provider's token_endpoint. ODC Release Manager will automatically retrieve this from your ODC Portal, however you may override it if you wish, for example if you want to control a different ODC environment.

To obtain this value, review the documentation here: https://success.outsystems.com/documentation/outsystems_developer_cloud/odc_rest_apis/api_authentication_and_authorization/about_oidc_discovery_document/

OverrideODCPortalFQDN

The fully qualified domain name of your ODC Portal. ODC Release Manager will automatically calculate this value, however you may override it if you wish, for example if you want to control a different ODC environment.

For example, if your ODC Portal URL is https://innovationlabs.outsystems.dev/, then set this value to: innovationlabs.outsystems.dev