From wiki.ginstr.com
Revision as of 19:30, 17 October 2016 by Dejan (talk | contribs)
Jump to: navigation, search

SSO Common Content

Introduction and general points

Single sign-on (SSO) is a property of access control of multiple related, but independent software systems. With this property a user logs in with a single ID and password to gain access to a connected system or systems without using different usernames or passwords, or in some configurations seamlessly sign on at each system. This means that single page is used to log in to multiple applications which are enabled / disabled for each user account by supervisor admin based on software modules ordered from ginstr. This multiple log in is ensured with common ticket which is added as post-fix in browser address of each application. (example https://my.ginstr.com/?ticket= here goes ticket number generated by SSO server) In browser application opens in different browser tab always so that SSO server tab stay opened and user can easily operate in both SSO server tab and in opened application tab.

ginstr SSO server is located on address https://sso.ginstr.com/


SSO log in screen


In bottom right corner of SSO log in screen there is drop down with languages where user have possibility to choose language in which SSO content will be displayed (NOTE: Not all listed languages are supported yet. If user choose unsupported language then content will be displayed in English)


drop down menu with languages


Below log in form on right side of log in form there is link "questions and answers (FAQ)" which when clicked opens page with frequently asked questions where user can find some help regarding registration process and other content needed for start of work with ginstr platform


position of FAQ link on log in screen
FAQ page


In case user doesn't find needed answer on FAQ page or in this manual then on right side of log in screen there is chat which when clicked opens chat window where user can chat directly with ginstr customer support.


position of chat on SSO log in page


If user already have Facebook or Google account then in this case below log in form on left side of log in form there are two buttons which allow user to log in to ginstr SSO with their existing Facebook or Google accounts. Once click on this buttons if not logged in to Facebook or Google user will be asked for authorization and if already logged in user will be asked to grant access to ginstr.


position of Facebook and Google log in buttons on SSO log in page


In case user forgot password there is link to screen for resetting password. Link is called "forgot password?" and is located on right side of log in form under password field. Once user enter screen for password reset there can enter e-mail used for registration and after click on reset password button e-mail with instructions will be sent to that e-mail address.

position of link which opens page to reset password


To register new account on ginstr SSO user should click on "sign up!" link positioned on top right side of log in form above e-mail field

position of sign up link

Signing up for new SSO account

Once user click on sign up! link on log in page of ginstr SSO a page with form for registering new ginstr iD (ginstr account) will open.

This form have following fields:

  • e-mail (required field)
  • password (required field)
  • re-enter password (required field)
  • first name (required field)
  • last name (required field)
  • mobile number (optional)
  • company (optional)

Also there is drop down with languages. Account will be created in language which is selected in this drop down (if language not supported yet if will be created in English language) There are also links that open page with frequently asked questions and page with privacy policy on ginstr web site.

appearance of form for registering new ginstr iD


Once fill all required fields and click on "register" button user will be taken to page with info that account is registered and that confirmation e-mail is sent to e-mail account that was used for registration. e-mail will be sent from address notifications@ginstr.com and will be titled ginstr iD activation (please check spam folder in case e-mail not appears in inbox folder shortly) and will contain link "Activate your ginstr iD" which when clicked will activate your account.


appearance of ginstr iD activation e-mail

Clicking "Activate your ginstr iD" link will take you to page where it will be confirmed that ginstr iD is activated and which will enable user to log in with newly created ginstr iD on ginstr SSO log in page.


SSO lobby

Once log in to ginstr SSO default set of applications icons will be displayed in SSO lobby. This applications are:

  • ginstr home page - opens https://www.ginstr.com/
  • ginstr web - opens ginstr web client which contains tables where master data for ginstr applications is defined and where data sent from ginstr applications is stored
  • OpenCellID - opens OpenCellID application


default applications icons in SSO lobby

When click on ginstr web icon user will be asked to accept "Conditions of Use for ginstr Applications". This will be required to do only once and when user accept this conditions of use they will not appear again on launching of ginstr web application.
NOTE: Even though account is now activated user will not be able to use ginstr web but will get error message "(1017) ginstr is disabled" until buy some ginstr subscription from ginstr shop https://shop.ginstr.com/produkt-kategorie/subscriptions/

In top right corner in SSO lobby there is user name displayed. When mouse over this user name drop down menu opens.


lobby menu position and appearance


Items in this menu are:

  • contact form
  • questions and answers (FAQ)
  • my account
  • conditions of use
  • imprint
  • privacy policy
  • log out


contact form

When click on this menu item then opens page with contact form that enables user to contact ginstr support via e-mail

contact form appearance

In this form all fields are required to be filled.


questions and answers (FAQ)

When click on this menu item then opens page with frequently asked questions


my account

When click on this menu item opens page for settings related to account. This page will be described in details later

my account page


conditions of use

When mouse over this menu item then sub menu item ginstr web appears. When click on that ginstr web sub menu item then page opens with displayed conditions of use for ginstr applications (same conditions of use which are displayed on first start of ginstr web application from SSO lobby)

conditions of use for ginstr applications


imprint

When click on this menu item opens imprint page on ginstr web site https://www.ginstr.com/imprint/


privacy policy

When click on this menu item opens the privacy protection page on ginstr web site https://www.ginstr.com/privacy-protection/


log out

When click on this menu item then user gets logged out and return to SSO log in screen


My account page

This page contains multiple sections:

  • my account
    • general
    • hide/show content
  • subaccounts
  • roles