rossoctl / rossoctl/cortex

feature: More metadata in created Keycloak client

Open
#341 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement good first issue stale
Dominant language
Go
Stars
13
Forks
40
Avg merge
12h 17m
Merged PRs (30d)
156

Description

Feature Description

When Kagenti import's an agent with AuthBridge Enabled, an OIDC client is created in Keycloak. For example, when I import the git-issue-agent, I get client ID spiffe://localtest.me/ns/team1/sa/git-issue-agent.

The "Description" field should be filled in so that users who navigate to it have some hint. (The description could be dynamic, mentioning the Agent and it's Agent Card URL, or it could be static, with nothing more than a link to Kagenti and/or Kagenti AuthBridge).

A scope, e.g. spiffe://localtest.me/ns/team1/sa/git-issue-agent-dedicated is also created. This scope has description "Dedicated scope and mappers for this client" but doesn't have any mappers.

Image
Proposed Solution

Create a OIDC Client with a Description that either links to Kagenti AuthBridge docs or has text explaining "This Client is specific to the Kagenti Agent instance git-issue-agent."

The documentation should help a new Kagenti admin understand that the Agent cannot be contacted via A2A and asked to do work without a bearer token that is a JWT issued by this Keycloak with this OIDC Client as the audience.

The documentation might even include instructions for creating that JWT.

Want to contribute?
  • I would like to work on this issue.
Additional Context

When designing the solution, consider making it generic to non-Keycloak OIDC providers, in case Kagenti is ever required to integrate with OpenShift OIDC or a corporate SSO.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No file or test is named. Start by locating the AuthBridge import path that creates the Keycloak OIDC client and dedicated scope, then inspect how their descriptions and mappers are currently configured. Done means the client has useful agent-specific guidance, the scope behavior is addressed, and the authentication documentation explains the required JWT audience without blocking future non-Keycloak OIDC providers.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
authentication, backend
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.