Configure a Credential Vault for overlay reports

To access the IBM Digital Analytics (formerly Coremetrics) system, store user information in a Credential Vault slot.

Set up the Credential Vault using one of the following methods:

• Manually using the Credential Vault portlet.
• Using xmlaccess.sh portlet.
• Importing an XML configuration interface script.

Store the following Coremetrics user information:

• The Coremetrics client ID
• The Coremetrics user name
• The Coremetrics authentication key.

The Credential Vault slot used for storing the user information must have the slot name...

com.ibm.portal.asa.coremetrics.slot

In the credential slot, 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
• An external-id in xmlaccess.sh script

For example: If we 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 configuration interface script for creating required Credential Vault entries:

<request xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
         xsi:noNamespaceSchemaLocation="PortalConfig_8.5.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 pairs) 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 with the user ID defined 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 topic: Configure security for overlay analytics reports

Next topic: Configure the theme for overlay reports

Related :

1. xmlaccess.sh
2. Import pages or page hierarchies using the XML Import portlet
3. Portlet authentication
4. Work with xmlaccess.sh