Extension:WebAuthn

From mediawiki.org
MediaWiki extensions manual
OOjs UI icon advanced.svg
WebAuthn
Release status: beta
Implementation User rights , Special page
Description Module for OATHAuth that enabled authentication using WebAuthn
Author(s)
Latest version Continuous updates
Compatibility policy Master maintains backward compatibility.
MediaWiki 1.34+
PHP 7.2+
License GNU General Public License 2.0 or later
Download
  • $wgWebAuthnRelyingPartyName
  • $wgWebAuthnRelyingPartyID
Translate the WebAuthn extension if it is available at translatewiki.net

WebAuthn is a module for the OathAuth extension, that provides support for U2F devices (such as YubiKey) by using the WebAuthn API in browsers. It enables support for logging-in using physical security tokens or biometric sensors along with regular password. Learn more about U2F on Wikipedia.

Requirements[edit]

WebAuthn requires OATHAuth and GMP php extensions to be installed as a prerequisite.

Installation[edit]

  • Download and place the file(s) in a directory called WebAuthn in your extensions/ folder.
  • Only when installing from Git, run Composer to install PHP dependencies, by issuing composer install --no-dev in the extension directory. (See task T173141 for potential complications.)
  • Add the following code at the bottom of your LocalSettings.php :
    wfLoadExtension( 'WebAuthn' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Browser support[edit]

List of all supported web browsers can be found on Mozilla Developer Network.

Desktop[edit]

  • Chrome 67+
  • Edge 18+
  • Firefox 60+

Mobile[edit]

  • Android WebView 70+
  • Chrome for Android 70+
  • Firefox for Android 60+