Manual for Bouncer 0.5.7. Chapters state version and distribution limits. Source cdd3b59, site build 20 November 2026. Your server or app may run an earlier version.
Ask for access
If your administrator lets you ask for a resource, you can ask from the app. An approver gets your request, and you see the answer in the app.
People usually ask from the app when they want to view a credential
themselves. Scripts and agents ask through the bouncer command-line tool or
the MCP server instead, with their own requester key.
Make a request
- Open the Requests tab and tap New request. On Windows, choose New request… from the tray menu, or New request in the window.
- Under Resource, tap Select resource and choose what you need. Search looks at names, descriptions and folders. Each one shows its kind (stored secret, stored API key or SSH access) and its description, and its folder when you search. If some lengths are not allowed, the form names them under How long with the longest time the resource allows.
- Under How long, choose a length, or Custom. Lengths the resource doesn't allow are shown greyed out with the reason. Your approver can choose a shorter or longer time than you ask for.
- Under Reason, answer Why do you need it? in up to 280 characters. Your approver sees it as your own words.
- Tap Send request.
The form also tells you how you'll use the resource once it's approved, for example "You can view it in the Library once your grant is active, if this server allows it", or "Once approved, use it from the CLI with your requester key."
If you're an approver for the resource yourself, the form says the request will also reach you, labelled Self-approval. Whether you may approve it depends on the resource's policy.
Wait for the answer
You see Waiting for approval, with the time left for an approver to answer. "Your approvers have been notified. If nobody answers within 15 minutes, the request expires and you can ask again." To withdraw it, tap Cancel request.
When it's approved, you see Approved for the length the approver chose, and when your access ends. If they chose a different length, it says what you asked for. For a stored secret, it also shows the command to use it from your computer:
bouncer exec prod-db-password -- <command>
Replace <command> with the program that needs the secret. If you use the
bouncer command-line tool, your administrator can show you how to run it.
Your requests
The Requests tab lists what's Waiting and what's Recent, with a status for each: Active, Ended, Revoked, Denied, Expired or Cancelled. For example:
- "Approved by Bob for 15 minutes, until 14:30. You asked for 1 hour."
- "Today · denied by Bob · asked for 1 hour"
- "Today · nobody answered within 15 minutes"
If the request is refused
| What you see | What to do |
|---|---|
| "Choose the resource you need." | Pick a resource first. |
| "The server didn't accept this reason. Change it and send again." | Change the reason and send again. |
| "This resource isn't ready in the vault. Ask the operator to finish setting it up. Other resources can still be used." | From 0.5.7: ask your administrator to finish the resource's OpenBao setup. |
| "Add a short reason. Your approver reads it before deciding." | Write a reason. |
| "Keep it to 280 characters." | Shorten the reason. |
| "Remove the hidden or control characters, so your approver sees exactly what you wrote." | Retype the reason rather than pasting it. |
| "You can't ask for this resource any more. Choose another." | Your administrator has changed who may ask for it. |
| "That length isn't allowed for prod-db-password now. Choose another." | The resource's limits changed. Choose again. |
| "Couldn't reach your Bouncer server." | Check your network connection, then try again. |