Hand over a key¶
When a key's holder moves on, the program using it shouldn't break. Hand the key to a colleague or another agent: its models, limits, routing, guardrails and budgets go with it, and the audit log records who handed it to whom and why.
Before you start¶
- You may revoke the key: you hold it, own its agent, or are an admin over it.
- Know who takes it: a person (for a person's key) or an agent (for an agent's key).
Steps¶
- Open Keys and choose the key.
- Choose Hand over….
- Choose the person or agent it goes to, and the team it acts for when they're in more than one.
- Choose Issue a new secret (recommended: the old secret stops now) or Keep the secret.
- Say why. It goes into the audit log.
- Confirm. It happens at once.
Check it worked¶
The key shows its new holder. With a new secret, you never see it: the new holder shows it from their own key page with Show key again and puts it where the program reads it.
Take over a key instead¶
When whoever issued a key can no longer issue it (they left its team, stopped being an admin there, or were deleted), the key says so and keeps working. Its team's admins and organisation admins see Take over: they become its issuer and the secret stays the same. Home's Needs attention lists such keys.
Good to know¶
- A key whose holder was deleted can be handed over too, and works again for its new holder.
- Keep the secret means nothing changes for the program, but the previous holder may still know it. Choose it only when you trust that.
- Moving a person's key to another of their own teams isn't a handover: Edit it and change Acts for.