Configuring Access

Once you have installed the server and can access it using your browser you are ready to configure access. Hypersocket utilises role-based access control to provide granular access to any number of network resources.

Your First Login

You login to the server for the first time using the credentials admin/admin. You will be prompted to change the admin password.

Creating Users

Hypersocket currently only supports an internal user database so the first job is to create an account for your users. Navigate to Security->Access Control here you will see 3 tabs, Users, Groups and Roles. Users and Groups can be assigned to Roles, which in turn are assigned to Resources to provide access.

Create an account by clicking on the Add button at the bottom of the Users table. For now just entering a username is enough for creating the user account. Once created you should see your new user in the list. Against each users is a number of action icons, the wrench icon allows you to edit the user account, trash icon will delete the user and the padlock icon lets you set the users password. Click the padlock icon and set a password for the user.

Creating Roles

Now that you have a user account you can create a Role to provide access to the user. Click on the Roles tab and click the Add button at the bottom of the list. First give your Role a useful name, then select any users you want to include in this role in the Users tab and click the arrow button to move the users into the included list. Finally, select the Permissions tab and select the Logon permission and click the arrow to move it over into the included list. Without the Logon permission a user will not be able to login using the client.

Save the Role, you are now ready to set up a Resource.

Creating Network Resources

A Network Resource defines a hostname and a protocol which when assigned to a Role, provides users within that Role access from the client to that hostname/protocol combination.

For example, to give your user access to an internal web service running on the host wiki.company.local on the standard HTTP/HTTPS ports you would click the Add button at the bottom of the Endpoint table and enter the form as displayed below.

Before saving, select the Roles tab and assign to any Roles that will have access to this Resource. Only users within the Roles assigned will be able to access this Endpoint.

You should now proceed to install the client on your users machines. When they login they will be able to open up a browser and access the Resource using the URL http://wiki.company.local