2019-06-07 14:33:31 +00:00
|
|
|
---
|
|
|
|
type: concepts, reference, howto
|
|
|
|
---
|
2019-07-16 07:02:20 +00:00
|
|
|
|
2016-03-10 19:48:29 +00:00
|
|
|
# Webhooks and insecure internal web services
|
2015-02-07 00:17:23 +00:00
|
|
|
|
2020-02-28 00:09:08 +00:00
|
|
|
NOTE: **Note:**
|
2020-08-12 15:10:02 +00:00
|
|
|
On GitLab.com, the [maximum number of webhooks and their size](../user/gitlab_com/index.md#webhooks) per project, and per group, is limited.
|
2020-02-28 00:09:08 +00:00
|
|
|
|
2019-06-07 14:33:31 +00:00
|
|
|
If you have non-GitLab web services running on your GitLab server or within its
|
|
|
|
local network, these may be vulnerable to exploitation via Webhooks.
|
2015-02-07 00:17:23 +00:00
|
|
|
|
2019-06-07 14:33:31 +00:00
|
|
|
With [Webhooks](../user/project/integrations/webhooks.md), you and your project
|
2019-06-07 19:27:48 +00:00
|
|
|
maintainers and owners can set up URLs to be triggered when specific changes
|
2019-10-23 09:06:03 +00:00
|
|
|
occur in your projects. Normally, these requests are sent to external web
|
|
|
|
services specifically set up for this purpose, that process the request and its
|
|
|
|
attached data in some appropriate way.
|
2015-02-07 00:17:23 +00:00
|
|
|
|
2019-06-07 14:33:31 +00:00
|
|
|
Things get hairy, however, when a Webhook is set up with a URL that doesn't
|
|
|
|
point to an external, but to an internal service, that may do something
|
|
|
|
completely unintended when the webhook is triggered and the POST request is
|
|
|
|
sent.
|
2015-02-07 00:17:23 +00:00
|
|
|
|
2019-10-23 09:06:03 +00:00
|
|
|
Webhook requests are made by the GitLab server itself and use a single
|
|
|
|
(optional) secret token per hook for authorization (instead of a user or
|
|
|
|
repo-specific token). As a result, these may have broader access than
|
|
|
|
intended to everything running on the server hosting the webhook (which
|
|
|
|
may include the GitLab server or API itself, e.g., `http://localhost:123`).
|
|
|
|
Depending on the called webhook, this may also result in network access
|
|
|
|
to other servers within that webhook server's local network (e.g.,
|
|
|
|
`http://192.168.1.12:345`), even if these services are otherwise protected
|
|
|
|
and inaccessible from the outside world.
|
2015-02-07 00:17:23 +00:00
|
|
|
|
2019-06-07 14:33:31 +00:00
|
|
|
If a web service does not require authentication, Webhooks can be used to
|
|
|
|
trigger destructive commands by getting the GitLab server to make POST requests
|
|
|
|
to endpoints like `http://localhost:123/some-resource/delete`.
|
2015-02-07 00:17:23 +00:00
|
|
|
|
2019-06-07 14:33:31 +00:00
|
|
|
To prevent this type of exploitation from happening, starting with GitLab 10.6,
|
|
|
|
all Webhook requests to the current GitLab instance server address and/or in a
|
|
|
|
private network will be forbidden by default. That means that all requests made
|
2020-01-07 18:07:34 +00:00
|
|
|
to `127.0.0.1`, `::1` and `0.0.0.0`, as well as IPv4 `10.0.0.0/8`, `172.16.0.0/12`,
|
|
|
|
`192.168.0.0/16` and IPv6 site-local (`ffc0::/10`) addresses won't be allowed.
|
2018-04-24 10:21:50 +00:00
|
|
|
|
2019-06-07 14:33:31 +00:00
|
|
|
This behavior can be overridden by enabling the option *"Allow requests to the
|
2019-07-26 13:03:06 +00:00
|
|
|
local network from web hooks and services"* in the *"Outbound requests"* section
|
2020-01-09 00:07:40 +00:00
|
|
|
inside the **Admin Area > Settings** (`/admin/application_settings/network`):
|
2018-04-24 10:21:50 +00:00
|
|
|
|
2019-07-30 10:53:23 +00:00
|
|
|
![Outbound requests admin settings](img/outbound_requests_section_v12_2.png)
|
2018-04-24 10:21:50 +00:00
|
|
|
|
2019-07-30 10:53:23 +00:00
|
|
|
NOTE: **Note:**
|
|
|
|
*System hooks* are enabled to make requests to local network by default since they are
|
|
|
|
set up by administrators. However, you can turn this off by disabling the
|
|
|
|
**Allow requests to the local network from system hooks** option.
|
2019-06-07 14:33:31 +00:00
|
|
|
|
2020-06-05 18:08:19 +00:00
|
|
|
## Allowlist for local requests
|
2019-08-08 16:54:52 +00:00
|
|
|
|
2020-05-21 03:08:00 +00:00
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/44496) in GitLab 12.2
|
2019-08-08 16:54:52 +00:00
|
|
|
|
|
|
|
You can allow certain domains and IP addresses to be accessible to both *system hooks*
|
|
|
|
and *webhooks* even when local requests are not allowed by adding them to the
|
2020-06-05 18:08:19 +00:00
|
|
|
allowlist. Navigate to **Admin Area > Settings > Network** (`/admin/application_settings/network`)
|
2019-08-08 16:54:52 +00:00
|
|
|
and expand **Outbound requests**:
|
|
|
|
|
2020-06-05 18:08:19 +00:00
|
|
|
![Outbound local requests allowlist](img/allowlist_v13_0.png)
|
2019-08-08 16:54:52 +00:00
|
|
|
|
2020-06-05 18:08:19 +00:00
|
|
|
The allowed entries can be separated by semicolons, commas or whitespaces
|
2019-08-08 16:54:52 +00:00
|
|
|
(including newlines) and be in different formats like hostnames, IP addresses and/or
|
2020-06-12 03:08:22 +00:00
|
|
|
IP ranges. IPv6 is supported. Hostnames that contain Unicode characters should
|
2019-08-08 16:54:52 +00:00
|
|
|
use IDNA encoding.
|
|
|
|
|
2020-06-05 18:08:19 +00:00
|
|
|
The allowlist can hold a maximum of 1000 entries. Each entry can be a maximum of
|
2019-08-08 16:54:52 +00:00
|
|
|
255 characters.
|
|
|
|
|
2020-06-05 18:08:19 +00:00
|
|
|
You can allow a particular port by specifying it in the allowlist entry.
|
2020-03-16 03:09:14 +00:00
|
|
|
For example `127.0.0.1:8080` will only allow connections to port 8080 on `127.0.0.1`.
|
2020-06-05 18:08:19 +00:00
|
|
|
If no port is mentioned, all ports on that IP/domain are allowed. An IP range
|
|
|
|
will allow all ports on all IPs in that range.
|
2020-03-16 03:09:14 +00:00
|
|
|
|
2019-08-08 16:54:52 +00:00
|
|
|
Example:
|
|
|
|
|
2020-05-20 03:08:04 +00:00
|
|
|
```plaintext
|
2019-08-08 16:54:52 +00:00
|
|
|
example.com;gitlab.example.com
|
|
|
|
127.0.0.1,1:0:0:0:0:0:0:1
|
|
|
|
127.0.0.0/8 1:0:0:0:0:0:0:0/124
|
2020-03-16 03:09:14 +00:00
|
|
|
[1:0:0:0:0:0:0:1]:8080
|
|
|
|
127.0.0.1:8080
|
|
|
|
example.com:8080
|
2019-08-08 16:54:52 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
NOTE: **Note:**
|
2020-03-16 03:09:14 +00:00
|
|
|
Wildcards (`*.example.com`) are not currently supported.
|
2019-08-08 16:54:52 +00:00
|
|
|
|
2019-06-07 14:33:31 +00:00
|
|
|
<!-- ## Troubleshooting
|
|
|
|
|
|
|
|
Include any troubleshooting steps that you can foresee. If you know beforehand what issues
|
|
|
|
one might have when setting this up, or when something is changed, or on upgrading, it's
|
|
|
|
important to describe those, too. Think of things that may go wrong and include them here.
|
|
|
|
This is important to minimize requests for support, and to avoid doc comments with
|
|
|
|
questions that you know someone might ask.
|
|
|
|
|
|
|
|
Each scenario can be a third-level heading, e.g. `### Getting error message X`.
|
|
|
|
If you have none to add when creating a doc, leave this section in place
|
|
|
|
but commented out to help encourage others to add to it in the future. -->
|