# &kgpgcertmanager;-håndbogen

Steffen Hansen

    steffen@klaralvdalens-datakonsult.se

Kalle Dalheimer Udvikler
Jesper Pedersen

    blackie@kde.org

Udvikler
Daniel Molkentin

    molkentin@kde.org

Udvikler
&erik.kjaer.pedersen.role;
&FDLNotice;
2004-01-17
0.9

&kgpgcertmanager; er et værktøj til at håndtere X509-certifikater.

KDE Kapp X509 LDAP gpg gpgsm

## Indledning

&kgpgcertmanager; er et værktøj til at håndtere X509-certifikater i GPGSM-nøgleboksen og til at hente certifikater fra LDAP-servere.

## Funktioner

### Søgning

Når &kgpgcertmanager; starter, er den allerede klar til at søge efter certifikater i den lokale nøgleboks: indskriv blot en del af navnet på en certifikatejer, og tryk på søgeknappen så vil resultatet blive vist.

Ved et resultat dobbeltklikkes, vises en dialog med information om certifikatet.

Kombinationsboksen i værktøjslinjen kan ændres fra "i lokale certifikater" til "i eksterne certifikater" for at søge efter certifikater på LDAP-servere. Når resultatet vises, kan hvert certifikat dobbeltklikkes for at vise en informationsdialog; denne dialog har knappen "Importér lokalt" som gør at certifikatet kan importeres til den lokale nøgleboks.

### Fil/Afslut

Menupunktet Fil Afslut afslutter programmet.

### Vis/Vis igen

Menupunktet Vis Vis igen udfører nuværende forespørgsel en gang til og viser resultatet.

### Certifikat/Nyt certifikat

Menupunktet Certifikat Nyt certifikat starter guiden for at oprette en forespørgsel om et certifikat. Den fører dig gennem et antal skridt til at oprette en forespørgsel om et certifikat. Når guiden afsluttes, kan denne forespørgsel enten sendes til en certifikatutautoritet (CA) for at blive underskrevet, eller gemmes til en fil (for eksempel på en diskette, så den kan sendes til certifikatautoriteten).

Så snart du er færdig med et skridt i guiden, tryk så på Næste for at gå til næste skridt (eller Tilbage for at kontrollere skridt som allerede er færdige). Oprettelsen af forespørgsler om certifikater kan afbrydes når som helst ved at trykke på knappen Annullér.

Det første skridt i guiden er at indtaste persondata for certifikatet. Feltet som skal udfyldes i er:

- Navn: Dit navn;

- Sted: Byen du bor i;

- Organisation: Organisationen du repræsenterer (f.eks. det firma hvor du arbejder);

- Afdeling: Enheden i organisationen hvor du er, for eksempel "Logistik";

- Landekode: Koden med to bogstaver for landet du bor i (for eksempel "dk");

- E-postadresse: Din e-postadresse. Sørg for at du skriver dette rigtigt — det er adressen som alle sender breve til når de anvender dit certifikat.

Næste skridt i guiden er at vælge om certifikatet skal opbevares i en fil eller sendes direkte til certifikatautoriteten. Du skal angive filnavn eller e-postadresse hvortil forespørgsler om certifikatet skal sendes.

### Importér/Certifikat

Menupunktet Importere Certifikat... lader dig importere et certifikat fra en fil til den lokale nøgleboks.

Certifikatfilens format skal være et som kan forstås af GPG-baggrundsprogrammet. Se manuelerne for GPG og GPGSM for detaljer om dette.

### Importér/CRL

Normalt håndteres certifikattilbagekaldslister (CRL'er) transparent af baggrundsprogrammet, men ind imellem kan det være nyttigt at importere CRL'er til den lokale CRL-cache manuelt.

Det kan gøres med menupunktet Importér CRL....

Bemærk: For at CRL-import skal virke, skal værktøjet "dirmngr" være i søgestien. Hvis menupunktet Fra fil... ikke kan vælges, bør du kontakte systemadministratoren og bede om at få dirmngr installeret.

Du kan kigge på indholdet i den lokale CRL-cache med menupunktet Vis CRL-cache.... Det vil vise en dialog med information om CRL'er som findes i cachen og fingeraftrykket for certifikaterne i hver CRL.

### Administrator-guide

#### Brugerindstilling af certifikat-oprettelsesguide

&kgpgcertmanager; tillader tilpasning af felterne som brugeren har lov til at indtaste for at lave sit certifikat.

Lav en gruppe der hedder CertificateCreationWizard i den systemomfattende `kgpgcertmanagerrc`. Hvis du ønsker en tilpasset rækkefølge af attributter eller hvis du kun ønsker at visse punkter skal ses, så lav en nøgle der hedder `DNAttributeOrder`. Argumentet er en mere af `CN,SN,GN,L,T,OU,O,PC,C,SP,DC,BC,EMAIL` Hvis du ønsker at forhindre felter med en bestemt værdi, så skriv noget i retning af Attribute=værdi. Hvis du ønsker at attributten skal behandles som krævet, så efterfølg den med et udråbstegn (f.eks. `CN!,L,OU,O!,C!,EMAIL!`, hvilket rent faktisk er standardindstillingen).

Brug af KIOSK-tilstandsflaget `$e` tillader at hente værdierne fra miljøvariabler eller fra et evalueret script eller binært program. Hvis du yderligere ønsker at forbyde redigering af de respektive felter, så brug flaget `$i`. Hvis du ønsker at forbyder brugen af knappen Indsæt min adresse så sæt `ShowSetWhoAmI` til falsk.

På grund af naturen af &kde;'s KIOSK-skelet, vil brug af flaget (`$i`) gøre det umuligt for brugeren at sætte flaget ud af kraft. Dette er med vilje. `$i` og `$e` kan bruges med en vilkårlig anden config-nøgle i &kde;'s programmer.

Følgende eksempel antyder mulige tilpasninger:

    [CertificateCreationWizard]
    ;Forbyd at kopiere personlige data fra adressebogen, tillad ikke lokalt at sætte ud af kraft
    ShowSetWhoAmI[$i]=false

    ;sætter brugernavnet til $USER
    CN[$e]=$USER

    ;sætter firmanavnet til "Mit firma", forbyder redigering
    OU[$i]=Mit firma

    ;sætter afdelingens navn til enværdi returneret af et script
    O[$ei]=$(slaa_afd_op_fra_ip)

    ; sætter land til DK, men tillader ændringer af brugeren
    C=DK

### Hjælp

Hjælpemenuen indeholder &kde;'s standardmenu for hjælp.

&help.menu.documentation;

## Medvirkende og licens

&kgpgcertmanager; ophavsret 2002 Steffen Hansen, Kalle Dalheimer og Jesper Pedersen, ophavsret 2004 Daniel Molkentin

Dokumentation ophavsret 2002 Steffen Hansen ophavsret 2004 Daniel Molkentin

Bidragydere

- Steffen Hansen hansen@kde.org

- Kalle Dalheimer kalle@kde.org

- Jesper Pedersen blackie@kde.org

- Daniel Molkentin molkentin@kde.org

&underGPL; &underFDL;
&documentation.index;