redact-secret · Report

API token

pypi- prefixed base64-encoded macaroon.

Python Package Index (PyPI)
Detectors: pypi-token
Run 2026-10-07
Mode published · redact-secret 0.1.0-beta.14

Dossier verdictReady
Dossier evidence levelT1 · Provider-documented
Dossier researched2026-09-22

New pipelineAuthority

Built from the new pipeline

The new pipeline is the authority for credential qualification. These numbers are read from the qualification view derived from the official credential-eval run of the public-evidence-snapshot population. The regression and policy populations keep their own counts on the qualification pages and are not added in here.

Authority: new
Population: public-evidence-snapshot
Engine: credential-eval 0.1.0-alpha.16
Evidence: snapshot-2026.10.06.4
Run: sha256:4bec6e539482…
Recorded: 2026-10-07
Authorised for: @redact-secret/core@0.1.0-beta.14

Maintainer-reviewed (independent review pending)

598 fixtures of the 7,041 in evidence release snapshot-2026.10.06.4 carry this label. They are counted in the numbers on this page.

Passed the project’s own verification (source evidence, automated checks, recorded counter-arguments); not yet independently reviewed.

OpenRedaction default (all patterns): not measured in this run (optional)

The default (all-pattern) profile is slow and noisy for credential evaluation: personal data and resource identifiers dominate its findings, and its last official measurement took 7 minutes of scanner time on a population the credential profile scans in seconds (its methods run takes 40+ minutes), so it is a manual measurement and never blocks other scanners or core verification (#763). Its earlier results stay as history with their run identity; the credential profile is a separate scanner, never spliced with it.

Last measurement: policy-corpus@linux-x64 (configuration sha256:2451ce7bf380), public-evidence-snapshot+methods@linux-x64 (configuration sha256:d47d081ce5fb), public-evidence-snapshot@linux-x64 (configuration sha256:2451ce7bf380), regression-corpus@linux-x64 (configuration sha256:2451ce7bf380) · engine 0.1.0-alpha.5 · recorded 2026-10-05 · retained record, no longer listed by the run registry. It stays labelled with that run identity and is never combined with another profile or another run.

Open the qualification page for this pointer

OpenRedaction credential profile (33 types): not measured in an official run (local exploratory diagnostics only: see ADR)

The credential profile is the comparison profile chosen in docs/decisions/2026-10-06-choose-the-openredaction-credential-bearing-profile-as-the-comparison-scanner.md. It is optional in the official run class because no pinned engine configuration measures it yet: making it required would refuse every official view until the owner approves the one profile-only run. Its own history starts with that run; nothing of the default's is reused for it.

No earlier measurement of it is recorded. Nothing is shown in its place.

Official measurement: pending: requires owner approval (one profile-only run; see the decision).

Open the qualification page for this pointer

Every population and its qualification

Research record

From credential-evidence snapshot-2026.10.06.4 · records at 77ce761 · schema 1.8.0. It describes the research on the format, not what any scanner or the product does, and not a support status.

Review stateDraft, not reviewed
Format revision1 · current
ResearchResearched
Researched2026-09-22

2 events in the review history: 1 observed, 1 reviewed. Latest: observed on 2026-09-22 by automation, project maintainer. Project-maintained review is not independent validation. The family record at this release.

Format

Provider format research from credential-evidence snapshot-2026.10.06.4 · records at 77ce761 · schema 1.8.0.

What it looks like

Descriptive pattern: ^pypi-[A-Za-z0-9_-]{85,}$

Parts are shown as recorded. Evidence classes belong to the facts below; no class is assigned to a part.

Format facts

Provider documented · provider-source · current · observed 2026-09-21
pypi- prefix, base64-serialized PyMacaroon, {85,} length floor: docs.pypi.org's own detection-format page publishes this contract's exact regex, pypi-[A-Za-z0-9-_]{85,}: the pypi- prefix, a "-" separator, a base64 PyMacaroon serialization, an 85-character floor and no ceiling
- docs.pypi.org/api/secrets/provider-documentation · last read 2026-09-22 · latest outcome read · supports docs.pypi.org's own detection-format page publishes this contract's exact regex, pypi-[A-Za-z0-9-_]{85,}: the pypi- prefix, a "-" separator, a base64 PyMacaroon serialization, an 85-character floor and no ceiling
Tool corroborated · tool-corroboration · current · observed 2026-09-21
Pinned scanner rules are consistent with the contract grammar (2 artifacts: gitleaks 8.30.1; trufflehog 3.97.4).
- gitleaks/gitleaks @ v8.30.1: config/gitleaks.tomlscanner-rule-source · last read 2026-10-04 · latest outcome read · supports gitleaks 8.30.1: gitleaks.toml
- trufflesecurity/trufflehog @ v3.97.4: pkg/detectors/pypi/pypi.goscanner-rule-source · last read 2026-09-21 · latest outcome read · supports trufflehog 3.97.4: pypi/pypi
Unresolved · listed-references · current · observed 2026-09-21
The legacy contract lists 1 reference without stating which property each supports.
- pypi.org/help/provider-documentation · last read 2026-09-22 · latest outcome read · supports Listed as a reference by the legacy contract · #apitoken
Provider documented · dossier-research · current · observed 2026-09-22
Legacy dossier research (verdict ready, tier T1) cited 2 sources; the dossier does not attribute sources to individual properties.
- docs.pypi.org/api/secrets/provider-documentation · last read 2026-09-22 · latest outcome read · supports Cited by the legacy dossier research for this family
- pypi.org/help/provider-documentation · last read 2026-09-22 · latest outcome read · supports Cited by the legacy dossier research for this family · #apitoken

Open questions

No open question is recorded for this revision.

Benchmark dossier notes

From the provider dossier, as written. The evidence level above says how well the format is backed; a fact the dossier does not record is not shown.

Shape: prefix pypi-, then a URL-safe base64 string (letters, digits, -, _) of at least 85 characters, with no upper bound because caveats can be added to the macaroon. Real tokens begin with the encoded macaroon header for the location pypi.org, which both pinned scanners key on. The extra character in trufflehog's pattern implies an identifier of 36 to 39 bytes, consistent with a UUID.
Basis: T1. docs.pypi.org/api/secrets (fetched 2026-09-21) publishes the regex pypi-[A-Za-z0-9-_]{85,} and says the body is a PyMacaroon base64 serialization. The PyPI help page confirms the pypi- prefix is part of the password value and that the identifier is meant to be inspectable. Scanner rules are narrower: trufflehog 3.97.4 requires the macaroon header plus 150 to 157 further characters, and gitleaks 8.30.1 requires the header plus 50 to 1000. Neither verifies the signature by default.
Issuance: not attempted. Benchmarks#104 decided a structurally faithful synthetic token can be built without any PyPI signing key (nil-UUID identifier, a caveat that says it is a fixture, and a hash-filler signature), so no real token is needed for the positives.
Contract in core: detector-families.md.

In this benchmark

Fixture rows on the current run. Counts are for redact-secret in published · redact-secret 0.1.0-beta.14 mode.

Fixtures: 26
Left readable: 0
Redacted too much: 0
False alarms: 0

26 fixtures: 9 expect a redaction, 17 must stay quiet. See every row

redact-secret fixture counts by evidence level
Evidence level	Fixtures	Left readable	Too much	False alarms
T1Provider-documented	9	0	0	0
T2Tool-corroborated	13	0	0	0
T3Project policy	4	0	0	0

Every scanner on the same fixtures

In run order. Counts are what each scanner recorded on this family's fixtures, whichever rules it has; a scanner with no rule for the family has nothing to report on it.

Counts per scanner on this family's fixtures
Scanner	Fixtures	Left readable	False alarms
flare-redactRuntime library · 1.6.1 · Published npm package · secrets-only (pii, generic_assignment disabled) · JavaScript engineNo rule maps to it	26	9	0
gitleaksRepository scanner · 8.30.1 · Directory scan · default rules1 rule targets it	26	0	4
redact-secretProduct measured here · 0.1.0-beta.14 · Published npm package · default detectors1 detector mapped	26	0	0
trufflehogRepository scanner · 3.97.4 · Filesystem scan · verification disabled1 rule targets it	26	0	0

Looks like it, but isn't

Values the dossier records as resembling this credential without being one.

Collisions: the identifier inside the macaroon is meant to be readable and is not itself the secret. Twine and pip use the same pypi- value as a password, so it appears under TWINE_PASSWORD-style names.

Scanner rules for this family

Mapped by hand (reviewed 2026-09-30) from each scanner's pinned rule file, never from what a scanner found on the fixtures.

Peer scanner rules that target this family
Scanner	Rule	What the rule matches
gitleaks · rules 8.30.1	`pypi-upload-token`	pypi-AgEIcHlwaS5vcmc + 50-1000 characters
openredaction · rules 1.1.5	`PYPI_TOKEN`	pypi- + 100 or more characters
trufflehog · rules 3.97.4	`pypi`	pypi-AgEIcHlwaS5vcmcCJ + 150-157 characters

No rule maps to this family in flare-redact.

Find

Evidence level

Scanners

26 of 26 rows

Fixtures in this family

26 rows, redact-secret's outcome on each. Rows that need a look come first (0), then the rest in corpus order. Choose "Every scanner" to see each scanner's outcome for the same rows.

Fixtures in API token
Fixture	Kind and evidence	redact-secret
`pypi-token-gitlab-ci-variables`pypi · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`pypi-token-noxfile-publish`pypi · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`pypi-token-public-id`pypi · benign-lookalike	Must not flagT2 · Tool-corroborated	Quiet
`pypi-token-pypirc`pypi · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`pypi-token-shape-1-bare`pypi · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`pypi-token-shape-1-length-bare-twin`pypi · wrong-length	Must not flagT2 · Tool-corroborated · twin	Quiet
`pypi-token-shape-1-length-quoted-twin`pypi · wrong-length	Must not flagT2 · Tool-corroborated · twin	Quiet
`pypi-token-shape-1-length-unicode-crlf-twin`pypi · wrong-length	Must not flagT2 · Tool-corroborated · twin	Quiet
`pypi-token-shape-1-quoted`pypi · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`pypi-token-shape-1-unicode-crlf`pypi · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`pypi-token-twine-env`pypi · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`pypi-token-twine-upload-flag`pypi · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`pypi-token-uv-publish-token`pypi · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`pypi-token-encoded-value`pypi · benign-lookalike	Must not flagT2 · Tool-corroborated	Quiet
`pypi-token-label-prose`pypi · benign-lookalike	Must not flagT3 · Project policy	Quiet
`pypi-token-mask`pypi · benign-lookalike	Must not flagT3 · Project policy	Quiet
`pypi-token-ordinary-prose`pypi · benign-lookalike	Must not flagT3 · Project policy	Quiet
`pypi-token-prefix-only`pypi · benign-lookalike	Must not flagT2 · Tool-corroborated	Quiet
`pypi-token-reference`pypi · benign-lookalike	Must not flagT3 · Project policy	Quiet
`pypi-token-shape-1-alphabet-bare-twin`pypi · wrong-alphabet	Must not flagT2 · Tool-corroborated · twin	Quiet
`pypi-token-shape-1-alphabet-quoted-twin`pypi · wrong-alphabet	Must not flagT2 · Tool-corroborated · twin	Quiet
`pypi-token-shape-1-alphabet-unicode-crlf-twin`pypi · wrong-alphabet	Must not flagT2 · Tool-corroborated · twin	Quiet
`pypi-token-shape-1-bare-twin`pypi · prefix-near-miss	Must not flagT2 · Tool-corroborated · twin	Quiet
`pypi-token-shape-1-quoted-twin`pypi · prefix-near-miss	Must not flagT2 · Tool-corroborated · twin	Quiet
`pypi-token-shape-1-unicode-crlf-twin`pypi · prefix-near-miss	Must not flagT2 · Tool-corroborated · twin	Quiet
`pypi-token-short-body`pypi · benign-lookalike	Must not flagT2 · Tool-corroborated	Quiet

Sources

Researched 2026-09-22.

Documentation and code

docs.pypi.org/api/secrets/
pypi.org/help/#apitoken

Research log

redact-secret/redact-secret-benchmarks#104Research issue
redact-secret/redact-secret-benchmarks#107Research issue