webservice overview

Author: Zhiyuan
Date: 20.Oct.24

If you have any advice or problems, feel free to leave comments under here or directly contact us.

Services

Our Service Portal :

https://hub.mai.informatik.tu-darmstadt.de/

Currently, we offer the following services to support our collaborative and organizational needs:

• Mattermost
  Mattermost serves as the main communication platform, allowing teams to stay connected through chat channels and direct messages.
• Gitlab
  GitLab is our centralized code management and version control tool. It also integrates with Mattermost for authentication, enabling seamless single sign-on and enhanced security
• Nextcloud
  Nextcloud functions as our primary file storage and sharing solution, akin to Google Drive or Dropbox but self-hosted. It allows users to store, share, and collaboratively edit files.
• Bookstack
  BookStack is a wiki-like platform tailored for organizing and documenting knowledge within the team. This tool is perfect for building a structured knowledge base, where team members can share tutorials, write guides, and document best practices.
• Keycloak
  Keycloak provides unified identity and access management, allowing users to authenticate once and access multiple services within MAI group using a single set of credentials. It supplies mainly OIDC and SMAL authentification services.
• Ldap
  LDAP (Lightweight Directory Access Protocol) is not visble to users. It acts as a backend directory service, supporting the authentication and management of user credentials across systems. It functions in conjunction with Keycloak and other applications.

New user registeration

1. Firstly you need to ask administrator to create a user for you, the following informations are needded:
   • username (note, not able to be changed anymore)
   • Email
   • Lab Postion
2. Once your account is created, you will receive the validation link in the corresponding Email.
   You should update your password as well as profiles like last name, first name.
3. Once account is verified, you could go to keycloak management link Link, there you could update your profile.

Mattermost user migration

We have migraed mattermost data from AIML to If you are already the user in AIML, you need to check if there is lost dialogs.

1. check your dialog and profile, your profile like nickname, profile photo are lost,

2. Known issues: reactions in reply is lost by migrating.

3. You need to manually migrate your focal board, just follow the following page, export archive(left page), import archive(right page). (unfortunately some info like creation time, createdBy Assignee are lost)