Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun[TM] Identity Manager 8.0 Administration 

Chapter 12
Security

This chapter provides information about Identity Manager security features, and details steps you can take to further reduce security risks.

Review the following topics to learn more about managing system security with Identity Manager.


Security Features

Identity Manager helps reduce security risks by providing the following features:

In addition, system architecture seeks to reduce security risks wherever possible. For example, once logged out, you cannot access previously visited pages through your browser’s Back feature.


Limiting Concurrent Login Sessions

By default, an Identity Manager user can have concurrent login sessions. You can limit concurrent sessions, however, to one per login application by opening the system configuration object for modification ((more...) ) and editing the value of the security.authn.singleLoginSessionPerApp configuration attribute. This attribute is an object that contains one attribute for each login application name (for example, the Administrator Interface, User Interface, or Identity Manager IDE). Changing the value of this attribute to true enforces a single login session for each user.

If enforced, then a user can log in to more than one session; however, only the last logged-in session remains active and valid. If the user performs an action on an invalid session, then he is automatically forced off the session and the session terminates.


Password Management

Identity Manager offers password management at multiple levels:


Pass-through Authentication

Use pass-through authentication to grant user and administrator access through one or more different passwords. Identity Manager manages authentication through the implementation of:

About Login Applications

Login applications define a collection of login module groups, which further define the set and order of login modules that will be used when a user logs in to Identity Manager. Each login application comprises one or more login module groups.

At login, the login application checks its set of login module groups. If only one login module group is set, then it is used, and its contained login modules are processed in the group-defined order. If the login application has more than one defined login module group, then Identity Manager checks the login constraint rules applied to each login module group to determine which group to process.

Login Constraint Rules

Login constraint rules are applied to login module groups. For each set of login module groups in a login application, only one cannot have a login constraint rule applied to it.

When determining which login module group of a set to process, Identity Manager evaluates the first login module group's constraint rule. If it succeeds, then it processes that login module group. If it fails, then it evaluates each login module group in turn, until a constraint rule succeeds or a login module group with no constraint rule is evaluated (and subsequently used).


Note

If a login application will contain more than one login module group, then the login module group with no login constraint rules should be placed in the last position of the set.


Example Login Constraint Rule

In the following example of a location-based login constraint rule, the rule gets the IP address of the requester from the HTTP header, and then checks to see if it is located on the 192.168 network. If 192.168. is found in the IP address, then the rule will return a value of true, and this login module group is selected.

Code Example 12-1  Location-Based Login Constraint Rule

<Rule authType='LoginConstraintRule' name='Sample On Local Network'>

  <match>

    <ref>remoteAddr</ref>

    <s>192.168.</s>

  </match>

  <MemberObjectGroups>

    <ObjectRef type='ObjectGroup' name='All'/>

  </MemberObjectGroups>

</Rule>

Editing Login Applications

From the menu bar, select Security, and then select Login to access the Login page.

The login application list shows:

From the Login page you can:

To edit a login application, select it from the list.

Setting Identity Manager Session Limits

From the Modify Login Application page, you can set a timeout value (limits) for each Identity Manager login session. Select hours, minutes, and seconds, and then click Save. The limits you establish display in the login application list.

You can set session timeouts for each Identity Manager login application. When a user logs in to an Identity Manager application, then the currently configured session timeout value is used to compute the future date and time when the user’s session will time out due to inactivity. This computed date is then stored with the user’s Identity Manager session so that it is available to be checked each time a request is made.

If a login administrator changes a login application session timeout value, then that value will be in effect for all future logins. Existing sessions will time out based on the value in effect when the user logged in.

Values set for HTTP timeout affect all Identity Manager applications and take precedence over the login application session timeout value.

Disabling Access to Applications

From the Create Login Application and Modify Login Application pages, you can select the Disable option to disable a login application, thereby preventing users from logging in. If a user tries to log in to a disabled application, the user is redirected to an alternate page that states that the application is currently disabled. You can edit the message that displays on this page by editing the custom catalog.

Login applications remain disabled until you de-select the option. As a safeguard, you cannot disable administrator login.

Editing Login Module Groups

The login module group list shows:

From the Login Module Groups page you can create, edit, and delete login module groups. Select a login module group from the list to edit it.

Editing Login Modules

Enter details or make selections for login modules as follows. (Not all options are available for each login module.)

Click Save to save a login module. Once it is saved, you can position the module relative to all other modules in the login module group.


Caution

If Identity Manager login is configured to authenticate to more than one system, an account's user ID and password should be the same across all systems that are targets of Identity Manager authentication.

If the user ID and password combinations differ, login will fail on each system whose user ID and password do not match the user ID and password entered on the Identity Manager User Login form.

Some of these systems may have a lockout policy enforcing the number of failed login attempts before an account is locked. For these systems, user accounts will eventually be locked, even though the user's login via Identity Manager continues to succeed.


Login Module Processing Logic

Code Example 12-2 contains pseudocode that describes the steps Identity Manager takes to map authenticated user IDs to Identity Manager users.

Code Example 12-2  Pseudocode describing login module processing logic

if an existing IDM user's ID is the same as the specified user ID

   if that IDM user has a linked resource whose resource name matches the
   resource that was authenticated and whose accountId matches the resource
   accountId returned by successful authentication (e.g. dn), then we have
   found the right IDM user

   otherwise if there is a LoginCorrelationRule associated with the
   configured login module

      evaluate it to see if it maps the login credentials to a single IDM
      user

      otherwise login fails

   otherwise login fails

if the specified userID does not match an existing IDM user's ID

   try to find an IDM user that has a linked resource whose resource name
   matches the resource accountID returned by successful authentication

      if found, then we have found the right IDM user

      otherwise if there is a LoginCorrelationRule associated with the
      configured login module

         evaluate it to see if it maps the login credentials to a single
         IDM user

         otherwise login fails

      otherwise login fails

In Code Example 12-2 the system will try to find a matching Identity Manager user using the user's linked resources (resource information). If the resource information approach fails, however, and a loginCorrelationRule is configured, the system will try to find a matching user using the loginCorrelationRule.


Configuring Authentication for Common Resources

If you have multiple resources that are logically the same (for example, multiple Active Directory domain servers that share a trust relationship), or if you have multiple resources that all reside on the same physical host, then you can specify that these resources are common resources.

You should declare common resources so that Identity Manager knows that it should only try and authenticate to a group of resources one time. Otherwise, if a user types a wrong password, Identity Manager will try the same password against each resource. This can lead to the user’s account being locked out due to multiple login failures, even though the user only typed the wrong password one time.

With common resources, a user can authenticate to one common resource, and Identity Manager will automatically try and map the user to the remaining resources in the common resources group. For example, an Identity Manager user account may be linked to a resource account for resource AD-1. The login module group, however, may define that users must authenticate to resource AD-2.

If AD-1 and AD-2 are defined as common resources (in this case, in the same trusted domain), then if the user successfully authenticates to AD-2, Identity Manager can also map the user to AD-1 by finding the same user accountId on resource AD-1.


Note

All resources listed in a common resources group must also be included in the Login Module definition. If a complete list of common resources does not also appear in the Login Module definition, then the common resources functionality will not work correctly.


Common resources can be defined in the System Configuration object ((more...) ) using the following format:

Code Example 12-3  Configuring Authentication for Common Resources

<Attribute name=’common resources’>

    <Attribute name=’Common Resource Group Name’>

        <List>

            <String>Common Resource Name</String>

            <String>Common Resource Name</String>

        </List

    </Attribute>

</Attribute>


Configuring X509 Certificate Authentication

Use the following information and procedures to configure X509 Certificate Authentication for Identity Manager.

Prerequisites

To support X509 certificate-based authentication in Identity Manager, ensure that two-way (client and server) SSL authentication is configured properly. From the client perspective, this means that an X509-compliant user certificate should have been imported into the browser (or be available through a smart card reader), and that the trusted certificate used to sign the user certificate should be imported into the Web application server’s keystore of trusted certificates.

Also, the client certificate used must be enabled for client authentication.

To verify that the client certificate’s client authentication option is selected, follow these steps:

  1. Using Internet Explorer, select Tools, and then select Internet Options.
  2. Select the Content tab.
  3. In the Certificates area, click Certificates.
  4. Select the client certificate, and then click Advanced.
  5. In the Certificate Purposes area, verify that the Client Authentication option is selected.

Configuring X509 Certificate Authentication in Identity Manager

To configure Identity Manager for X509 certificate authentication, follow these steps:

  1. Log in to the Administrator Interface as Configurator (or with equivalent permissions).
  2. Select Configure, and then select Login to display the Login page.
  3. Click Manage Login Module Groups to displays the Login Module Groups page.
  4. Select a login module group from the list.
  5. Select Identity Manager X509 Certificate Login Module from the Assign Login Module... list. Identity Manager displays the Modify Login Module page.
  6. Set the login success requirement. Acceptable values are:
    • Required — The login module is required to succeed. Irrespective of whether it succeeds or fails, authentication proceeds to the next login module in the list. If it is the only login module, the administrator is successfully logged in.
    • Requisite — The login module is required to succeed. If it succeeds, authentication proceeds to the next login module in the list. If it fails, authentication does not proceed.
    • Sufficient — The login module is not required to succeed. If it does succeed, authentication does not proceed to the next login module, and the administrator is successfully logged in. If it fails, authentication continues to the next login module in the list.
    • Optional — The login module is not required to succeed. Irrespective of whether it succeeds or fails, authentication continues to the next login module in the list.
  7. Select a login correlation rule. This could be a built-in rule or a custom correlation rule. (See the following section for information about creating custom correlation rules.)
  8. Click Save to return to the Modify Login Module Group page.
  9. Optionally, reorder the login modules (if more than one login module is assigned to the login module group, and then click Save.
  10. Assign the login module group to a login application if it is not yet assigned. From the Login Module Groups page, click Return to Login Applications, and then select a login application. After assigning a login module group to the application, click Save.

  11. Note

    If the allowLoginWithNoPreexistingUser option is set to a value of true in the waveset.properties file, then when configuring the Identity Manager X509 Certificate Login Module, you are prompted to select a New User Name Rule. This rule is used to determine how to name new users created when one is not found by the associated Login Correlation Rule.

    The New User Name Rule has the same available input arguments as the Login Correlation Rule. It returns a single string, which is the user name used to create the new Identity Manager user account.

    A sample new user name rule is included in idm/sample/rules, named NewUserNameRules.xml.


Creating and Importing a Login Correlation Rule

A Login Correlation Rule is used by the Identity Manager X509 Certificate Login Module to determine how to map the certificate data to the appropriate Identity Manager user. Identity Manager includes a built-in correlation rule, named Correlate via X509 Certificate subjectDN.

You can also add your own correlation rules. Refer to LoginCorrelationRules.xml, which is located in the idm/sample/rules directory, as an example. Each correlation rule must follow these guidelines:

Arguments passed to login correlation rules are:

The naming convention for certificate arguments passed to the login correlation rule is:

cert.field name.subfield name

Example argument names that are available to the rule include:

The login correlation rule, using the passed-in arguments, returns a list of one or more AttributeConditions. These are used by the Identity Manager X509 Certificate Login Module to find the associated Identity Manager user.

A sample login correlation rule is included in idm/sample/rules, named LoginCorrelationRules.xml.

After creating a custom correlation rule, you must import it into Identity Manager. From the Administrator Interface, select Configure, and then select Import Exchange File to use the file import facility.

Testing the SSL Connection

To test the SSL connection, go to the configured application interface’s URL via SSL (for example, https://idm007:7002/idm/user/login.jsp). You are notified that you are entering a secure site, and then prompted to specify which personal certificate to send to the Web server.

Diagnosing Problems

Problems authenticating via X509 certificates should be reported as error messages on the login form. For more complete diagnostics, enable trace on the Identity Manager server for these classes and levels:

If the client certificate attribute is named something other than javaxservlet.request.X509Certificate in the HTTP request, then you will receive a message that this attribute cannot be found in the HTTP request.

To correct this:

  1. Enable trace for SessionFactory to see the complete list of HTTP attributes and determine the name of the X509Certificate.
  2. Use the Identity Manager debug facility ((more...) ) to edit the LoginConfig object.
  3. Change the name of the <AuthnProperty> in the <LoginConfigEntry> for the Identity Manager X509 Certificate Login Module to the correct name.
  4. Save, and then retry.

You may also need to remove, and then re-add the Identity Manager X509 Certificate Login Module in the login application.


Cryptographic Use and Management

Cryptography is used to ensure the confidentiality and integrity of server data in memory and in the repository, as well as all data transmitted between the server and gateway.

The following sections provide more information about how cryptography is used and managed in the Identity Manager Server and Gateway, and addresses questions about server and gateway encryption keys.

Cryptographically Protected Data

The following table shows the types of data that are cryptographically protected in the Identity Manager product, including the ciphers used to protect each type of data.

Table 12-1  Cryptographically-Protected Data Types  

Data Type

RSA
MD5

NIST
Triple DES
168-bit key
(DESede/ECB/NoPadding)

PKCS#5
Password-Based Crypto
56-bit key
(PBEwithMD5andDES)

Server encryption keys

 

default

configuration option1

Gateway encryption keys

 

default

configuration option1

Policy dictionary words

yes

 

 

User passwords

 

yes

 

User password history

 

yes

 

User answers

 

yes

 

Resource passwords

 

yes

 

Resource password history

yes

 

 

All payload between server and gateways

 

yes

 

1Configure via the System Configuration object ((more...) ) via the pbeEncrypt attribute or the
Manage Server Encryption task.

Server Encryption Key Questions and Answers

Read the following sections for answers to frequently asked questions about server encryption key source, location, maintenance, and use.

Where do server encryption keys come from?

Server encryption keys are symmetric, triple-DES 168-bit keys. There are two types of keys supported by the server:

Where are server encryption keys maintained?

Server encryption keys are objects maintained in the repository. There can be many data encryption keys in any given repository.

How does the server know which key to use for decryption and re-encryption of encrypted data?

Each piece of encrypted data stored in the repository is prefixed by the ID of the server encryption key that was used to encrypt it. When an object containing encrypted data is read into memory, Identity Manager uses the server encryption key associated with the ID prefix on the encrypted data to decrypt, and then re-encrypt with the same key if the data changed.

How do I update server encryption keys?

Identity Manager provides a task called Manage Server Encryption. This task allows an authorized security administrator to perform several key management tasks, including:

See Managing Server Encryption in this chapter for more information about how to use this task.

What happens to existing encrypted data if the "current" server key is changed?

Nothing. Existing encrypted data will still be decrypted or re-encrypted with the key referenced by the ID prefix on the encrypted data. If a new server encryption key is generated and set to be the "current" key, any new data to be encrypted will use the new server key.

To avoid multikey issues, as well as to maintain a higher level of data integrity, use the Manage Server Encryption task to re-encrypt all existing encrypted data with the "current" server encryption key.

What happens when you import encrypted data for which an encryption key is not available?

If you import an object that contains encrypted data, but that data was encrypted with a key that is not in the repository into which it is being imported, then the data will be imported, but not decrypted.

How are server keys protected?

If the server is not configured to use password-based encryption (PBE) - PKCS#5 encryption (set in the System Configuration object via the pbeEncrypt attribute or the Manage Server Encryption task), then the default key is used to encrypt the server keys. The default key is the same for all Identity Manager installations.

If the server is configured to use PBE encryption, then a PBE key is generated each time the server is started. The PBE key is generated by providing a password, generated from a server-specific secret, to the PBEwithMD5andDES cipher. The PBE key is maintained only in memory and never persisted. In addition, the PBE key is the same for all servers sharing a common repository.

To enable PBE encryption of server keys, the cipher PBEwithMD5andDES must be available. Identity Manager does not package this cipher by default, but it is a PKCS#5 standard that is available in many JCE providers implementations, such as those provided by Sun and IBM.

Can I export the server keys for safe external storage?

Yes. If the server keys are PBE encrypted, then before they are exported, they will be decrypted and re-encrypted with the default key. This allows them to be imported to the same or another server at a later date, independent of the local server PBE key. If the server keys are encrypted with the default key, then no pre-processing is done before they are exported.

When they are imported into a server, if the server is configured for PBE keys, the keys will be decrypted and then re-encrypted with the local server's PBE key, if that server is configured for PBE key encryption.

What data is encrypted between the server and gateway?

All data (payload) transmitted between the server and gateway is triple-DES encrypted with a randomly generated, per server-gateway session symmetric 168 bit key.

Gateway Key Questions and Answers

Read the following sections for answers to frequently asked questions about gateway source, storage, distribution, and protection.

Where do the gateway keys come from to encrypt or decrypt data?

Each time an Identity Manager Server connects to a gateway, the initial handshake will generate a new random 168-bit, triple-DES session key. This key will be used to encrypt or decrypt all subsequent data transmitted between that server and that gateway. There is a unique session key generated for each server/gateway pair.

How are gateway keys distributed to the gateways?

Session keys are randomly generated by the server and then securely exchanged between server and gateway by encrypting them with the shared secret master key as part of the initial server-to-gateway handshake.

At initial handshake time, the server queries the gateway to determine which mode it supports. The gateway can operate in two modes

Can I update the gateway keys used to encrypt or decrypt the server-to-gateway payload?

Identity Manager provides a task called Manage Server Encryption that allows an authorized security administrator to do several key management tasks, including generate a new "current" gateway key and update all gateways with the "current" gateway key. This is the key that is used to encrypt the per-session key used to protect all payload transmitted between server and gateway. The newly generated gateway key will be encrypted with either the default key or PBE key, depending on the value of the pbeEncrypt attribute in the System Configuration ((more...) ).

Where are the gateway keys stored on the server, on the gateway?

On the server, the gateway key is stored in the repository just like server keys. On the gateway, the gateway key is stored in a local registry key.

How are gateway keys protected?

The gateway key is protected the same way server keys are. If the server is configured to use PBE encryption, the gateway key will be encrypted with a PBE generated key. If the option is false, it will be encrypted with the default key. See the previous section titled How are server keys protected? for more information.

Can I export the gateway key for safe external storage?

The gateway key can be exported via the Manage Server Encryption task, just as with server keys. See the previous section titled Can I export the server keys for safe external storage? for more information.

How are server and gateway keys destroyed?

Server and gateway keys are destroyed by deleting them from the server repository. Note that a key should not be deleted as long as any server data is still encrypted with that key or any gateway is still relying on that key. Use the Manage Server Encryption task to re-encrypt all server data with the current server key and to synchronize the current gateway key to all gateways to ensure no old keys are still being used before they are deleted.


Managing Server Encryption

The Identity Manager server encryption feature allows you to create new 3DES server encryption keys, as shown in the following figure, and then encrypt these keys by using 3DES or PKCS#5 encryption. Only users with Security Administrator capabilities can run the Manage Server Encryption task, which is accessed from the Server Tasks tab.

Figure 12-1  Manage Server Encryption Task

Manage server encryption task

Select Run Tasks, and then select Manage Server Encryption from the list to configure this information for the task:


Using Authorization Types to Secure Objects

You typically use permissions specified in an AdminGroup capability to grant access to an Identity Manager objectType such as a Configuration, Rule, or TaskDefinition. However, granting access to all objects of an Identity Manager objectType within one or more controlled organizations is sometimes still too broad.

Using authorization types (AuthType) allows you to further scope or restrict this access to a subset of objects for a given Identity Manager objectType. For example, you might not want to give your users access to all rules within their scope of control when populating rules to select from in a user form.

To define a new authorization type, edit the AuthorizationTypes configuration object in the Identity Manager repository and add a new <AuthType> element. This element requires two properties:

For example, if you want to add a new Rule authorization type, called Marketing Rule, that extends Rule, you would define the following:

<AuthType name='Marketing Rule' extends='Rule'/>

Next, to enable the authorization type to be used, you must reference that authorization type in two places.

Following are examples of both references.

The first example shows an AdminGroup capability definition granting access to Marketing Rules.

Code Example 12-4  

<AdminGroup name='Marketing Admin'>

<Permissions>

<Permission type='Marketing Rule' rights='View,List,Connect,Disconnect/>

</Permissions>

<AdminGroups>

<ObjectRef type='AdminGroup' id='#ID#Account Administrator'/>

</AdminGroups>

</AdminGroup>

The next example shows a Rule definition that enables users to access the object because they have been granted access to Rule or Marketing Rule.

<Rule name='Competitive Analysis Info' authType='Marketing Rule'>

...

</Rule>


Note

Any user granted rights to a parent authorization type, or to a static type that an authorization type extends, will have the same rights on all child authorization types. So, using the preceding example, any user granted rights to Rule will also have the same rights to Marketing Rule. The converse, however, is not true.



Security Practices

As an Identity Manager administrator, you can further reduce security risks to your protected accounts and data by following these recommendations, at setup time and after.

At Setup

You should:

During Use

You should:

If your application server is Servlet 2.2-compliant, the Identity Manager installation process sets the HTTP session timeout to a default value of 30 minutes. You can change this value by editing the property; however, you should set the value lower to increase security. Do not set the value higher than 30 minutes.

To change the session timeout value, follow these steps:

  1. Edit the web.xml file, which is located in the
    idm/WEB-INF directory in your application server directory tree.
  2. Change the number value in the following lines:
  3. <session-config>
    <session-timeout>30</session-timeout>
    </session-config>



Previous      Contents      Index      Next     


Part No: 820-2954-10.   Copyright 2008 Sun Microsystems, Inc. All rights reserved.