-
-
Notifications
You must be signed in to change notification settings - Fork 5.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add warning to mailer documentation about authentication (#11563)
* Add warning to mailer documentation about authentication References #7966 Signed-off-by: Andrew Thornton <[email protected]> * As per @guillep2k and @mrsdizzie * as per @mrsdizzie Signed-off-by: Andrew Thornton <[email protected]> Co-authored-by: guillep2k <[email protected]>
- Loading branch information
Showing
3 changed files
with
16 additions
and
3 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -627,7 +627,8 @@ SUBJECT_PREFIX = | |
; Mail server | ||
; Gmail: smtp.gmail.com:587 | ||
; QQ: smtp.qq.com:465 | ||
; Note, if the port ends with "465", SMTPS will be used. Using STARTTLS on port 587 is recommended per RFC 6409. If the server supports STARTTLS it will always be used. | ||
; Using STARTTLS on port 587 is recommended per RFC 6409. | ||
; Note, if the port ends with "465", SMTPS will be used. | ||
HOST = | ||
; Disable HELO operation when hostnames are different. | ||
DISABLE_HELO = | ||
|
@@ -639,11 +640,13 @@ SKIP_VERIFY = | |
USE_CERTIFICATE = false | ||
CERT_FILE = custom/mailer/cert.pem | ||
KEY_FILE = custom/mailer/key.pem | ||
; Should SMTP connection use TLS | ||
; Should SMTP connect with TLS, (if port ends with 465 TLS will always be used.) | ||
; If this is false but STARTTLS is supported the connection will be upgraded to TLS opportunistically. | ||
IS_TLS_ENABLED = false | ||
; Mail from address, RFC 5322. This can be just an email address, or the `"Name" <[email protected]>` format | ||
FROM = | ||
; Mailer user name and password | ||
; Please Note: Authentication is only supported when the SMTP server communication is encrypted with TLS (this can be via STARTTLS) or `HOST=localhost`. | ||
USER = | ||
; Use PASSWD = `your password` for quoting if you use special characters in the password. | ||
PASSWD = | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -397,10 +397,15 @@ set name for unique queues. Individual queues will default to | |
- `DISABLE_HELO`: **\<empty\>**: Disable HELO operation. | ||
- `HELO_HOSTNAME`: **\<empty\>**: Custom hostname for HELO operation. | ||
- `HOST`: **\<empty\>**: SMTP mail host address and port (example: smtp.gitea.io:587). | ||
- Using opportunistic TLS via STARTTLS on port 587 is recommended per RFC 6409. | ||
- `IS_TLS_ENABLED` : **false** : Forcibly use TLS to connect even if not on a default SMTPS port. | ||
- Note, if the port ends with `465` SMTPS/SMTP over TLS will be used despite this setting. | ||
- Otherwise if `IS_TLS_ENABLED=false` and the server supports `STARTTLS` this will be used. Thus if `STARTTLS` is preferred you should set `IS_TLS_ENABLED=false`. | ||
- `FROM`: **\<empty\>**: Mail from address, RFC 5322. This can be just an email address, or | ||
the "Name" \<[email protected]\> format. | ||
- `USER`: **\<empty\>**: Username of mailing user (usually the sender's e-mail address). | ||
- `PASSWD`: **\<empty\>**: Password of mailing user. Use \`your password\` for quoting if you use special characters in the password. | ||
- Please note: authentication is only supported when the SMTP server communication is encrypted with TLS (this can be via `STARTTLS`) or `HOST=localhost`. See [Email Setup]({{< relref "doc/usage/email-setup.en-us.md" >}}) for more information. | ||
- `SKIP_VERIFY`: **\<empty\>**: Do not verify the self-signed certificates. | ||
- **Note:** Gitea only supports SMTP with STARTTLS. | ||
- `SUBJECT_PREFIX`: **\<empty\>**: Prefix to be placed before e-mail subject lines. | ||
|
@@ -415,7 +420,6 @@ set name for unique queues. Individual queues will default to | |
- `SENDMAIL_PATH`: **sendmail**: The location of sendmail on the operating system (can be | ||
command or full path). | ||
- `SENDMAIL_TIMEOUT`: **5m**: default timeout for sending email through sendmail | ||
- ``IS_TLS_ENABLED`` : **false** : Decide if SMTP connections should use TLS. | ||
|
||
## Cache (`cache`) | ||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters