How To: Use a Mail Relay for Password Reset Emails

For security, InterWorx does not send password reset emails through the typical outbound email relays. In an environment where system administrators only allow messages from a specific relay or relays, this could mean that password reset emails may not arrive. In this rare occasion, it is possible for system administrators to set the relay that will be used for sending password reset emails.

To Configure a Mail Relay for Password Reset Emails

  1. Log in to the server at the CLI as root, either via SSH or from the terminal

  2. At the CLI, using a text editor, open ~iworx/iworx.ini. The following example uses the Vim text editor:

    vim ~iworx/iworx.ini

  3. In edit mode, add the following to the end of the file, replacing relayserveraddress.tld with the corresponding information:

    [lostpass]
relay="relayserveraddress.tld"

  4. If the relay requires SMTP authentication, add all of the following fields just below relay, replacing smtp_user_name, yourpassword, and login with the corresponding information. Authentication style settings are provided the third-party email relay service.:

    username="smtp_user_name"
password="yourpassword"
connection_class="login"

    connection_class should be set to one of the following options:

    • plain

    • login

    • crammd5

    These options are explained in greater detail here.

    Warning

    If any of the three fields above are missing, InterWorx will not attempt to use any credentials when accessing the relay.

  5. Save and exit the file