OIC OAuth Support

Owned by Karl Henselin
Last updated: Jan 08, 2024 by Muthu Sankaralingam
4 min read

FlexDeploy now supports the use of OAuth authentication for Oracle Integration Cloud. You can follow the below steps for configuring OAuth for OIC.

The following OAuth methods are currently supported:

  • Resource Owner

  • JWT User Assertion

Oracle Integration 3 instances only support OAuth authentication. Basic Auth cannot be used in FlexDeploy for these instances

Prerequisite

For both OAuth methods, we need a certificate to be generated from the endpoint where flexdeploy server is going to execute the plugin operations for OIC/VBCS.

1. Generate certificate

If you already have a public/private key and their keystore location feel free to skip this step.

Continuing with this step, we assume you don’t have third party certificates and going to generate a self signed cert.

Keystore

1 Create the Keystore.

keytool -genkey -keyalg RSA -alias <your_alias ex FlexDeploySandbox> -keystore <keystore_file ex FDSandboxkeystore.jks> -storepass <new_keystore_pass> -validity 365 -keysize 2048

2 Export to generate a cert file. Make sure that the aliases are unique.

keytool -exportcert -alias <your_alias ex FlexDeploySandbox> -file <filename ex flexdeployad.cer> -keystore <keystore_file ex FDSandboxkeystore.jks> -storepass <keystore_pass>

 Install the Certificate

Install the cer file generated in the previous step #2 into the JDK cacerts used by FlexDeploy endpoint.

  1. First figure out JDK used by FlexDeploy and/or Endpoint as applicable.

    1. For example, cd /u01/jdk1.8.0_372

  2. cd jre/lib/security/

  3. Copy .cer file in this folder.  

  4. cp cacerts cacerts.bak

  5. ../../bin/keytool -importcert -keystore cacerts -alias <alias name> -file <certificate file name>

  6. Type password (likely “changeit”)

Resource Owner

  1. Create a Confidential Application in Identity Console

  2. Add cer file to Partner Settings

  3. Create FlexDeploy Cloud Account

1. Create a Confidential Application in Oracle Identity Console

 

 

 

 

 

 

 

 

 

 

 

  • Give it a meaningful name such as ‘FlexDeploy OAuth App’.

  • Click Next.

  • On the client configuration select Configure this application as a client now. Be sure to select the grant type of Resource Owner, Client Credentials and add scopes for your OIC Instances where you want to use this application.

  • Copy the scope that ends in /ic/api to notepad

  • For Client Type, select Confidential and import the cer (flexdeployad.cer) file generated earlier. Make sure to use the same alias name used to generate the file(ex FlexDeploySandbox).

 

 

 

 

 

 

 

 

 

 

 

 

  • You can accept the default values throughout the rest of the configuration.

  • Copy the client id and secret that show up after completing the application (you can access this from the configuration tab as well)

  • Activate your application

 

 

 

 

 

 

 

 

 

 

 

2. Add cer file to Partner Settings

We have configured the signing certificate in the Confidential Application, IDCS requires to configure the signing certificate as a Trusted Partner Certificate as well. Go to Settings → Partner Settings and Import the cer file. Make sure to use the same alias name used to generate the file(ex FlexDeploySandbox).

 

 

 

 

 

 

 

 

 

 

3. Create the Cloud Account in FlexDeploy

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

JWT User Assertion

JWT User Assertion requires an ssl certificate to be uploaded to Oracle Cloud Infrastructure and referenced in FlexDeploy. The key can be self-signed or from a more trusted chain.

  1. Create Oracle Identity Application with the JWT Assertion grant type

  2. Add cer file to Partner Settings

  3. Create FlexDeploy Cloud Account

1. Create Oracle Identity Application with the JWT Assertion grant type

 

 

 

 

 

 

 

 

 

 

 

  • Give it a meaningful name such as ‘FlexDeploy OAuth App’.

  • Click Next.

  • On the client configuration select Configure this application as a client now. Be sure to select the grant type of JWT Assertion, Client Credentials and add scopes for your OIC Instances where you want to use this application.

  • Copy the scope that ends in /ic/api to notepad

  • For Client Type, select Confidential and import the cer (flexdeployad.cer) file generated earlier. Make sure to use the same alias name used to generate the file(ex FlexDeploySandbox).

 

 

 

 

 

 

 

 

 

 

 

 

 

  • You can accept the default values throughout the rest of the configuration.

  • Copy the client id and secret that show up after completing the application (you can access this from the configuration tab as well)

  • Activate your application

 

 

 

 

 

 

 

 

 

 

 

2. Add cer file to Partner Settings

We have configured the signing certificate in the Confidential Application, IDCS requires to configure the signing certificate as a Trusted Partner Certificate as well. Go to Settings → Partner Settings and Import the cer file. Make sure to use the same alias name used to generate the file(ex FlexDeploySandbox).

 

 

 

 

 

 

 

 

 

 

3. Create FlexDeploy Cloud Account

Lastly you need to create a cloud account in FlexDeploy specifying your client application information as well as the certificate information.

 

The following macros are not currently supported in the footer:
  • style