<dataSources>

The xml file has to contain the tag <dataSources> and underneath one or more data source configurations.

Example

<dataSources>      <dataSource id="PRIVATE_DATASOURCE">      ...      </dataSource>      <dataSource id="CORP_LDAP">      ...      </dataSource> </dataSources>

 

Metadata of a Data Source

The metadata of a data source is specified as attributes in the <dataSource> tag and describes the data source and how the persistence manager uses it.

Mandatory attributes

·        id: Specifies the name that the persistence manager or an application uses to identify the data source. The ID has to be unique.

Allowed characters are capital letters (“A”-“Z”) and underscores (“_”). The length of Ids is restricted to 20 characters.

Changing the ID of an existing data source leads to inaccessible data.

 

className: Specifies the implementation class of the data source, which implements the IDataSource interface. The specified class has to be loadable by the class loader which loads the jar com.sap.security.core.jar.

The following values are allowed:

...

¡        com.sap.security.core.persistence.datasource.imp.DataBasePersistence

(used to read/write UME data from/to a database)

¡        com.sap.security.core.persistence.datasource.imp.LDAPPersistence

(used to read/write UME data from/to an LDAP server)

¡        com.sap.security.core.persistence.datasource.imp.R3Persistence

(used to read user data from an SAP system)

¡        com.sap.security.core.persistence.datasource.imp.R3RoleDataSource

(used to read roles from an SAP system and present them as UME groups)

This list may be extended in the future by new data source implementations developed by SAP or customers.

Optional attributes:

displayName: Contains a meaningful name or a resource bundle key which is used to display the data source on a user interface.

isReadonly: Specifies whether the data source is only used for read and search operations, or also for create, modify and delete operations.

Allowed values: true, false

Default value: false (used if the attribute is not specified)

isPrimary: Specifies whether the data source is a replication data source, which is only involved in create, modify and delete operations, but not in search and read operations.

Allowed values: true, false

Default value: true (used if the attribute is not specified)

You can not combine isReadonly="true" and isPrimary="false".

Example

<dataSource id="CORP_LDAP"      className="com.sap.security.core.persistence.datasource.imp.LDAPPersistence"          displayName="SAP Employees"          isReadonly="true"         isPrimary="true">     ... </dataSource>