kcontrol5/kcm_ssl/index.docbook

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
0003 "dtd/kdedbx45.dtd" [
0004   <!ENTITY % addindex "IGNORE">
0005   <!ENTITY % English "INCLUDE">
0006 ]>
0007 <article id="kcm_ssl" lang="&language;">
0008 <title>SSL Versions and Certificates</title>
0009 <articleinfo>
0010 <authorgroup>
0011 <author><firstname>Subhashish</firstname> <surname>Pradhan</surname></author>
0012 <author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
0013 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0014 </authorgroup>
0015
0016 <date>2015-04-09</date>
0017 <releaseinfo>Frameworks 5.9</releaseinfo>
0018
0019 <keywordset>
0020 <keyword>KDE</keyword>
0021 <keyword>Systemsettings</keyword>
0022 <keyword>SSL</keyword>
0023 <keyword>certificates</keyword>
0024 </keywordset>
0025 </articleinfo>
0026
0027 <sect1 id="intro">
0028 <title>Introduction</title>
0029 <para>&kde; provides a list of all the X.509 certificates used by the system. They
0030 can be accessed in the <guilabel>SSL Preferences</guilabel> module in
0031 &systemsettings;.</para>
0032
0033 <para>This module provides a categorized listing of all SSL versions and
0034 certificates. You can see the details of each of the certificates and add, delete,
0035 disable, or enable them.</para>
0036
0037 <para>The certificates are categorized into <guilabel>System certificates</guilabel>
0038 and <guilabel>User-added certificates</guilabel>. The <guilabel>System
0039 certificates</guilabel> are further categorized by the organization that issued
0040 them.</para>
0041
0042 <screenshot id="screenshot-module">
0043 <screeninfo>The SSL Versions and Certificates module</screeninfo>
0044 <mediaobject>
0045 <imageobject><imagedata fileref="module.png" format="PNG"/></imageobject>
0046 <textobject><phrase>The SSL Versions and Certificates module</phrase></textobject>
0047 </mediaobject>
0048 </screenshot>
0049
0050 <sect2 id="details">
0051 <title>Viewing the Details of a Certificate</title>
0052
0053 <para>Select a certificate under a listed organization, and click on the
0054 <guibutton>Display...</guibutton> underneath the list to view the details of the
0055 certificate.</para>
0056
0057 <screenshot id="screenshot-details">
0058 <screeninfo>Viewing the Details of a Certificate</screeninfo>
0059 <mediaobject>
0060 <imageobject><imagedata fileref="details.png" format="PNG"/></imageobject>
0061 <textobject><phrase>The certificate details window.</phrase></textobject>
0062 </mediaobject>
0063 </screenshot>
0064
0065 </sect2>
0066
0067 <sect2 id="enable-disable">
0068 <title>Enabling or Disabling a Certificate</title>
0069
0070 <para>First, select a certificate listed under an organization.  Then, click the
0071 <guibutton>Enable</guibutton> button to enable the certificate, or click the
0072 <guibutton>Disable</guibutton> button to disable an enabled certificate.</para>
0073
0074 <para>Alternatively, you can enable or disable a certificate by selecting or
0075 clearing the check box before the certificate.</para>
0076
0077 <tip>
0078 <para>You can enable or disable multiple certificates by selecting them while
0079 holding the &Ctrl; key and then clicking on the <guibutton>Enable</guibutton> or
0080 <guibutton>Disable</guibutton> button below the list.</para>
0081 </tip>
0082
0083 </sect2>
0084
0085 <sect2 id="add">
0086 <title>Adding a Certificate</title>
0087
0088 <!--link file selector dialog to buildingblocks when its done-->
0089 <para>First, click on the <guibutton>Add...</guibutton> button below the certificate
0090 list.  It will open the file selector dialog allowing you to locate where the
0091 certificate files are stored.  After locating the certificate file, select it
0092 and click on the <guibutton>Open</guibutton> button to add it.</para>
0093
0094 <note>
0095 <para>The certificates must be in one of the following formats:
0096 <acronym>DER</acronym>, <acronym>PEM</acronym>, or &Netscape;-encoded X.509
0097 certificate.</para>
0098 </note>
0099
0100 </sect2>
0101
0102 <sect2 id="remove">
0103 <title>Removing a Certificate</title>
0104
0105 <para>Select the listed certificate that you want to remove, and click the
0106 <guibutton>Remove</guibutton> button to remove the certificate.</para>
0107
0108 <important>
0109 <para>System certificates cannot be removed.</para>
0110 </important>
0111
0112 </sect2>
0113
0114 <sect2 id="ack">
0115 <title>Thanks and Acknowledgments</title>
0116
0117 <para>Special thanks to Google Code-In 2011 participant Subhashish Pradhan for
0118 writing this article.</para>
0119
0120 </sect2>
0121
0122 </sect1>
0123
0124 </article>
0125
0126 <!--
0127 Local Variables:
0128 mode: xml
0129 sgml-minimize-attributes:nil
0130 sgml-general-insert-case:lower
0131 sgml-indent-step:0
0132 sgml-indent-data:nil
0133 End:;
0134 -->