feature: More metadata in created Keycloak client
Nobody has claimed this yet.
- 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.
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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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