index.rst (9278B)
1 .. _mozilla_projects_nss_tools: 2 3 NSS Tools 4 ========= 5 6 .. _nss_security_tools: 7 8 `NSS Security Tools <#nss_security_tools>`__ 9 -------------------------------------------- 10 11 .. container:: 12 13 Newsgroup: `mozilla.dev.tech.crypto <news://news.mozilla.org/mozilla.dev.tech.crypto>`__ 14 15 `Overview <#overview>`__ 16 ~~~~~~~~~~~~~~~~~~~~~~~~ 17 18 .. container:: 19 20 The NSS Security Tools allow developers to test, debug, and manage applications that use NSS. The 21 `Tools Information <#tools>`__ table below describes both the tools that are currently working 22 and those that are still under development. The links for each tool take you to the source code, 23 documentation, plans, and related links for each tool. The links will become active when 24 information is available. 25 26 Currently, you must download the NSS 3.1 source and build it to create binary files for the NSS 27 tools. For information about downloading the NSS source, see 28 :ref:`mozilla_projects_nss_building`. 29 30 If you have feedback or questions, please feel free to post to 31 `mozilla.dev.tech.crypto <news://news.mozilla.org/mozilla.dev.tech.crypto>`__. This newsgroup is 32 the preferred forum for all questions about NSS and NSS tools. 33 34 .. _overall_objectives: 35 36 `Overall Objectives <#overall_objectives>`__ 37 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 38 39 .. container:: 40 41 #. Provide a tool for analyzing and repairing certificate databases (`dbck <#dbck>`__). 42 #. Migrate tools from secutil.h interface to PKCS #11 interface. 43 #. Eliminate redundant functionality in tools. Many tools implement private versions of 44 PKCS11Init(), OpenCertDB(), etc. 45 #. Eliminate use of getopt() and replace with NSPR calls to get command options (to eliminate 46 platform dependencies with getopt()). 47 48 .. _tools_information: 49 50 `Tools information <#tools_information>`__ 51 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 52 53 .. container:: 54 55 +--------------+-----------------------------------------+-----------------------------------------+ 56 | **Tool** | **Description** | **Links** | 57 +--------------+-----------------------------------------+-----------------------------------------+ 58 | certutil 2.0 | Manage certificate and key databases | ` | 59 | | (cert7.db and key3.db). | Source <https://dxr.mozilla.org/mozilla | 60 | | | /source/security/nss/cmd/certutil/>`__, | 61 | | | :ref | 62 | | | :`mozilla_projects_nss_tools_certutil`, | 63 | | | :ref:`moz | 64 | | | illa_projects_nss_tools_certutil-tasks` | 65 +--------------+-----------------------------------------+-----------------------------------------+ 66 | cmsutil 1.0 | Performs basic CMS operations such as | `So | 67 | | encrypting, decrypting, and signing | urce <https://dxr.mozilla.org/mozilla/s | 68 | | messages. | ource/security/nss/cmd/smimetools/>`__, | 69 | | | :r | 70 | | | ef:`mozilla_projects_nss_tools_cmsutil` | 71 +--------------+-----------------------------------------+-----------------------------------------+ 72 | crlutil | Manage certificate revocation lists | `Source <https://dxr.mozilla.org/mozill | 73 | | (CRLs). | a/source/security/nss/cmd/crlutil/>`__, | 74 | | | :re | 75 | | | f:`mozilla_projects_nss_tools_crlutil`, | 76 +--------------+-----------------------------------------+-----------------------------------------+ 77 | dbck 1.0 | Analyze and repair certificate | `Source <https://dxr.mozilla.org/moz | 78 | | databases (not working in NSS 3.2) | illa/source/security/nss/cmd/dbck/>`__, | 79 | | | :ref: | 80 | | | `mozilla_projects_nss_tools_dbck-tasks` | 81 +--------------+-----------------------------------------+-----------------------------------------+ 82 | modutil 1.1 | Manage the database of PKCS11 modules | `Source <https://dxr.mozilla.org/mozill | 83 | | (secmod.db). Add modules and modify the | a/source/security/nss/cmd/modutil/>`__, | 84 | | properties of existing modules (such as | :re | 85 | | whether a module is the default | f:`mozilla_projects_nss_tools_modutil`, | 86 | | provider of some crypto service). | :ref:`mo | 87 | | | zilla_projects_nss_tools_modutil-tasks` | 88 +--------------+-----------------------------------------+-----------------------------------------+ 89 | pk12util 1.0 | Import and export keys and certificates | ` | 90 | | between the cert/key databases and | Source <https://dxr.mozilla.org/mozilla | 91 | | files in PKCS12 format. | /source/security/nss/cmd/pk12util/>`__, | 92 | | | :ref | 93 | | | :`mozilla_projects_nss_tools_pk12util`, | 94 | | | :ref:`moz | 95 | | | illa_projects_nss_tools_pk12util-tasks` | 96 +--------------+-----------------------------------------+-----------------------------------------+ 97 | signtool 1.3 | Create digitally-signed jar archives | ` | 98 | | containing files and/or code. | Source <https://dxr.mozilla.org/mozilla | 99 | | | /source/security/nss/cmd/signtool/>`__, | 100 | | | `Do | 101 | | | cumentation <https://docs.oracle.com/ja | 102 | | | vase/8/docs/technotes/guides/security/S | 103 | | | ecurityToolsSummary.html#jarsigner>`__, | 104 +--------------+-----------------------------------------+-----------------------------------------+ 105 | signver 1.1 | Verify signatures on digitally-signed | `Source <https://dxr.mozilla.org/mozill | 106 | | objects. | a/source/security/nss/cmd/signver/>`__, | 107 | | | `Document | 108 | | | ation <https://docs.oracle.com/javase/t | 109 | | | utorial/deployment/jar/verify.html>`__, | 110 | | | :ref:`mo | 111 | | | zilla_projects_nss_tools_signver-tasks` | 112 +--------------+-----------------------------------------+-----------------------------------------+ 113 | sslstrength | SSL Strength | :ref:` | 114 | | | mozilla_projects_nss_tools_sslstrength` | 115 +--------------+-----------------------------------------+-----------------------------------------+ 116 | ssltap 3.2 | Proxy requests for an SSL server and | `Source <https://dxr.mozilla.org/mozil | 117 | | display the contents of the messages | la/source/security/nss/cmd/ssltap/>`__, | 118 | | exchanged between the client and | : | 119 | | server. The ssltap tool does not | ref:`mozilla_projects_nss_tools_ssltap` | 120 | | decrypt data, but it shows things like | | 121 | | the type of SSL message (clientHello, | | 122 | | serverHello, etc) and connection data | | 123 | | (protocol version, cipher suite, etc). | | 124 | | This tool is very useful for debugging. | | 125 +--------------+-----------------------------------------+-----------------------------------------+