Exoguard Docs
  • Introduction
    • Quick Start
  • Commands
  • Tutorials
    • Permissions
    • Enroll yourself
      • WebAuthn
    • Audit webhook setup
      • External audit webhooks
    • Request a custom link
  • Service
    • Access levels
    • Subscriptions
    • Privacy Policy
    • Terms of Service
Powered by GitBook
On this page
  • Register a new passkey
  • Manage registered passkeys
  • Edit assigned passkeys
  • Rename a passkey
  • Delete passkeys
  • Delete TOTP authentication
  1. Tutorials
  2. Enroll yourself

WebAuthn

Learn how to register and manage your passkeys.

PreviousEnroll yourselfNextAudit webhook setup

Last updated 8 months ago

To access the WebAuthn menu, you will need to use the 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:

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.

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.

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.

Edit assigned passkeys

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.

Rename a passkey

This option will allow you to rename a registered passkey, to attribute it a new custom 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.

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.

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.

Completing the registration will automatically assign your new passkey to the Discord server where you have run the command. The message will be edited one last time to confirm your enrollment has either been completed or updated.

Selecting a passkey will show you the same modal than when you . After submitting the new name, the message will be edited to confirm the operation.

If you want to re-enable TOTP authentication, simply again. This will recreate a TOTP secret key (which you will need to confirm) without impacting your passkey authentication at all.

enroll yourself
register a new passkey
/enroll
/enroll
Screenshot of the enrollment menu, shadowed to make the WebAuthn button stand out.
Screenshot of the passkeys management menu, with a short explanation and its three colored buttons.
Screenshot of the passkey name modal.
Screenshot of the passkey registration message with a link button.
Screenshot of the enrollment update confirmation message.
Screenshot of the registered passkeys menu, with a list of passkeys and management buttons underneath.
Screenshot of the passkey assignment menu, with one selected passkey out of two.
Screenshot of the selection menu to choose which passkey you want to rename.
Screenshot of a successful passkey rename operation, displaying both the old and the new name.
Screenshot of the selection menu to choose which passkeys you want to delete.
Screenshot of a successful passkey deletion.
Screenshot of the confirmation message upon deleting TOTP authentication.