Basic Realm and the Realm Tool

The ORB comes with an implementation of the Security Realm, basic realm, that self manages the users and provides support for authentication. A tool called realmtool is provided to manage instances of the basic realm.

The realmtool is run with the name of the realm properties file as parameter. It reads in the contents of the realm file and presents a prompt on which you can list, add, delete users and verify their passwords.

promt% realmtool -realm db/realms/bank 

Basic Realm Administration Tool 

realmtool > 

Available Commands: 
  
    list 
    add  
    delete  
    verify  
    save 
    quit 

realmtool >

Once you have manipulated the realm, you can save it. The realm properties file contains a property for each user, and the name of the realm. The realm name should match the file name in which the realm is stored. For example, the realm file for the "bank" realm used by the Secure Bank application looks like this:

#Sun Nov 22 17:08:05 PST 2000 
user.109=b5815c91d9f6af38c01a8641673a5e0a 
user.108=bf4e44f39d64385fe01c9757aa5676fd 
user.107=a4377b79cef077aad45f1beed3116ad7 
user.106=4980b5a0edbc8d6bb0a777ab62942d05 
user.105=9886ba211eb626f8f294fb55a123b0bb 
user.104=2b6b59b5133ee30b157c523f86e75240 
user.103=0b79f6058b3466c7bfb6e9c441fff034 
user.102=e25ae087cb5047630d50b519fc3779fa 
user.101=0f83f39ba77aca046204111b494035ee 
user.100=13e3e2d1eedc39a2cfadac91e3e21f38 
realm.name=bank 
user.bankserver=fc8ee732231590088b88bbe029ec3464 
realm.class=com.sssw.jbroker.security.realms.BasicRealm