jira/apps/api/plane/app/serializers/webhook.py

# Copyright (c) 2023-present Plane Software, Inc. and contributors
# SPDX-License-Identifier: AGPL-3.0-only
# See the LICENSE file for details.

# Python imports
import logging
from urllib.parse import urlparse

# Third party imports
from rest_framework import serializers

# Django imports
from django.conf import settings

# Module imports
from .base import DynamicBaseSerializer
from plane.db.models import Webhook, WebhookLog
from plane.db.models.webhook import validate_domain, validate_schema
from plane.utils.ip_address import validate_url

logger = logging.getLogger(__name__)


class WebhookSerializer(DynamicBaseSerializer):
    url = serializers.URLField(validators=[validate_schema, validate_domain])

    def _validate_webhook_url(self, url):
        """Validate a webhook URL against SSRF and disallowed domain rules."""
        try:
            validate_url(
                url,
                allowed_ips=settings.WEBHOOK_ALLOWED_IPS,
                allowed_hosts=settings.WEBHOOK_ALLOWED_HOSTS,
            )
        except ValueError as e:
            logger.warning("Webhook URL validation failed for %s: %s", url, e)
            raise serializers.ValidationError({"url": "Invalid or disallowed webhook URL."})

        hostname = (urlparse(url).hostname or "").rstrip(".").lower()

        # Hosts explicitly trusted via WEBHOOK_ALLOWED_HOSTS bypass the
        # disallowed-domain check — they're already trusted for SSRF, so
        # the loop-back guard would only get in the way of legitimate
        # sibling services that share a parent domain with Plane.
        if hostname in settings.WEBHOOK_ALLOWED_HOSTS:
            return

        request = self.context.get("request")
        disallowed_domains = list(settings.WEBHOOK_DISALLOWED_DOMAINS)
        if request:
            request_host = request.get_host().split(":")[0].rstrip(".").lower()
            disallowed_domains.append(request_host)

        if any(hostname == domain or hostname.endswith("." + domain) for domain in disallowed_domains):
            raise serializers.ValidationError({"url": "URL domain or its subdomain is not allowed."})

    def to_representation(self, instance):
        data = super().to_representation(instance)
        # secret_key is the HMAC signing secret. It is only revealed on creation
        # and secret regeneration (opt-in via the show_secret_key context flag),
        # never on list/retrieve/update.
        #
        # This context flag — not the fields= allowlists in views/webhook/base.py —
        # is the sole enforcement point. Those fields= kwargs are dead
        # on two independent levels, so do not assume fixing either one re-activates
        # them:
        #   1. DynamicBaseSerializer.__init__ pops the caller's fields= and then
        #      overwrites it with self.expand (serializers/base.py:16-18), so the
        #      requested allowlist never reaches _filter_fields at all.
        #   2. _filter_fields never *removes* anything even when it does receive a
        #      list — it builds `allowed` purely to add expansion serializers for
        #      names not already present, then returns self.fields unfiltered
        #      (serializers/base.py:45-119).
        # A future one-line `fields = fields or self.expand` fix addresses only (1);
        # (2) still has to be made restrictive before any fields= allowlist can be
        # relied on for confidentiality.
        if not self.context.get("show_secret_key"):
            data.pop("secret_key", None)
        return data

    def create(self, validated_data):
        url = validated_data.get("url", None)
        self._validate_webhook_url(url)
        return Webhook.objects.create(**validated_data)

    def update(self, instance, validated_data):
        url = validated_data.get("url", None)
        if url:
            self._validate_webhook_url(url)
        return super().update(instance, validated_data)

    class Meta:
        model = Webhook
        fields = "__all__"
        read_only_fields = ["workspace", "secret_key", "deleted_at"]


class WebhookLogSerializer(DynamicBaseSerializer):
    class Meta:
        model = WebhookLog
        fields = "__all__"
        read_only_fields = ["workspace", "webhook"]