enroll/tests/test_secret_detection.py
Miguel Jacq 5ffad10665
Some checks failed
Lint / test (push) Waiting to run
CI / test (push) Successful in 55s
CI / test (almalinux, docker.io/library/almalinux:9, python3.11) (push) Successful in 10m49s
CI / test (debian, docker.io/library/debian:13, python3) (push) Has been cancelled
Catch key/value sensitive strings in ignore, where there is no : or = delimiter
2026-07-01 11:04:33 +10:00

285 lines
11 KiB
Python

"""Regression test: safe-mode content sniff must catch URI-embedded credentials
and HTTP Authorization headers, not just assignment-style credential keys."""
from enroll.ignore import IgnorePolicy
def test_uri_embedded_credentials_denied():
pol = IgnorePolicy(dangerous=False)
leaking = [
b"DATABASE_URL=postgresql://admin:S3cr3tPass@db:5432/app\n",
b"REDIS_URL=redis://:mypassword@localhost:6379/0\n",
b"broker_url = amqp://guest:guest@rabbit:5672//\n",
b"uri: mongodb+srv://user:p%40ss@cluster0.mongodb.net\n",
]
for data in leaking:
assert (
pol._content_deny_reason("/etc/svc/app.conf", data) == "sensitive_content"
), data
def test_authorization_headers_denied():
pol = IgnorePolicy(dangerous=False)
for data in [
b"Authorization: Bearer eyJhbGciOiJIUzI1NiIs\n",
b"Authorization: Basic dXNlcjpwYXNzd29yZA==\n",
b"Proxy-Authorization: Bearer xyz\n",
]:
assert (
pol._content_deny_reason("/etc/svc/app.conf", data) == "sensitive_content"
), data
def test_benign_urls_not_false_positive():
pol = IgnorePolicy(dangerous=False)
for data in [
b"homepage = https://example.com/docs\n",
b"server = http://localhost:8080/api\n",
b"origin = git://github.com/u/repo.git\n",
b"bind = http://[::1]:9000/\n",
b"contact = mailto:admin@example.com\n",
b"log_level = info\nworkers = 4\n",
]:
assert pol._content_deny_reason("/etc/svc/app.conf", data) is None, data
def test_bare_word_password_denied():
"""Credential lines using the word password/passphrase/credentials without
an assignment delimiter (netrc, ppp, space/tab separated) must be denied."""
pol = IgnorePolicy(dangerous=False)
for data in [
b"machine api.example.com login bob password s3cret\n",
b"passphrase mysecretphrase\n",
b"credentials /run/creds/db\n",
b"pin 1234\n",
]:
assert (
pol._content_deny_reason("/etc/svc.conf", data) == "sensitive_content"
), data
def test_ppp_secrets_paths_denied():
pol = IgnorePolicy(dangerous=False)
for p in ("/etc/ppp/chap-secrets", "/etc/ppp/pap-secrets", "/etc/ppp/my-secrets"):
assert pol._path_deny_reason(p) == "denied_path", p
def test_short_credential_key_components_denied():
pol = IgnorePolicy(dangerous=False)
for data in [
b"pass = hunter2\n",
b"db_pass = hunter2\n",
b"pass_key = hunter2\n",
b"db-pass: hunter2\n",
b"pin = 1234\n",
b"db_pin = 1234\n",
b"pin-key: 1234\n",
]:
assert (
pol._content_deny_reason("/etc/app.conf", data) == "sensitive_content"
), data
def test_password_keyword_no_false_positives():
pol = IgnorePolicy(dangerous=False)
for data in [
b"passive_mode = true\n",
b"PassengerRoot /usr/lib\n",
b"pinboard = enabled\n",
b"pinot_region = noir\n",
b"description = reset the account\n",
b"compression = gzip\n",
]:
assert pol._content_deny_reason("/etc/app.conf", data) is None, data
def test_pw_abbreviation_credential_key_denied():
"""The ``pw`` abbreviation is an extremely common password key form
(``db_pw``, ``DB_PW``, ``root_pw``). It must be treated like ``pwd``/``pass``
so a real assignment-style credential using ``pw`` is not silently harvested
in default safe mode."""
pol = IgnorePolicy(dangerous=False)
for data in [
b"pw = hunter2\n",
b"db_pw = SuperSecret123\n",
b"DB_PW=hunter2\n",
b"root_pw: aaaa\n",
b"master_pw = topsecret\n",
b"ftp_pw=x\n",
b"mysql_root_pw: x\n",
b"pw_hash = abc\n",
b'"pw": "x"\n',
]:
assert (
pol._content_deny_reason("/etc/app.conf", data) == "sensitive_content"
), data
def test_pw_abbreviation_no_false_positives():
"""Adding the short ``pw`` token must not flag ordinary keys that merely
contain the letters ``pw`` without it being a delimited credential token.
The surrounding token-boundary structure (a keyword must stand alone between
``[_.-]`` delimiters) is what keeps these benign."""
pol = IgnorePolicy(dangerous=False)
for data in [
b"pwned = 1\n",
b"software = x\n",
b"hardware = y\n",
b"firmware: z\n",
b"spwd = z\n",
b"powerline = on\n",
b"wallpaper = img\n",
b"pwm_freq = 1000\n",
b"cpwd_check=1\n",
b"newpwx = 1\n",
]:
assert pol._content_deny_reason("/etc/app.conf", data) is None, data
def test_block_comment_open_cannot_mask_private_key():
"""Security regression: a line beginning with ``/*`` must not put the content
scanner into a runaway block-comment state that hides later real secrets.
Previously, any line starting with ``/*`` suppressed scanning of every
subsequent line until a ``*/`` appeared. An unterminated (or hostile) block
open therefore masked a PEM private key / password in an arbitrary config
file (one not covered by a path deny-glob)."""
pol = IgnorePolicy(dangerous=False)
leaking = [
# leading /* with no closing */ masking a PEM private key
b"/* app config\n"
b"tls_key = -----BEGIN PRIVATE KEY-----\n"
b"MIIBVw...\n"
b"-----END PRIVATE KEY-----\n",
# leading /* masking an assignment-style password
b"/* app config\npassword = realSecret123\n",
# unterminated block masking an age secret key
b"/* doc\nAGE-SECRET-KEY-1ABCDEF0123456789\n",
# inline open+close then a secret on the same line
b"/* note */ password = realSecret123\n",
]
for data in leaking:
assert (
pol._content_deny_reason("/etc/app/app.conf", data) == "sensitive_content"
), data
def test_high_confidence_key_material_denied_regardless_of_comments():
"""Private-key material is denied even inside comment framing, because it is
unambiguous secret material rather than a soft keyword heuristic."""
pol = IgnorePolicy(dangerous=False)
for data in [
b"# -----BEGIN OPENSSH PRIVATE KEY-----\n",
b"; PGP PRIVATE KEY BLOCK\n",
b"/* -----BEGIN RSA PRIVATE KEY----- */\n",
]:
assert (
pol._content_deny_reason("/etc/app/app.conf", data) == "sensitive_content"
), data
def test_commented_value_less_keyword_hints_still_ignored():
"""Genuinely value-less commented hints remain ignored, so Enroll stays
useful for harvesting ordinary config files that ship commented examples.
Only a bare credential *word* with no assigned value is tolerated in a
comment; a populated commented assignment is treated as a real (disabled)
secret -- see test_commented_out_credential_values_require_dangerous."""
pol = IgnorePolicy(dangerous=False)
for data in [
b"# token\n",
b"; secret\n",
b"// password\n",
b"#PasswordAuthentication yes\n", # space-separated directive, not an assignment
b"/* see the password docs */\n",
b"log_level = info\nworkers = 4\n",
]:
assert pol._content_deny_reason("/etc/app/app.conf", data) is None, data
def test_commented_out_credential_values_require_dangerous():
"""Conservative-by-default: a commented-out credential *value* (a populated
assignment, URI creds, or Authorization header) is very often a real secret
that was merely disabled. Such a file is refused in safe mode and requires
--dangerous, regardless of comment style or block-comment framing."""
safe = IgnorePolicy(dangerous=False)
dangerous = IgnorePolicy(dangerous=True)
commented_real_secrets = [
b"# password = realProductionPass\n",
b"; auth_token = abc123secret\n",
b"// client_secret: deadbeef\n",
b"/* password = changeme123 */\n",
b"/*\n api_key = AKIA0123\n*/\nlisten = 8080\n",
b"# DATABASE_URL=postgres://user:pass@host/db\n",
b"# -----BEGIN OPENSSH PRIVATE KEY-----\n",
b"/*\nAuthorization: Bearer eyJabc\n*/\n",
]
for data in commented_real_secrets:
# Refused in safe mode...
assert (
safe._content_deny_reason("/etc/app/app.conf", data) == "sensitive_content"
), data
# ...but --dangerous still collects it (operator's explicit choice).
assert dangerous._content_deny_reason("/etc/app/app.conf", data) is None, data
def test_whitespace_separated_compound_credentials_denied():
"""Security regression (audit finding): a populated credential assignment
that uses whitespace (space/tab) instead of ':'/'=' as the separator must
still be refused in safe mode when the key is a *compound* credential name.
The soft keyword tier cannot catch these because its ``\\b`` boundary is
defeated by the leading underscore in a compound key (e.g. the ``secret`` in
``client_secret`` is preceded by ``_``, a word character), and the
assignment tier only recognised ``:``/``=`` separators. Some real config
styles (.netrc-like files, some daemon configs) use whitespace separators,
so a value such as ``aws_secret_access_key wJalr...`` would previously leak.
"""
safe = IgnorePolicy(dangerous=False)
dangerous = IgnorePolicy(dangerous=True)
leaking = [
b"aws_secret_access_key wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\n",
b"aws_access_key_id AKIAIOSFODNN7EXAMPLE\n",
b"client_secret hunter2deadbeef\n",
b"oauth_token ya29.A0ARrdaReALlOOkINgToKeN\n",
b"refresh_token 1//0longrefreshvalue\n",
b"my_token deadbeef1234\n",
b"app_password s3cr3tValue\n",
b"db_pw s3cr3tvalue\n",
b"private_key /etc/ssl/private/app.pem\n",
b"session_key 0xDEADBEEFCAFE\n",
b"\tapi_key AKIA12345678\n",
]
for data in leaking:
assert (
safe._content_deny_reason("/root/.netrc", data) == "sensitive_content"
), data
# --dangerous remains the explicit opt-in to collect such material.
assert dangerous._content_deny_reason("/root/.netrc", data) is None, data
def test_whitespace_separated_non_credentials_still_allowed():
"""The whitespace-separated credential rule must not false-positive on
ordinary config or PAM directives. It is intentionally restricted to
*compound* credential keys with a value-like token, so standalone words and
common config lines are not affected by it.
(Standalone ``password``/``token``/``secret`` words on a non-comment line
are still caught by the comment-aware soft tier; that is unchanged. The
cases here are ones that must remain collectable: PAM stack directives, SSH
key-file path directives, and plain settings.)
"""
pol = IgnorePolicy(dangerous=False)
allowed = [
# SSH key-file path directives (key material is denied by path globs,
# not by content here).
b"HostKey /etc/ssh/ssh_host_ed25519_key\n",
b"host_key /etc/ssh/known\n",
b"public_key /home/u/.ssh/id_rsa.pub\n",
# Plain numeric / boolean settings.
b"max_connections 1024\n",
b"PermitRootLogin no\n",
b"PasswordAuthentication yes\n",
]
for data in allowed:
assert pol._content_deny_reason("/etc/app/app.conf", data) is None, data