CSS Wiki

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
applications:vaultwarden [2025/03/28 23:29] – created rootapplications:vaultwarden [2025/05/20 19:10] (current) – external edit 127.0.0.1
Line 1: Line 1:
-===== Vaultwarden =====+====== Vaultwarden =====
 + 
 +[[https://github.com/dani-garcia/vaultwarden|Vaultwarden]] is a Bitwarden server used to store account credentials. It can be accessed at [[https://vault.cssbham.com]]. 
 + 
 +It is running in a Docker container on [[infrastructure:servers:tex-drug-den]]. 
 + 
 +===== Adding a new user ===== 
 + 
 +An existing admin on Vaultwarden must enrol a new user. 
 + 
 +  - Log in to [[https://vault.cssbham.com]] 
 +  - Head to the CSS organisation's admin console by clicking on 'Admin Console' in the bottom left 
 +  - Click on 'Members' and add their student email (xxx@student.bham.ac.uk) 
 +      - If this user is also responsible / capable of administering CSS' infrastructure, then choose the 'Owner' role 
 +      - Otherwise, choose the 'User' role 
 +  - Click on 'save'
 + 
 +The user will receive an email invitation within a few minutes, this must be accepted within 5 days. Once they have accepted the invitation: 
 + 
 +  - Return to the 'Members' page 
 +  - Click on 'Needs confirmation' 
 +  - Verify the users account fingerprint is correct and confirm the user 
 +      - This is to make sure the person you sent the invite to is actually them 
 +  - Click on the user, click on collections, and add the 'CSS Credentials' collection at a permission level of 'Can edit' or greater 
 + 
 + 
 +===== Resetting a user ===== 
 + 
 +If someone have forgotten their master password, then it cannot be recovered. You will need to delete the user and follow the steps above again. 
 + 
 +The Vaultwarden admin interface can be accessed at [[https://vault.cssbham.com/admin]]. The secret token is stored only on the server itself. You can find it within the Docker start parameters. 
 + 
 +:!: Note that this is different to the 'Admin Console' which organisations have. This admin interface is concerned with the administration of the actual server itself, unlike the organisation admin interface. 
 + 
 +===== Email ===== 
 + 
 +Vaultwarden requires functioning email sending to be able to invite users. It is for this reason we have a [[services:mailjet|Mailjet account]].
applications/vaultwarden.1743204596.txt.gz · Last modified: (external edit)