Configure a mail service for user invitations
editConfigure a mail service for user invitations
editSupported authentication mode: standard only. Read more about authentication strategies in the Users and access.
To send user invitations and password resets from Workplace Search when using standard authentication, you must configure an SMTP mailer along with your deployment.
Mailer configuration is found in the config/enterprise-search.yml
file.
Local Mail Service SMTP Server Configuration
editWhen using Postfix or a similar service, the mailer configuration follows this template:
email.account: enabled: true smtp: auth: plain # Can be plain, login, or CRAM-MD5. starttls.enable: false # Whether emails are sent encapsulated in TLS, or not. host: 127.0.0.1 port: 25 user: mail@example.com password: secure-pass-phrase email_defaults: from: noreply@example.com # The 'from' address is the address from which emails are sent.
Gmail SMTP Server Configuration
editGmail makes for a handy and easy way to set up an SMTP server. There are multiple options: you can use a G Suite organization or a personal account.
Read the Google documentation to get it set up, then provide the values in the configuration file:
email.account: enabled: true smtp: auth: plain starttls.enable: true host: smtp.gmail.com port: 587 user: example@gmail.com password: secure-pass-phrase email_defaults: from: noreply@gmail.com
Outlook SMTP Server Configuration
editFollow the Microsoft Office documentation to learn how to set up Outlook to send mail on Workplace Search’s behalf, and provide the necessary values in the configuration file:
email.account: enabled: true smtp: auth: login starttls.enable: true host: https://smtp-mail.outlook.com port: 587 user: example@outlook.com password: secure-pass-phrase email_defaults: from: noreply@outlook.com