index.rst (2429B)
1 .. _mozilla_projects_nss_pkcs11_module_installation: 2 3 PKCS11 module installation 4 ========================== 5 6 .. container:: 7 8 `PKCS #11 </en-US/PKCS11>`__ modules are external modules which add to Firefox support for 9 smartcard readers, biometric security devices, and external certificate stores. This article 10 covers the two methods for installing PKCS #11 modules into Firefox. Users can use the 11 preferences dialog to install or remove PKCS #11 module. Extensions can programmatically manage 12 PKCS #11 modules using the nsIPKCS11 programming interface. 13 14 .. note:: 15 16 **Note:** The information in this article is specific to Firefox 3.5 and newer. Older versions 17 of Firefox may support the 18 `window.pkcs11 <https://developer.mozilla.org/en-US/docs/Web/API/Window/pkcs11>`__ property 19 for installing PKCS #11 modules. 20 21 .. _using_the_firefox_preferences_to_install_pkcs_11_modules: 22 23 `Using the Firefox preferences to install PKCS #11 modules <#using_the_firefox_preferences_to_install_pkcs_11_modules>`__ 24 ------------------------------------------------------------------------------------------------------------------------- 25 26 .. container:: 27 28 #. Save the PKCS #11 module to a permanent location on your local computer 29 #. Open the Firefox preferences dialog. Choose "Advanced" > "Encryption" > "Security Devices" 30 #. Choose "Load" 31 #. Enter a name for the security module, such as "My Client Database". NOTE: there is currently a 32 bug in Firefox where international characters may cause problems. 33 #. Choose "Browse..." to find the location of the PKCS #11 module on your local computer, and 34 choose "OK" when done. 35 36 .. _provisioning_pkcs_11_modules_using_the_pkcs11_api: 37 38 `Provisioning PKCS #11 modules using the pkcs11 API <#provisioning_pkcs_11_modules_using_the_pkcs11_api>`__ 39 ----------------------------------------------------------------------------------------------------------- 40 41 .. container:: 42 43 Starting with Firefox 58, extensions can use the ``pkcs11`` browser extension API to enumerate 44 PKCS #11 modules and make them accessible to the browser as sources of keys and certificates. 45 46 .. _see_also: 47 48 `See also <#see_also>`__ 49 ------------------------ 50 51 .. container:: 52 53 - `Web security <https://developer.mozilla.org/en-US/docs/Web/Security>`__ 54 - :ref:`mozilla_projects_nss_pkcs11` 55 - ``pkcs11.installModule()`` 56 - ``pkcs11.isModuleInstalled()``