<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kgpgcertmanager "<application
>KgpgCertManager</application
>">
  <!ENTITY kappname "&kgpgcertmanager;">
  <!ENTITY package "kdepim">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Estonian  "INCLUDE">
]>

<book lang="&language;">

<bookinfo>
<title
>&kgpgcertmanager;i käsiraamat</title>

<authorgroup>
<author
><firstname
>Steffen</firstname
> <othername
></othername
> <surname
>Hansen</surname
> <affiliation
> <address
><email
>steffen@klaralvdalens-datakonsult.se</email
></address>
</affiliation>
</author>

<othercredit role="developer"
><firstname
>Kalle</firstname
> <surname
>Dalheimer</surname
> <contrib
>Arendaja</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Jesper</firstname
> <surname
>Pedersen</surname
> <affiliation
> <address
><email
>blackie@kde.org</email
></address>
</affiliation>
<contrib
>Arendaja</contrib>
</othercredit>
<othercredit role="developer"
><firstname
>Daniel</firstname
> <surname
>Molkentin</surname
> <affiliation
> <address
><email
>molkentin@kde.org</email
></address>
</affiliation>
<contrib
>Arendaja</contrib>
</othercredit>

<othercredit role="translator"
> <firstname
>Marek</firstname
> <surname
>Laane</surname
> <affiliation
><address
><email
>bald@online.ee</email
></address
></affiliation
> <contrib
>Tõlge eesti keelde</contrib
></othercredit
> 
</authorgroup>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2004-01-17</date>
<releaseinfo
>0.9</releaseinfo>

<abstract>
<para
>&kgpgcertmanager; aitab hallata X509 sertifikaate. </para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>Kapp</keyword>
<keyword
>X509</keyword>
<keyword
>LDAP</keyword>
<keyword
>gpg</keyword>
<keyword
>gpgsm</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction"
> <title
>Sissejuhatus</title
> 

<para
>&kgpgcertmanager; aitab hallata X509 sertifikaate gpgsm võtmekastis ja tõmmata sertifikaate <acronym
>LDAP</acronym
> serveritelt.</para>

</chapter>

<chapter id="functions"
><title
>Funktsioonid</title>

<sect1 id="search"
><title
>Otsimine</title>
<para
>Kui &kgpgcertmanager; käivitub, on ta valmis otsima sertifikaate kohalikus võtmekastis. Kirjuta kasvõi osa sertifikaadi omaniku nimest, vajuta otsimisnuppu ja mõne hetke pärast näed tulemusi.</para>
<para
>Tulemusel topeltklõpsu tehes ilmub dialoog sertifikaadi infoga.</para
> 
<para
>Hüpikkastis tööriistaribal on võimalik vahetada režiim "kohalikes sertifikaatides" režiimi vastu "välistes sertifikaatides", et otsida sertifikaate LDAP-serveritelt. Tulemuste ilmudes on võimalik teha igal sertifikaadil topeltklõps, et näha selle infot. Infodialoogil on ka nupp "Impordi kohalikuks", mis võimaldab importida sertifikaadi kohalikku võtmekasti.</para>
</sect1>

<sect1 id="quit"
><title
>Fail/Välju</title>
<para
>Menüükäsuga <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Välju</guimenuitem
></menuchoice
> saab rakenduse sulgeda. </para
></sect1>

<sect1 id="redisplay"
><title
>Vaade/Näita uuesti</title>
<para
>Menüükäsk <menuchoice
><guimenu
>Vaade</guimenu
><guimenuitem
>Näita uuesti</guimenuitem
></menuchoice
> sooritab äsjase otsingu uuesti ja näitab uusi tulemusi. </para
></sect1>

<sect1 id="newcert"
><title
>Sertifikaadid/Uus sertifikaat</title>
<para
>Menüükäsk <menuchoice
><guimenu
>Sertifikaadid</guimenu
><guimenuitem
>Uus sertifikaat</guimenuitem
></menuchoice
> käivitab sertifikaadi loomise nõustaja. See aitab sul mõne sammuga valmis saada sertifikaadisoovi. Soovi võib nõustaja töö lõppedes saata sertifitseerimiskeskusele (SK) signeerimiseks või salvestada failina (näiteks flopile, et selle saaks saata postiga SK-le).</para>
<para
>Kui oled nõustajas mingi sammuga ühele poole saanud, vajuta nupule <guibutton
>Järgmine</guibutton
>, et minna edasi järgmise sammu juurde (või nupule <guibutton
>Tagasi</guibutton
>, et vaadata kriitilise pilguga üle juba tehtu). Sertifikaadi loomise võib igal hetkel peatada, vajutades nupule <guibutton
>Katkesta</guibutton
>. </para>
<para
>Esimene samm nõustajas on sisestada sertifikaadi tarbeks enda andmed. Täitmist vajavad väljad on järgmised: <itemizedlist>
<listitem>
<para
><guilabel
>Nimi:</guilabel
> sinu nimi.</para>
</listitem>
<listitem>
<para
><guilabel
>Asukoht:</guilabel
> linn või asula, kus sa elad.</para>
</listitem>
<listitem>
<para
><guilabel
>Organisatsioon:</guilabel
> organisatsioon, mida sa esindad (näiteks firma, milles töötad).</para>
</listitem>
<listitem>
<para
><guilabel
>Allüksus:</guilabel
> organisatsiooni allüksus, kuhu sa kuulud. Näiteks "Raamatupidamine".</para
> 
</listitem>
<listitem>
<para
><guilabel
>Maakood:</guilabel
> selle maa kahetäheline kood, kus sa elad. Näiteks "EE".</para>
</listitem>
<listitem>
<para
><guilabel
>E-posti aadress:</guilabel
> sinu meiliaadress. Kirjuta sinna kindlasti kehtiv aadress, sest sellele saadavad inimesed kirju, kui nad sinu sertifikaati kasutavad.</para>
</listitem>
</itemizedlist>
</para
><para
>Järgmine samm nõustajas on valik, kas salvestada sertifikaat faili või saata otse SK-le. Sertifikaadisoovi saatmiseks tuleb määrata failinimi või meiliaadress. </para
></sect1>


<sect1 id="import"
><title
>Import/Sertifikaat</title>
<para
>Menüükäsk <menuchoice
><guimenu
>Import</guimenu
><guimenuitem
>Sertifikaat...</guimenuitem
></menuchoice
> võimaldab importida sertifikaadi failist kohalikku võtmekasti</para
><para
>Sertifikaadifaili vorming peab olema mõistetav taustaprogrammile gpg. Täpsema info jaoks vaata gpg ja gpgsm käsiraamatuid. </para>
</sect1>

<sect1 id="crl"
><title
>Import/CRL</title>
<para
>Tavaliselt käitleb taustaprogramm sertifikaadi tühistamise nimekirju (CRL-id) läbipaistvalt, kuid vahel võib olla kasulik importida nimekiri käsitsi kohalikku CRL-puhvrisse.</para>
<para
>Seda saab teha menüükäsuga <menuchoice
><guimenu
>Import</guimenu
><guimenuitem
>CRL...</guimenuitem
></menuchoice
>.</para>
<para
>MÄRKUS: Et CRLi import töötaks, peab rakendus "dirmngr" asuma otsinguteel. Kui menüükäsk <guimenuitem
>Failist...</guimenuitem
> ei ole lubatud, tuleks pöörduda süsteemi administraatori poole ja paluda tal paigaldada dirmngr. </para>
<para
>Kohaliku CRL vahemälu sisu saab vaadata menüükäsuga <menuchoice
><guimenu
>Vaade</guimenu
><guimenuitem
>CRL vahemälu...</guimenuitem
></menuchoice
>. See tekitab dialoogi infoga vahemälus asuvate CRLide ning sertifikaadi sõrmejälgede kohta igas CRLis. </para>
</sect1>

<sect1 id="admin"
><title
>Administraatori juhised</title>
<sect2>
<title
>Sertifikaadi loomise nõustaja kohandamine</title>
<para
>&kgpgcertmanager; lubab kohandada välju, mida kasutajal on lubatud täita oma sertifikaadi loomisel. </para>
<para
>Loo süsteemses failis <filename
>kgpgcertmanagerrc</filename
> grupp CertificateCreationWizard. Kui soovid kohandada atribuutide järjekorda või lubada ainult teatud elementide näitamist, loo võti <varname
>DNAttributeOrder</varname
>. Argumendiks võivad olla <varname
>CN,SN,GN,L,T,OU,O,PC,C,SP,DC,BC,EMAIL</varname
>. Kui soovid täita väljad eelnevalt määratud väärtustega, pane vajalikud väärtsed kirja kujul atribuut=väärtus. Kui soovid, et atribuut oleks nõutav, lisa selle järele hüüumärk (nt. <varname
>CN!,L,OU,O!,C!,EMAIL!</varname
>, mis muide esineb ka vaikekonfiguratsioonis). </para
><para
><acronym
>KIOSK</acronym
>i režiimi muutujate <varname
>$e</varname
> kasutamine lubab hankida väärtused keskkonnamuutujatest või konkreetsest skriptist või binaarfailist. Kui soovid lisaks keelata mõne välja muutmise, kasuta muutujat <varname
>$i</varname
>. Kui soovid keelata nupu <guibutton
>Lisa minu aadress</guibutton
> kasutamise, määra <varname
>ShowSetWhoAmI</varname
> väärtuseks 'väär' (false). </para>

<tip
><para
>&kde; <acronym
>KIOSK</acronym
>i raamistiku iseloomu tõttu muudab muutmist vältiva lipu <varname
>$i</varname
> pruukimine kasutajal selle tühistamise võimatuks. Sellel on oma kindel mõte. Muutujaid <varname
>$i</varname
> ja <varname
>$e</varname
> saab kasutada mis tahes muu &kde; rakendustest tarvitatava võtmega. </para
></tip>

<para
>Järgnev näide selgitab kohandamisvõimalusi:</para>

<para>
<programlisting
>[CertificateCreationWizard] 
;Keelab isiklike andmete kopeerimise aadressiraamatust, ei luba kohalikku tühistamist
ShowSetWhoAmI[$i]=false

;määrab kasutaja nimeks $USER
CN[$e]=$USER

;määrab firma nimeks "Minu firma", keelab muutmise
OU[$i]=Minu firma

;määrab osakonna nime hankimise skripti väärtusest
O[$ei]=$(lookup_dept_from_ip)

; määrab riigiks EE, kuid lubab kasutajal seda muuta
C=EE
</programlisting>

</para>
</sect2>
</sect1>

<sect1 id="help"
><title
>Abi</title>


<para
>Menüü <guimenu
>Abi</guimenu
> sisaldab tavapärast &kde; abimenüüd.</para>
&help.menu.documentation; </sect1>

</chapter>

<chapter id="credits-and-license">
<title
>Autorid ja litsents</title>

<para
>&kgpgcertmanager;i autoriõigus 2002: Steffen Hansen, Kalle Dalheimer ja Jesper Pedersen, autoriõigus 2004: Daniel Molkentin.</para>

<para
>Dokumentatsiooni autoriõigus 2002: Steffen Hansen, autoriõigus 2004: Daniel Molkentin</para>

<itemizedlist>
<title
>Kaasaaitajad</title>
<listitem>
<para
>Steffen Hansen <email
>hansen@kde.org</email
></para>
</listitem>
<listitem>
<para
>Kalle Dalheimer <email
>kalle@kde.org</email
></para>
</listitem>
<listitem>
<para
>Jesper Pedersen <email
>blackie@kde.org</email
></para>
</listitem>
<listitem>
<para
>Daniel Molkentin <email
>molkentin@kde.org</email
></para>
</listitem>
</itemizedlist>
&underGPL; &underFDL; </chapter>

&documentation.index; 
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->
