redact-secret · Report

API token

hf_ prefixed access token.

Hugging Face
Detectors: huggingface-token
Run 2026-10-07
Mode published · redact-secret 0.1.0-beta.14

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

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-23

2 events in the review history: 1 observed, 1 reviewed. Latest: observed on 2026-09-23 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: ^hf_[A-Za-z0-9]{34}$

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-23
@huggingface/hub SDK reference AccessToken type (hf_${string}): Hugging Face's SDK reference on huggingface.co types the user access token as hf_${string}, establishing the hf_ prefix; the provider's Hub OpenAPI spec (/.well-known/openapi.json, POST /api/credentials/revoke) gives a raw access-token example of hf_ followed by 34 placeholder characters, which establishes the 34-character body length on example strength only. The [A-Za-z0-9] body alphabet is not provider-stated and remains a support-policy union of the tool alphabets (gitleaks letters only, TruffleHog alphanumeric); the api_org_ variant is not covered by this provider source
- huggingface.co/docs/huggingface.js/hub/modulesprovider-documentation · last read 2026-09-23 · latest outcome read · supports Hugging Face's SDK reference on huggingface.co types the user access token as hf_${string}, establishing the hf_ prefix; the provider's Hub OpenAPI spec (/.well-known/openapi.json, POST /api/credentials/revoke) gives a raw access-token example of hf_ followed by 34 placeholder characters, which establishes the 34-character body length on example strength only. The [A-Za-z0-9] body alphabet is not provider-stated and remains a support-policy union of the tool alphabets (gitleaks letters only, TruffleHog alphanumeric); the api_org_ variant is not covered by this provider source
Tool corroborated · tool-corroboration · current · observed 2026-09-23
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/huggingface/huggingface.goscanner-rule-source · last read 2026-09-23 · latest outcome read · supports trufflehog 3.97.4: huggingface/huggingface
Unresolved · listed-references · current · observed 2026-09-23
The legacy contract lists 1 reference without stating which property each supports.
- huggingface.co/.well-known/openapi.jsonprovider-documentation · last read 2026-09-23 · latest outcome read · supports Listed as a reference by the legacy contract
Provider documented · dossier-research · current · observed 2026-09-23
Legacy dossier research (verdict ready, tier T1) cited 3 sources; the dossier does not attribute sources to individual properties.
- redact-secret/redact-secret @ 8b6a5fde52ecb4dfce13f09c7a947062d21483c7: docs/audits/evidence/654/README.mdproject-research-note · last read 2026-09-23 · latest outcome read · supports Final research evidence recorded by the legacy dossier
- huggingface.co/.well-known/openapi.jsonprovider-documentation · last read 2026-09-23 · latest outcome read · supports Cited by the legacy dossier research for this family
- huggingface.co/docs/huggingface.js/hub/modulesprovider-documentation · last read 2026-09-23 · latest outcome read · supports Cited by the legacy dossier research for this family

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: hf_ then 34 characters. Core accepts [A-Za-z0-9]; every observed sample and letters-only tool regex is narrower, and no source says digits never occur. hf_oauth_… and hf_jwt_… are other documented hf_ tokens, so a later _ in a body does not prove it is not Hugging Face.
Basis: prefix: the SDK reference types AccessToken as hf_${string} (a type annotation, not prose; accepted as T1 by maintainer ruling in the #575 record). Length: the POST /api/credentials/revoke example is hf_ plus 34 placeholder characters; the schema says only minLength 1 and maxLength 200, so length is on example strength. Alphabet: T2 only; Hugging Face's own current code (hf-mcp-server, agent-manager) and a retired inference-playground validator use hf_[A-Za-z0-9]{34}, which is code, not documentation, and tools split on the alphabet (#654).
Issuance: not attempted.
Contract in core: detector-families.md (row huggingface:api-token); evidence #654 record.

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: 11 expect a redaction, 15 must stay quiet. See every row

redact-secret fixture counts by evidence level
Evidence level	Fixtures	Left readable	Too much	False alarms
T1Provider-documented	11	0	0	0
T2Tool-corroborated	13	0	0	0
T3Project policy	2	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 engine1 rule targets it	26	0	3
gitleaksRepository scanner · 8.30.1 · Directory scan · default rules1 rule targets it	26	5	0
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	1

Benchmark dossier questions

Things the sources do not settle. They are listed so nobody reads them as settled.

Open caveat: T1 is a maintainer ruling on an SDK-reference type annotation (prefix) and an OpenAPI example (length 34); the alphabet is not provider-stated and api_org_ has no current source.

Looks like it, but isn't

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

Collisions: the api_org_ variant has no current provider-domain source (a 2021 archived page shows a placeholder; the current SDK rejects org tokens at login), so it stays outside the T1 contract.

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
flare-redact · rules 1.6.1	`huggingface_token`	hf_ + 30-45 characters
gitleaks · rules 8.30.1	`huggingface-access-token`	hf_ + 34 letters
trufflehog · rules 3.97.4	`huggingface`	hf_ + 34 alphanumerics

No rule maps to this family in openredaction.

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
`huggingface-token-dash-identifier-embedding`huggingface · benign-lookalike	Must not flagT2 · Tool-corroborated	Quiet
`huggingface-token-hf-auth-login`huggingface · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`huggingface-token-inference-bearer-header`huggingface · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`huggingface-token-shape-1-bare`huggingface · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`huggingface-token-shape-1-quoted`huggingface · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`huggingface-token-shape-1-unicode-crlf`huggingface · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`huggingface-token-user-plain-twin`huggingface · wrong-length	Must not flagT2 · Tool-corroborated · twin	Quiet
`huggingface-token-user-unicode-crlf-twin`huggingface · wrong-length	Must not flagT2 · Tool-corroborated · twin	Quiet
`huggingface-token-actions-sync-to-hub`huggingface · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`huggingface-token-hf-token-env`huggingface · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`huggingface-token-inference-client`huggingface · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`huggingface-token-leading-identifier-embedding`huggingface · benign-lookalike	Must not flagT2 · Tool-corroborated	Quiet
`huggingface-token-mask`huggingface · benign-lookalike	Must not flagT3 · Project policy	Quiet
`huggingface-token-model-repo-and-revision-public-id`huggingface · public-identifier	Must not flagT2 · Tool-corroborated	Quiet
`huggingface-token-prefix-only`huggingface · benign-lookalike	Must not flagT2 · Tool-corroborated	Quiet
`huggingface-token-reference`huggingface · benign-lookalike	Must not flagT3 · Project policy	Quiet
`huggingface-token-shape-1-prefix-bare-twin`huggingface · prefix-near-miss	Must not flagT2 · Tool-corroborated · twin	Quiet
`huggingface-token-shape-1-prefix-quoted-twin`huggingface · prefix-near-miss	Must not flagT2 · Tool-corroborated · twin	Quiet
`huggingface-token-shape-1-prefix-unicode-crlf-twin`huggingface · prefix-near-miss	Must not flagT2 · Tool-corroborated · twin	Quiet
`huggingface-token-short-body`huggingface · benign-lookalike	Must not flagT2 · Tool-corroborated	Quiet
`huggingface-token-stored-tokens-ini`huggingface · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`huggingface-token-trailing-identifier-embedding`huggingface · benign-lookalike	Must not flagT2 · Tool-corroborated	Quiet
`huggingface-token-user-plain`huggingface · documented-format-literal	Must redactT1 · Provider-documented	Redacted
`huggingface-token-user-prefix-plain-twin`huggingface · prefix-near-miss	Must not flagT2 · Tool-corroborated · twin	Quiet
`huggingface-token-user-prefix-unicode-crlf-twin`huggingface · prefix-near-miss	Must not flagT2 · Tool-corroborated · twin	Quiet
`huggingface-token-user-unicode-crlf`huggingface · documented-format-literal	Must redactT1 · Provider-documented	Redacted

Sources

Researched 2026-09-23.

Documentation and code

huggingface.co/docs/huggingface.js/hub/modules
huggingface.co/.well-known/openapi.json

Research log

redact-secret/redact-secret#654Research issue
Final evidence, pinned to a commit/redact-secret/redact-secret/blob/8b6a5fde52ecb4dfce13f09c7a947062d21483c7/docs/audits/evidence/654/README.md