Configuring Credential Vault for Connections User
WebSphere Portal requires Connections user credentials to fetch the Connections files and configure inside WCM Authoring Tools using Personalization and Rich text components. So, we will now create a Credential Vault for Connections user.
1. Log in to IBM WebSphere Portal Console as an Administrator using credentials wpsadmin/wpsadmin (username/password).
2. Navigate to Administration → Access → Credential Vault
. Click on Add a vault slot
3. Specify the vault slot name as connections_slot
. Create a new vault resource for this vault slot with name as conn_resource
. Make the vault slot as shared by checking the check box. Specify the Connections userid and password as firstname.lastname@example.org/passw0rd as shown in the figure below.
4. Click OK
5. In Administration → Access → Credential Vault → Manage system vault slots
, you should find that the added vault slot connections_slot
Configuring Portal for Integration with Connections Files
We must configure the Federated Document Service in WebSphere Application Server (WAS) Administration Console to specify the CMIS URL and authentication information of the Connections server. Follow the steps to configure the Resource Environment Providers, WP FederatedDocumentsService
1. Log in to WAS Administration Console as an Administrator using credentials wpsadmin/wpsadmin (username/password).
2. Navigate to Resources → Resource Environment → Resource Environment Providers
. Select WP FederatedDocumentsService
. The values can be specified in the Custom Properties section as shown in the figure below.
3. Click on Custom properties
under Additional Properties.
4. Click on New
as shown in the figure below :
: If a property by name is already present in Custom properties, then click on the property and replace only the property value. Click Apply
changes directly to master configuration.
5. Specify the Property name and value for Federated Documents.
a. Enter property name as wp.federated.documents.ic_personalized_sc.url
and value as https://connectionsww.demos.ibm.com/files/basic/cmis/my/servicedoc
as shown in figure below :
b. Click Apply
button and then click Save
directly to master configuration link.
c. Click OK
button. We can now find that the added property name is getting displayed in Resources → Resource Environment → Resource Environment Providers → WP FederatedDocumentsService
Similarly, follow the above steps a, b, c and add the following properties :
Your Documents on IBM Connections.
Your Documents on IBM Connections.
6 . We can also specify the Credential Vault information while connecting to remote Connections server. In case, if SSO is configured with Portal and Connections, then we may not need Credential Vault. Specify whether we need the Credential Vault for federated documents for the two ways : Personalization (PZN) and Rich Text Element (RTE).
Follow the above steps 5 a, b, c and add two properties with names :
Setting the property value to true indicates that we need credential vault slot, false indicates that credential vault slot is disabled. If the Credential vault slot is disabled, then the current logged in user is used for connecting to remote server. If the credential vault is enabled, then we must add an additional property with name as wp.federated.documents.suffix.vault.slot
and value as connections_slot
. While connecting to CMIS server in WCM PZN and RTE components, the credential vault slot is displayed based on these properties.
The following properties are added to enable credential vault slot.
7. If the credential vault slot is enabled, then we must grant permission to All Authenticated Portal Users
to the ADMIN_SLOTS
virtual resource. Follow the steps for granting permission as show in the figure below.
a. Log in to IBM WebSphere Portal Console as an Administrator using credentials wpsadmin/wpsadmin (username/password).
b. Navigate to Administration Portlet → Access → Resource Permissions
c. From the Resource Types
, select Virtual Resources
d. For the ADMIN_SLOTS
resource, click the Assign Access icon
e. Edit the User role
, and add the All Authenticated Portal Users
to the role.
8. Add the Theme wp_federated_documents_picker
in /ibm.portal.80Theme/profiles/profile_deferred.json and /ibm.portal.80Theme/profiles/profile_full.json files of the Portal 8.0 theme. WCM Authoring portlet needs this theme to display the Insert Link to Remote Document
in Rich Text Element.
This article is one of several which describes how to use WCM to render social content:
5.4 Using WCM to render social content