1
0
mirror of https://github.com/bitwarden/help synced 2025-12-06 00:03:30 +00:00
Files
help/_articles/hosting/admin-portal.md
fred_the_tech_writer 906e2ca0dd Promote to Master (#748)
* initial commit

* adding quotes for the array error

* Create Gemfile

* Create Gemfile.lock

* add .nvmrc and .node-version

* removed /article from URL

* update links to work with netlify

* more fixed links

* link fixes

* update bad links

* Update netlify.toml

toml test for redirects

* article redirect

* link fixes

* Update index.html

* Update netlify.toml

* Update _config.yml

* Update netlify.toml

* Update netlify.toml

* Update netlify.toml

* Update netlify.toml

* Update netlify.toml

* add article back into URL for launch

* Update netlify.toml

* Update netlify.toml

* add order to categories front matter

* Update netlify.toml

* update

* sidemenu update

* Revert "sidemenu update"

This reverts commit 5441c3d35c.

* update order prop

* Navbar updates per Gary and compiler warnings

* font/style tweaks

* Update sidebar.html

* Stage Release Documentation (#739)

* initial drafts

* rewrite Custom Fields article to prioritize new context-menu option & better organize ancillary information

* edit

* edit

* Custom Field Context Menu & CAPTCHA item in release notes

* SSO relink event

* update rn

* small edits

* improve release notes titles

* fix side menu

* Edits courtest of mportune!

* update order

* link fixes

* link cleanup

* image updates and a link

* fix trailing slash

Co-authored-by: DanHillesheim <79476558+DanHillesheim@users.noreply.github.com>
2021-09-21 13:21:11 -04:00

45 lines
2.0 KiB
Markdown

---
layout: article
title: System Administrator Portal
categories: [hosting]
featured: false
popular: false
tags: [hosting, docker, admin]
order: "09"
---
The Bitwarden System Administrator Portal can be used to:
- Check currently installed and latest available versions.
- View Environment Configuration settings (for more information, see [Configure Environment Variables]({{site.baseurl}}/article/environment-variables/)).
- View and delete registered users.
- View and delete registered Organizations.
{% callout info %}
Provisioned admins cannot view sensitive data that is protected (encrypted) in any user's or Organization's vault.
{% endcallout %}
## Configure Users for the Admin Portal
Configure access to the Admin Portal by editing the environment file, located at `./bwdata/env/global.override.env`.
Adding an email address to `adminSettings__admins=`, located at the bottom of `global.override.env`, will provide access to the Admin Portal from that email address. You can provision multiple admins using this field, for example:
```
adminSettings__admins=john@example.com,bill@gmail.com,tom@example.com
```
These email addresses **do not** need to be registered with an account on your Bitwarden instance.
### Configure SMTP Mail Server
The System Adminstrator Portal uses email to provide secure links for authentication. Therefore, you will need to configure your installation's SMTP Mail Server settings prior to attempting to log in to the portal. For more information, see [Configure Environment Variables]({{site.baseurl}}/article/environment-variables/).
## Access the Admin Portal
The System Administrator Portal for your instance is available at `https://your.domain.com/admin`.
The Portal uses a secure means of *passwordless authentication*. When a user attempts to log in, a secure link is sent to their email address **only** if that email address is specified in `adminSettings__admins=`.
Clicking this temporary link will log that user into the System Adminstrator Portal. The link is active for 15 minutes following the login attempt.