DEV Community

SorrelThorncroft
SorrelThorncroft

Posted on

Pleroma: 578 title matches and the risk of a static admin token

Pleroma: 578 title matches and the risk of a static admin token

Pleroma instances expose a client API, federation endpoints and an administrative API. On 2026-11-04, ZoomEye returned 578 matches for title="Pleroma" and zero for app="Pleroma" with page 1, page size 1 and sub_type=all. The title count is a candidate population, not a count of live instances. The administrative API is the security boundary that deserves the first review.

Admin authority is broader than a normal user scope

Pleroma supports hierarchical OAuth scopes and additional administrative scopes. The admin API requires an authenticated administrator, and the documentation warns that an instance-wide static admin token is weaker than an account-based authentication flow. That warning is useful when a deployment or automation tool favors a single long-lived token.

Inventory how administrators authenticate, which tokens exist and whether any token is shared across services. Prefer a user-bound OAuth flow with narrowly scoped permissions. Rotate a static token after an operator change and remove it when the integration is retired. Record the administrator identity behind each change.

The public surface and the admin surface

A public instance may intentionally show federated posts, profiles and instance metadata. The admin API can manage users, federated instances and configuration. Review the reverse proxy so the admin path is not made available by a generic wildcard rule. Test with an ordinary token that a state-changing admin request is rejected.

Do not attempt to enumerate third-party accounts. For owned deployments, use a test account and a test object. Check whether the admin panel is reachable from the public internet and whether that is intended. If it is intended, require a strong authentication path, network restriction and audit logging.

Federation changes need attribution

Federation policy, relays and domain blocks can change what local users see and what remote servers can deliver. A static token that can modify those settings is an authority-bearing secret. Treat it as an administrative credential, not as a monitoring API key.

The zero application count means the 578 title matches should be grouped by domain and ownership. The title can come from a documentation page, a client application or a server page. Review the small set that belongs to the organization first.

Verification checklist

  • Map all administrative accounts and tokens.
  • Check the scopes and lifetime of automation credentials.
  • Confirm admin API routes reject ordinary users.
  • Review federation and relay configuration changes.
  • Test token revocation and operator offboarding.

ZoomEye gives a broad but imperfect external view. Pleroma's scope model and static-token warning explain why the next step is a credential inventory. A visible title is not proof of an exposed admin API, and a missing fingerprint is not proof of absence.

References

[1] Pleroma authentication and authorization

[2] Pleroma admin API

[3] Pleroma configuration cheat sheet

Top comments (1)

Collapse
 
alexshev profile image
Alex Shev •

A static admin token turns every discovery result into a potential permanent control-plane compromise. The remediation should pair rotation with scoped, expiring credentials and an audit trail for privileged calls; otherwise replacing the string only resets the clock on the same design flaw.