Register a passkey¶
You add, replace and remove passkeys yourself, in your browser, on a page Hadron's server hosts. There is nothing to install and nothing to say to an agent: an agent cannot register a passkey for you, and neither can the CLI, an API key or a sign-in token, because a passkey answers only to the person who holds it. A passkey is what lets you sign a node; this page is only about getting one.
Passkey registration is off by default on a server you run yourself. An
operator turns it on with PASSKEY_SIGNING_ENABLED=true and
PASSKEY_REGISTRATION_ENABLED=true. Check a server with
/capabilities: it lists
passkey-registration when registration is on. If it is not listed, the pages
below do not exist on that server. What a signature is and why only a person
can make one is in Signed revisions.
The pages sit on the server's own address: /passkeys/register,
/passkeys/revoke and /passkeys/window/end. Open them on a server whose
/capabilities lists passkey-registration.
Add your first passkey¶
Your first passkey is any passkey you add while your account has no unrevoked passkey. If you came here from an email sign-in that asked for one, the sign-in page walks the same steps inside that sign-in.
- Open the Add a passkey page.
- Under 1. Confirm who you are, click Confirm with GitHub, Google or Apple, or enter your email and click Send link. An email link must be opened in this same browser; it confirms you to this page only and does not sign you in. The confirmation lasts 10 minutes.
- Under 2. Name and add it, type a name you will recognise, such as "Work laptop", and click Add my first passkey. Your browser or device asks for your fingerprint, face or device PIN.
The page states the cooling-off window for a first passkey: at least 72 hours (72 unless the operator set it longer; the page states the hours for your server). During it the passkey works, but anything it signs stays pending. Hadron emails you when a passkey is added. For a first passkey that email contains a Remove this passkey link that works without signing in and only until the window ends. If the passkey was not yours, use it. If your account has no email address, the passkey is still added, but the notice has nowhere to go, so the cancel link never reaches you.
Add another passkey¶
You can add a second passkey, for another device, with one you already hold.
- Open the Add a passkey page. Type a name for the new passkey in Name for this passkey.
- Click Use my passkey, then add another and approve with an existing passkey. It must not be inside its own cooling-off window; a passkey still in its window cannot vouch for another.
- The page shows the account it is about to add to ("You are adding a passkey to the Hadron account @..."). Click Continue if that is yours, or Not my account: stop.
- Your browser or device asks you to create the new passkey. Approve it. The page says "Passkey added. We emailed you a notice."
A later passkey has no cooling-off window and no cancel link. Its email only tells you a passkey was added.
A passkey reaches a second device only through the route you choose when your browser asks: your own provider's sync, a cross-device QR code, or a hardware key. See Signing from a second device.
End the cooling-off window early¶
If you added the first passkey yourself and do not want to wait, open the End your first passkey's cooling-off window early page. Confirm who you are with a method you did not use to add the passkey, click Continue, then Yes, I added this passkey: end the window. Anything it signed stops being pending. I didn't add this passkey is the other button: choose it if you do not recognise the passkey. If you have no other method, the window simply ends by itself, or you can use the cancel link in the first-passkey email.
Remove a passkey¶
- Open the Remove a passkey page.
- Under 1. Prove it's you, either click Use another of my passkeys and approve with it, or confirm with the identity provider linked to your account and then click Show my passkeys. An email link cannot be used to remove a passkey, apart from the cancel link in the first-passkey email (above).
- Under 2. Choose the passkey to remove, click Remove beside the one to remove and accept the browser's confirmation ("Remove the passkey ... This also signs out the sessions it signed in."). The passkey you used to prove it is you is listed but cannot be removed in the same go.
- The page says
Removed "<name>". Start again to remove another.
Removing a passkey also signs out the sessions it signed in. What it already signed keeps its state, except that a first passkey still inside its cooling-off window has its pending signatures cancelled and they never count. If you have lost every passkey and have no linked GitHub, Google or Apple account, contact Hadron support.
When it does not work¶
- The page does not exist. Registration is off on that server. See the
/capabilitiescheck above. - Too many attempts. The pages answer "Too many attempts. Wait a minute and try again."
- The browser has no passkey support. Use a current browser that supports passkeys.
Related¶
- Signed revisions: what a signature covers and why only a person signs.
- Rules this page follows, from the product specs:
cor:aut:040:02(registering a passkey needs an interactive step-up),cor:aut:040:07(a first passkey's cooling-off window and cancel link) andcor:aut:040:08(only the owner registers or revokes their passkeys). - Why email sign-in needs a passkey
- Sign in with email and a passkey
- Sign a node
/capabilities