Oracle® Fusion Middleware

Oracle Cloud Adapters Postinstallation Configuration Guide

12.1.3

E63651-01

May 2015

Oracle Fusion Middleware Oracle Cloud Adapters Postinstallation Configuration Guide, 12.1.3

E63651-01

Copyright © 2015, Oracle and/or its affiliates. All rights reserved.

Primary Author: Mark Kennedy

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 or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. 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 and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon 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, Opteron, the AMD logo, and the AMD Opteron 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.

This documentation is in preproduction status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

The information contained in this document is for informational sharing purposes only and should be considered in your capacity as a customer advisory board member or pursuant to your beta trial agreement only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has been executed by you and Oracle and with which you agree to comply. This document and information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

Contents
Preface

- Audience

- Documentation Accessibility

- Related Resources

- Conventions

1 Deploying the Oracle Cloud Adapter EAR File and Configuring CSF Settings

- Deploying the cloudsdk.ear File from the Oracle WebLogic Server Administration Console

- Granting Permissions to Access the Credentials Store

- Creating the CSF Map in Oracle Enterprise Manager Fusion Middleware Control

- Creating the CSF Key for the Eloqua Cloud Adapter in Oracle Enterprise Manager Fusion Middleware Control

- Creating the CSF Key for Other Cloud Adapters in Oracle Enterprise Manager Fusion Middleware Control

2 Configuring the Certificate and Proxy Settings

- Configuring the Proxy Server During Design Time in Oracle JDeveloper

- Importing the Client Certificates to the Trust Store (DemoTrust.jks)

- Configuring the Proxy Server for Runtime

3 Specifying Inbound WSDL URL Patterns

- Specifying Oracle SOA Suite and Oracle Service Bus Inbound WSDL URL Patterns

Preface

Topics:

Oracle Cloud Adapters Postinstallation Configuration Guide describes how to configure the Oracle Cloud adapters after completing patch installation.

- Audience

- Documentation Accessibility

- Related Resources

- Conventions

Audience

Oracle Cloud Adapters Postinstallation Configuration Guide is intended for users who need to configure the Oracle Cloud adapters after completing the patch installation.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Related Resources

For more information, see these Oracle resources:

- Using Oracle RightNow Cloud Adapter

- Using Oracle Sales Cloud Adapter

- Using Oracle Eloqua Cloud Adapter

- Using Oracle HCM Cloud Adapter

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.

1 Deploying the Oracle Cloud Adapter EAR File and Configuring CSF Settings

Perform the following Oracle Cloud Adapter EAR file deployment and CSF map and CSF key configuration tasks.

Topics

- Deploying the cloudsdk.ear File from the Oracle WebLogic Server Administration Console

- Granting Permissions to Access the Credentials Store

- Creating the CSF Map in Oracle Enterprise Manager Fusion Middleware Control

- Creating the CSF Key for the Eloqua Cloud Adapter in Oracle Enterprise Manager Fusion Middleware Control

- Creating the CSF Key for Other Cloud Adapters in Oracle Enterprise Manager Fusion Middleware Control

Deploying the cloudsdk.ear File from the Oracle WebLogic Server Administration Console

You must deploy the cloudsdk.ear file after installing the cloud adapter patches.

1. Find the cloudsdk.ear file, which is located within the Oracle home directory structure after adapter patch installation.

2. Log in to Oracle WebLogic Server Administration Console.

3. Under Domain Structure, select Deployments.

4. Click Install, then browse for and select the cloudsdk.ear file to deploy.

5. Click Next.

6. Click Next again and select the target servers.

7. Click Finish.

8. Restart the server(s).

Granting Permissions to Access the Credentials Store

You must grant permissions to access the credentials store. This task only needs to be performed once for any Oracle Weblogic Server domain.

1. Log in to Oracle Enterprise Manager Fusion Middleware Control.

2. In the navigator, expand Weblogic Domain.

3. Right-click the domain you want to modify and select Security > System Policies to display the System Policies page.

4. Expand Search.

5. For Type, select Codebase.

6. For Name Includes, enter jca and click the Search button.

7. Select jca-binding-api.jar in the results that are displayed, and click Edit.

8. On the Edit System Grant page, click Add.

9. On the Add Permission page, click Select here to enter details for a new permission and enter the following details for a new permission:

- Permission Class: oracle.security.jps.service.credstore.CredentialAccessPermission

- Resource Name: context=SYSTEM,mapName=oracle.wsm.security,keyName=*

- Permission Action: *

10. Click OK to save the new permission.

Creating the CSF Map in Oracle Enterprise Manager Fusion Middleware Control

You must create the CSF map and configure the CSF key in Oracle Enterprise Manager Fusion Middleware Control before you can manage and monitor the adapter in an application during runtime. The same CSF key configuration details that you specify at design time in the Adapter Configuration Wizard must be specified in the credential store of the Oracle Weblogic Server domain on which to deploy the SOA composite application or Oracle Service Bus business service.

1. Log in to Oracle Enterprise Manager Fusion Middleware Control.

2. In the navigator, expand the WebLogic Domain folder.

3. Right-click the managed server you are using for deployment and navigate to Security > Credentials.

4. Click Create Map.

5. Enter oracle.wsm.security, and click OK.
This creates a map in the credentials list.

Creating the CSF Key for the Eloqua Cloud Adapter in Oracle Enterprise Manager Fusion Middleware Control

Specify the following details to create the CSF key for the Oracle Eloqua Cloud adapter in Oracle Enterprise Manager Fusion Middleware Control.

1. Access the Credential Store page by following the steps in Configuring the CSF Map in Oracle Enterprise Manager Fusion Middleware Control.

2. Click Create Key.

3. Enter the following details, and click OK. The values you enter must be the same as those you enter when creating the CSF authentication key in the Adapter Configuration Wizard in Oracle JDeveloper.

Field

Description

Select Map

Select oracle.wsm.security.

Key

Enter a key value (for example, eloqua-key).

Type

Select Generic. Oracle Eloqua Cloud adapter requires an additional property named company. The dialog is refreshed and prompts you to create specific property names and values.

a. Enter an optional description.

b. Click Enter map of property name and value pairs.

c. Click Add Row to add an initial property name and value row.

d. Enter username in the Property Name column.

e. Specify values for username in the Value and Confirm Value columns.

f. Repeat the previous steps to enter rows for company and password. When complete, the dialog looks as follows for the Oracle Eloqua Cloud adapter:

g. Click OK.

Creating the CSF Key for Other Cloud Adapters in Oracle Enterprise Manager Fusion Middleware Control

Specify the following details to create the CSF key for the Oracle Sales Cloud, Oracle RightNow Cloud, Oracle HCM Cloud, and Salesforce Cloud adapters in Oracle Enterprise Manager Fusion Middleware Control.

1. Access the Credential Store page by following the steps in Creating the CSF Map in Oracle Enterprise Manager Fusion Middleware Control.

2. Click Create Key.

3. Enter the following details, and click OK. The values you enter must be the same as those you enter when creating the CSF authentication key in the Adapter Configuration Wizard in Oracle JDeveloper.

Field

Description

Select Map

Select oracle.wsm.security.

Key

Enter a key value (for example, rightnow-key if you are configuring the Oracle RightNow Cloud adapter).

Type

Select Password.

User Name

Enter the user name.

Password

Enter the password.

Confirm Password

Enter the same password a second time.

Description

Optionally enter a unique description.

The created key is displayed beneath the map name (oracle.wsm.security) in the credentials list.

2 Configuring the Certificate and Proxy Settings

Perform the following Oracle Cloud Adapter certificate and proxy setting tasks.

Topics

- Configuring the Proxy Server During Design Time in Oracle JDeveloper

- Importing the Client Certificates to the Trust Store

- Configuring the Proxy Server for Runtime

Configuring the Proxy Server During Design Time in Oracle JDeveloper

Configure the proxy server in Oracle JDeveloper.

1. In Oracle JDeveloper, select Tools > Preferences > Web Browser and Proxy.

2. Select the Proxy Settings tab in Web Browser and Proxy.

3. In Manual Proxy Settings, configure the following settings:

- Set Host to www-proxy.us.company_name.com.

- Set No Proxy For to localhost|*.us.company_name.com|127.0.0.1|10.*.*.*|*.foo.com|etc .
Where company_name is your company name.

4. Test the proxy by clicking Test Proxy.

5. Click OK to finish.

Importing the Client Certificates to the Trust Store (DemoTrust.jks)

If the application WSDL is certificate authority (CA)-certified, you must update FMW_HOME/user_projects/domains/WLS_SOA/bin/setDomainEnv.sh as follows:

1. Open FMW_HOME/user_projects/domains/WLS_SOA/bin/setDomainEnv.sh.

2. In EXTRA_JAVA_PROPERTIES:

Replace:

- -Djavax.net.ssl.trustStore=%WL_HOME%\server\lib\DemoTrust.jks

With:

- -Djavax.net.ssl.trustStore=kss://system/trust -Djavax.net.ssl.trustStoreType=kss

Configuring the Proxy Server for Runtime

You must configure the proxy server for runtime use.

1. Open FMW_HOME/user_projects/domains/WLS_SOA/bin/setDomainEnv.sh.

2. Add the following line to EXTRA_JAVA_PROPERTIES:
-Dhttp.proxyHost=www-proxy.us.company_name.com -Dhttp.proxyPort=80 -Dhttp.nonProxyHosts=localhost|*.us.company_name.com|127.0.0.1|10.*.*.*|*.foo.com|etc -Dhttps.proxyHost=www-proxy.us.company_name.com -Dhttps.proxyPort=80"
Where company_name is your company name.

3 Specifying Inbound WSDL URL Patterns

Oracle SOA Suite and Oracle Service Bus inbound WSDL URLs must adhere to the conventions described in this section.

Topic

- Specifying Oracle SOA Suite and Oracle Service Bus Inbound WSDL URL Patterns

Specifying Oracle SOA Suite and Oracle Service Bus Inbound WSDL URL Patterns

Use the following conventions when specifying Oracle SOA Suite and Oracle Service Bus inbound WSDL URLs for the Oracle Sales Cloud, Oracle RightNow Cloud, and Oracle HCM Cloud adapters.

Pattern

URL Format

Example

Oracle SOA Suite

https://hostname:ssl_port/integration/flowsvc/adapter/partition_name/composite_name/service_name/version?wsdl

where adapter is:

- rightnow

- hcm

- osc

https://abc123.us.company.com:20117/integration/flowsvc/rightnow/default/RNOW-OSC-SYNC/RightnowService/v1.0/?wsdl

Oracle Service Bus

https://hostname:ssl_port/integration/flowsvc/adapter/application_name/proxy_name?wsdl

where adapter is:

- rightnow

- hcm

- osc

https://abc123.us.company.com:7002/integration/flowsvc/hcm/HCM-HCM/HcmService/?wsdl

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2019, Oracle and/or its affiliates. All rights reserved.

License Restrictions Warranty/Consequential Damages Disclaimer

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.

Warranty Disclaimer

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.

Restricted Rights Notice

If this is software 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 installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

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.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon 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, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

Third-Party Content, Products, and Services Disclaimer

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.

Pre-General Availability Draft Documentation Notice

If this document is in public or private pre-General Availability status:

This documentation is in pre-General Availability status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

Private Pre-General Availability Draft Documentation Notice

If this document is in private pre-General Availability status:

The information contained in this document is for informational sharing purposes only and should be considered in your capacity as a customer advisory board member or pursuant to your pre-General Availability trial agreement only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has been executed by you and Oracle and with which you agree to comply. This document and information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.