Skip to content

Adding skills for oidc, update overall skills#1289

Open
muralibasani wants to merge 1 commit into
mainfrom
mbasani-token-fwd-review
Open

Adding skills for oidc, update overall skills#1289
muralibasani wants to merge 1 commit into
mainfrom
mbasani-token-fwd-review

Conversation

@muralibasani
Copy link
Copy Markdown
Contributor

About this change - What it does

References: #xxxxx

Why this way

@muralibasani muralibasani requested a review from a team as a code owner May 21, 2026 12:05
@muralibasani muralibasani requested review from HelenMel and nosahama May 21, 2026 12:06
description: Context for Karapace's OIDC + basic-auth implementation across Schema Registry (SR) and REST Proxy (RP). Use when working on token validation, JWKS, token forwarding from RP to SR, schema-client cache partitioning, role-based authz, or basic-auth coexistence. Triggers - files under src/karapace/api/oidc/, src/karapace/api/middlewares/, src/karapace/core/auth.py, src/karapace/core/serialization.py (sr_authorization_ctx, _token_fingerprint), src/karapace/kafka_rest_apis/__init__.py (publish/fetch gates), or any change to sasl_oauthbearer_* config.
---

# Karapace OIDC & Auth — Architecture Reference
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Architecture Reference more efficiently have in a sec/karapace/core as a AGENT.md and CLAUDE.md

@@ -0,0 +1,228 @@
---
name: oidc-auth
description: Context for Karapace's OIDC + basic-auth implementation across Schema Registry (SR) and REST Proxy (RP). Use when working on token validation, JWKS, token forwarding from RP to SR, schema-client cache partitioning, role-based authz, or basic-auth coexistence. Triggers - files under src/karapace/api/oidc/, src/karapace/api/middlewares/, src/karapace/core/auth.py, src/karapace/core/serialization.py (sr_authorization_ctx, _token_fingerprint), src/karapace/kafka_rest_apis/__init__.py (publish/fetch gates), or any change to sasl_oauthbearer_* config.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

'Context for Karapace's OIDC'

Not really Job for a skill IMHO. A skill might be an example of karapace starting and validating each of them.

For context, better just include an exaplanatiln in corresponding hierarchy: src/karapace/api/CLAUDE.md or src/karapace/core/CLAUDE.md

subject: Subject,
version: Version | None,
token_fingerprint: str,
token_fingerprint: str, # cache-key only; partitions the LRU per principal
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@nosahama I added this comment here. We need this field to handle cache key.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants