debian-mirror-gitlab/doc/integration/akismet.md

55 lines
2 KiB
Markdown
Raw Normal View History

2021-01-29 00:20:46 +05:30
---
2021-02-22 17:27:13 +05:30
stage: Create
group: Ecosystem
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2021-01-29 00:20:46 +05:30
---
2021-04-17 20:07:23 +05:30
# Akismet **(FREE)**
2016-04-02 18:10:28 +05:30
2021-01-29 00:20:46 +05:30
GitLab leverages [Akismet](https://akismet.com/) to protect against spam.
2016-09-13 17:45:13 +05:30
GitLab uses Akismet to prevent the creation of spam issues on public projects. Issues
2021-01-29 00:20:46 +05:30
created through the web UI or the API can be submitted to Akismet for review.
2016-09-13 17:45:13 +05:30
2021-01-29 00:20:46 +05:30
Detected spam is rejected, and an entry is added in the **Spam Log** section of the
Admin page.
2016-04-02 18:10:28 +05:30
2020-06-23 00:09:42 +05:30
Privacy note: GitLab submits the user's IP and user agent to Akismet.
2021-02-22 17:27:13 +05:30
NOTE:
2020-06-23 00:09:42 +05:30
In GitLab 8.11 and later, all issues are submitted to Akismet.
In earlier GitLab versions, this only applied to API and non-project members.
2016-04-02 18:10:28 +05:30
## Configuration
To use Akismet:
2021-01-29 00:20:46 +05:30
1. Go to the [Akismet sign-in page](https://akismet.com/account/).
1. Sign in or create a new account.
1. Click **Show** to reveal the API key.
2020-01-01 13:55:28 +05:30
1. Go to **Admin Area > Settings > Reporting** (`/admin/application_settings/reporting`).
2021-01-29 00:20:46 +05:30
1. Select the **Enable Akismet** checkbox.
2019-02-15 15:39:39 +05:30
1. Fill in the API key from step 3.
1. Save the configuration.
2016-04-02 18:10:28 +05:30
![Screenshot of Akismet settings](img/akismet_settings.png)
2016-09-13 17:45:13 +05:30
## Training
2021-01-29 00:20:46 +05:30
To better differentiate between spam and ham, you can train the Akismet
2016-09-13 17:45:13 +05:30
filter whenever there is a false positive or false negative.
2019-02-15 15:39:39 +05:30
When an entry is recognized as spam, it is rejected and added to the Spam Logs.
2021-01-29 00:20:46 +05:30
From here you can review if entries are really spam. If one of them is not really
2019-02-15 15:39:39 +05:30
spam, you can use the **Submit as ham** button to tell Akismet that it falsely
2016-09-13 17:45:13 +05:30
recognized an entry as spam.
![Screenshot of Spam Logs](img/spam_log.png)
2021-01-29 00:20:46 +05:30
If an entry that is actually spam was not recognized as such, you can also submit
this information to Akismet. The **Submit as spam** button is only displayed
to administrator users.
2016-09-13 17:45:13 +05:30
![Screenshot of Issue](img/submit_issue.png)
2021-01-29 00:20:46 +05:30
Training Akismet helps it to recognize spam more accurately in the future.