Version vom 18. September 2014, 06:53 Uhr

Authorization is needed in some services of the Terminology Server like services in Authoring or Administration. The default method is a combination with username and password. However, you can add your own authorization method and parametrize it in the settings. This page will help you creating your own authorization method.

Building your own authorization method

According to your infrastructure please implement authorization methods for the following artefacts.

Terminology Server (required)

1. Create a new Java file in package de.fhdo.terminologie.ws.authorization
2. Implement the interface IAuthorization with all of its methods
   1. method Login: logs in a user
   2. method Logout: logs out a user
   3. method Authenticate: authenticates a user, if he has logged in before
3. create or edit termserver.properties file, specify your created class there in parameter login.classname

See the file UsernamePasswordMethod.java for a sample.

That's it. If you want to use an authorization before the Terminology Server, just follow the steps above and do a successful login every time or dependent on the user id, for example.

Terminology Browser (optional)

Same here except there will be no login procedure but you might want to show a login dialog here. Do the following steps:

1. Create a new Java file in package de.fhdo.authorization
2. Implement the interface IAuthorization with all of its methods
   1. method doLogin: opens the dialog for login
   2. method doLogout: performs a logout
3. create or edit termbrowser.properties file, specify your created class there in parameter login.classname

See the file UsernamePasswordMethod.java for a sample.

Administration (optional)

Do the following steps:

1. Create a new Java file in package de.fhdo.authorization
2. Implement the interface IAuthorization with all of its methods
   1. method doLogin: opens the dialog for login
   2. method doLogout: performs a logout
   3. method changePassword
   4. method createOrEditUser
   5. method resendPassword
3. Create a new zul page with related java file for login page
4. create or edit termadmin.properties file
   1. specify your created class there in parameter login.classname
   2. specify your login zul page in parameter login.zul

See the file UsernamePasswordMethod.java and UsernamePasswordLogin.java for a sample.