Managing Accounts
Note
Accounts can be managed via the API as well.
Adding an Account
Accounts can be added by either importing them using a YAML file, via the API
or by adding them using the Add Account
form.
To add an Account by import refer to Importing Accounts. To add a Account
using the Add Account
form:
- Mouse over or Click
Accounts
- Click
Add Account
- Enter the Account details
- Click the
Create Account
button
Updating an Account
- Click
Accounts
- Select the account > Click
Edit
under actions - Update the details you want to change
- Click the
Update account
button
Deleting an Account
- Click
Accounts
- Select the Account > Click the
Account name
- Click
Delete account
- Click the
Delete Account
button
Exporting Accounts
Accounts can be exported to YAML, To export accounts.
- Click
Accounts
- Click
Export Accounts
- Click
Download the yaml file
- Save the YAML file to your computer
Search for Accounts
If you have a large number of accounts you can search for an account or accounts by name.
- Click
Accounts
- Enter the Accounts name in the search box
- Click the
Search
Button
Add alias address
Alias addresses enable a user to view emails addressed to other addresses that belong to them apart from their primary email address.
Address tags are supported. The +
and -
separators are supported.
It is possible to add addresses such as username-*@domain.com
and
username+*@domain.com
. That will match username-work@domain.com
and
username+work@domain.com
.
To add an Alias address.
- Click
Accounts
- Select the Account > Click the Username
- Click then
Add alias address
menu option - Enter
Email Address
- Check the
Enabled
checkbox - Click the
Create
button
Update alias address
- Click
Accounts
- Select the Account > Click the Username
- Find the alias address under
Alias Addresses
- Click the
Edit
icon - Update the
Email Address
- Check or uncheck the
Enabled
checkbox - Click the
Update
button
Delete alias address
- Click
Accounts
- Select the Account > Click the Username
- Find the alias address under
Alias Addresses
- Click the
Delete
icon - Click the
Delete
button
Add account signatures
Baruwa can manage email signatures / disclaimers that are added to messages that are sent outbound through it. Both HTML and Text signatures are supported. HTML signatures support a single embedded image.
Account specific signatures/disclaimers can be setup.
- Click
Accounts
- Select the Account > Click the Username
- Click
Add signature
- Select
Signature type
from the drop down - Enter signature content
- Ensure the
Enabled
checkbox is checked - Click the
Add signature
button
Assign User Delivery Servers
Baruwa supports delivering of clean mail on a user specific basis. This means that email for some users in a domain can be delivered to a server different from the default delivery server.
To deliver a users mail to a specific server different from the default servers,
you need to add User Delivery Servers
to the users domain. The servers are
then available for assignment to users.
To assign User Delivery Servers
to a user:
- Click
Accounts
- Select the Account > Click the Username
- Click
Assign User Delivery Servers
- Select the
User Delivery Servers
- Click the
Assign
button
Enable Two Factor Authentication
TOTP based Two Factor Authentication is supported. Any device or App that can generate TOTP tokens as well as scan QRcodes can be used. We recommend FreeOTP which is open source and developed by Redhat and available for Andriod and IOS.
To enable Two Factor Authentication for a user:
- Click
Accounts
- Select the Account > Click the Username
- Click
Two Factor Authentication
- Click the
Show QR code
link - Scan the QRcode using your App
- Check the
Enable Two Factor Authentication
checkbox - Click the
Update
button
Disable Two Factor Authentication
Disabling of Two Factor Authentication can only be performed by adminstrative users.
To disable Two Factor Authentication for a user:
- Click
Accounts
- Select the Account > Click the Username
- Click
Two Factor Authentication
- Uncheck the
Enable Two Factor Authentication
checkbox - Click the
Update
button
Reset Two Factor Authentication
If the device used to generate TOTP tokens is lost or destroyed, the TOTP secret can be reset. This allows the user to enroll a new device. Resetting the TOTP secret can only be performed by adminstrative users.
To reset Two Factor Authentication for a user:
- Click
Accounts
- Select the Account > Click the Username
- Click
Two Factor Authentication
- Uncheck the
Reset OTP Secret
checkbox - Ensure the
Enable Two Factor Authentication
checkbox is unchecked - Click the
Update
button
Changing an Account password
Domain administrator and normal user account passwords can be changed using the web interface, administrator accounts can only be changed using the command line.
To change an account password:
- Click
Accounts
- Select the Account > Click the Username
- Click
Change password
- Enter the password in the
New Password
field - Reenter the password in the
Retype Password
field - Click the
Change password
button
Bulk account management
To enable
, disable
or delete
multiple accounts:
- Click
Accounts
- Use the checkbox to select the accounts
- Select
enable
ordisable
ordelete
at the top - Click the
Submit
button