Support
Draft. The support contact details and how quickly we reply aren't decided
yet, so this page shows placeholders such as <SUPPORT_EMAIL> where they will
go.
Bouncer is the approval app for a Bouncer server that your organisation runs.
If something's wrong with your access itself (who may ask for what, or a
device you've lost), your organisation's Bouncer administrator can help
fastest. For problems with the app, email <SUPPORT_EMAIL> and say which
device and app version you have (shown near the bottom of Settings).
Don't send secret values, pairing codes, pairing strings, the keys your scripts or agents use to ask for access, or screenshots that show any of them. The FAQ answers the common questions.
Getting started
- Ask your administrator to run
bouncer-admin device pairfor you. It shows a QR code and a pairing string. The pairing string is your server's address and a one-time pairing code together, as one line of text; the QR code holds the same thing. Both work once and expire after a few minutes. - On a phone, tap Scan QR code, or Enter the code instead and paste the pairing string. On Windows, copy the pairing string and click Paste pairing string, or type the server address and the pairing code separately.
- Check the server and your name, name the device, and tap Pair.
- On a phone, allow notifications when asked, so you hear about new requests. On Windows, Bouncer waits in the notification area and shows a Windows notification while it's running. If you quit it, it can't tell you about new requests until you start it again.
The device needs a network connection that reaches your Bouncer server. Some organisations put the server on a VPN to keep it off the open internet. If yours does, connect it first.
Common problems
"Can't reach your Bouncer server." The device can't get to the server. Check your network connection (and your VPN, if your organisation uses one for Bouncer), and that the address is right. Nothing is approved or changed while the app is offline.
"This code has expired or was already used." Each pairing code works once and only for a few minutes. Ask for a new one.
"Too many wrong codes." Wait a few minutes, then try again with a fresh code.
The camera doesn't open. Allow camera access for Bouncer in the system settings, or use Enter the code instead. The camera is only used to read the pairing QR code. The Windows app doesn't use the camera.
I don't get notifications. Phone notifications only work with a Bouncer server that S6 Studios has set up to send them. Servers run by other organisations can't send them, so open the app to see what's waiting: requests always show in the inbox. If your server does send notifications, check Notification settings in Settings; Android 13 and later ask for permission first. On Windows, Bouncer Desktop shows a notification only while it's running (when it's installed from the Store or an MSIX package, it starts at sign-in unless you turned that off).
A request vanished from the inbox. Requests wait for a limited time. If nobody answers in time it expires and nothing is granted. Whoever asked can ask again.
I approved something by mistake. Open Grants and tap Revoke. Bouncer then stops handing out anything new for that access. Anything it has already handed out, such as a token or a server login, can keep working until it runs out or until the system it opens stops accepting it. A password that was already read can't be taken back, so ask whoever looks after it to change it and to close any logins that used it.
New, lost or retired device
- Switching to a new phone: pair the new one, then sign out on the old one (Settings > Sign out). Signing out asks the server to remove that device.
- Lost or stolen phone: tell your administrator straight away. They remove
the device on the server (
bouncer-admin device revoke), and it can't approve anything after that. - Switching servers: Settings > Switch Bouncer server. The app asks the old server to remove this device first.
- Removing everything: sign out, then uninstall. See the privacy policy for what's kept and where.
Security problems
If you think you've found a security problem in Bouncer, email
<SECURITY_EMAIL> (or <SUPPORT_EMAIL>) privately rather than posting it in
public. We'll reply within <RESPONSE_TIME, TO DECIDE>.