Chapter 14. Configuring Security in the accounts.xml

This chapter explains the contents of accounts.xml which defines users and groups used for JEUS security system.

XML schema file: JEUS_HOME/lib/schemas/jeus/accounts.xsd

14.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.

14.2. XML Schema/XML Tree

(1) <accounts>
- (2) <users> ?
  - (3) <user> *
    (4) <name>
    (5) <password> ?
    (6) <group> *
    (7) <description> ?
- (8) <groups> ?
  - (9) <group> *
    (10) <name>
    (11) <subgroup> *
    (12) <description> ?
- (13) <sfmUsers> ?
  - (14) <sfmUser> *
    (15) <sfmUserId>
    (16) <sfmUserName>
    (17) <jeusName>

14.3. Element Reference

(1) `<accounts>`
Description	Account settings. You can define users and groups here.
Value Type	accountsType
Child Elements	(3) `users` (9) `groups` (14) `sfmUsers`

(2) `< accounts > <users>`
Description	Create users.
Value Type	usersType
Child Elements	(4) `user`

(3) `< accounts >< users > <user>`
Description	User properties.
Value Type	userType
Child Elements	(5) `name` (6) `password` (7) `group` (8) `description`

(4) `< accounts >< users >< user > <name>`
Description	Name of the user. The user name is the primary identifier and must be unique.
Value Type	token

(5) `< accounts >< users >< user > <password>`
Description	Password for the user.
Value Type	token

(6) `< accounts >< users >< user > <group>`
Description	Name of the group to which the user belongs. The group must be defined within <groups><group><name></name></group></groups>.
Value Type	token

(7) `< accounts >< users >< user > <description>`
Description	Description of the user.
Value Type	token
Value Description	Description

(8) `< accounts > <groups>`
Description	Create groups.
Value Type	groupsType
Child Elements	(10) `group`

(9) `< accounts >< groups > <group>`
Description	Configuration for the group.
Value Type	groupType
Child Elements	(11) `name` (12) `subgroup` (13) `description`

(10) `< accounts >< groups >< group > <name>`
Description	Name of the group. The group name is the primary identifier and must be unique.
Value Type	token

(11) `< accounts >< groups >< group > <subgroup>`
Description	Define a subgroup. The group must be defined within <groups><group><name></name></group></groups>.
Value Type	token

(12) `< accounts >< groups >< group > <description>`
Description	Description of the group.
Value Type	token
Value Description	Description

(13) `< accounts > <sfmUsers>`
Description	JEUS ID information mapped to the SuperFrame Manager user.
Value Type	SFMUsersType
Child Elements	(15) `sfmUser`

(14) `< accounts >< sfmUsers > <sfmUser>`
Description	JEUS ID information mapped to the SuperFrame Manager user.
Value Type	SFMUserType
Child Elements	(16) `sfmUserId` (17) `sfmUserName` (18) `jeusName`

(15) `< accounts >< sfmUsers >< sfmUser > <sfmUserId>`
Description	ID of the SuperFrame Manager user. It is the primary identifier and must be unique.
Value Type	token

(16) `< accounts >< sfmUsers >< sfmUser > <sfmUserName>`
Description	Name of the SuperFrame Manager user.
Value Type	token

(17) `< accounts >< sfmUsers >< sfmUser > <jeusName>`
Description	Name for JEUS mapped to the SuperFrame Manager user.
Value Type	token

14.4. Example File

[Example 14.1] Example File

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<accounts xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
   <!--
        User information for authentication Service.
    -->
   <users>
      <user>
         <description>A really nice guy!</description>
         <name>johan</name>
         <password>{base64}bXlwYXNzd29yZA==</password>
         <group>my group</group>
      </user>
   </users>
   <groups>
      <group>
         <description>A really nice group</description>
         <name>my group</name>
      </group>
   </groups>
</accounts>

Prev		Next
Chapter 13. Configuring a Cluster Session in domain.xml	Home	Chapter 15. Configuring Security in the policies.xml