Introduction
This article shows you how to set up a realm for users/groups and authentication which will be handled by the Hypersocket server itself.
This creates a realm of users and groups that is stored within the local Hypersocket Database and does not rely on any third party services. The built-in System realm is a Local Database type, therefore if your requirements are for locally stored users, then you may opt to use the existing System realm, or create a new one of this type.
Configuration
The configuration of a Local Database is much simpler than all of the others, with only 2 tabs.
First, give the Realm a name and set the Realm Type to Local Database. In the first tab, Security, the only setting is:
- Password Encoding: Chooses the mechanism by which the passwords are encoded in the database. Choose from PBKDF2_SHA1_1000 and PBKDF2_SHA1_20000 (Default).
The second tab is Hosts. If more than one realm is being set up it is advised to configure the settings in this tab.
- Restrict Hosts: if this option is turned on, then users from another realm will not be able to authenticate to the Hypersocket server when accessing via the defined Realm Host. This can be especially useful in a Managed Service Provider environment. If Restrict Hosts is off, then a user from another realm will be able to authenticate as long as their username is not a duplicate of one on this realm.
- Realm Hosts: It is strongly advised to configure this setting. Type in the hostname that your users will be using to access the Hypersocket server for this realm. The Hypersocket server then will know to send authentication attempts to this host to the correct User Database. A different hostname should be used for each realm, which requires you are able to configure your domain’s DNS settings so that these hostnames point to the Hypersocket server.
Type in the realm host and press enter to add the host. Multiple hostnames can be configured on a realm.
Without a Realm Host setting, Hypersocket will attempt to authenticate a user on the Default realm first, before trying to find that user on other realms. This can lead to unpredictable behavior in a multi-realm environment.
Click Create to create the new realm.
