Authentication

The authentication dialogue can be brought up by:

  1. clicking on the Login icon in the Welcome Screen of TextGridLab:

    Login icon in Welcome Screen
  2. selecting a function or view that requires authentication (e.g. creating a new project, creating a new object, opening the Navigator),

TextGrid uses Shibboleth for single sign-on authentication purposes. In the Shibboleth model, the individual user’s home organisation (identity provider, IdP) is responsible for authenticating them – that is, (a) for checking that the credentials (a username/password combination) the user presents are correct, and (b) for passing on necessary identity information to service providers. The organisational infrastructure Shibboleth depends on has not yet been fully implemented in Germany. For this reason, the identity information of TextGrid users is, at this stage, provided by a virtual home organisation TextGrid Community IdP.

Authentication dialogue

Figure: Authentication dialogue

Users who have a TextGrid account with TextGrid Community IdP can authenticate using their individual username/password combination. You can obtain a TextGrid account using a web form at www.textgrid.de/beta/installation or sending an email with your contact details to register@textgridlab.org.

Users who do not have a TextGrid account and want to authenticate via their home organisation should click on the button Log in via DFN-AAI. They can then select their identity provider and log in to TextGridLab using the credentials of their home organisation.

When a user has successfully logged in, their login status and TextGridLab User ID are displayed on the Welcome Screen.

Users who have directly registered with TextGrid and are not authenticated via another IdP can change the password for their TextGrid account and update their email address. Select “Help” in the menubar and leftclick “Authentication”. An authentication information dialogue is shown that displays the user’s User ID. Click on the Change Password button. For safety reasons, a dialogue appears that requires you to re-authenticate. Type in your username and current password and click on Login. You can now update your email address and choose a new password.

In some cases it may be necessary to start a new session in TextGridLab. This can be achieved by re-authentication. Select “Help” in the menubar and leftclick “Authentication” for the authentication information dialogue to appear. Clicking on the Re-Authenticate button brings up the authentication dialogue. You can now select your identity provider “TextGrid Community IdP” in the dropdown menu. Refresh your authentication by clicking on the Select button.

To log out, just quit or restart the TextGridLab application or use the corresponding button in the dialog at Help / Authentication.

Note: The authentication procedure can only be executed properly if the web browser TextGridLab uses for displaying HTML content is set to accept cookies. Under Microsoft Windows, TextGridLab uses the rendering engine of Internet Explorer regardless of which application is the system’s standard web browser. Adjust your settings using the Windows Control Panel. Select “Internet Options” and set the privacy level to “Medium” or “Medium High”.