Changes between Initial Version and Version 1 of net.sf.basedb.webauthn/using

Jun 3, 2022, 12:08:55 PM (6 months ago)
Nicklas Nordborg

Started to write user documentation


  • net.sf.basedb.webauthn/using

    v1 v1  
     1= How to use the !WebAuthn authentication extension =
     3== Logging in ==
     5Before it is possible to login with a !WebAuthn Security Key the server administrator need to register the key and connect it to the user account. It is not possible for users to register the key by themselves.
     7 1. Start by entering the '''Login''' and '''Password''' information in the form.
     8 2. Press '''ENTER''' or click on the '''Login''' button.
     9 3. The browser should ask you to insert the security into an USB port (unless it is already inserted).
     10 4. Press the button on the security key (do not click on the '''Cancel''' button).
     11 5. You should now be logged in.
     15<div style="background-color: #fffff0; border: 2px solid #6060A0; border-radius: 5px; padding: 1em; max-width: 60em;">
     17The exact prompts and dialogs that the browser displays vary by the browser and operating system you are using. Below are some examples:
     23== Assigning security keys to users ==
     25 1. To assign a !WebAuthn security to a user, the BASE administrator should
     26    locate that user in the '''Administrate->Users''' list and open the edit dialog.
     27 2. Switch to the '''!WebAuthn''' tab. This should state that no security key is enabled for
     28    the account.
     29 3. Insert the security key into an USB port and click on the '''Register''' button.
     30 4. Press the button on the security for verification.
     31 4. If the registration is successful the dialog should switch to reflect the
     32    fact that the account is now !WebAuthn-enabled. Take out the key and
     33    enter the serial number into the '''Serial #''' field (optional). Save!
     36== Unassign a security key ==
     38Click on the '''Remove''' in the '''!WebAuthn''' tab in the '''Edit user''' dialog. Save!
     40== Notes! ==
     42 1. It is possible to assign the same security key to more than one user account. This might be
     43    practical for persons that have one regular account for daily usage and one account for
     44    administrative needs.
     45 2. The administrator may allow other authentication methods.