Chapter 16. Configuring user-cert-map.xml

This chapter explains user-cert-map.xmlwhich defines the information of the certificates contained in the keystore that will be mapped to the user.

XML schema file: JEUS_HOME/lib/schemas/jeus/user-cert-map.xsd

16.1. Introduction

XML references are configured in the following format.

XML Schema/XML Tree: Summarizes all the tags of XML configuration file. Each node is defined in the following format.
1. Tag reference enables quick search for tags. Each tag is attached with index numbers ( ex: (11) ). Tags are explained with this number in tag reference.
2. The XML tag name defined in the XML schema is expressed in the format of <tag name>.
3. Tags are set with cardinality defined in XML schema.
  
  “?” is for 0 or 1 element, “+” is for 1 or more elements, “*” is for 0 or more elements, (no symbol) is for exactly one element
4. Several tags have "P" character, meaning that they are the tags related to performance. These tags are used to tune the setting.
Element Reference: Explains XML tags in the tree.
1. Dynamic: Allowed to change the configuration dynamically.
2. Non-Dynamic: Not allowed to change the configuration dynamically. This is expressed only for the special case to comment out.
3. Description: A short description for tags.
4. Value Description: The value and type.
5. Value Type: Data type of the value. (ex: String)
6. Value Type Description: Description for the data type of the value.
7. Default Value: The value to be used by default when the XML is not used.
8. Defined Value: The default value.
9. Example: The XML tag example.
10. Performance Recommendation: The value recommended to improve performance.
11. Child Elements:The tags contained in its own tag element.

16.3. Element Reference

(1) `<user-cert-map>`
Description	Information about the mapping of users to certificates in the keystore.
Value Type	UserCertMapType
Child Elements	(3) `user-cert`

(2) `< user-cert-map > <user-cert>`
Description	Maps users to certificates.
Value Type	UserCertType
Child Elements	(4) `username` (5) `alias` (6) `keypassword` (7) `secretkey`

(3) `< user-cert-map >< user-cert > <username>`
Description	User name of the certificate within the keystore. This is the primary identification and must be unique.
Value Type	token

(4) `< user-cert-map >< user-cert > <alias>`
Description	Alias of the certificate within the keystore.
Value Type	token

(5) `< user-cert-map >< user-cert > <keypassword>`
Description	Key password to retrieve the private key of the certificate within the keystore. To save it in an encrypted form, use the format {algorithm}ciphertext. For example, {DES}FQrLbQ/D8O1lDVS71L28rw==
Value Type	token

(6) `< user-cert-map >< user-cert > <secretkey>`
Description	Private key.
Value Type	SecretKeyType
Child Elements	(8) `keyname` (9) `keyalgorithm` (10) `keyvalue`

(7) `< user-cert-map >< user-cert >< secretkey > <keyname>`
Description	Private key name.
Value Type	token

(8) `< user-cert-map >< user-cert >< secretkey > <keyalgorithm>`
Description	Private key algorithm.
Value Type	token

(9) `< user-cert-map >< user-cert >< secretkey > <keyvalue>`
Description	Private key value in Base64 format.
Value Type	token

16.4. Example File

[Example 16.1] Example File

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<user-cert-map xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
  <user-cert>
    <username>choco</username>
    <alias>chococa</alias>
    <keypassword>changeit</keypassword>
    <secretkey>
      <keyname>testkeypass</keyname>
      <keyalgorithm>AES</keyalgorithm>
      <keyvalue>bjhTUjJvSXRTOGlkVEdlNHJnM2N3VnljSDZXV0JkYz0=</keyvalue>
    </secretkey>
  </user-cert>
</user-cert-map>

Prev		Next
Chapter 15. Configuring Security in the policies.xml	Home	Chapter 17. Configuring cert-user-map.xml

Chapter 16. Configuring user-cert-map.xml

16.1. Introduction

16.2. XML Schema/XML Tree

16.3. Element Reference

16.4. Example File