|
The User List has three columns: Enabled, Name, and Mailbox. The Enabled column contains a checkbox for each user entry, which can be used to quickly enable/disable the user's account. The Name column lists the user's real name (e.g. Frank Thomas), and the Mailbox column lists the mailbox portion of the user's email address (e.g. "frank" in "frank@example.com"). To edit a user, double-click the desired user in the list or select the user and then click Edit on the toolbar at the top of the page. This will open the User Edit screen.
The toolbar at the top of the page is used to initiate various tasks associated with the User List. Most of the toolbar buttons require you to first select a user from the list before you can click the desired button. The only exceptions are: Back, New, Import, and Export. Those buttons can be clicked without selecting a user. The toolbar contains the following eleven options:
Back
When you get to the User List via the Domain List, you can use this button to easily go back to the previous page.
New
Click New to open the New User dialog, used for creating a new user account under this domain. Like the User Edit dialog, New User is where you will designate the user's mailbox name, real name, password, and administrator privileges.
Edit
Use the toolbar's Edit button to open the User Edit dialog corresponding to the user currently selected in the User List. Alternatively, you can also open the User Edit dialog by double-clicking an entry.
Delete
To delete one or more users, select the users from the list and then click Delete. A box will open asking you to confirm the decision to delete the users. You can select multiple users by using the Ctrl and Shift keys.
Show/Hide Search
Click Show Search to open the User List's search option. Type some text in the User name or mailbox field and click Search to filter the User List, to display only the users with entries that contain that text. Click X Cancel Search to cancel the search and return the User List to normal.
Settings
This button opens the selected user's My Settings page, which you can use to change the user's password, set the account's quarantine preferences, turn on automatic allowlisting for the user, and to specify the number of items to display on a page when the user logs in to SecurityGateway.
Messages
This button is used to open the Message Log for the selected user. The Message Log contains an entry for each message sent either to or from that user. From the Message Log you can then open the Message Information page for any entry, which displays the SMTP session transcript and the message's content and source (when available).
Quarantine
Click Quarantine to view the Quarantine page for the selected user. All quarantined messages for that user are listed and can be reviewed from that page.
Allowlist
Use the Allowlist button to view the selected user's Addresses Allowlist. This is the user's personal allowlist, applying to his or her account only.
Blocklist
Use the Blocklist button to view the selected user's Addresses Blocklist. This is the user's personal blocklist, applying to his or her account only.
You can use a comma separated values (CSV) file to import a list of users to the User List. To do so, click Import on the toolbar at the top of the page. This will open the Import Users dialog. Use the Browse button on this dialog to navigate to the CSV file containing the users that you wish to import, and then click Import Users.
At the bottom of the Import Users dialog is the option: "Automatically create non-existent domains." When you enable that option, a new domain will be created automatically when the list of users being imported contains an email address for a domain that doesn't already exist. If that option is disabled then addresses for domains that do not exist in SecurityGateway will be ignored; those entries will not be imported.
CSV File Format
You can use any text editor such as Notepad to create the CSV file for adding users to the User List. Simply create the file according to the format below and save it as filename.csv.
The first line of the CSV file must be a mapping row, which allows the server to know in what order the data will appear. The following fields in the mapping row are supported:
•Email - the user's email address, such as "frank@example.com".
•MailBox - the mailbox portion of the email address (i.e. "frank" of "frank@example.com").
•Domain - the domain portion of the address (i.e. "example.com").
•FullName - the user's actual name, such as "Frank Thomas".
•Password - the user's password, used when logging into their account or authenticating when sending email through SecurityGateway.
•Enabled - designates whether or not the account is enabled or disabled. You can use "1", "yes", or "true" in this field for the account to be enabled, or you can use "0", "no", or "false" for disabled.
The Email, Mailbox, and Domain fields are processed in order, so if the value of any of those fields contradict a previous field then the latter value will be used. For example, if you use "frank@example.com" in the Email field but then use "domain.com" in the Domain field, then "frank@domain.com" is the address that will be used.
All fields in all rows must be contained in quotes and separated by commas.
Example CSV file:
"Email", "MailBox", "Domain", "FullName", "Password", "Enabled"
"frank@example.com", "frank", "example.com", "Frank Thomas", "1234Password", "1"
"rip@example.com", "rip", "example.com", "Rip Collector", "FoundAPenny", "yes"
"big@domain.com", "big", "domain.com", "Mister Big", "NumeroUno", "1"
Export
You can export the domain's User List by clicking Export on the toolbar. This will export the list to a CSV file with the same format as that used in the Import option outlined previously. To export the User List:
1.Click Export on the toolbar at the top of the page. This will open the File Download dialog.
2.Click Save.
3.Choose a file name and location for the file.
4.Click Save and then Close.
