Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
1
Merge Requests
1
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
nexedi
gitlab-ce
Commits
6c45a770
Commit
6c45a770
authored
Jun 29, 2020
by
John Long
Committed by
Marcin Sedlak-Jakubowski
Jun 29, 2020
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add note suggesting best practice for address used
parent
4a8e1e7a
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
15 additions
and
0 deletions
+15
-0
doc/administration/incoming_email.md
doc/administration/incoming_email.md
+15
-0
No files found.
doc/administration/incoming_email.md
View file @
6c45a770
...
@@ -21,6 +21,11 @@ GitLab has several features based on receiving incoming emails:
...
@@ -21,6 +21,11 @@ GitLab has several features based on receiving incoming emails:
## Requirements
## Requirements
NOTE:
**Note:**
It is
**not**
recommended to use an email address that receives or will receive any
messages not intended for the GitLab instance. Any incoming emails not intended
for GitLab will receive a reject notice.
Handling incoming emails requires an
[
IMAP
](
https://en.wikipedia.org/wiki/Internet_Message_Access_Protocol
)
-enabled
Handling incoming emails requires an
[
IMAP
](
https://en.wikipedia.org/wiki/Internet_Message_Access_Protocol
)
-enabled
email account. GitLab requires one of the following three strategies:
email account. GitLab requires one of the following three strategies:
...
@@ -106,6 +111,16 @@ Alternatively, use a dedicated domain for GitLab email communications such as
...
@@ -106,6 +111,16 @@ Alternatively, use a dedicated domain for GitLab email communications such as
See GitLab issue
[
#30366
](
https://gitlab.com/gitlab-org/gitlab-foss/-/issues/30366
)
See GitLab issue
[
#30366
](
https://gitlab.com/gitlab-org/gitlab-foss/-/issues/30366
)
for a real-world example of this exploit.
for a real-world example of this exploit.
CAUTION:
**Caution:**
Be sure to use a mail server that has been configured to reduce
spam.
A Postfix mail server that is running on a default configuration, for example,
can result in abuse. All messages received on the configured mailbox will be processed
and messages that are not intended for the GitLab instance will receive a reject notice.
If the sender's address is spoofed, the reject notice will be delivered to the spoofed
`FROM`
address, which can cause the mail server's IP or domain to appear on a block
list.
### Omnibus package installations
### Omnibus package installations
1.
Find the
`incoming_email`
section in
`/etc/gitlab/gitlab.rb`
, enable the feature
1.
Find the
`incoming_email`
section in
`/etc/gitlab/gitlab.rb`
, enable the feature
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment