Skip to content

Overview

Step-by-step setups for running Keycard with a gateway, identity provider, or agent platform you already use.

A recipe takes a product you already run, such as Kong, Azure API Management, Microsoft Entra ID, or Amazon Bedrock AgentCore, to a working Keycard setup on one page. Your product keeps doing its job, and Keycard decides which people and agents may reach each resource and issues the short-lived credentials they use.

  1. Agent or MCP client Signs in through Keycard, for a person or as itself, and asks for access to a resource.
  2. Keycard Checks policy, then issues a short-lived token for that caller and that resource, or refuses.
  3. Your gateway or service Checks the token before it lets the call through.
  4. Keycard Records each decision in the Audit Log.
If you’re asking Start with
Our MCP servers sit behind a gateway. Can Keycard decide who reaches them? agentgateway
Can the gateway call GitHub or Google as the person who asked? agentgateway upstream credentials
We already run Kong, Azure API Management, or Gravitee. Can Keycard allow or refuse each tool call inside it? Kong AI Gateway, Azure API Management, Gravitee
Our agents run as Entra app registrations. Can they sign in to Keycard with their own Entra token? Entra service principals
We have many agents in Entra. Can we register them all from Terraform? Entra service principals with Terraform
Our agents run on Amazon Bedrock AgentCore. How do they get Keycard tokens? Amazon Bedrock AgentCore
Other agents need to call our AgentCore runtime. Can Keycard decide which ones may? AgentCore runtime access

Each recipe starts with what happens on each request, then has these sections in this order:

  1. Prerequisites, including the product version the recipe was tested with.
  2. The setup steps, grouped by what each part sets up.
  3. Verify, with one call that Keycard allows and one that it refuses.
  4. Clean up, which removes what the recipe created, in Keycard and outside it.
  5. Limits, which says where Keycard’s part ends and what the recipe doesn’t cover.
  6. Troubleshooting, which lists errors you might see, each with its cause and fix.