Using Oracle Integration 3 Us Government Cloud
Using Oracle Integration 3 Us Government Cloud
F45536-21
March 2025
Oracle Cloud Using Oracle Integration 3 on Oracle Cloud Infrastructure US Government Cloud,
F45536-21
This software and related documentation are provided under a license agreement containing restrictions on use and
disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or
allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit,
perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation
of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find
any errors, please report them to us in writing.
If this is software, software documentation, data (as defined in the Federal Acquisition Regulation), or related
documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then
the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software, any
programs embedded, installed, or activated on delivered hardware, and modifications of such programs) and Oracle
computer documentation or other Oracle data delivered to or accessed by U.S. Government end users are "commercial
computer software," "commercial computer software documentation," or "limited rights data" pursuant to the applicable
Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, reproduction,
duplication, release, display, disclosure, modification, preparation of derivative works, and/or adaptation of i) Oracle
programs (including any operating system, integrated software, any programs embedded, installed, or activated on
delivered hardware, and modifications of such programs), ii) Oracle computer documentation and/or iii) other Oracle
data, is subject to the rights and limitations specified in the license contained in the applicable contract. The terms
governing the U.S. Government's use of Oracle cloud services are defined by the applicable contract for such services.
No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not
developed or intended for use in any inherently dangerous applications, including applications that may create a risk of
personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all
appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its
affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle®, Java, MySQL, and NetSuite are registered trademarks of Oracle and/or its affiliates. Other names may be
trademarks of their respective owners.
Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used
under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Epyc, and the AMD logo
are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open
Group.
This software or hardware and documentation may provide access to or information about content, products, and
services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all
warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an
applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss,
costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth
in an applicable agreement between you and Oracle.
Contents
iii
Audience
Preface
This guide describes how to use Oracle Integration 3 in Oracle Cloud Infrastructure US
Government environments.
Topics:
• Audience
• Documentation Accessibility
• Diversity and Inclusion
• Related Resources
• Conventions
Audience
This guide is intended for administrators who want to use Oracle Integration 3 in an Oracle
Cloud Infrastructure US Government Cloud with FedRAMP or US Federal Cloud with DISA
Impact Level 5 Authorization environment. To use Oracle Integration 3 in a commercial, UK
government, or commercial US government environment, see Overview of Oracle Integration 3
in Provisioning and Administering Oracle Integration 3.
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility
Program website at https://www.oracle.com/corporate/accessibility/.
Related Resources
For more information, see these Oracle resources:
• Oracle Integration documentation on the Oracle Help Center.
• Oracle Cloud at http://cloud.oracle.com.
4
Conventions
Conventions
The following text conventions are used in this document:
Convention Meaning
boldface Boldface type indicates graphical user interface elements associated with an
action, or terms defined in text or the glossary.
italic Italic type indicates book titles, emphasis, or placeholder variables for which
you supply particular values.
monospace Monospace type indicates commands within a paragraph, URLs, code in
examples, text that appears on the screen, or text that you enter.
5
1
Get Started with Oracle Integration
Oracle Integration is a fully managed service that allows you to integrate your cloud and on-
premises applications. Oracle Integration is available on Oracle Cloud Infrastructure US
Government Cloud.
With Oracle Integration, you can design integrations to monitor and manage connections
between your applications, selecting from our portfolio of hundreds of prebuilt adapters and
recipes to connect with Oracle and third-party applications.
Topics:
• How to Use This Guide
• About Oracle Integration 3 on Oracle Cloud Infrastructure US Government Cloud
• Restrictions
1-1
Chapter 1
About Oracle Integration 3 on Oracle Cloud Infrastructure US Government Cloud
Key Points
• The instances that you can provision in Oracle US Defense Cloud depend upon whether
your tenancy uses identity domains:
– If your tenancy uses identity domains, you can provision only Oracle Integration 3
instances in Oracle US Defense Cloud.
– If your tenancy doesn't use identity domains, you can provision only Oracle Integration
Generation 2 instances in Oracle US Defense Cloud.
• B2B for Oracle Integration is supported.
Topics
• Feature Availability
• Useful Resources
Feature Availability
Oracle Integration on Oracle Cloud Infrastructure US Government Cloud is available in both
Standard and Enterprise editions, but not all features are available in US government realms.
Review the following table for an overview of feature availability in Oracle Integration instances
on Oracle Cloud Infrastructure US Government Cloud environments.
1-2
Chapter 1
About Oracle Integration 3 on Oracle Cloud Infrastructure US Government Cloud
Useful Resources
Review the following documentation resources.
1-3
Chapter 1
Restrictions
Restrictions
Note the following current restrictions when creating Oracle Integration instances and using
them in Oracle Cloud Infrastructure US Government Cloud environments.
• US Government Cloud does not support creating events to publish and subscribe to in
integrations.
• US Government Cloud environments currently don't support export and import of design-
time metadata between instances (see Import and Export Instances in Provisioning and
Administering Oracle Integration 3), whether you use the Import/Export page or the REST
API Clone command in US Government Cloud environments. Note that you can import and
export packages and project deployments.
• In US Government Cloud realm (realm key: OC2) accounts, you can use login credentials
(username and password) for console-based login flows. However, you can't use these
login credentials for programmatic API invocations.
• To run a scheduled integration in an Oracle Cloud Infrastructure US Government Cloud
environment, you must use a non-federated account. The user should ideally be a service
account user profile, and not an actual in-person user account profile.
If you use a federated account, the scheduler cannot trigger jobs and intermittently errors
out with a Schedule request submitted message.
• If you use the FTP Adapter with private keys (with a passphrase) in government
environments, only OpenSSH-formatted keys are supported. RSA keys are not supported
if the private key is associated with a passphrase.
• The Oracle Autonomous Transaction Processing Adapter, Oracle Autonomous Data
Warehouse Adapter, and Oracle Database Cloud Service Adapter do not support using the
JDBC Basic Authentication security policy (also known as Username Password Token)
with direct connectivity. You must use a wallet security policy (JDBC Over SSL or JDBC
With OCI Signature) if you want to directly connect to database endpoints.
• For users working in Chrome incognito mode: Add your Oracle Integration service
instance application domain for third-party cookies as shown below. This workaround
ensures users are logged out of their sessions after signing out.
1-4
Chapter 1
Restrictions
This ensures users are logged out of their sessions after signing out.
1-5
2
Set Up Users and Groups
Configure users and groups and grant them the right level of access on Oracle Cloud
Infrastructure US Government Cloud.
Topics:
• Configure Access to Create and Manage Instances
2-1
Chapter 2
Configure Access to Create and Manage Instances
2. Select the compartment in which you want to create your instance or create a new
compartment.
To create a new compartment:
a. Click Create Compartment to create the compartment to use for creating an instance.
b. Enter the following:
• Name: Enter a name that is unique across all compartments in your tenancy
(maximum 100 characters, including letters, numbers, periods, hyphens, and
underscores). For example, enter a name such as OICCompartment.
• Description: Enter a description for this compartment.
• Tags: Enter tags to organize and list resources based on your business needs.
See Managing Tags and Tag Namespaces.
c. Click Create Compartment.
Return to the navigation pane.
2-2
Chapter 2
Configure Access to Create and Manage Instances
2. If not already selected, select the Compartment in which the domain where you want to
create the group resides.
3. Click Groups.
The Groups page for the domain is displayed.
4. Click Create group.
5. In the Create group screen, assign a name to the group (for example, oci-integration-
admins), and enter a description.
6. Click Create.
2-3
Chapter 2
Configure Access to Create and Manage Instances
Notes:
Verb Access
read Includes permission to view Oracle Integration instances and
their details.
manage Includes all permissions for Oracle Integration instances.
2-4
Chapter 2
Configure Access to Create and Manage Instances
8. On the user details page that is displayed, you can edit user information as needed, and
reset the user's password.
• Name: A unique name or email address for the user. The name must be unique across
all users in your tenancy. You cannot change this value later. The name must meet the
following requirements: no spaces, only Basic Latin letters (ASCII), numerals,
hyphens, periods, underscores, +, and @.
• Description: This value could be the user's full name, a nickname, or other descriptive
information. You can change this value later.
• Email: Enter an email address for the user. This email address is used for password
recovery. The email address must be unique in the tenancy. If the user forgets their
password, they can click Forgot Password on the sign on page, and a temporary
password is generated and sent to the email address provided here. The user or an
administrator can also update the email address later.
9. Provide new users with the credentials they need to sign in to their tenancy. Upon signing
in, they will be prompted to enter a new password.
Note:
It's a best practice to assign Oracle Integration roles to selected groups rather than
individual users.
Oracle Integration provides a standard set of roles, which govern access to features. See
Oracle Integration Service Roles. Depending on the Oracle Integration features your
organization uses, you may choose to create groups named for the role they are granted. For
example, you might create and name groups as follows:
• OICServiceAdministrators to grant admin permissions in service instances
• OICServiceDevelopers to grant developer permissions in service instances
• OICServiceInvokers to grant service invoke only permission to one instance
• OICServiceMonitors to grant monitor only permission to one or more instances
1. Open the navigation menu and click Identity & Security. Under Identity, click Domains.
2-5
Chapter 2
Configure Access to Create and Manage Instances
2-6
Chapter 2
Configure Access to Create and Manage Instances
In Oracle Integration, when you assign a role to a user, the user is granted that role for all
Oracle Integration features provisioned on an instance. Further, each role grants different
privileges for different features to the same user. Note that not all Oracle Integration predefined
roles are available in all features.
2-7
3
Work with Instances
Create and edit Oracle Integration 3 instances in the Oracle Cloud Infrastructure Console on
Oracle Cloud Infrastructure US Government Cloud.
Topics:
• Create an Oracle Integration Instance
• Use Supported Formats for Key Pairs in SFTP
• View Instance Details
2. Open the navigation menu and click Developer Services. Under Application Integration,
click Integration.
3-1
Chapter 3
Create an Oracle Integration Instance
3. From the Compartment list, click through the hierarchy of compartments and select the
one in which to create the instance. You may need to expand the + icon to find the
compartment to use. Compartments can contain other compartments. It may take several
minutes for the new compartment to appear after the policy has been created.
Note:
Do NOT select the root or ManagedCompartmentForPaaS compartment in which
to create your instance.
4. Click Create.
5. Enter the following details and click Create:
Field Description
Display Name Enter the display name for the instance. Note that the display
name becomes part of the URL for accessing the instance.
Consumption Model Lists consumption models available in this tenancy. Typically,
one model is displayed, but multiple consumption models are
listed if your tenancy is enabled for more than one. Available
models include:
• Metered (Universal Credit)
• Oracle Integration Government
Note:
Oracle Integration Government is a license and
doesn't specify the realm.
3-2
Chapter 3
Use Supported Formats for Key Pairs in SFTP
Field Description
Shape Choose a shape for the instance. The shape determines when
the instance receives updates, which happen every other month.
Only some regions allow you to choose a shape. If you don't see
the option to choose a shape, your instance is created in the
Production shape. For details about the shapes that each
region supports, see About Oracle Integration 3 on Oracle
Cloud Infrastructure US Government Cloud.
• Development: Instances with this shape receive updates
two weeks before instances with a Production shape.
• Production: Instances with this shape receive updates two
weeks after instances with a Development shape.
Note: You can't change the shape after you create the instance.
However, you can move data to another instance using the
export and import features.
License Type • Select to create a new Oracle Integration license in the
cloud. This provides you with packages of 5K messages per
hour.
• Select to bring an existing Oracle Fusion Middleware
license to the cloud for use with Oracle Integration. This
provides you with packages of 20K messages per hour.
This option is also known as bring your own license (BYOL).
Message Packs The message pack options available for selection are based on
the version of Oracle Integration instance you are creating.
Select the number of message packs. The total number of
messages available per pack is based on the License Type
option you selected. You can select up to 3 message packs if
you bring an existing Oracle Fusion Middleware license to the
cloud. You can select up to 12 message packs if you create a
new Oracle Integration license in the cloud.
If... Then...
You need to create a new key Enter the following command:
pair
ssh-keygen -t rsa -m RFC4716
3-3
Chapter 3
View Instance Details
If... Then...
You already have a PEM- Enter the following command to convert from PEM to OpenSSH format
formatted key pair
ssh-keygen -p -f your_PEM_formatted_private_key -m
RFC4716
Once the private key is generated, upload it to the Connections page for the FTP Adapter. If
you open the OpenSSH-formatted key, the header must look similar to the following:
The following table describes the key information shown on the instance details page:
3-4
Chapter 3
View Instance Details
Field Description
Integration Instance Information tab • Creation date
• Last updated date (for example, the last time
started)
• Selected consumption (billable) model
• Edition (standard or enterprise)
• OCID value that uniquely identifies the
instance, which can be shown in full and
easily copied
• Network access setting, which you can
change by clicking Network Access under
Resources.
• Service Console URL, which can be shown
in full and easily copied
• License type (either a new cloud license or
an existing license brought over from Oracle
Fusion Middleware). If you are viewing an
Oracle Integration for SaaS instance, the
License Type field is not displayed.
• Number of message packs and the quantity
of messages in each pack
Service Console Click to access the login page. See the Oracle
Integration Help Center.
Note: You can also access the login page from
the main Oracle Cloud Infrastructure Console
page for Oracle Integration. At the far right, click
for the specific instance, and select Service
Console.
Edit Click to edit your settings.
See Editing the Edition, License Type, Message
Packs, and Custom Endpoint of an Instance in
Provisioning and Administering Oracle
Integration 3.
Move Click to move the instance to a different
compartment. This action can take some time to
complete.
See Moving an Instance to a Different
Compartment in Provisioning and Administering
Oracle Integration 3.
Add Tags Click to add tags to the instance. You can use
tags to search for and categorize your instances
in your tenancy.
See Resource Tags in the Oracle Cloud
Infrastructure Documentation.
More Actions Contains options to stop, start, or delete the
instance.
See in Provisioning and Administering Oracle
Integration 3:
• Stopping and Starting an Oracle Integration
Instance
• Deleting an Instance
Metrics Displays message metrics.
See Viewing Message Metrics in Provisioning
and Administering Oracle Integration 3.
3-5
Chapter 3
View Instance Details
Field Description
Work Requests Lists instance life cycle activity, such as instance
creation time, instance stop and start times, and
so on.
Network Access Click Edit to change the Network Access setting.
Select Restrict Network Access to disallow
inbound traffic from external networks.
3-6