Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 3 Current »

Most OAC plugin operations require the FDOAC_CLOUD_ACCOUNT_CODE target property since FlexDeploy 9.0.0.3. For more details, refer to the Configuring Cloud Accounts section. If upgrading from FlexDeploy 9.0.0.2 or lower, OAC cloud account will be automatically created from target properties (URL, Username, Password).

Property Name

Property Code

Required

Description

OAC Instance URL

FDOACACCT_INSTANCE_URL

Yes

URL of the Oracle Analytics cloud instance. Typically, the URL of your Oracle Cloud service

e.g. https://fddev2-idzor6zhmigm-ia.analytics.ocp.oraclecloud.com

Auth Type

FDOACACCT_AUTHTYPE

Yes

Authentication method for connecting to Oracle Analytics Cloud instance. Additional properties may be required depending on selection.

Options: BasicAuth, OAuthResourceOwner, OAuthJWTAssertion

Username

FDOACACCT_USERNAME

Yes

 

Password

FDOACACCT_PASSWORD

Conditional

The password. Required for BasicAuth and OAuthResourceOwner.

Oracle Identity Cloud Service URL

FDOACACCT_IDENTITY_BASE_URI

Conditional

 The Oracle Identity Cloud Service URL (IDCS).

e.g. https://idcs-1a2bc3de.identity.oraclecloud.com

Required for OAuthResourceOwner and OAuthJWTAssertion

Client Id

FDOACACCT_CLIENT_ID

Conditional

Client Id of OAuth application in Oracle Identity service. See more details below.

Required for OAuthResourceOwner and OAuthJWTAssertion

Client Secret

FDOACACCT_CLIENT_SECRET

Conditional

Client Secret of OAuth application in Oracle Identity service. See more details below.

Required for OAuthResourceOwner and OAuthJWTAssertion

Oracle EPM Scope

FDOACACCT_SCOPE

Conditional

Client Scope. See more details below.

e.g. https://smpqp3ct4ogsgjzdkgsztq2ovgcylnga.analytics.ocp.oraclecloud.comurn:opc:resource:consumer::all

Required for OAuthResourceOwner and OAuthJWTAssertion

Private Key

FDOACACCT_PRIVATE_KEY

Conditional

Private Key to use for JWT Assertion. See more details below.

Required for OAuthJWTAssertion

See Private Key type Credential for information on how to generate Private Key with Certificate and upload to FlexDeploy credential.

Certificate

FDOACACCT_CERTIFICATE

Conditional

Certificate to use for JWT Assertion. See more details below.

Required for OAuthJWTAssertion

See Certificate type Credential for information on how to generate Private Key with Certificate and upload to FlexDeploy credential. Certificate also needs to be uploaded to Oracle Cloud, see more details below.

OAuth Configurations for Oracle Cloud

FlexDeploy supports the use of OAuth authentication for various Oracle Cloud related application and services. You can follow one of the 2 options for configuring OAuth: Resource Owner and JWT Assertion. This details are currently applicable for following plugins.

For both options, you will need to create Confidential Application in Oracle Identity domain. See detailed steps below. For additional context see https://docs.oracle.com/en-us/iaas/Content/Identity/applications/add-confidential-application.htm.

Resource Owner

  • Login to https://cloud.oracle.com and search for your Identity domain.

  • Click on Integrated applications, then click Add application to add new confidential application. Select Confidential Application and click Launch Workflow.

image-20250212-135736.png
  • Give a meaningful name such as ‘FlexDeploy OAC Dev OAuth’ and Click Next.

image-20250212-140044.png
  • On the Configure OAuth tab, select the following,

    • Resource Server Configuration, should be defaulted to Skip for later.

    • For Client Configuration, select Configure this application as a client now.

      • Be sure to select the grant type of Resource Owner, Client Credentials. Also, select Refresh Token to allow use of refresh token if access token has expired to get new access token.

      • For Client Type, select Confidential, which is default selection. (Import certificate is not needed)

      • Token Issuance policy should be Specific.

      • Check Add scopes for your resources which you want to integrate using this application. Select specific scope, copy the scope to notepad for use later. See #10 in the second image below. Scope search works as Starts with (Case insensitive) for name or description and requires you to enter at least 3 characters.

      • Click Add on Add scope popup.

      • Then click Next.

image-20250212-141409.pngimage-20250212-161415.png
  • You can accept the default values throughout the rest of the configuration and click Finish.

image-20250212-143642.png
  • Click Activate.

image-20250212-143711.png
  • You can copy Client Id and Client Secret shown below for use with FlexDeploy integration instance configuration.

image-20250212-143747.png
  • Now you can configure FlexDeploy Integration Instance as shown below and use it for build/deploy processes.

image-20250212-144422.png

JWT Assertion

To use JWT Assertion, you need both a private key and a certificate. The certificate must be uploaded to Oracle Cloud Infrastructure and referenced in FlexDeploy. The private key can either be self-signed or issued by a trusted certificate authority.

See Credential Type - Private Key and Credential Type - Certificate for details on how to generate Private Key and Certificate for this setup. You will also need to upload .cer file (Certificate) to Oracle Cloud Identity service settings.

  • Login to https://cloud.oracle.com and search for your Identity domain.

  • Click on Integrated applications, then click Add application to add new confidential application. Select Confidential Application and click Launch Workflow.

image-20250212-160708.png
  • Give a meaningful name such as ‘FlexDeploy OAC Dev OAuth’ and Click Next.

image-20250212-161136.png
  • On the Configure OAuth tab, select the following,

    • Resource Server Configuration, should be defaulted to Skip for later.

    • For Client Configuration, select Configure this application as a client now.

      • Be sure to select the grant type of JWT assertion, Client Credentials. Also, select Refresh Token to allow use of refresh token if access token has expired to get new access token.

      • For Client Type, select Confidential, which is default selection. (Import certificate is not needed)

      • Token Issuance policy should be Specific.

      • Check Add scopes for your resources which you want to integrate using this application. Select specific scope, copy the scope to notepad for use later. See #10 in the second image below. Scope search works as Starts with (Case insensitive) for name or description and requires you to enter at least 3 characters.

      • Click Add on Add scope popup.

      • Then click Next.

image-20250212-161504.png
  • You can accept the default values throughout the rest of the configuration and click Finish.

image-20250212-161553.png
  • Click Activate.

image-20250212-161649.png
  • You can copy Client Id and Client Secret shown below for use with FlexDeploy integration instance configuration.

image-20250212-161731.png
  • Now we need to upload certificate to Partner Settings.

    • Go to your Identity Domain.

    • Client Settings, then click Trusted partner certificates.

    • Click Import certificate and upload .cer file. Click Import.

image-20250212-162916.png
  • Now you can configure FlexDeploy Integration Instance as shown below and use it for build/deploy processes.

    • Generated Private Key and Certificate should be uploaded to FlexDeploy Credential store for use with Integration Instance. This can be done directly from Private Key and Certificate drop down on Integration Instance page.

image-20250212-162623.png

  • No labels