Skip to main content
← Back to list
01Issue
FeatureShippedSwamp CLI
Assigneesstack72

Relationships

#1611 Add swamp access group list-idp to enumerate IdP groups seen by the server

Opened by stack72 · 8/11/2026· Shipped 8/11/2026

Problem statement

When using idp-group: subjects in grants (e.g. with Okta), there is no way to verify that a specific IdP group claim is arriving at the server. swamp access group list only shows local groups, not IdP groups. Operators must write a grant targeting an IdP group and then test it to confirm the claim is being received — there is no observability into what groups the server has actually seen.

This makes it difficult to:

  • Verify Okta group claim configuration is correct
  • Debug why an idp-group: grant isn't matching
  • Audit which IdP groups have been observed across all authenticated users
  • Confirm case-sensitive group names match exactly (matching is strict Map.get())

Proposed solution

Add a subcommand to swamp access that enumerates IdP groups the server has seen. For example:

swamp access group list-idp --server wss://...

This could aggregate groups from all active server tokens (the data is already stored — each server token's data record contains a groups array). The output would show:

  • Group name
  • Number of active tokens/users with that group
  • Last seen timestamp

This should require read on access:group (same as swamp access group list).

Workaround today

Operators can use swamp access token list --server --json and aggregate the groups arrays from all tokens, but this requires admin access and manual processing.

Alternatives considered

  • Exposing the raw token list is too privileged for this use case
  • access.check includes groups in its response but requires admin on access:* and is per-principal
  • access.can-i shows the caller's own groups but not all groups system-wide
02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 4 MOREPR_MERGED+ 2 MORESESSION_SUMMARIZED

Shipped

8/11/2026, 10:53:25 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack728/11/2026, 9:41:12 PM

Sign in to post a ripple.