debian-mirror-gitlab/doc/integration/akismet.md
2021-02-22 17:27:13 +05:30

1.9 KiB

stage group info
Create Ecosystem 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

Akismet

GitLab leverages Akismet to protect against spam. GitLab uses Akismet to prevent the creation of spam issues on public projects. Issues created through the web UI or the API can be submitted to Akismet for review.

Detected spam is rejected, and an entry is added in the Spam Log section of the Admin page.

Privacy note: GitLab submits the user's IP and user agent to Akismet.

NOTE: 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.

Configuration

To use Akismet:

  1. Go to the Akismet sign-in page.
  2. Sign in or create a new account.
  3. Click Show to reveal the API key.
  4. Go to Admin Area > Settings > Reporting (/admin/application_settings/reporting).
  5. Select the Enable Akismet checkbox.
  6. Fill in the API key from step 3.
  7. Save the configuration.

Screenshot of Akismet settings

Training

To better differentiate between spam and ham, you can train the Akismet filter whenever there is a false positive or false negative.

When an entry is recognized as spam, it is rejected and added to the Spam Logs. From here you can review if entries are really spam. If one of them is not really spam, you can use the Submit as ham button to tell Akismet that it falsely recognized an entry as spam.

Screenshot of Spam Logs

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.

Screenshot of Issue

Training Akismet helps it to recognize spam more accurately in the future.