Configure WebCenter Content and Oracle Content and Experience for the WCC Connector

Verify Network Accessibility for a WCC Connector

The communication between Oracle Content and Experience and WebCenter Content Server takes place over JAX-WS protocol, so the Oracle Content and Experience instance and WebCenter Content Server need to be on the same network for them to work together.

For the Oracle Content and Experience Public cloud, the WebCenter Content Server should be accessible from the Public networks.
For the Oracle Content and Experience private cloud, the WebCenter Content Server should be accessible from that private network.

Check WebCenter Content Readiness

The WebCenter Content connector is deployed on an Oracle Content and Experience managed server and can be accessed using the context root /cec-connector/wcc.

To verify the deployment, go to the following link in the browser:

http://<host>:<port>/cec-connector/wcc/rest/api

This gives the following response which indicates the connector is deployed properly:

Description of oce-readiness-check.png follows

Description of the illustration oce-readiness-check.png

Enable SSL

The Oracle Content Server should be accessible over HTTPS protocol. Access the content server sign-in page using the following URL, which will render the sign-in page in the browser:

Login Page: https://<host_name>:<port>/cs/login/login.htm

Description of the illustration enable-ssl.png

Enable Jax-WS

JAX-WS should be enabled on Oracle Content Server for the connector to work. This is the basic prerequisite.

Access the content server instance using the following URL. This will render the WSDL in the browser.

https://<host_name>:<port>/idcnativews/IdcWebLoginPort?WSDL

Description of jax-ws-style.png follows
Description of the illustration jax-ws-style.png

Check Oracle Content and Experience Readiness

The WebCenter Content connector is deployed on an Oracle Content and Experience managed server and can be accessed using the context root /cec-connector/wcc.

To verify the deployment, go to the following link in the browser:

http://<host>:<port>/cec-connector/wcc/rest/api

This gives the following response, which indicates the connector is deployed properly:

["v1"]

Set Up the Security Policy on WebCenter Content Server

We will communicate with the WebCenter Content Server using the JAX-WS communication channel. The JAX-WS endpoints must be secured using the OWSM policies.

We will use the oracle/wss_username_token_over_ssl_service_policy server-side policy. Any client that communicates with the WebCenter Content Server must enter both a user name and a password. If these values are incorrect, then the handshake with the WebCenter Content Server will not be established.

Take the following steps to configure the server-side policy:

Check the OWSM policy attached to JAX-WS.
To check the policy attached, access https://<host_name>:<port>/idcnativews/IdcWebLoginPort?WSDL. You should see the policy <wsp:PolicyReference> field in the wsdl.

Description of the illustration wsdl-owsm-policy.png
If the attached policy is oracle/wss_username_token_over_ssl_service_policy, then ignore the steps that follow.

Description of the illustration wcc-enterprise-manager.png
If the attached policy is a different one, then first detach that policy, and then attach the policy oracle/wss_username_token_over_ssl_service_policy. The steps to attach or detach a policy follow. If no policy is attached, tfollow the steps.

Description of the illustration ucm-web-services.png

Take the following steps to Attach an OWSM Policy:

Go to the WebCenter Content Server Enterprise Manager:
```
http://<host_name>:<port>/em
```
Sign in with your administrator credentials (weblogic/<password>)
On the Target Navigation page, choose Application Deployments -> Oracle UCM Native Web Services -> oracle UCM Native Web Service(UCM_Server1).
Choose Application Deployment -> Web Services.
On the IdcWebLoginPort (Web Services Endpoint) page, click Attach/Detach Policies.

Description of the illustration attach-detach-policies.png
In the directly attached policies section, if there is any policy other than oracle/wss_username_token_over_ssl_service_policy attached, first detach it. Then attach the oracle/wss_username_token_over_ssl_service_policy policy:
1. Click the policy whose category is Security, select it, and then click Detach.
  Notice that this policy will go away from the Directly Attached Policies list.
  
  Description of the illustration detach-policy.png
2. Attach the oracle/wss_username_token_over_ssl_service_policy policy.
  Under Available Policies, search for oracle/wss_username_token_over_ssl_service_policy. In the result section, select oracle/wss_username_token_over_ssl_service_policy, and then click the Attach button.
  
  Description of the illustration attach-policy.png
Verify that oracle/wss_username_token_over_ssl_service_policy is under Directly Attached Policies, click Validate, and then clickOK. After the popup closes, click the Return button. No restart is required.

Description of the illustration validate-policy.png
Access https://<host_name>:<port>/idcnativews/IdcWebLoginPort?WSDL.
You should see the policy oracle/wss_username_token_over_ssl_service_policy being attached to the IdcWebLoginPort wsdl. This confirms that the policy is attached correctly.

Description of the illustration wsp-policy.png
Also, verify that the https://<host_name>:<port>/idcws/GenericSoapPort?WSDL wsdl loads successfully.

Configure the WebCenter Content Connector

Before you start using the WebCenter Content Connector in an Oracle Content and Experience instance, the connector needs to be registered, configured, and enabled on the Oracle Content and Experience side.

To configure a WebCenter Content Connector for Oracle Content and Experience:

Sign in to Oracle Content and Experience as an administrator.
Go to Administration > Integrations > Content Connectors, locate the out-of-the-box connector Webcenter Content, and click Enable next to it.

Description of the illustration webcenter-content-fields.png
Enter a description and select the Allow content type creation and Enable for end-users checkboxes.
Enter details for Additional Fields:
- WebCenter Content JAX-WS Connection URI: http://<host_name>:<port>/idcnativews
- WebCenter Content Server JAX-WS Client Policy: oracle/wss_username_token_over_ssl_client_policy
- WebCenter Content Server Web Context Root: /cs (This depends on Content Server setup.)
Click Save.
The WebCenter Content connector is now enabled and ready to be used.

Specify WebCenter Content Connector Mappings

Selection of the Allow content type creation option for a WebCenter Content Connector creates a WebCenter-Content content type in Oracle Content and Experience by the administration user who is configuring the connector.

Description of the illustration wcc-mappings.png

You can view the content type on the Administration > Assets > Content Types page.

Description of content-types.png follows

Description of the illustration content-types.png

As an administrator for the asset repository, you can specify mappings for the connector type.

Enable a WebCenter Content Connector for an Asset Repository

Once the connector is configured and enabled, we need to enable it for the asset repository, as follows.

Selecting the connector automatically adds the associated content type to the repository. Be sure to add the required members to the content type for them to be able to access and create content items in the repository.

Description of wcc-edit-repository.png follows

Description of the illustration wcc-edit-repository.png

Use a WebCenter Content Connector

To use a WebCenter Content Connector, follow these steps.

Go to the asset repository for which you have configured the connector, and click Add > Import from WebCenter Content
This launches a WebCenter Content sign-in dialog.

Description of the illustration wcc-sign.png
Enter your WebCenter Content Server credentials.
These credentials will be securely stored on Oracle Content and Experience and can be reused for subsequent access. To clear the credentials, go to Add > Manage Sources > Connector > Revoke.

After your credentials are authenticated, you will see a connector-picker dialog that lists content from the content server.

Description of the illustration connector-picker-dialog.png
Browse through the files and folders. You can also use search for specific items. Additionally, you can choose to view the listing in various layouts, like card, compact, and list.

Description of the illustration files-and-folders.png
The dialog also supports pagination for a large number of files and folders. Select the file or files you are interested in, and click Ok

Description of the illustration select-files.png
You can add to the asset repository. An intermediate dialog lists the files to be added and lets you choose the collection and channels. You can also specify tags for the content you are adding. Click Add.
Once Add is successful, content items are created in the asset repository. Two artifacts are created for every document that is added: the actual document (digital asset) and the content item that references the digital asset.

Description of the illustration digital-assets.png
The following image shows the content item created by referencing the digital asset document.

Description of the illustration content-item.png

Create a Custom Content Type

To create a custom content type, you can reuse an existing content type or create a new one and do the necessary mapping in the connector configuration screen.

For example, suppose we were to register a new WebCenter Content connector for another WebCenter Content instance we want to wire to. We could not check Allow Content type creation and instead choose to use the WebCenter Content content type in the Oracle Content and Experience content type and perform the necessary mappings of the listed attributes.

Description of content-item-data-fields.png follows

Description of the illustration content-item-data-fields.png

Revoke Authorized Users

Once you provide the user credentials, they are stored in Oracle Content and Experience and passed to the connector during subsequent usage, which means the login challenge will not be given all the time.

If you need to sign in as a different user, then the signed-in authorized user needs to be revoked. To revoke an authorized user:

Click Assets → Add → Manage Sources.
Click Revoke next to a user name.
Click OK to revoke the user.

Run the Indexer and File Formats Wizard

To complete the configuration of a WebCenter Content connector, you need to run the Indexer for search results and the File Formats Wizard for IBR configuration in Oracle Content and Experience.

It is mandatory to run the Indexer for a search to return results. For thumbnail generation for documents in the WCC file picker window in Oracle Content and Experience. Choose Administration → Admin Applets → Repository Manager → Indexer.

IBR must be configured for Content Server. Choose Administration -> Refinery Administration -> File Formats Wizard.

Description of file-formats-wizard.png follows

Description of the illustration file-formats-wizard.png