Managing Organizations

Note

Organizations can be managed via the API as well.

Organizations enable easy management of large number of domains, Administrators are assigned to Organizations and can manage all the domains with in the organization.

You can create smaller organizations out of bigger organizations and add specific domains from a bigger organization to allow delegation of domain management.

Adding an Organization

Organizations can be added by either importing them using a YAML file, via the API or by adding them using the Add Organization form.

To add an Organization by import refer to Importing Organizations. To add an Organization via the API refer to the API documentation.

  1. Mouse over or Click Organizations
  2. Click Add Organization
  3. Enter the name in Organization name
  4. Select domain in Domains list if they already exist
  5. Select admins from Admins list if they already exist
  6. Click the Add organization Button

Updating an Organization

  1. Click Organizations
  2. Select organization > Click Edit
  3. Make changes
  4. Click the Update organization Button

Deleting an Organization

  1. Click Organizations
  2. Select organization > Click Delete
  3. Check Delete Organization domains if you want to delete domains belonging to the organization.
  4. Click the Delete organization Button

Search for an Organization

If you have a large number of organizations you can search for an organization by name.

  1. Click Organizations
  2. Enter the organization name in the search box
  3. Click the Search Button

List all domains that belong to an organization

To find all domains that belong to a specific organization.

  1. Click Organizations
  2. Select organization > Click List domains

List all accounts that belong to an organization

To find all accounts that belong to a specific organization.

  1. Click Organizations
  2. Select organization > Click List accounts

Add a new domain to an organization

  1. Click Organizations
  2. Select organization > Click Add domain
  3. Enter the domain details
  4. Click Add domain

Importing Organizations

Full organizations with their admins and domains as well as other settings can be imported. To import organizations.

  1. Click Organizations
  2. Select organization > Click Import Organizations
  3. Browse for the YAML file by clicking Browse next to the YAML file field
  4. Click the Import Button

Exporting Organizations

You can export all the organizations on a system. To export organizations.

  1. Click Organizations
  2. Click Export Organizations
  3. Click Download the YAML file
  4. Save the file to your computer

Import domains in to an organization

Domains can be imported using a YAML formatted file. To import domains in to an organization.

  1. Click Organizations
  2. Select organization > Click Import domains
  3. Browse for the YAML file by clicking Browse next to the YAML file field
  4. Click the Import Button

Export an Organization’s user accounts

You can export all the user accounts with in an organization.

  1. Click Organizations
  2. Click the organization name
  3. Click Export accounts
  4. Click Download the YAML file
  5. Save the file to your computer

View Organization details

To view the details of an organization such as number of domains, admins, relay settings

  1. Click Organizations
  2. Click the organization name

Outbound SMTP relay settings

Relaying of outbound mail is authenticated on a per organization basis, to enable an organization to send outbound mail through Baruwa you need to add relay settings.

Two kinds of outbound relaying are supported.

  • IP address
  • SMTP AUTH

You can also set spam check thresholds and actions to outbound SMTP relays, this allows you to manage spam on outbound email. The spam thresholds and actions work the same way they do for domains and users but will in this case apply to email originating from the specified IP address or SMTP-AUTH user.

It is also possible to restrict the sender domain names that senders can use to send messages outbound to only the domains configured for this organization. You can use this to prevent senders from forging their sending domain name.

Add Outbound SMTP IP Address settings

This allows the specific IP address to send outbound mail through Baruwa.

  1. Click Organizations
  2. Click the organization name
  3. Click Add relay setting
  4. Enter the IP address in the Hostname field
  5. Ensure the Enabled checkbox is checked
  6. Enter a description in the Description field
  7. You can change the Number of messages per 15 minutes if the default is not high enough for you
  8. Enter Probable spam score and Definite spam score values if you do not want to use the defaults
  9. Select the What to do with probable spam and What to do with definite spam actions
  10. Click Add settings

Update Outbound SMTP IP Address settings

  1. Click Organizations
  2. Click the organization name
  3. Select the Relay Host in the list at the bottom and click the edit icon
  4. Make the required changes
  5. Click Update settings

Delete Outbound SMTP IP Address settings

  1. Click Organizations
  2. Click the organization name
  3. Select the Relay Host in the list at the bottom and click the delete icon
  4. Click Delete settings

Add Outbound SMTP AUTH settings

This allows any client that supplies these credentials to send outbound mail through Baruwa.

  1. Click Organizations
  2. Click the organization name
  3. Click Add relay setting
  4. Ensure the Enabled checkbox is checked
  5. Enter the username in the SMTP-AUTH username field
  6. Enter the password in the SMTP-AUTH password field
  7. Reenter the password in the Retype Password field
  8. Enter a description in the Description field
  9. You can change the Number of messages per 15 minutes if the default is not high enough for you
  10. Click Add settings

Update Outbound SMTP AUTH settings

  1. Click Organizations
  2. Click the organization name
  3. Select the SMTP AUTH item in the list at the bottom and click the edit icon
  4. Make the required changes
  5. Click Update settings

Delete Outbound SMTP AUTH settings

  1. Click Organizations
  2. Click the organization name
  3. Select the SMTP AUTH item in the list at the bottom and click the delete icon
  4. Click Delete settings

Fallback servers

Fallback servers are used when no delivery server has been configured for a domain. They can be setup in cases where an organization has several domains whose mail is hosted on the same server so it would be repetitive to setup the same delivery server for each domain.

An Organization can have multiple Fallback servers.

Add a Fallback server

To add a Fallback server:

  1. Click Organizations
  2. Click the organization name
  3. Click Add Fallback server
  4. Enter server IP address or Hostname in the Server address field
  5. Select the protocol in the Protocol drop down
  6. Change the port in the Port field if your mail server does not use port 25
  7. Ensure the Enabled checkbox is checked
  8. Click the Add server button

Update a Fallback server

  1. Click Organizations
  2. Click the organization name
  3. Select the Fallback server in the list at the bottom and click the edit icon
  4. Make the required changes
  5. Click Update server

Delete a Fallback server

  1. Click Organizations
  2. Click the organization name
  3. Select the Fallback server in the list at the bottom and click the delete icon
  4. Click Delete server

Organization SmartHosts

Organization SmartHosts are used to route outbound email for domains in an organization that do not have a domain smarthost configured. This can be setup in cases where an organization has several domains whose outbound mail is routed via the same smarthost so it would be repetitive to setup the same smarthost for each domain.

An Organization can have multiple Organization SmartHosts.

Add a SmartHost

To add a SmartHost:

  1. Click Organizations
  2. Click the organization name
  3. Click Add SmartHost
  4. Enter server IP address or Hostname in the Server address field
  5. Change the port in the Port field if your mail server does not use port 25
  6. Enter a description of the SmartHost
  7. Enter the SMTP-AUTH username and SMTP-AUTH password and Retype Password if using SMTP-AUTH.
  8. Ensure the Require TLS checkbox is checked if using SMTP-AUTH or service uses TLS.
  9. Ensure the Enabled checkbox is checked
  10. Click the Add SmartHost button

Update a SmartHost

  1. Click Organizations
  2. Click the organization name
  3. Select the SmartHost in the list at the bottom and click the edit icon
  4. Make the required changes
  5. Click Update SmartHost

Delete a SmartHost

  1. Click Organizations
  2. Click the organization name
  3. Select the SmartHost in the list at the bottom and click the delete icon
  4. Click Delete SmartHost