WebSphere brand IBM WebSphere XML Document Management Server, Version 7.0

Normalization and mapping considerations

There are several considerations concerning how normalization and mapping are implemented.

Normalization functions

With IMS, user identifiers (UIDs) are normally represented as uniform resource indicators (URIs). URIs used by SIP may contain a scheme, port, and URI parameters that you may want to strip or remove. In addition, your environment may require that UIDs be case sensitive. Service URIs can also be normalized, service URIs are URIs that identify a service or resource. Service URIs are used as Session Initiation Protocol (SIP) Request URIs and they are identified in rls-services documents.

The normalization properties are defined in the properties file: was_root/properties/WebSphere_IMS_Common_Utils.properties.
Note: was_root is the installation root directory for WebSphere® Application Server Network Deployment. By default, this directory is:
  • AIX /usr/IBM/WebSphere/AppServer
  • Linux /opt/IBM/WebSphere/AppServer
There must be a normalization properties file on each XDMS server with the same properties values. The application server(s) needs to be restarted for changes in the normalization properties file to take effect.
Note: If you change the normalization or mapping properties, you run the risk of orphaning documents that were stored using different mapping properties. These changes should be made in pre-production. If changes are made in production, you may have to recreate the database to remove or recover documents stored with the old mapping properties.
The normalization function has several configurable parameters for UID and service URIs.
Table 1. UID normalization properties
property description default value
enableMultipleIDMapping Strips the schema data from the UID. true
isCaseSensitive Set to true if the UID is case sensitive. If false, the resulting UID will be converted to all lower case. true
idMappingProvider Class that implements the Interface for returning a list of matching UIDs or finding a primary UID. empty
Table 2. Service URI normalization properties
property description default value
enableMultipleServiceURIMapping Set to true if the schema should be stripped from a service URI. false
URIParametersFilter Comma delimited list of parameters to keep attached to Service URI, all others are stripped. Set to star'*' to keep all parameters. If property is empty, all parameters are stripped. Parameters that remain will be sorted in alphabetical order for the resulting Service URI. empty
stripPort Set to true if the service URI will have the port stripped. true
The following describes how normalization functions.
XML Configuration Access Protocol (XCAP)
The XCAP User Identifier (XUI) in the document selector is always normalized.
SIP
The UID of the document parameter in the event header is normalized. If the document is global/index, it finds a list with a service uri= that matches what is in the subscribe header of the SIP SUBSCRIBE. If the document is not specified, it subscribes to the home directory of the user in the To header, that UID will be normalized and the subscription will be to the directory of the normalized UID.
Policy
Comparing principal to XUI in the document selector.
Comparing principal to entry in policy document.

Public identity mapping

For the IBM® XDMS, the primary purpose of multiple public identity mapping is access control. If users are granted access to a document with one public identity, they can be allowed to access that document with another public identity. The multiple public identity mapping feature enables the mapping of public identities to private ones and has a normalization feature for UIDs and service URIs.

The manner in which public identity mapping is implemented is up to the IBM XDMS service provider. Telecom Application Enablement Feature provides an interface for public identity mapping and the service provider develops the logic that works with their user repository implementation.




Terms of use
(C) Copyright IBM Corporation 2009. All Rights Reserved.