Document History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
5 Auditing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
5.1 Logging of Security-Relevant Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
6 Content Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
8 Regulatory Compliance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
8.1 Person-Related Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
Data Protection and Privacy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Table 1:
Document Version Description of Change
A digital signature is added to win32 clients. See section Viewing Win32 Cli
ent Digital Signatures [page 57].
Updated the section Person-Related Data to cover Data Protection and Pri
vacy. See section Data Protection and Privacy [page 55]
Added new MDM LDAP parameters in the section, MDM LDAP Parameters
[page 19].
4.21 / June 2014 Corrected description of User Filter parameter in the section,MDM LDAP
Parameters [page 19].
Added note that you can configure a secure connection from MDS to the
Active Directory only when MDS is installed on a Windows platform.
3.1 / April 2012 Consolidated information from the MDM Console Reference guide into the
following sections:
New CLIX command added for emergency Admin user password creation.
See Emergency User Creation [page 16].
An overview of the intended audience and scope of this security guide for SAP NetWeaver Master Data
Management (MDM) 7.1.
Target Audience
Technology consultants
System administrators
CIOs
Security experts
This document is not included as part of the Installation Guides, Configuration Guides, Technical Operation
Manuals, or Upgrade Guides. Such guides are only relevant for a certain phase of the software lifecycle,
whereby the Security Guides provide information that is relevant for all phases of the lifecycle.
The MDM Security Guide describes the security only for SAP NetWeaver Master Data Management.
For information about other SAP components used in MDM scenarios, see the MDM Master Guide on the SAP
Help Portal at help.sap.com/nwmdm71.
See the corresponding Security Guides for the SAP components that are a part of the MDM scenarios.
Table 2:
Application Guide Most Relevant Sections or Specific
Restrictions
SAPECC 6.0 SAP ERP 2005 Security Guide In the SAP ERP 2005 Security Guide,
choose Security Guides for SAPECC
6.0.
SAP NetWeaver Process Integration 7.1 SAP NetWeaver Security Guide In the SAP NetWeaver Security Guide,
choose Security Guides for SAP
NetWeaver Products SAP Security
Guide PI .
Operating Systems and Database Plat SAP NetWeaver Security Guide In the SAP NetWeaver Security Guide,
forms choose Operating System and
Database Platform Security Guides.
For a complete list of SAP Security Guides, see service.sap.com/securityguide on SAP Service
Marketplace.
For a complete list of SAP NetWeaver MDM components, see the MDM Master Guide on the SAP Help Portal at
help.sap.com/nwmdm71.
MDM provides its own user management. There are no user and role features delivered on top of the MDM
user management.
2.1 Users
You can set passwords for MDM Servers and users of MDM repositories.
By default, access to new Master Data Servers is not limited. You have to set a password to control access.
When mounting a Master Data Server for the first time using the MDM Console, make sure that you set a
password for the server. Select the MDM Server in the left window pane of the MDM Console window, and
choose MDM Servers Change Password .
MDM Repositories
You access MDM repositories with a user and password. SAP NetWeaver MDM uses its own mechanisms to
define users. You have to set passwords for the users to control access:
When creating a new repository, make sure that you set a password for the predefined Administrator user.
When updating an existing repository or unarchiving a shipped repository template, you have to use the
users and passwords that were already defined for the repository.
Note
You must log on to the repository at least once during an MDM Console session. This means that you have
to log on to a repository each time you start the MDM Console. The icon next to the repository name
indicates whether you have to log onto the repository.
For more information about updating repositories, see the MDM Upgrade Guide on the SAP Help Portal at
help.sap.com/nwmdm71.
SAP NetWeaver MDM uses its own mechanisms for roles and authorizations.
Roles
Roles are assigned to users. Each repository contains the standard roles: Admin and Default. They cannot be
deleted. The Admin role cannot be changed. The Default role is predefined with full privileges.
Authorizations
Authorizations (called privileges in MDM) are assigned to roles and are edited in the Roles table. You can
granularly enable or disable authorizations for specific functions (such as Add Records or Delete Records) or
limit access to tables and fields (such as read/write access and constraints).
The following privileges are required to manage users, roles, and passwords:
For more information, see the section, MDM User and Role Management, in the MDM Console Reference Guide
on the SAP Help Portal at help.sap.com/nwmdm71.
A new repository has one predefined user and two predefined roles.
When creating a repository from scratch, there is one predefined user and there are two predefined roles. The
predefined user is the Admin user and the predefined Admin role is assigned to it. A password is predefined
initially for the User Admin role. It is very important to maintain a strong password for this user shortly after
creating the repository.
The other predefined role is the Default role. Initially it has full privileges. It is important to reduce these
privileges shortly after creating the repository.
The .NET and Java APIs use the user name and password or the trusted connection concept to log on to the
Master Data Server and the repositories. For more information, see Trusted Connections [page 10].
The ABAP API uses the trusted connection concept and extends this concept by always logging on with the sy-
uname of the logged on user on the AS ABAP.
When using the Web Services Generator or iViews, you can use an SSO-like feature.
With the SSO-like feature in MDM, there is no need to re-authenticate between the application running on the
SAP NetWeaver Application Server Java (AS Java) and MDS. The same MDM session is kept for different
requests to the MDS issued by the same source.
The AS Java object for the SSO is the SAP logon ticket.
As SAP logon ticket evaluation is not currently supported in the MDS, the SSO-like feature is implemented in
the MDM applications on the AS Java.
For the SSO-like feature, the user authenticated for SAP NetWeaver Application Server Java (AS Java) should
be propagated to MDM.
Trusted connection configuration has a direct influence on how authentication is performed and whether or
not the SSO-like feature is supported. See Authentication of Trusted Connections [page 35] for more
information about trusted connection configuration.
The following facets have an impact on the authentication mode and SSO-like feature support:
User mapping
User management
Trusted connection between SAP NetWeaver Application Server Java (AS Java) and MDM
User mapping is defined for a specific MDM system:
Same as in iViews and UWL in the MDM 5.5 release
Likely with authenticated session
Trusted connection also works
No user mapping: SSO-like feature
User management as described for same users in UME and MDS in User Management [page 10]
Trusted connection is required between AS Java and MDS
The Web Services Generator application is a Web application supporting basic HTTP authentication of SAP
NetWeaver Application Server Java (AS Java). MDM user credentials are inserted by the user in the Web
Services Generator wizard.
The Web services generated by the Web Services Generator have security capabilities.
SSL Support
The transport protocol for the generated Web services can be either SOAP over HTTP or SOAP over HTTPS.
You can also specify that the transport protocol for connecting generated Web services to the Master Data
Server has a secure connection.
Authentication
You can define the following authentication modes in the SAP NetWeaver Application Server Java (AS Java)
for the generated Web services:
No Authentication
An MDM constant user is defined in the Visual Administrator/Services/Configuration Adapter and its
MDM password is stored there.
Basic Authentication
User name and password of the Web service user are propagated to MDM. This requires user
management as described for same users in UME and MDS in User Management [page 10].
Users with the appropriate authorization (such as the Admin role) can create new users in the MDM Console.
End users can be forced to change their password after the first logon to the Master Data Server using one of
the MDM client applications.
This feature prevents the administrator from knowing the passwords of the end users.
Note
The admin-supplied password is not saved in the password history.
You can configure this initial password behavior by setting the flag User Must Change Password in the MDM
Console User Detail pane to Yes after creating a user. (The default setting for User Must Change Password is
No.)
This feature can also be used by the administrator to enforce a password change by the user at any time.
Strong and secure passwords are a combination of upper and lowercase letters, numbers and special
characters with a recommended length of approximately 12 14 characters. Passwords using personal
information like names or dates, user names or repetitions, dictionary words and sequences should not be
used.
From MDM 7.1 SP10, you can set a password policy to enforce end users to use strong and secure passwords.
A password policy can include one or more of the following requirements:
Password requirement options are set in the mds.ini file. After setting these options, the new password
requirements are enforced for password changes or creation of new passwords.
The following sections describe the password requirements that you can set in the mds.ini file.
You can set the minimum and maximum length of passwords in the mds.ini file.using the following options:
If the minimum password length is set to a value that is equal to or greater than the maximum password
length, the allowed password length will be a fixed value that is equal to the maximum password length.
You can set password complexity requirements in the mds.ini file using the following options:
Password Re-use
To increase password security, you can prevent users from reusing previous passwords by using the Number
Of Previous Passwords That Cannot Be Reused option in the mds.ini file.
The value that you set for this option determines the number of recent passwords that are stored in the user's
password history and cannot be re-used.
A password is saved in the password history when it is first defined. The default value of 1 means that only the
current password is saved, therefore, a new password must always be different from the current password.
You cannot define a value of less than 1. The maximum value allowed is 99. SAP recommends a value of at
least 3.
Note
The admin-supplied password is not saved in the password history.
Users are forced to change the password after the validity timeframe for the password has expired.
The validity timeframe of the password is maintained centrally in the mds.ini file located in the server
directory ..\sap\MAF\MDS {instance number}\config.
After the defined number of warning days, the user cannot log onto the system without changing his or her
password.
Note
Changes to the mds.ini file take effect only after a restart of the Master Data Server.
Direct changes to the mds.ini file are not logged by the MDM system and it is therefore advisable to limit
access to this file.
It is possible to define that the password for a user will never expire. The flag Password Never Expires in the
console user administration activates the described behavior if it is set to Yes.
Authentication credentials are not automatically deactivated if they have not been used for a certain period of
time.
The administrator should deactivate user accounts that are not in use by assigning a non-authorized role
and/or by assigning a secret password.
The user account is locked after a defined number of failed password logon attempts for a defined length of
time.
The user account lock settings are maintained centrally in the mds.ini file located in the server directory ..
\sap\MAF\MDS {instance number}\config.
After the defined number of failed password logon attempts, the user cannot log on to the system for the
defined number of seconds.
Note
Changes to the mds.ini file take effect only after a restart of the Master Data Server.
Direct changes to the mds.ini file are not logged by the MDM system and it is therefore advisable to limit
access to this file.
The administrator can reset a locked account at any time. The flag Reset Account Lock in the console user
administration deactivates the lock if it is set to yes.
Note
The User Account Lock feature does NOT work for users with the Admin role. This prevents administrators
from lock out scenarios.
Tip
Keep the number of users with the Admin role as small as possible. Use especially strong passwords for
those users, as they are not protected against brute force attacks.
This feature can significantly slow down password brute force attacks if the number of allowed failed password
attempts is set to a low value and the lock duration is set to a relatively high value.
The repUser set of MDM CLIX commands enable administrators to get information about, change, expire,
and unexpire passwords for repository users.
For complete information about these commands, see the CLIX Command Reference on the SAP Help Portal
at help.sap.com/nwmdm71.
The following table shows the tools used for user management and user administration with the business
scenario.
Table 3:
Tool Detailed Description
MDM Console Use the user management as described in the MDM Console Reference Guide. In
the MDM Console you define the MDM user.
Java / .NET / ABAP APIs All available APIs offer functions for user management. You can build your own
user management tools on top of the APIs.
MDM CLIX The repUser set of MDM CLIX commands enable administrators to get infor
mation about, change, expire, and unexpire passwords for repository users.
Standard User
The following table shows the standard user created by the system when you build a repository from scratch.
Table 4:
System User ID Password Description
You can create an emergency user to access a system in case of loss of all administrative user credentials.
To create a new password for the Admin user of an MDM repository, use the CLIX command
repEmergencyAdminUserSetPassword. For complete information about this command, see the CLIX
Command Reference on the SAP Help Portal at help.sap.com/nwmdm71.
Some MDM customers require support for LDAP (Lightweight Directory Access Protocol) within the MDM
system. This section discusses the various issues of LDAP use within MDM.
Note
From MDM 7.1 SP06 and higher, to use LDAP authentication for MDM users on HP-UX 11.31, you must have
Mozilla LDAP C SDK 5.17 installed. For support, contact your Hewlett-Packard (HP) vendor.
What is LDAP?
LDAP allows a company to control, configure and distribute user privileges, rights, and access from a single
location.
Without LDAP, the system manager is forced to maintain familiarity with the proprietary access control
mechanism offered by each software product, and to use each one to separately maintain access control
information every time an employee is hired, moves, changes job within the organization, and so on.
Imagine a company with thousands of employees and dozens of programs requiring access control, and it
becomes clear how much of a burden it can be to manage access control without LDAP.
By contrast, by using MDM in conjunction with LDAP, MDM customers can manage access control information
in a single location with a common, familiar interface of their choosing.
LDAP acts as a lookup into a directory, very similar to using a telephone book. For example, you can perform a
general search, such as one that returns all instances of Mary Lamb. In BigFoot, this returns 100+ records in
the United States. Or you can restrict the search by adding in California to the search, which then returns 6
records.
It turns out that the BigFoot search engine is based on an LDAP directory that includes Name and State
lookup categories. Owners of LDAP directories can retrieve additional fields, categories, or attributes, such as
Telephone Numbers, Primary Automobile, Hair Color, or MDM User Type. This additional information
can be used as well for additional selection criteria.
For MDM to support LDAP, SAP has designated the information that MDM will be querying from and that must
be entered and maintained within the customers LDAP database/directory.
The MDM LDAP fields are defined or created and then populated by the customer in the customers LDAP
directory. Presently, MDM makes use of LDAP user group assignments, stored in LDAP fields. In rare cases
when LDAP user group assignments cannot be used, MDM requires the addition of only one attribute field
(unless an existing field is used):
Note
While SAP suggests the name MDMRoles, you can choose any name that suits your situation.
Since LDAP allows multiple instances of an attribute, MDM concatenates multiple entries as though they were
in a single record separated by semi-colons (;).
Inspect or configure the mds.ini file to determine whether MDM uses proprietary user validation or LDAP
validation (see MDM LDAP Parameters [page 19]).
After configuring the mds.ini file for LDAP validation, run a Verify > Repair operation on all repositories
mounted on a Master Data Server
If using an LDAP viewer, perform security validation and retrieve role information from LDAP (see LDAP
Search Algorithms [page 24]). Use the role names retrieved from LDAP rather than the MDM repository
to initialize the user and login. Any roles that are not found in the current MDM repository are ignored, and
if none of the roles in the LDAP list are found, the user is prevented from logging in.
Note
Role names within MDM cannot contain semi-colons (;) nor start with an exclamation point (!), as
enforced by MDM Console.
Note
While roles are designed and named via the MDM software, they are assigned to users via LDAP,
centralizing this information outside of specific MDM repositories. For multi-repository environments, you
may need to name roles in an MDM repository keeping in mind other repositories that could use the same
role names. By having unique roles across all repositories, you can effectively control specific repository
access to your users.
When MDS uses LDAP (LDAP in Use=True), user validation can fail for several reasons; for example, the
LDAP server cannot be reached or the username does not exist on that LDAP server.
When Fallback in Use=True, MDM first tries to find the user in the LDAP server, and if it is not there,
MDM then looks for the user in the repository.
When Fallback in Use=True and Use Cache=True, MDM first tries to find the user in the LDAP data
cache, and then in the LDAP server. If it is not there, MDM then looks for the user in the repository.
This parameter is relevant only for the login phase. After the user has logged in, the parameter has no further
meaning. MDM continues to work in LDAP mode and does not recognize any of the users that are saved in the
MDM repository.
All LDAP access is performed by the MDS (Master Data Server). Clients of the MDS provide MDMUserName/
MDMUserPass values, which MDM then validates with LDAP.
LDAP contact information and other parameters relevant to MDM are maintained in the secure mds.ini file in
a separate section named [MDM LDAP].
Table 5:
Parameter Description
LDAP in Use Whether MDM should use LDAP. Options are True or False.
Server LDAP system address (usually a DNS name). The LDAP Server specifica
tion can be either a hostname or an IP address to which MDM attempts to
Server Port
bind; optional Server Port defaults to 389.
Admin DN The full distinguished name (DN) and password of an Admin that can search
for the users full DN.
Admin Password
For backward compatibility with previous releases, MDM will construct a
missing Admin DN from the following settings: Admin Identifier,
Admin Name, and Base DN.
Base DN The node from which MDM starts to search in the LDAP server, for example,
o=sap,c=US. This node includes users, groups, and more.
Users Base DN To optimize the search, define the subnode under the Base DN from which
to start the search for user information.
Note
If you define both Users Base DN and Groups Base DN, MDM ig
nores the Base DN setting. If only one of them is defined, MDM uses
Base DN for the other.
Groups Base DN To optimize the search, define the subnode under the Base DN from which
to start the search for group information.
Note
If you define both Users Base DN and Groups Base DN, MDM ig
nores the Base DN setting. If only one of them is defined, MDM uses
Base DN for the other.
User Identifier The name of the LDAP ID field that will match the value that the user pro
vides as the Username at logon, such as cn or uid.
MDM Roles Attribute The name of the LDAP attribute that contains the group assignments, such
as memberOf.
MDM Email Attribute The name of the LDAP attribute that contains the email addresses that are
assigned to users, and is required for workflow. Usually this name is mail.
Fallback in Use When set to True, if the LDAP server is not available or the user does not
exist in the LDAP server, MDM will attempt to find user information in the re
pository.
This parameter is relevant only for the login phase and should be used care
fully. When using this parameter our recommendation is to set only one user
in the repository, which should be read-only since company security should
be based on LDAP alone (if Use LDAP=True).
Group Identifier The name of the LDAP attribute that identifies groups, such as cn or
samAccountName. This field is mandatory for group mapping algorithms.
For more information, see LDAP Search Algorithms [page 24].
Member Attribute (Optional) The name of the LDAP attribute that lists all members of an LDAP
group, such as member. Use this field, for example, with LDAP server IBM
Tivoli. For more information, see LDAP Search Algorithms [page 24].
Page Size The number of records sent by the LDAP server per page. Default is 1000.
This value does not need to changed unless LDAP performance is problem
atic and you need to retrieve much more than 1000 records per search from
the LDAP server.
User Filter (Optional) Use this parameter to improve performance by limiting the user
search results to LDAP user records only.
This applies to all different search algorithms for users and groups.
Group Filter (Optional) Use this parameter to improve performance by limiting the group
search results to LDAP group entries only.
Group Identifier is the name of the LDAP ID field that matches the
MDM role name, such as cn or samAccountName.
The additional condition limits the result set on the LDAP server side to spe
cific role records only.
This applies to all different search algorithms for users and groups.
Secure Connection to Active Specifies whether the MDS connects securely to the Microsoft Active Direc
Directory tory LDAP server. Possible values are True or False.
Note
You can configure a secure connection from MDS to the Active Directory
only when MDS is installed on a Windows platform.
User ObjectType DN (Optional) Use this parameter to specify that the user identifier attribute re
lates to a user. This optimizes the search operation in the LDAP server and
limits the search to users only.
For example:
Group ObjectType DN (Optional) Use this parameter to specify that the group identifier attribute
relates to an LDAP group. This optimizes the search operation in the LDAP
server and limits the search to LDAP groups only.
For example:
Enable Case Sensitive Login (Optional) From MDM 7.1 SP11, you can use this option to cancel the case-
sensitive limitation for login to MDM using LDAP.
This limitation was added in MDM 7.1 SP08 and cannot be cancelled in re
leases SP08 through SP10.
All LDAP parameters except LDAP in Use can be changed in mds.ini without having to stop and restart
MDS. You must run a Verify > Repair operation on all repositories mounted on a Master Data Server after
changing the servers LDAP in Use parameter.
Whenever MDM needs information about user permissions or user names, MDM queries the LDAP server. In
order to improve performance you can set up a cache for user names, user email addresses, and user groups.
Note
The cache is not used for login operations.
To set up and use the cache for LDAP server data, add the following parameters to the [MDM LDAP] section in
the mds.ini configuration file:
Table 6:
Parameter Description
Use Cache Set the value to True to use the internal MDS cache for LDAP server data. The
default is False.
Cache Update Interval MDM checks at the specified interval whether the LDAP data cache needs to be
updated.
Sample Code
Use Cache=True
Cache Update Interval=24
If you make changes to the following parameters, you do not need to restart MDS.
Table 7:
Parameter Description
Create Time Stamp The name of the property in the LDAP server that stores the time stamp when a
Identifier user or role was created in the LDAP server.
MDM tries to detect the LDAP attribute name according to known values,
whenCreated or createtimestamp. If one of these values is detected, it is
added automatically to mds.ini.
If your LDAP server does not use one of these known values, the LDAP cache will
not start. In order to enable LDAP cache functionality, modify this parameter
with the attribute name that is used by your LDAP server.
Modify Time Stamp The name of the property in the LDAP server that stores the time stamp of the
Identifier last update of the user or role in the LDAP server.
MDM tries to detect the LDAP attribute name according to known values,
whenChanged or modifytimestamp. If one of these values is detected, it is
added automatically to mds.ini.
If your LDAP server uses a different property name, you must modify this param
eter accordingly.
DateTime End Trail The trailing characters of the Date/Time string in the Modify Time Stamp attrib
ute in the LDAP server, which is used when checking whether the LDAP server
was modified since the last check. For example, 201611131200.Z is the Date/
Time string for 2016-11-13:12:00, and the trailing characters are .Z.
If you manually set values for Create Time Stamp Identifier and Modify Time
Stamp Identifier properties, you should also manually set the DateTime End Trail
property as MDM will not attempt automatically to find the value for the prop
erty.
In order to enable LDAP data cache operations, the following entries in mds.ini are required and should be
configured with relevant data:
Users Base DN
Groups Base DN
Once the LDAP data cache is enabled in MDS, MDM retrieves requested information from the cache and does
not request information from the LDAP server except for login information and required updates to the cache.
Loading MDS
Any changes in MDM roles (add, remove, or modify)
After mounting a repository
In the following cases, MDM checks whether any changes were made to the LDAP data before updating the
LDAP cache:
After checking the LDAP server for changes at the interval specified in mds.ini
On loading the repository
After a repository update
After a login by a user that exists in the LDAP server but not in the LDAP cache
The LDAP cache manager rejects new requests for LDAP cache data and it redirects them to the LDAP
server.
After MDS finishes the last request, the LDAP cache update operation starts.
Once the update operation starts, all requests for internal cache data are rerouted to the LDAP server
directly.
When the cache update operation finishes, MDM continues to serve user and role requests from the
cache.
Note
You can manually refresh the LDAP cache with updated LDAP server data using the CLIX command
repRefreshLDAPCacheData. For more information, see the section, Repository Control Commands, in the
CLIX Command Reference.
MDM uses different methods to search in LDAP depending on the LDAP parameter settings in the LDAP
section of the mds.ini file:
Group member search: Used when both Group Identifier and Member Attribute parameters are
set.
Group filter search: Used when Group Identifier is set but Member Attribute is empty.
Attribute search: Used when Group Identifier is empty.
The group member search algorithm retrieves information for all users assigned to the specified group, as
follows:
In the actual implementation, the user information is not retrieved for every user individually, since
performance would be affected by the large number of individual LDAP calls. Instead, the user information is
requested in chunks to lower the number of LDAP calls.
The group member search algorithm works for LDAP servers with the following mds.ini file settings:
User Identifier=samAccountName
Group Identifier=samAccountName
MDM Roles Attribute=memberOf
Member Attribute=member
The algorithm also works for IBM Tivoli with the following mds.ini file settings:
User Identifier=Uid
Group Identifier=cn
MDM Roles Attribute=ibm-allGroups
Member Attribute=ibm-allMembers
You can also use this search algorithm with other LDAP directory brands, such as, OpenLDAP, Sun One,
iPlanet, and so on.
Note
A role name can occur multiple times in your LDAP tree. However, for a case sensitive DBMS, such as
Oracle, be sure to enter role names with the same case as stored in the MDM repository. Roles can be
viewed from within MDM Console.
Starting from MDM 7.1 SP02, you can use the group filter search algorithm (also known as GroupMapping2)
for LDAP servers. The group filter search uses an improved search filter to minimize the size of the result set
by retrieving only users with a roles attribute value that matches the group Distinguished Name.
The Group Filter search algorithm makes use of the LDAP Group Identifier attribute to identify a group.
For many LDAP server installations this attribute is samAccountName, and you can use this algorithm with the
following mds.ini file settings:
User Identifier=samAccountName
Group Identifier=samAccountName
MDM Roles Attribute=memberOf
The search results might be improved by using an additional filter attribute as described in the following
section.
The attribute search algorithm can be used when no groups are defined in the LDAP directory or the defined
groups cannot be used for some reason.
The attribute search algorithm works in a similar way to the group filter search, but the search filter uses only
the MDM role name, as the group DN cannot be used because of the lack of groups.
The MDM roles attribute can be any LDAP attribute that is used for MDM user role assignments. You can
create the LDAP attribute, or you can use an existing LDAP attribute that is dedicated to MDM user role
assignment.
The MDM roles attribute must be multi-valued to allow more than one MDM role to be assigned to a user.
For each MDM user, the MDM role assignments must be maintained in the LDAP directory.
The member attribute setting is not used.
The group identifier must explicitly be empty, as this distinguishes the attribute search from group
mapping. (If you remove the parameter from mds.ini the system will use the default for a missing group
identifier parameter, which is the value set for the user identifier parameter.)
The attribute search algorithm can be used with the following mds.ini file settings:
User Identifier=cn
MDM Roles Attribute=employeeType
Group Identifier=
Member Attribute=
Without traversing the tree, the attribute search is much faster and can be used to provide user information to
the workflow.
With very large directories, when the search might still be slow, you can try to narrow the search results by an
improved search filter. For example, if the user entries in LDAP have a special object type, such as person, you
can use the option to specify an additional user search filter condition in the mds.ini file:
User Filter=objectClass=person
Errors that occur due to LDAP failures are returned to the client application. Therefore, you are likely to receive
reports from clients when there are problems with your LDAP service.
Note
You should always test changes to LDAP with the MDM client software that you use.
Some of the more common error messages are listed in the following table.
Ambiguous User More than one user exists with this login name.
Admin Authorization Failed One or more of the following settings in the mds.ini file are invalid:
Invalid User User does not exist in LDAP or invalid User Identifier setting in the
mds.ini file.
Unable to Initialize LDAP Host Server or port specified in the mds.ini file could not be reached.
Mds.ini Problem A required parameter is missing from the [MDM LDAP] section of the mds.ini
file. Check the Master Data Server log for the missing parameter name.
User Has No Roles None of the roles retrieved from LDAP are valid for this repository or invalid MDM
Roles Attribute setting in the mds.ini file.
Your network infrastructure is extremely important for protecting your system. Your network needs to support
the communication necessary for your business without allowing unauthorized access. A well-defined network
topology can eliminate many security threats caused by software errors (at both operating system and
application level) or network attacks such as eavesdropping. If users cannot log onto your application or
database servers at operating system or database layer, then there is no way for intruders to compromise the
machines and gain access to the database or files of the backend system. Additionally, if users are not able to
connect to the server LAN (local area network), they cannot exploit well-known bugs and security holes in
network services on the server machines.
The network topology for SAP NetWeaver MDM 7.1 is based on the topology used by the SAP NetWeaver
platform. Therefore, the security guidelines and recommendations described in the SAP NetWeaver Security
Guide also apply to the business scenario. Details that specifically apply to the business scenario are described
in the following topics:
Caution
Carelessly handled users and authorizations for connection destinations can cause severe security issues.
Transport layer security for communication among MDM servers and clients is available using the Internet
standard protocol Secure Sockets Layer (SSL). This optional encrypted channel runs alongside the existing
MDM client-server TCP communication layer.
Setting up secure communications within an MDM landscape involves the following steps:
1. Installing or upgrading MDM servers and clients to MDM 7.1 SP07 or later.
2. Configuring MDM servers for SSL.
3. Copying SSL library and client key files to client locations.
4. Creating secure connections from rich client UIs.
5. Creating secure connections via APIs.
Note
MDM supports SSL for communication between MDM components only. Communications established
between third party applications and MDM components, including, but not limited to the DBMS, are not
affected by MDM security settings; however, the third party applications may provide their own form of
communication security.
For more information about which MDM components support SSL-based communication, see the MDM
Master Guide on the SAP Help Portal at help.sap.com/nwmdm71.
All MDM servers and clients must be version 7.1 SP07 or higher. In addition, the following server-side and
client-side components are required in order to establish secure connections on MDM systems.
Note
Key files and ticket files are created automatically during the installation/upgrade process, but the SSL
Library file must be downloaded separately. For information about downloading the SSL Library file, see
SAP Note 397175 .
The ticket file must be located in the same directory as the SSL Library file.
Rich UI clients such as MDM Console, MDM Data Manager, MDM Syndicator, and MDM Import Manager
require the 32-bit version of the SSL Library file.
Note
If you are upgrading from a version of MDM prior to MDM 7.1 SP07, the parameters described in this section
must be added manually to your server configuration files. They are added automatically only for new
installations of MDM 7.1 SP07 and later.
For information about configuring MDM server parameters, see the MDM Console Reference Guide on the SAP
Help Portal at help.sap.com/nwmdm71.
MDS Configuration
The following Master Data Server (MDS) settings are stored under the [MDM Server] section of the mds.ini
file.
Table 9:
Parameter Description
Listening Mode Specifies if the Master Data Server accepts unencrypted, encrypted, or both types of con
nections. Options are Unencrypted , SSL , or Both.
Note
If the Listening Mode parameter is set to Unencrypted , attempts by clients to estab
lish secure connections to the Master Data Server will fail.
SSL Lib Path The path to the servers SSL Library file.
The following Master Data Server (MDS) settings are stored under the [MDM Server] section of the mds.ini
file.
The following auxiliary server (MDIS, MDSS, MDLS) settings are stored in the mdis.ini, mdss.ini, and
mdls.ini files under the header:
where <MDSHOST> is the name of the machine on which the MDS is installed and <portNumber> is the
listening port for the specified MDS (for example, myhost:50051 ).
Table 10:
Parameter Description
Service Control Security Enabled Options are True or False. Must always be False on UNIX landscape.
SSL Enabled Specifies if the server connects to MDS on an unencrypted or SSL port. Options
are True or False. For the server to establish a secure connection to MDS, this
parameter must be set to True.
SSL Lib Path The path to the auxiliary servers SSL Library file.
SSL Key Path The path to the auxiliary servers SAPSSLS.PSE file.
Note
The header and parameters described in this section must also be added to the mds.ini file of any remote
MDS on which a slave repository is mounted.
Icons in the Console Hierarchy tree display locks to indicate a secure connection to a SSL-enabled server was
established when the server was mounted on the Console.
Secure connections to SSL-enabled MDM servers must be configured from within an MDM Console. For more
information, see the MDM Console Reference Guide on the SAP Help Portal at help.sap.com/nwmdm71.
When connecting MDM Data Manager, MDM Import Manager, MDM Syndicator, or MDM Publisher to a
repository on an SSL-enabled Master Data Server, a lock icon appears in the clients Connect To MDM
Repository dialog box.
Secure connections to repositories on SSL-enabled MDM servers must be configured from within each client.
For information, see Setting Up Secure Repository Connections in the client reference guide.
Before you can connect CLIX to an SSL-enabled Master Data Server, you must add the paths to the client-side
SSL library and key files to the clix.ini file. Adding the Y[+] option flag to a CLIX command then encrypts
communication with the MDS.
For more information, see the MDM CLIX Command Reference on the SAP Help Portal at help.sap.com/
nwmdm71.
For information about establishing SSL secure connections from applications that use MDM Java or .NET
APIs, see the following sections in the MDM Java and .NET API Guide on the SAP Help Portal at help.sap.com/
nwmdm71:
For information about establishing SSL secure connections from ABAP API applications, see the MDM ABAP
API Guide on the SAP Help Portal at help.sap.com/nwmdm71.
For information about establishing SSL secure connections from Web UIs, see the following guides on the SAP
Help Portal at help.sap.com/nwmdm71:
MDM Portal Content Development Guide: Connecting with the MDM Repository
MDM Web Dynpro Components Guide: Installing the MDM Web Dynpro Environment
For information about establishing SSL secure connections from Web UIs, see the following sections in the
MDM Web Services Guide on the SAP Help Portal at help.sap.com/nwmdm71:
MDM Web Services Generator (Design Time): Generating a New Web Service
Generated Web Services (Runtime): Creating MDM Destinations for Web Service Operation Calls
Generated Web Services (Runtime): Installing MDM Web Services Runtime Environment: MDM Web
Services Security
Generated Web Services (Runtime): Data Types: Common Data Types: Generic Data Types:
RepositoryInformation Data Type
Generated Web Services (Runtime): Web Services and Operations: Generic Functionality for Web Service
Operations: Connecting the MDM Repository at Runtime
For information about establishing SSL secure connections from the MDM PI Adaptor, see the section, Setting
Up Messaging: MDM Adapter Specific Configuration,.in the MDM PI Adapter Guide SAP on the SAP Help Portal
at help.sap.com/nwmdm71.
For information about establishing SSL secure connections from the MDM Enrichment Controller, see the
section, Editing the Configuration File of the Enrichment Controller,.in the MDM Enrichment Architecture Guide
SAP on the SAP Help Portal at help.sap.com/nwmdm71.
It is possible to install MDM servers and the DBMS on the same or on different physical server machines. The
MDM server landscape should be placed within a secured area, even in a closed corporate network.
You should ensure that the DBMS cannot be accessed by end users (except for the database administrator)
using any kind of management tools, as certain scenarios require that the database user and password for end
users are available.
Client/MDS Communication
In general, the Master Data Server (MDS) communicates with the following applications or APIs using TCP/IP:
MDM Console
MDM Data Manager
MDM Image Manager
MDM Syndicator
MDM Publisher
MDM Import Manager
Master Data Import Server
Master Data Layout Server
Master Data Syndication Server
A native protocol is used for communication between the different servers and between the servers and
clients.
The Master Data Server also contains an RFC server. It is used to communicate with the MDM ABAP (for more
information, see Remote Function Call [page 34]).
As of MDM 7.1 SP08, MDM uses the following default listening ports:
Table 11:
Application Unencrypted Port SSL Port
You can configure different listening ports from the installer when you install/upgrade MDM. For more
information, see the MDM Installation Guide or MDM Upgrade Guide on the SAP Help Portal at help.sap.com/
nwmdm71.
The Master Data Server (MDS) contains a Remote Function Call (RFC) server. This RFC server is used to
connect through MDM ABAP API, which is an add-on for the SAP NetWeaver Java Application Server (Java
AS).
The RFC functions delivered within MDS can only be called from a trusted Java AS.
When MDS is installed on a Windows platform, you can configure a secure connection from MDS to the
Microsoft Active Directory LDAP server by setting the Secure Connection to Active Directory
parameter to true. This setting is stored under the [LDAP] section of the mds.ini file. For more information,
see MDM LDAP Parameters [page 19].
SAP NetWeaver MDM 7.1 offers a Trusted Connection mechanism for authentication of client connections to
MDS. When enabled, there are two modes of client authentication: IP and SSL.
When IP-based authentication is enabled, all requests for trusted connections coming from trusted IP
addresses will be accepted. This form of authentication is vulnerable to IP spoofing attacks. SSL-based
authentication for trusted connections removes this vulnerability.
When SSL-based authentication is enabled, all requests for trusted connections coming from trusted
distinguished names (DNs) will be accepted.
The following Master Data Server (MDS) settings are stored under the [MDM Server] section of the mds.ini
file.
Table 12:
Parameter Description
Trusted Connection Authentication Mode Specifies the type of authentication required for trusted connections to the
Master Data Server (MDS). Options are None, IP, SSL, or Both.
Note
SSL-based authentication of trusted connections also requires the Master Data Servers Listening Mode
parameter to be set to SSL or Both.
IP-based trusted connections enable users from safe machines to access Master Data Servers and
repositories using their sign-on credentials only (without having to additionally provide Master Data Server and
repository passwords).
Note
IP-based trusted connections are currently available to SAP system usernames only. Users must still
provide a DBMS password for operations which require a connection to the DBMS.
Trusted systems are identified by IP address in a special file (allow.ip). In this file, you can enter IP
addresses for individual machines or for an entire subnet. Requests from IP addresses not included in this file
are automatically denied. An optional file, deny.ip, lets you restrict specific IP addresses within an otherwise
allowed subnet.
Note
You must create the allow.ip and deny.ip files; they are not created automatically by MDM.
By default, the Master Data Server looks for the allow.ip and deny.ip files in the folder containing the
Master Data Server executable file (mds.exe). You can change this location by modifying the TrustFilesDir
parameter in the Master Data Server configuration file (mds.ini).
For users to connect to an MDM repository from a trusted connection, their usernames must exist on the
MDM repositorys Users table.
Alternatively, if the Master Data Server is configured for LDAP use, the username must exist in the LDAP
directory referenced in the Master Data Server configuration file.
If no matching username is found on the Users table or LDAP directory, access to the MDM repository is
denied.
Once connected, users are permitted access to MDM repository data and functions based on the MDM role(s)
assigned to their MDM or LDAP usernames.
Each Master Data Server must maintain its own trusted connections. The files and parameters required for
trusted connections are described in the following table.
allow.ip A flat, text-only file containing the IP addresses of trusted systems. Connection requests from
systems not included in this list are automatically denied.
Wildcards can be used to signify an entire subnet. For example, 10.17.79.* or 10.17.* or
10.*
deny.ip A flat, text -only file containing the IP addresses of excepted machines in an allowed subnet. Con
nection requests from IP addresses in this file are denied.
Wildcards can be used to signify an entire subnet. For example, 10.17.79.* or 10.17.* or
10.*
File is optional.
mds.ini The parameter TrustFilesDir identifies the location of the allow.ip and deny.ip files.
This is set by default to the folder where the Master Data Server executable file (mds.exe) is
located.
The Master Data Server must be restarted after modifying the allow.ip or deny.ip file.
For SSL-based authentication of trusted connections, the list of trusted distinguished names must be
maintained in an allow.dn file, where each trusted distinguished name must appear on its own line in the file,
in the format:
The batch scripts described in the following sections create an allow.dn file formatted for use with MDM. If
an allow.dn file already exists, the scripts will append distinguished names to the file provided.
The following files, which are created in the exe folder of the global host after the installation or update of
MDM is complete, are required for configuring SSL-based trusted connections:
Table 14:
File Description Comments
SAPSSLS.pse Server key of the SSL communication. The MDM Copied also to the sec folder of the
servers will need this file. MDM servers.
ticket For internal use. Copied also to the sec folder of the
MDM servers.
For information about creating the client and server keys manually, see SAP Note 1562668 .
Context
You can create PK12 certificates and import them to MDM Key Storage using the MDM Destination
Administration tool.
Procedure
Context
Procedure
Context
You can import PK12 certificates that were generated by a certificate authority (CA).
Procedure
Context
You can import x509 certificates that were generated by a certificate authority (CA).
Procedure
The ABAP API always passes the logged on AS ABAP user (sy-uname) to the Master Data Server. The AS
ABAP user must also be available in the repository (this is not valid for an LDAP scenario) to be able to log onto
A specific system in the landscape can be trusted. If one of the APIs is running on the trusted system, it can
access the Master Data Server or repository just by submitting an existing user name.
Note
There is no control mechanism like in ABAP for the transmitted user name. You can pass an arbitrary user
name to the Master Data Server.
The application on top of the API has to ensure that unauthorized access to the Master Data Server through
user name is prevented.
The "4-eyes-principle"/"dual control" is often used to protect critical transactions. This means that access (or
completing an action) is only allowed if at least one additional person has given his or her approval through a
suitable approval process. This is also applicable for administrative tasks.
The Master Data Server does not support the separation of duties.
Proposed solution:
Separation can be implemented for applications on top of the available APIs (.NET, Java, ABAP).
Auditors need a trace that shows who had which authorization when. The audit log records the creation,
change and deletion of users and roles as well as the assignment of roles to users.
Note
When a role is created, the corresponding authorizations are not added to the log. Roles are always created
with full privileges. When a role is updated, the changes are recorded in the log.
Example
Example of a function log entry:
<function>16777216</function><access>1</access>
</functionRight></role></repositoryAdmin>
In this case the role with ID 2 has been modified. The authorization with ID 16777216 (see function ID map
below) has been set to 1 (Execute).
</objectRight></role></repositoryAdmin>
In this case the role with ID 5 has been modified. The table access with ID 1 has been set to 2 (Read-only).
Function log:
1 = Execute
0 = None
2 = Read-only
3 = Read/write
Table 15:
Function ID in log Corresponging hex value Function name
Table 16:
Function ID in log Corresponging hex value Function name
Table 17:
Function ID in log Corresponging hex value Function name
Table 18:
Function ID in log Corresponging hex value Function name
Table 19:
Function ID in log Corresponging hex value Function name
Table 20:
Function ID in log Corresponging hex value Function name
Table 21:
Function ID in log Corresponging hex value Function name
Table 22:
Function ID in log Corresponging hex value Function name
Table 23:
Function ID in log Corresponging hex value Function name
Table 24:
Function ID in log Corresponging hex value Function name
Table 25:
Function ID in log Corresponging hex value Function name
Table 26:
Function ID in log Corresponging hex value Function name
Table 27:
Function ID in log Corresponging hex value Function name
Changes to authorizations are logged in the MDS_Audit log file. If a log file exceeds a size of 2 MB, a new file is
created. Since logs are not overwritten, you can create a long-term archive.
Note
There is no MDM tool for archiving old log files. Older log files should be archived manually or by using an
archive tool.
The Master Data Server contains a logging functionality for security-relevant information. The logs are stored
as CSV files in the usr\sap\<SAPSID>\<instance_name>\log directory. You can view them from the MDM
Console. There are two types of logs:
If a log file exceeds a size of 2 MB, a new file is created. Since logs are not overwritten, you can create a long-
term archive. Due to the risk of running out of hard disk space, you should archive old log files or (if there is no
need for a long-term archive) delete them from time to time.
Server:
Repository:
Repository Metadata:
The Master Data Server can store documents (PDF) and files (images, sounds, videos, and binary objects) in
the database. It does not contain an integrated virus scanner. Documents and files should be checked with a
separate virus scanner before they are released for uploading.
Under Linux/Solaris, you can set the base directory to a different directory.
Config:
Contains the configuration ini file
Access recommendation: Do not share
Data:
Contains cached information
Access recommendation: Do not share
Exe:
Contains the application
Access recommendation: Do not share
Log:
Contains MDM log files.
Access recommendation: Can be made available to MDM administrators
MDM
Accelerator
Contains accelerator files for repositories
Access recommendation: Do not share
Archives
Contains created repository archives
Access recommendation: Can be made available to MDM administrators
Distributions
Contains port configuration files and is used as file shelf for file import/export using ports
Access recommendation: Should only be shared if an import scenario that accesses the file
system directly is implemented
Reports
Contains repository operation (archive, duplicate, load, unarchive, update, verify check, verify
repair) reports
Access recommendation: Can be made available to MDM administrators
Sec
Not used.
Work
This is the work directory of all processes (SAPStartSrv, MDS , MDIS, MDSS, MDLS) started by the
instance. The folder is used to store a trace. Log files and long-term archiving files should never be
stored in this directory. This directory can be made available to MDM administrators, and can be
accessed using the SAPControl WebService or the SAPmmc Console.
The Master Data Server uses session IDs to authenticate client users. There are different sessions for different
purposes:
The session ID does not change when the authentication status changes. If a session ID is detected before it is
authenticated, it might be misused at a later point of time after authentication of the user.
The randomly-defined part of the session ID is 64 bits long. It is not impossible to guess a valid session ID (128
bit length would be necessary for that).
Proposed solution:
A long inactivity (for example, 30 minutes) implies that the user has left his or her work place. If an application
is not locked, unauthorized persons can access the application from the unattended computer.
The MDM user session is not locked after an inactive period of time and re-authentication of the user is not
necessary.
All client applications run under Microsoft Windows. The operating system should be configured so that it
locks automatically after a certain period of inactivity. This prevents unauthorized users from accessing the
application and the corresponding user session.
Person-related data is an important topic within a master data environment. One of the tasks of the application
is to handle the regulations regarding person-related data. In this context, the Master Data Management
Server is only used as data storage in certain cases.
Depending on the use case and the application on top of the Master Data Management Server in the
environment, the application must comply with the following rules:
Master data applications must provide the capability to avoid unnecessary storage of person-related data.
Master data applications must provide the capability to notify a person if data related to this person is
stored for the first time.
Master data applications must support deletion of personal data.
It must be possible to store the agreement of the affected person to the storage of his/her personal data.
Processing of person-related data must be limited to the primary reason for storing the data.
Person-related data stored for different reasons must be stored separately.
The transfer of person-related data to other systems must be logged.
The points above should be kept in mind when you create applications on top of the SAP Master Data Server
(for example, using one of the available APIs).
SAP enables you to comply with national legal data protection and privacy requirements. SAP software
supports data protection and privacy by providing security features and functions for blocking and deleting
personal data. This includes the destruction of stored personal data after the retention period, and the
blocking of stored personal data after the residence (end of purpose) period by restricting access to the data.
Personal data is defined as: The specifics about personal or material circumstances of an identified or
identifiable natural person (data subject).
Data privacy is defined as: A set of legal requirements which forces companies to treat personal data with
special care. The core requirements are to use personal data only for particular business purposes, and to
erase personal data as soon as it is no longer required for the particular purpose.
Blocking is defined as: A method of restricting access to data for which the primary business purpose has
ended.
Deleting data is defined as: The deletion of personal data so that the data is no longer usable.
SAP NetWeaver MDM 7.1 complies with the security requirement SEC-256:
SAP software shall support deletion of personal data (including personally identifiable information).
Syndicator Guide
Import Manager Reference Guide
Console Reference Guide
CLIX Commands Guide
Data Manager Reference Guide
DB Views Guide
ABAP API Guide
Java and .NET API Guide
Context
You can view Win32 client digital signatures during MDM 7.1 installation.
Note
The signature is located in the Installation file (wise package) and the .exe file.
Procedure
1. On the User Account Control window, choose Yes when prompted to allow this app to make changes to
your PC?
2. Choose ok when the Console.exe Properties window displays the following Signature List in the Digital
Signatures tab:
a. Name of signer: SAP SE.
b. Digest algorithm: sha1.
c. Timestamp: current date.
Coding Samples
Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system
environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and
completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, unless damages were caused by SAP
intentionally or by SAP's gross negligence.
Accessibility
The information contained in the SAP documentation represents SAP's current view of accessibility criteria as of the date of publication; it is in no way intended to be
a binding guideline on how to ensure accessibility of software products. SAP in particular disclaims any liability in relation to this document. This disclaimer, however,
does not apply in cases of willful misconduct or gross negligence of SAP. Furthermore, this document does not result in any direct or indirect contractual obligations
of SAP.
Gender-Neutral Language
As far as possible, SAP documentation is gender neutral. Depending on the context, the reader is addressed directly with "you", or a gender-neutral noun (such as
"sales person" or "working days") is used. If when referring to members of both sexes, however, the third-person singular cannot be avoided or a gender-neutral noun
does not exist, SAP reserves the right to use the masculine form of the noun and pronoun. This is to ensure that the documentation remains comprehensible.
Internet Hyperlinks
The SAP documentation may contain hyperlinks to the Internet. These hyperlinks are intended to serve as a hint about where to find related information. SAP does
not warrant the availability and correctness of this related information or the ability of this information to serve a particular purpose. SAP shall not be liable for any
damages caused by the use of related information unless damages have been caused by SAP's gross negligence or willful misconduct. All links are categorized for
transparency (see: http://help.sap.com/disclaimer).