From wiki.ginstr.com
Revision as of 21:45, 4 November 2016 by Mark (talk | contribs)
Jump to: navigation, search

SSO Supervisor / Admin / Master Specific Content

General

In SSO server the following roles are defined, with ascending order for access level:

  • USER
  • ADMIN
  • MASTER
  • SUPERVISOR

"Standard" users (i.e. registered via sign up form) have role USER, which allows them to perform actions on themselves and their subaccounts only.

ADMIN, MASTER and SUPERVISOR are special user roles with increased permissions.

additional options in SUPERVISOR menu
action SUPERVISOR role MASTER role ADMIN role USER role
delete can delete all users can delete ADMIN & USER users only can delete USER users only cannot delete users
see can see all users can see ADMIN & USER users only can see USER users only can see himself and subusers only
modify can modify all users can modify ADMIN & USER users only can modify USER users only can modify himself and subusers only
add can add all users can add ADMIN & USER users only can add USER users only can modify himself and subusers only
update can update all users cannot update users cannot update users cannot update users

These roles are distinct from the roles defined in SSO Common Content roles section which are user-created roles for permissions on ginstr apps tables while SSO roles relate to permissions for SSO users.

When a user with SUPERVISOR permission logs in to SSO, the following additional options appear in the SSO lobby menu (accessed by hovering mouse over user name in top right corner of screen when logged in to SSO).

  • edit users
  • configure lobby
  • configure applications

When users with ADMIN or MASTER role log in to SSO, only the additional option 'edit users' appears in the SSO lobby menu.

edit users

File:list of users.png
'list of users' table

In this section are listed all SSO users with options to create new users, edit users, delete users and enable/disable ginstr for certain user.

This list of users is divided in multiple columns containing different info related to users. The table can be sorted by each of these columns by clicking on the sort iconsort.giflocated at the top right of each column heading.

DB num
this column contains id of user which is generated by SSO server automatically. Each id is a unique identifier for each user.
main account
this column is only filled if the user is a subaccount user, in which case it displays the main account of subaccount user
account status
existing account statuses are:
max subs
this column displays maximum number of subaccounts which user can create.
This number is defined by SUPERVISOR/ADMIN/MASTER when creating new user or editing existing user on edit users page or by ginstr subscription purchased from the ginstr shop.

On the far right side of page there are several links which when clicked open new pages or make some status changes on user accounts:-


edit

This page is the same as the page for creating new user which is opened by clicking on the
new user
button at the bottom of the 'list of users' page.
user's general information

At the top left side there are fields with general information related to the selected user account.

e-mail
In this field you can enter a personal or company e-mail address for the selected user.
password and re-enter password
These two fields are used to change the current password for the selected user.
NFC
In this field you can enter an NFC tag id, allowing the selected user to log in to ginstr apps by scanning this NFC tag on Android devices with built-in NFC technology.
first name and last name
In these fields you can modify first and last name which were entered on account creation.
mobile number
In this field you can enter a personal or company mobile number for the selected user.
company (optional)
In this field you can enter the name of the selected user's company.
attachments upload disable / enable and setting attachments limit section

At the bottom left side there is a section where SUPERVISOR/ADMIN/MASTER can set restrictions on attachments uploaded by the selected user.

disable chat support
This checkbox disables support chat so that the chat window will no longer be displayed to the selected user in either SSO or ginstr web.
enable upload of videos
if checked, the selected user can upload video files to ginstr web.
max. size per video in MB
defines the maximum size permitted for each video file uploaded by selected user.
max. size all videos in MB
defines the maximum total size permitted for all video files uploaded by the selected user.
enable upload of pictures
if checked, the selected user can upload image files to ginstr web.
max. size per picture in MB
defines the maximum size permitted for each image file uploaded by the selected user.
max. size all pictures in MB
defines the maximum total size permitted for all image files uploaded by the selected user.
enable upload of voice notes
if checked, selected user can upload audio files to ginstr web.
max. size per voice note in MB
defines the maximum size permitted for each audio file uploaded by the selected user.
max. size all voice notes in MB
defines the maximum total size permitted for all audio files uploaded by the selected user.
enable upload of documents
if checked, the selected user can upload document files to ginstr web.
max. size per document in MB
defines the maximum size permitted for each document file uploaded by selected user.
max. total size of all documents in MB
defines the maximum total size permitted for all document files uploaded by the selected user.
max. size account in MB
defines the maximum total size permitted for all files uploaded by the selected user.
user settings

In the top right corner there is a section related to the selected user account settings.

comment about user
This field can be used to save some comment(s) related to the selected user account.
account status
This drop down menu can be used to change the status of account (ACTIVE/SUSPENDED/DELETED)
role
This drop down menu can be used to change the SSO role of the selected account (USER/ADMIN/MASTER/SUPERVISOR)
enforce password expiry policy?
If checked, the selected user will be forced to renew password after certain period of time
ignore password and username minimum requirements for this account?
If checked, the default password requirements (password must have one number, one uppercase letter, one lowercase letter and at least eight characters) will not be disregarded on next renewal or change of password by the selected user
language
This drop down menu can be used to change the language in which SSO content will be displayed for the selected user
number of booked subaccounts
In this field you can define the maximum number of subaccounts which the selected user can create.
This field is not displayed if editing a subaccount.
Once this amount is set here manually, it is no longer set by a user's ginstr subscription, and can only be changed by a user with SUPERVISOR/ADMIN/MASTER role (unless a reset is performed).
account was created by
This field, which is only shown if the selected user is a subaccount, displays the name of the main account which created the subaccount.
section for editing user's applications
dialog for defining maximum amount of rows in each table of the selected app
dialog for generating demo data of PLUS applications

In the bottom right corner there is a list of all existing applications where SUPERVISOR/ADMIN/MASTER can enable/disable each app for the selected user, remove tables and data of certain apps for that user, set maximum amount of rows that can be added in table of some app and generate demo data for PLUS applications.

On top of this section there are 3 links :-

activate all
enables all applications in list below
deactivate all
disables all applications in list below
remove all tables
removes all tables and data from enabled applications in list below

Below these links is a list of modules (which are displayed in SSO lobby) and ginstr apps (which are displayed in the hide/show content section of the my account page on every main user account).

Before each module and application name there is a checkbox which can be used to manually activate / deactivate each separate module and application.

After each ginstr application name, one or more of the following icons will be displayed :-

delete icon.png delete icon
The delete icon appears after every ginstr application name, and when clicked opens a 'delete' dialog window with a security question.
If a SUPERVISOR/ADMIN/MASTER chooses 'yes' in the security dialog then all tables and data of the selected app belonging to the selected user will be removed.
pencil icon.png pencil icon
If tables of a ginstr app are already generated for the selected user, there will also be a pencil icon next to the application name.
Clicking on the pencil icon will open a dialog window to set the maximum amount of rows in each table of the selected app.
In this dialog window you can define the maximum amount of rows that can be added to each app table by user.
If the user attempts to add more rows than the maximum amount defined here, they will be shown an error message.
If no value is entered in a field, this means that an unlimited amount of rows can be added to table.
The limits applied here are saved when disabling an app for the selected user and are applied again if application is subsequently enabled for that user again.
arrow icon.png arrow icon
For PLUS applications there is an additional arrow icon.
Clicking on the arrow icon opens a dialog window for applying the predefined demo data for the language selected in the drop down to the PLUS app on the selected user account.

remove

Clicking the remove button on the 'list of users' table sets the selected account status to DELETED.

After several days account and all of its data will be completely removed.

EULA decisions

EULA decisions page

Clicking the EULA decisions button on the 'list of users' table opens a dialog box which contains a record of when the EULA (End User License Agreement) was accepted or declined by the selected user.

enable ginstr/disable ginstr

Disabling ginstr for a certain account means that the selected user will not be able to use the ginstr module at all.

Upon the expiry of a ginstr subscription, ginstr is automatically disabled for that account.

The enable ginstr/disable ginstr links in the 'list of users' table allows a SUPERVISOR/ADMIN/MASTER to manually enable/disable ginstr for some accounts.

In case ginstr is enabled/disabled manually then ginstr shop no longer has control over that account and all further actions in this regard on that account must be performed manually by a SUPERVISOR/ADMIN/MASTER (unless a reset is performed).

reset ginstr

Clicking on reset ginstr link for some account returns control of the account to ginstr shop and all changes previously made manually by SUPERVISOR/ADMIN/MASTER are overridden.

configure lobby

configure lobby page

In this section a SUPERVISOR can configure modules which are displayed in SSO server lobby.

For each module, the following modifications can be made:

  • name of module that will be displayed in SSO lobby
  • link to module address
  • icon which will be displayed in SSO lobby for that module
  • whether module should be displayed for all users by default in SSO lobby

configure applications

configure application page

On this page a SUPERVISOR can edit existing ginstr applications or add a new ginstr application to server.

The 'configure applications' table contains the following columns :-

  • App ID
  • Display Name
  • owner of private application
  • Active By Default
  • App version
  • Minimum ginstr launcher version
  • App Icon
  • Uploaded by
  • Uploaded on date

new application page

new application page
When a SUPERVISOR clicks on the
new application
button, a new page is opened with the following fields:-
type
This drop down contains two options - private or public
A private application is published only for a certain user and is visible only for that certain user and no one else.
A public application can be active by default or not active by default. If a public app is active by default then it will be displayed for all existing and future accounts. If a public app is not active by default it will be displayed only for those accounts where a SUPERVISOR enables that app.
owner of private application
If private is chosen from the type field, this drop down is used to select the username of user who will be able to use that application
Display Name
This field is used to enter the name of the new app which will be displayed in SSO and in ginstr web.
Active by Default
This checkbox is not editable for private applications because such application is visible only for user chosen in owner of private application drop down.
For a public app, enabling this checkbox means that the new app will be displayed for all existing and future accounts.
App ID
This field is for the unique identifier of the new app and must be entered for both private and public app. App ID must be in camel case and be same as the name of the application zip file.
  • After all required fields are filled, click on the
    Browse...
    button to select the new application .zip file from your local PC.
  • Once file is selected, click on the
    save
    button to start the upload process.
  • Upload progress is displayed in bar below the
    Browse...
    button.
  • When upload is complete, a success message (with green background) confirms that the app has been added to the server and is now displayed in the configure applications page. If there was a problem during upload then an error message (with red background) will be displayed with advice on further steps required.

edit application page

edit application page

When a SUPERVISOR clicks on an app name on configure applications page then page where can edit that application is opened. This page is similar to the 'new application' page with a few differences.

None of the fields on this page are editable but only an updated zip can be uploaded with same app id. Only the checkbox 'Active By Default' editable allowing SUPERVISOR to change that status for each app at any time.

If the new app zip which should be uploaded has some changes in table structure then simple upload of new app version will not be possible and errors will be displayed when the upload is completed. In this case SUPERVISOR must remove the existing app and then create new app with same ID and upload that new zip with new table structure.

There are 3 fields on this edit application page that does not exist on new application page.

usage statistic CSV file example
usage statistic
When a SUPERVISOR clicks on this button, a CSV file is exported with info about which accounts are using the selected application and how many records those accounts have in tables of that app.
remove tables
When a SUPERVISOR clicks on this button then a dialog window will appear with security question.
If 'yes' is chosen then all tables of the selected application will be deleted for all accounts where that app is enabled.
Removal of tables mean that tables are temporary deleted but data is permanently deleted. On next log in, an account which has that app enabled can generate tables again but new tables will be empty
remove ginstr app
When a SUPERVISOR clicks on this button then a dialog window will appear with security question.
If 'yes' is chosen then the selected application will be removed from SSO and ginstr web and also all tables and data will be removed for all accounts where app is enabled.