Webservice tutorial
If you have any advice or problems, feel free to leave comments under here or directly contact us.
Services
Currently we include services:
MattermostGitlabNextcloudBookstackkKeycloakLdap
Our homepage link is
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 withinMAI
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.
Tutorial for new user
- 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)
- Lab Postion
- Got to keycloak management link Link, you could also find this at home navigation page.
- Choose forget password, you will receive resetting link and you would able to set your profiles
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.
-
check your dialog and profile, your profile like nickname, profile photo are lost, and you need to manually migrate your focal board, just follow the following page,
export archive
(left page),import archive
(right page). (unfortunately some info likecreation time
,createdBy
Assignee
are lost)
Notice:
- It's recommended to add SSH key to use gitlab asap.
- You could only change your profile like
name
password
under keycloak - Services under the name
xxx back-up
is the last day's mirror and only be used when emergent usage like service is down. - Nextcloud:
- there is a group called "everyone", any people is defautly in this group, you could place any files that you wanna to share public
- Be careful for online/offline editing office(docx, xlsx, pptx etc) files, You could only cooperate(multiple users edit one file ) online. And remember to check if your editing is synced back properly or not.
- Bookstack:
- phd and phd+ has permission to read/write any books/pages/..., while guest only read/write their own books.