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
dda308d1
Commit
dda308d1
authored
Feb 11, 2021
by
Viji Rao
Committed by
Suzanne Selhorn
Feb 11, 2021
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add clarification on internal email visibility
parent
4ab1e2c3
Changes
2
Show whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
30 additions
and
24 deletions
+30
-24
doc/user/project/img/service_desk_nav_item.png
doc/user/project/img/service_desk_nav_item.png
+0
-0
doc/user/project/service_desk.md
doc/user/project/service_desk.md
+30
-24
No files found.
doc/user/project/img/service_desk_nav_item.png
deleted
100644 → 0
View file @
4ab1e2c3
5.04 KB
doc/user/project/service_desk.md
View file @
dda308d1
...
@@ -6,7 +6,7 @@ info: To determine the technical writer assigned to the Stage/Group associated w
...
@@ -6,7 +6,7 @@ info: To determine the technical writer assigned to the Stage/Group associated w
# Service Desk **(FREE)**
# Service Desk **(FREE)**
>
-
Moved to GitLab Free in 13.2.
> Moved to GitLab Free in 13.2.
Service Desk is a module that allows your team to connect
Service Desk is a module that allows your team to connect
with any external party through email, without any external tools.
with any external party through email, without any external tools.
...
@@ -54,36 +54,41 @@ Here's how Service Desk works for you:
...
@@ -54,36 +54,41 @@ Here's how Service Desk works for you:
## Configuring Service Desk
## Configuring Service Desk
NOTE:
Users with Maintainer and higher access in a project can configure Service Desk.
Service Desk is enabled on GitLab.com.
You can skip step 1 below; you only need to enable it per project.
Service Desk issues are
[
confidential
](
issues/confidential_issues.md
)
, so they are
only visible to project members. In GitLab 11.7 we updated the generated email
address format. The older format is still supported, so existing aliases or
contacts still work.
If you have project maintainer access you have the option to set up Service Desk. Follow these steps:
If you have
[
templates
](
description_templates.md
)
in your repository, you can optionally select
one from the selector menu to append it to all Service Desk issues.
1.
[
Set up incoming email
](
../../administration/incoming_email.md#set-it-up
)
for the GitLab instance.
To enable Service Desk in your project:
1.
(GitLab self-managed only)
[
Set up incoming email
](
../../administration/incoming_email.md#set-it-up
)
for the GitLab instance.
We recommend using
[
email sub-addressing
](
../../administration/incoming_email.md#email-sub-addressing
)
,
We recommend using
[
email sub-addressing
](
../../administration/incoming_email.md#email-sub-addressing
)
,
but
in GitLab 11.7 and later
you can also use
[
catch-all mailboxes
](
../../administration/incoming_email.md#catch-all-mailbox
)
.
but you can also use
[
catch-all mailboxes
](
../../administration/incoming_email.md#catch-all-mailbox
)
.
1.
Navigate to your project's
**Settings > General**
and locate
the
**Service Desk**
section.
1.
In a project, in the left sidebar, go to
**Settings > General**
and expand
the
**Service Desk**
section.
1.
Enable the
**Activate Service Desk**
toggle. This reveals a unique email address to email issues
1.
Enable the
**Activate Service Desk**
toggle. This reveals a unique email address to email issues
to the project.
These issues are
[
confidential
](
issues/confidential_issues.md
)
, so they are
to the project.
only visible to project members. Note that in GitLab 11.7, we updated the generated email
address's format. The older format is still supported, however, allowing existing aliases or
Service Desk is now enabled for this project! To access it in a project, in the left sidebar, select
contacts to continue working
.
**Issues > Service Desk**
.
WARNING:
WARNING:
This email address can be used by anyone to create an issue on this project, regardless
Anyone in your project can use the Service Desk email address to create an issue in this project,
**
regardless
of their access level to your GitLab instance. We recommend
**putting this behind an alias on your email system**
so it can be
of their access level
**
to your GitLab instance.
changed if needed. We also recommend
**[enabling Akismet](../../integration/akismet.md)**
on your GitLab
instance to add spam checking to this service. Unblocked email spam would result in many spam
issues being created.
If you have
[
templates
](
description_templates.md
)
in your repository, you can optionally select
To improve your project's security, we recommend the following:
one from the selector menu to append it to all Service Desk issues.
Service Desk is now enabled for this project! You should be able to access it from your project's
-
Put the Service Desk email address behind an alias on your email system so you can change it later.
**Issues**
menu.
-
[
Enable Akismet
](
../../integration/akismet.md
)
on your GitLab instance to add spam checking to this service.
Unblocked email spam can result in many spam issues being created.
![
Service Desk Navigation Item
](
img/service_desk_nav_item.png
)
The unique internal email address is visible to all project members in your GitLab instance.
However, when using an email alias externally, an end user (issue creator) cannot see the internal
email address displayed in the information note.
### Using customized email templates
### Using customized email templates
...
@@ -232,7 +237,8 @@ The configuration options are the same as for configuring
...
@@ -232,7 +237,8 @@ The configuration options are the same as for configuring
## Using Service Desk
## Using Service Desk
There are a few ways Service Desk can be used.
You can use Service Desk to
[
create an issue
](
#as-an-end-user-issue-creator
)
or
[
respond to one
](
#as-a-responder-to-the-issue
)
.
In these issues, you can also see our friendly neighborhood
[
Support Bot
](
#support-bot-user
)
.
### As an end user (issue creator)
### As an end user (issue creator)
...
...
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