You may wish to allow users to access SuperWEB2 without logging in (referred to as "guest access").
When guest access is enabled, users can access SuperWEB2 without having to provide a username and password. They can either click the Guest log in link on the login screen, or visit a special URL that bypasses the login screen altogether and takes them straight to SuperWEB2 (see below for more details).
SuperSTAR is supplied with a number of default, standard user accounts to enable you to complete the initial setup. One of the standard accounts is a guest user (username: guest, password: guest).
By default, guest access is enabled and is configured to use this account for guest access.
Configure Guest Access
If you want to use a different user account for guest access, you will need to complete the following configuration steps:
Step 1 - Create the Dedicated Guest User Account
If you do not want to use the default guest account, or you have deleted it, you will need to create a dedicated account for guest access.
Create the account in SuperADMIN, using the
account command. For example:
Once you have created the guest account, configure permissions in SuperADMIN so that it has read access to all the datasets you want guest users to see. Learn more about configuring user permissions.
Step 2 - Configure SuperWEB2
By default, SuperWEB2 is configured to use the username guest and the password guest to login when a user clicks the Guest log in option. If your guest user account has a different username and password, then you will need to update the SuperWEB2 configuration:
- Open <tomcat_home>\webapps\webapi\WEB-INF\web.xml in a text editor.
Locate the following section:
Update the parameter values to the username and password of the guest user account. For example:
- Restart the Tomcat or SuperWEB2 service.
- Connect to SuperWEB2 in your browser and check that you can login as the guest user:
Disable Guest Access
If you do not want to allow guest access then you can disable it by doing the following:
- Open <tomcat_home>\webapps\webapi\login.xhtml in a text editor.
Locate the following section:
Comment out the element that prints the guest login link:
- Save your changes to the file.
Open <tomcat_home>\webapps\webapi\WEB-INF\web.xml in a text editor and check the
GuestUsernameparameter to confirm which account is currently configured for guest access:
In this example, the account with the username
guestis configured for guest access.
Leave the settings in web.xml unchanged, but go to SuperADMIN and delete this guest user account. For example:
This step is necessary in order to prevent users from logging in using the special
/homeURL (see below).
- Restart Tomcat or the SuperWEB2 service.
Allow Automatic Login as Guest
Once you have configured the guest login, you can allow users to log in as guest automatically by providing them with a special URL to access SuperWEB2.
/home to the standard SuperWEB2 URL, as follows:
|If the SuperWEB2 URL is...||The Automatic Guest Login URL is...|
Prevent Guest Users from Creating Large Tables
If you decide to allow guest user access to your system, you may wish to prevent guest users from creating large tables. See Prevent Guest Users from Creating Large Tables - SuperWEB2 for more details.
You can also apply user limits to the guest user account, as an alternative means of preventing guest users from creating large tables. See Configure User Query Limits - SuperWEB2 for more information.
Configure the Number of Concurrent Guest Users
If you choose to enable guest user access, you may wish to configure the maximum number of guest users who can connect at any one time. See Configure Concurrent User Limits - SuperWEB2 for more information.