Files
WeKnora/docreader/tests/test_ssrf.py
T
lyingbug 1030832c4b fix(security): harden outbound URL SSRF protection (#2626)
* fix(security): harden outbound URL SSRF protection

* test(security): add SSRF validation tests for outbound URL caching

Introduce tests for outbound SSRF validation cache to ensure proper handling of URL validation, including cache reuse for the same origin, cache invalidation on whitelist changes, and expiration of cached entries. This enhances the robustness of SSRF protection mechanisms in the application.

* refactor: clean up whitespace in engine_factory.go and ssrf_outbound_cache.go

Removed unnecessary blank lines in engine_factory.go and adjusted variable declarations for consistency in ssrf_outbound_cache.go. This improves code readability without altering functionality.
2026-08-10 13:24:14 +08:00

62 lines
2.0 KiB
Python

import ipaddress
import os
import unittest
from unittest.mock import patch
from docreader.utils.ssrf import is_ssrf_safe_url, reset_ssrf_whitelist_cache_for_test
class TestSSRFValidation(unittest.TestCase):
def setUp(self) -> None:
self._env_patch = patch.dict(
os.environ,
{"SSRF_WHITELIST": "", "SSRF_WHITELIST_EXTRA": ""},
clear=False,
)
self._env_patch.start()
reset_ssrf_whitelist_cache_for_test()
def tearDown(self) -> None:
self._env_patch.stop()
reset_ssrf_whitelist_cache_for_test()
def test_blocks_loopback_ip(self):
safe, reason = is_ssrf_safe_url("http://127.0.0.1:8080/page")
self.assertFalse(safe)
self.assertTrue(reason)
def test_blocks_restricted_hostname(self):
safe, reason = is_ssrf_safe_url("http://host.docker.internal/secret")
self.assertFalse(safe)
self.assertIn("restricted", reason)
def test_blocks_metadata_host(self):
safe, reason = is_ssrf_safe_url(
"http://169.254.169.254/latest/meta-data/iam/security-credentials/"
)
self.assertFalse(safe)
self.assertTrue(reason)
def test_blocks_invalid_port(self):
safe, reason = is_ssrf_safe_url("https://example.com:99999/path")
self.assertFalse(safe)
self.assertIn("invalid port", reason)
def test_blocks_ipv4_mapped_private_ipv6_resolution(self):
with patch(
"docreader.utils.ssrf._resolve_host_ips",
return_value=((ipaddress.ip_address("::ffff:127.0.0.1"),), None),
):
safe, reason = is_ssrf_safe_url("https://example.invalid/path")
self.assertFalse(safe)
self.assertIn("restricted", reason)
def test_allows_public_https(self):
safe, reason = is_ssrf_safe_url("https://example.com/article")
self.assertTrue(safe, reason)
self.assertEqual(reason, "")
if __name__ == "__main__":
unittest.main()