Configuring a Credential Vault for overlay reports

To access the IBM Coremetrics Web Analytics system, you have to store the user information in a Credential Vault slot. If you do not do this, the portal overlay reports cannot show data from the Coremetrics system.

We can set up the Credential Vault by one of the following three methods:

• Manually using the Credential Vault portlet in the section for Access and Managing credential information of the portal administration. For details refer to the portlet help about Manage credential information and Add a vault slot.

• By using xmlaccess.sh portlet. For details refer to the Import XML portlet help Import an XML configuration file.

• By importing an xmlaccess.sh script. For details refer to the topics about the portal xmlaccess.sh and working with it.

Also refer to Portlet authentication.

Make sure you store the following Coremetrics user information:

• The Coremetrics client ID

• The Coremetrics user name

• The Coremetrics authentication key.

1. The Credential Vault slot used for storing the user information must have the slot name com.ibm.portal.asa.coremetrics.slot .

2. In the credential slot, you need to enter the Coremetrics user name and client ID, separated by a hash sign ( # ), either as a shared user ID in the portal Administration user interface, or as an external-id in xmlaccess.sh script.

For example: If you have a Coremetrics user name Bob and a Coremetrics client ID 123456789, enter these values as "Bob#123456789" in the credential slot. Here is a sample XML configuraion interface script for creating required Credential Vault entries:

<request    
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    
   xsi:noNamespaceSchemaLocation="PortalConfig_8.0.0.xsd"    
   type="update" create-oids="true">       
   <!-- Sample for updating the Credential Vault. 
        This script creates a new segment containing one slot in the portal Credential Vault.
        The credentials (user ID and password pairso stored in the vault cannot be 
        accessed using xmlaccess.sh. We can only set the credentials 
        using the portal administration portlets for the Credential Vault. -->  
   <portal action="locate">          
      <credential-segment action="update" adapter-type="default" 
                          name="com.ibm.portal.asa.coremetrics.segment" user-mapped="false">
         <description>Segment containing credentials for Coremetrics</description>         
         <credential-slot action="update" name="com.ibm.portal.asa.coremetrics.slot" 
                          active="false" system="true" resource="none" 
                          secrettype="userid-password">               
            <localedata locale="en">                   
               <description>Credentials for accessing the CoreMetrics server</description>
               <keywords>CoreMetrics</keywords>     
            </localedata> 
            <password-secret action="create" user="user_id" 
               external-id="coremetrics_user_name#coremetrics_client_id">coremetrics_auth_key
            </password-secret>           
         </credential-slot>       
      </credential-segment>   
   </portal>
</request>

In the sample XML script, replace the following variables with the actual Coremetrics user data values:

user_id

Replace this variable by the user ID of the user who is entered in the under the Resource Environment Provider WP_VaultService in the entry systemcred.dn .

coremetrics_user_name

Replace this variable by the Coremetrics user name.

coremetrics_client_id

Replace this by the Coremetrics client ID.

coremetrics_auth_key

Replace this by the authentication key used by Coremetrics. This allows URL queries to the Coremetrics system.

Parent: Display overlay analytics reports
Previous: Configure security for overlay analytics reports
Next: View overlay analytics statistics
Related:
xmlaccess.sh
Related:
Portlet authentication
Work with xmlaccess.sh