Skip to main content

Getting Started

Set Timezone

Ensure the timezone is set correctly in your machine. From an SSH/Console prompt, run the following command to set your timezone where ZONE is your preferrred timezone (Example: sudo timedatectl set-timezone EST)

sudo timedatectl set-timezone ZONE

You can get a listing of all the time zones by running the following command:

sudo timedatectl list-timezones

Access Hermes SEG Administrator Console

Using a browser, access the Hermes SEG Administrator Console at ​https://<IP_ADDRESS>/admin/ where <IP_ADDRESS> is the IP address of your server.

If you have recently rebooted your system, you may get a 500 Internal Server Error when attempting to access the Hermes SEG Administrator Console. This usually means that the Authentication Server has not initialized yet. This error usually goes away on its own. Wait a couple of minutes and try refreshing your browser again.

Login with the following default credentials

  • Username: admin
  • Password: ChangeMe2!

     

    Set System Settings MySQL Database Credentials

    On initial login to the Hermes SEG Administrator Console, the system will automatically navigate you to the System Settings page in order to set the MySQL Database Credentails.

    • If this is a brand new installation, Do NOT fill in Postmaster E-mail Address field yet. If this is a system restored from backup, DO fill in the Postmaster E-mail Address field with an email address that contains a domain that your system relays e-mail.
    • Do NOT fill in the Admin E-mail Address field yet.
    • Fill in the MySQL Hermes Database Username you set during installation.
    • Fill in the MySQL Hermes Database Password you set during installation.
    • Fill in the MySQL Ciphermail Database Username you set during installation.
    • Fill in the MySQL Ciphermail Database Password you set during installation.
    • Fill in the MySQL SysLog Database Username you set during installation.
    • Fill in the MySQL SysLog Database Password you set during installation.
    • Fill in the MySQL Opendmarc Database Username you set during installation.
    • Fill in the MySQL Opendmarc Database Password you set during installation.
    • Click the Save Settings button (Figure 1).

    Figure 1

    Figure4.jpg

     

    Set Network Settings

    • Navigate to System --> Network Settings.
    • Set the Network Mode drop-down to Static.
    • Fill in the Host Name field. Ensure you enter only the name without the domain part. For example, if the FQDN of your Hermes SEG appliance is going to be smtp.domain.tld, then in the Host Name field you will simply enter smtp without the domain part.
    • Fill in the Primary Domain Name field. For example, if the FQDN of your Hermes SEG appliance is going to be smtp.domain.tld, then in the Primary Domain Name field you will simply enter domain.tld.
    • Fill in the Hermes SEG appliance IP Address, select the appropriate Subnet Mask for your network, fill in the Gateway and DNS1. If applicable, fill in DNS2 and DNS3 fields.
    • Click on the Submit button. Once the settings are saved, they will not take effect until you click on the Apply Settings button.
    • Click on the Apply Settings button (Figure 2).

    Figure 2

    image-1638453135015.png

    • If you changed Hermes SEG IP Address, your browser will most likely time out. Remember, to access the Hermes SEG Administrator Console Web GUI at https://<NEW_IP_ADDRESS/admin/ where is the <NEW_IP_ADDRESS> is the IP you set above.

     

    Setup Relay Domains

    In order for Hermes SEG to deliver email, you must first set the domain(s) that Hermes SEG will process email for along with their corresponding email server(s). You can add as many domains and email servers as required. An email server can be configured as an IP address or a Host Name as long as the Hermes SEG can reach it over Port TCP/25. Multiple domains can be pointed to the same email server if necessary.

    • From the Hermes SEG Administrator Console, navigate to Gateway --> Relay Domains
    • Under the Relay Domain Destination Type, select whether you are adding an IP Address Destination to an email server or a Host Name Destination to an email server.

    If you are adding an IP Address Destination

    In the Relay Domain field enter the domain name, in the IP field enter the email server's IP address, in the Port field enter the email server's port number (if other than 25) and click the Add button (Figure 3).

    Figure 3

    Figure6.jpg

    If you are adding a Host Name Destination

    In the Relay Domain field enter the domain name, in the Host field, enter the email server's Host Name part of the FQDN address (without the domain part), in the Domain field, enter the email server's domain part of the FQDN address, in the Port field enter the email server's port number (if other than 25), check the MX Lookup checkbox if necessary and then click the Add button (Figure 4).

    Figure 4

    Figure7.jpg

     

    Set System Settings Postmaster & Admin E-mail Address

    • From the Hermes SEG Administrator Console, navigate to System --> System Settings.
    • Fill in Postmaster E-mail Address field with an email ofbelonging to a domainRelay Domain you setup in Step 3 above.
    • Fill in the Admin E-mail Address field with an email of domain outside of the system (i.e. a domain that the system does not relay email Ex: someone@hotmail.com).
    • Click the Save Settings button.

     

    Setup Relay IPs & Networks

    In addition to inbound email, if the email server(s) you added will also be sending outbound email through the Hermes SEG (recommended), you must allow their IP address(es) to send (relay) email through the Hermes SEG.

    • From the Hermes SEG Administrator Console, navigate to Gateway --> Relay IPs & Networks
    • Ensure IP Address is selected and the under the IP Address field enter the IP Address of the email server that you want to allow to send email through the Hermes SEG, under the Note field, enter a short description identifying the email server (ensure that you don't use any spaces or special characters in the Note field) and click the Add button (Figure 5)

    Figure 5

    Figure8.jpg
    • Repeat as necessary for every email server that you want to allow to send outbound email through the Hermes SEG.
    • As you add entries, you will notice that each entry shows up under the Permitted Relay Ips/Networks to be added section (Figure 6)

    Figure 6

    2020_11_17_17_58_57_Select_Vivaldi.png
    • After you are finished adding all your permitted email servers, you must apply the settings in order for the changes to take effect. On the bottom of the page, click on the Apply Settings button (Figure 7)

    Figure 7

    apply_settings.jpg

     

    Initialize Pyzor and Vipul's razor

    Pyzor is a collaborative, networked system to detect and block spam using digests of messages. Vipul's Razor is a distributed, collaborative, spam detection and filtering network.

    Hermes SEG uses both of these components for better spam detection. Both of these components must be initialized before Hermes SEG can use them.

    Initialize Pyzor

      • From the Hermes SEG Administrator Console, navigate to Content Checks --> Initialize Pyzor and click on the Initialize Pyzor button. Wait for successful completion before proceeding further (Figure 118).

    Figure 118

    Initialize Vipul's Razor

    Before attempting to initialize Vipul's Razor, ensure the Hermes SEG has outbound Internet access. Initialization can take a few minutes to complete, so please be patient.

      • From the Hermes SEG Administrator Console, navigate to Content Checks --> Initialize Vipul's Razor and click on the Initialize Razor button. Wait for successful completion before proceeding further (Figure 129).

    Figure 129

    Initialize Global Sender Block/Allow

      • From the Hermes SEG Administrator Console, navigate to Content Checks --> Global Sender Block/Allow List enter an e-mail address in the Enter Email Address or Domain below field (the e-mail address you enter is not important), leave the Select Action to take below field on Block Action and click the Add button  (Figure 11).

      Figure 11

      image-1615165570388.png

      • Click the Apply Settings button at the bottom of the page (Figure 12).

      Figure

       

      12

      image-1615166249756.png

      • Next, click the Select box next the e-mail address you just added from the Delete Global Sender Block/Allow Entry section below and click the Delete Button (Figure 13).

      Figure 13

      image-1615167004963.png

      • Click the Apply Settings button at the bottom of the page (Figure 14).

      Figure 14

      image-1615166249756.png

      Clear Bayes Database

      The Bayes Database tries to identify spam by looking at what are called tokens; words or short character sequences that are commonly found in spam or ham.

      On a new Hermes SEG installation, it's always best to ensure a clean Bayes Database before you start processing email.

        • From the Hermes SEG Administrator Console, navigate to Content Checks --> Clear Bayes Database and click on the Clear Database button. Wait for successful completion before proceeding further (Figure 1510).

      Figure 1510

      Add Internal Recipients Manually

      Hermes SEG requires a listing of Internal Recipients in order to process incoming email and deliver that email to the correct recipient mailboxes which are located on an email server(s) which were previously specified on Section 2 Setup Relay Domains of this guide above, The system will ONLY allow you to add recipients with domains that were specified under Section 2 Setup Relay Domains of this guidesection above.

      This method will allow you to add Internal Recipients manually one by one using the Hermes SEG Administratior console. If you have a need to bulk import users, this can be easily accomplished on a SSH/Console prompt utilizing our bulk recipient import and delete script. 

      Hermes SEG also supports automatic import of recipients via AD/LDAP but that feature is only available with a Hermes SEG Pro License. If you have a SEG Pro License and you wish to utilize AD/LDAP Recipient import, please see Section 7 Add Internal Recipients Automatically with AD/LDAP Directory of this guide below.

        • From the Hermes SEG Administrator Console, navigate to Gateway --> Internal Recipients

        • UnderClick the ManuallyCreate Recipient(s) button (Figure 11):

        Figure 11

        image-1638454933344.png

        In the Add Internal RecipientRecipient(s) section, enter a valid email addresspage, in the InternalRecipient(s) Recipientfield, E-enter an e-mail Addressaddress each in each own line, select the appropriate options in the SVF Policy to Assign, Quarantine Reports, Quarantine Report Frequency, Train Bayes Filter from User Portal, Download Messages from User Portal, PDF encryption, S/MIME Encryption, S/MIME SIGNATURE, PGP Encryption fielddrop-downs and click the AddSubmit button. Add as many email addresses as necessary. As you add Internal Recipients, you will notice that each email address is populating the Internal Recipients to be added sectionbutton (Figure 1612).:

      Figure 1612

      1. Once you have finished adding all the Internal Recipients, click on the Apply Settings button on the bottom of the page in order to apply your changes (Figure 17)

      Figure 17image-1638455551356.png

       

      Add Internal Recipients Automatically with AD

      Hermes SEG requires a listing of Internal Recipients in order to process incoming email and deliver that email to the correct recipient mailboxes which are located on an email server(s) which were previously specified on Section 2 Setup Relay Domains of this guide above, The system will ONLY allow you to add recipients with domains that were specified under Section 2 Setup Relay Domains of this guide above.

      This method will allow you to add Internal Recipients automatically via an AD connection. Please note, this feature is ONLY available if you have a Hermes SEG Pro License.

      In order to import Internal Recipients via AD, you must first create an AD connection. In order to create an AD connection, you must first validate the connection and once succesful, you will be able to save the connection.

      Validate & Save AD Connection

      1. From the Hermes SEG Administrator Console, navigate to System --> AD Integration

      2. Under the Connection Mode section, you will notice that ONLY the Validate Connection is enabled and selected. The Save Connection option is not available because the connection has not been validated yet

      3. Under the Connection Name field, enter a descriptive name for the connection

      4. Under the Domain Controller field, enter the IP or the FQDN of a domain controller or simply enter the FQDN of your domain so you don't bind the connection to just one domain controller

      5. Under the Object Class field, select the Active Directory Object class you wish to query

      6. Under the Distinguished Name field, enter the DN of the recipients locations, or you can simply enter the DN of the entire domain. For example, if your domain is east.domain.tld, your DN should be DC=east, DC=domain, DC=tld. Ask your Administrator if you have any questions

      7. Under the Netbios Domain Name enter your domain Netbios name. For example, if your domain is east.domain.tld, your netbios domain could simply be DOMAIN. Ask your Administrator if you have any questions

      8. Under the Username field enter a username that has access to enumerating user objects in your domain

      9. Under the Password field, enter the password for the username from Step 7

      10. If you wish to schedule the automatic import of Internal Recipients on a specified interval, ensure you check the Schedule SMTP Address Import checkbox and select the interval form the drop-down box and click the Submit button (Figure 18)

      Figure 18

      1. If the AD connection validation is succesful, the system will then enable the Save Connection option under the Connection Mode section. If not, please check the provided information and try again.

      2. Once the Save Connection option is enabled under the Connection Mode section, select it and then click the Submit button again to save the connection (Figure 19)

      Figure 19

      1. The connection you just added will now show up under the Delete Existing AD Connection(s) section. You can add as many AD connections as required (Figure 20)

      Figure 20

      Automatically Import Internal Recipients via AD Connection

      1. From the Hermes SEG Administrator Console, navigate to Gateway --> Internal Recipients

      2. Since you have added an AD connection from the previous steps, the Import from Active Directory option under the Add Internal Recipients section will now be enabled. Selecting the Import from Active Directory option will automatically populate the Import Internal Recipients from Active Directory drop-down with the Active Directory connection(s) you previously added. Ensure the correct connection is selected from the drop-down and click the Import button.

      3. The Internal Recipients to be added section, will automatically be populated with SMTP address(es) from Active Directory (Figure 21)

      Figure 21

      1. Finally, click on the Apply Settings button on the bottom of the page to import all the recipients into your Hermes SEG (Figure 22)

      Figure 22

      Set Encryption Settings

      1. From the Hermes SEG Administrator Console, navigate to Encryption --> Encryption Settings.

      2. Fill in Encryption by e-mail subject keyword field or leave it set to default [encrypt].

      3. Select whether you wish to Remove the e-mail subject keyword after encryption or leave it to default Yes.

      4. Fill in the Secure Portal Address. The address should be the Internet accessible FQDN of the Hermes SEG system on port 9080 followed by /web/portal/. Ex: https://hermes.domain.tld:9080/web/portal/

      5. Fill in the PDF Reply Sender E-mail field. This must be an email address with a domain that Hermes SEG relays email. Ex: postmaster@domain.tld

      6. Click the button for the Server, Client and Mail Secret Keyword fields to generate random keywords, or set your own 10-character minimum uppler/lower case letter/number keywords.

      7. Click on the Save Settings button (Figure 23).

      Figure 23

      Change the Hermes SEG Administrator Console admin Account Password

      1. From the Hermes SEG Administrator Console, navigate to System --> Change Password

      2. In the Existing Password field, enter the default password of ChangeMe2!

      3. In the New Password field enter the new password. Passwords must be at least 8 characters long, they must contain letters, numbers and special characters.

      4. In the Verify New Password field, repeat the new password you entered and click on the Change Password button (Figure 24)

      Figure 24

      Change the Ciphermail Web GUI admin Account Password

      1. With your web browser navigate to https://:9080/ciphermail where is the IP of your machine and login with the following default credentials (Figure 25):

      Username: admin Password: admin

      Figure 25

      1. Once logged in, click on the Admin entry on the top menu and on the Administrators page, click on the admin username (Figure 26).

      Figure 26

      1. In the Edit Administrator: admin page, enter a new password in the first Password field and then verify it in the second Password field and then click on the Apply button at the bottom of the page (Figure 27). Passwords must be at least 8 characters long, they must contain letters, numbers and special characters.

      Figure 27

      1. Logout of the Ciphermail Web GUI by clicking on the Logout button on the left of the page (Figure 28).

      Figure 28

      Recommendations

      Add Barracuda and Zen Spamhaus RBLs

      1. In order to use the Barracuda RBL you must first register for a free account. Goto http://www.barracudacentral.org/rbl and register for a free account.

      2. From the Hermes SEG Administrator Console, navigate to Content Checks --> RBL Configuration

      3. Under the Select the type of entry section, ensure Block List is selected. Under the Block List field enter b.barracudacentral.org, under the Weight field enter 3 and then click the Add button.

      4. Repeat Step 3 to add zen.spamhaus.org with a weight of 3 also (Figure 29)

      Figure 29

      1. Finally, click on the Apply Settings button on the bottom of the page to apply the RBL changes (Figure 30)

      Figure 30

      Back to top