WebAuthn
Learn how to register and manage your passkeys.
Last updated
Learn how to register and manage your passkeys.
Last updated
To access the WebAuthn menu, you will need to use the /enroll command then click on the blurple WebAuthn button. You can safely ignore the TOTP enrollment procedure, as it will not have any impact on your data unless you click the green Confirm enrollment button.
Once you have clicked the WebAuthn button, you will find the passkeys management menu:
Clicking the Register a new passkey button will open a modal to ask you for the name you want to give to your new passkey. Passkey names are 1 to 32 characters in length, and cannot contain backtick or newline characters to ensure markdown formatting consistency.
Once you have submitted the name you want, the menu will be edited with a link button to your passkey registration session. The link is confidential because it contains a unique session ID that will be used to pair the newly registered key to your Discord account.
Completing the registration will automatically assign your new passkey to the Discord server where you have run the /enroll command. The message will be edited one last time to confirm your enrollment has either been completed or updated.
This is it, your passkey is now globally registered and can be managed, should you want to edit its server assignments to use it in other communities for example, which is recommended.
Clicking the Manage registered passkeys button will show you a list of your currently registered passkeys using their custom names, along with their registration date and the amount of servers they are assigned to.
This option will allow you to select which passkeys you want to be assigned to the current server.
Closing the selection menu will save your settings. Only assigned passkeys will be requested by your web browser on login, unassigning all passkeys will therefore disable WebAuthn authentication.
You will not be able to unassign all passkeys if TOTP authentication is not configured.
This option will allow you to rename a registered passkey, to attribute it a new custom name.
Selecting a passkey will show you the same modal than when you register a new passkey. After submitting the new name, the message will be edited to confirm the operation.
Names do not have to be unique, they are just an easy way for you to recognize your passkeys.
This option will allow you to permanently delete unassigned passkeys from the service.
Only unassigned passkeys will be displayed, you can however select multiple keys at once. After submitting your selection, the message will be edited to confirm the operation.
Deleted passkeys can be registered again at any time, should you want to reuse them in the future.
Clicking the Delete TOTP authentication button will erase your TOTP secret key for the given Discord server from the service's database, therefore making passkey authentication mandatory.
You will not be able to click the button if you do not have at least one assigned passkey.
Once clicked, the message will be edited to confirm the operation.
If you want to re-enable TOTP authentication, simply enroll yourself again. This will recreate a TOTP secret key (which you will need to confirm) without impacting your passkey authentication at all.
