WebAuthn

Learn how to register and manage your passkeys.

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.

Screenshot of the enrollment menu, shadowed to make the WebAuthn button stand out.

Once you have clicked the WebAuthn button, you will find the passkeys management menu:

Screenshot of the passkeys management menu, with a short explanation and its three colored buttons.

Register a new passkey

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.

Screenshot of the passkey name modal.

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.

Screenshot of the passkey registration message with a link button.

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.

Screenshot of the enrollment update confirmation message.

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.

Manage registered passkeys

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.

Screenshot of the registered passkeys menu, with a list of passkeys and management buttons underneath.

Edit assigned passkeys

This option will allow you to select which passkeys you want to be assigned to the current server.

Screenshot of the passkey assignment menu, with one selected passkey out of two.

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.

Rename a passkey

This option will allow you to rename a registered passkey, to attribute it a new custom name.

Screenshot of the selection menu to choose which passkey you want to rename.

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.

Screenshot of a successful passkey rename operation, displaying both the old and the new name.

Names do not have to be unique, they are just an easy way for you to recognize your passkeys.

Delete passkeys

This option will allow you to permanently delete unassigned passkeys from the service.

Screenshot of the selection menu to choose which passkeys you want to delete.

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.

Screenshot of a successful passkey deletion.

Deleted passkeys can be registered again at any time, should you want to reuse them in the future.

Delete TOTP authentication

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.

Screenshot of the confirmation message upon deleting TOTP authentication.

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.