# Підручник з &kleopatra;

Marc
Mutz

    marc@kdab.net

David
Faure
Розробник
Steffen
Hansen

    &Steffen.Hansen.mail;

Розробник
Matthias Kalle
Dalheimer
Розробник
Jesper
Pedersen

    &Jesper.Pedersen.mail;

Розробник
Daniel
Molkentin

    &Daniel.Molkentin.mail;

Розробник
Юрій
Чорноіван

    yurchor@ukr.net

Переклад українською
&GPLNotice;
2009-02-19
2.0.5

&kleopatra; — це інструмент для роботи з сертифікатами X.509 і OpenPGP.

KDE
Kapp
X509
LDAP
gpg
gpgsm

## Вступ

&kleopatra; — це інструмент &kde; для керування сертифікатами X.509 і OpenPGP у наборі ключів &gpgsm; і отримання сертифікатів з серверів LDAP.

&kleopatra; можна запустити з меню Інструменти Керування сертифікатами &kmail; або за допомогою командного рядка. Виконуваний файл програми &kleopatra; називається ``kleopatra``.

Програму було названо на честь Клеопатри, славнозвісної цариці Єгипту, яка жила у часи Юлія Цезаря, з яким, як говорять, у неї був інтимний зв’язок.

Таку назву було обрано, оскільки програма бере початок з Ägypten Projects (Ägypten німецькою означає Єгипет). &kleopatra; — це запис німецькою мовою імені Клеопатри.

## Основні функції

### Перегляд локального сховища ключів

Основною функцією &kleopatra; є показ і редагування вмісту локального сховища ключів, яке подібне до зв’язок ключів &gpg;, якщо не занадто захоплюватися продовженням цієї аналогії.

Головне вікно програми поділено на велику область списку ключів, що складається з декількох вкладок, смужку меню і панель пошуку, розташовані згори, і смужку стану, розташовану внизу вікна.

Кожному рядку у списку ключів відповідає один сертифікат, що визначається так званим &dn; суб’єкта. &dn; — це скорочення від Distinguished Name (окрема назва), ідентифікатор у ієрархії, дуже подібний до системного шляху з незвичайним синтаксисом запису, який, як припускається, однозначно визначає даний сертифікат.

Щоб бути чинними і придатними для використання, (відкриті) ключі мусять бути підписані &ca; (видавцем цифрових сертифікатів). Ці підписи називаються сертифікатами, але, зазвичай, терміни сертифікат і (відкритий) ключ використовуються один замість іншого в тому самому значенні, і ми також не будемо їх відрізняти в цьому підручнику (за винятком окремо зазначених випадків).

Щоб &ca; набув чинності, його, у свою чергу, має бути підписано іншим &ca;. Звичайно ж, такий ланцюжок має десь закінчуватися, тому &ca; найвищого рівня (кореневий &ca;) підписує свій ключ самостійно (такий ключ називається самопідписаним). Таким чином, кореневим сертифікатам слід призначати чинність (яку зазвичай називають надійністю) вручну, наприклад, після порівняння їх відбитку з відбитком з веб-сайта &ca;. Зазвичай, ці дії виконуються системним адміністратором або виробником продукту, який використовує сертифікати, але користувач може виконати їх і самостійно за допомогою інтерфейсу командного рядка &gpgsm;.

Щоб дізнатися, які з сертифікатів є кореневими, ви можете перемкнути програму до режиму ієрархічного списку ключів за допомогою пункту меню Перегляд Ієрархічний список сертифікатів.

Ви можете переглянути докладні відомості щодо будь-якого з сертифікатів, навівши на його позначку вказівник миші і клацнувши двічі лівою кнопкою, переглянути відомості можна і за допомогою пункту меню Перегляд Подробиці про сертифікат. У відповідь на ваші дії програма відкриє діалогове вікно, у якому буде показано найзагальніші властивості сертифіката, його ланцюжок сертифікатів (тобто ланцюжок видавців, аж до кореневого &ca;), а також показано всі відомості, які сервер обробки зможе видобути з сертифіката.

Якщо у сховище ключів було внесено зміни без використання &kleopatra; (наприклад, за допомогою інтерфейсу командного рядка &gpgsm;), ви можете оновити дані у перегляді за допомогою пункту меню F5 Перегляд Показати повторно.

### Пошук та імпортування сертифікатів

У більшості випадків нові сертифікати будуть отримуватися перевіркою підписів повідомлень електронної пошти, оскільки ці сертифікати вбудовано до підписів, які створюються за їх допомогою. У випадку ж, коли вам потрібно буде надіслати листа електронної пошти комусь, з ким у вас ще немає контакту, вам слід буде отримати сертифікат з каталогу LDAP (хоча &gpgsm; може виконувати цю дію в автоматичному режимі) або з файла. Вам також слід буде імпортувати ваш власний сертифікат після отримання відповіді &ca; на ваш запит щодо сертифікації.

Щоб виконати пошук сертифіката у каталозі LDAP, скористайтеся пунктом меню Файл Пошук сертифікатів на сервері, а потім введіть якийсь текст (наприклад, ім’я особи, сертифікат якої ви бажаєте знайти) у поле діалогового вікна Пошук сертифіката на сервері ключів і натисніть кнопку Пошук. Результати буде показано у списку ключів, розташованому під панеллю пошуку. Там ви зможете обирати сертифікати для перегляду відомостей про них за допомогою натискання кнопки Подробиці або звантаження їх до локального сховища ключів за допомогою кнопки Імпортувати.

Ви можете налаштувати список серверів LDAP, на яких виконуватиметься пошук, на сторінці Служби каталогу діалогового вікна налаштування &kleopatra;.

Якщо ви отримали сертифікат у файлі, скористайтеся пунктом меню Файл Імпортувати сертифікати.... &gpgsm; має підтримувати формат файлів, у якому записано ваш файл сертифіката. Список підтримуваних форматів можна знайти у підручнику з &gpgsm;.

Якщо ви не створювали вашу пару ключів за допомогою &gpgsm;, вам також доведеться вручну імпортувати відкритий ключ (а також закритий ключ) з файла PKCS#12, який ви отримали від &ca;. Виконати цю дію можна за допомогою командного рядка, а саме, команди ``kleopatra `--import-certificate` `назва файла```, або за допомогою графічного інтерфейсу &kleopatra;, а саме, пункту меню Файл Імпортувати сертифікати..., тобто виконати дії, які ви виконуєте зі звичайними сертифікатами.

### Як створювати нові пари ключів

За допомогою пункту меню Файл Створити сертифікат... можна відкрити майстер створення запиту на сертифікат, який допоможе вам виконати декілька кроків створення запиту на сертифікат.

Після заповнення сторінки майстра належними даним, натисніть кнопку Далі, щоб перейти до наступного кроку (або кнопку Назад, щоб змінити відомості введені на попередніх сторінках). Процес створення запиту на сертифікат можна у будь-який момент перервати натисканням кнопки Скасувати.

На першій сторінці майстра вам слід обрати тип сертифіката, який ви бажаєте створити:

Створити особисту пару ключів OpenPGP

  Пари ключів OpenPGP буде створено локально і посвідчено вашими друзями або знайомими. Централізовано гаранта сертифікатів не буде; замість цього кожен користувач створює особисту мережу надійності, посвідчуючи пари ключів інших користувачів своїм власним сертифікатом.

  Вам слід ввести Ім’я, Адресу ел. пошти і, за бажання, Коментар.

Створити особисту пару ключів X.509 і запит на посвідчення

  Пари ключів X.509 створюються локально, але сертифікуються централізовано службами сертифікації (&ca;). Служби сертифікації можуть надавати сертифікати іншим службам сертифікації. Таким чином, створюється централізований, ієрархічний ланцюжок надійності.

  На наступному кроці роботи майстра вам потрібно буде ввести ваші особисті дані для сертифіката. Серед полів, які вам потрібно буде заповнити:

  - П. І. Б.: ваше ім’я;

  - Адреса ел. пошти: адреса вашої електронної пошти, перевірте правильність введеної інформації, — цю адресу буде використано тими, хто надсилатиме пошту з використанням вашого сертифіката.

  - Адреса: місто або селище, у якому ви мешкаєте;

  - Відділ організації: підрозділ організації, у якій ви працюєте (наприклад, «Логістики»);

  - Організація: організація, яку ви представляєте (наприклад, компанія, на яку ви працюєте);

  - Код країни: дволітерний код країни, у якій ви мешкаєте (наприклад, «UA»);

  Наступним кроком у майстрі буде вибір між збереженням сертифіката до файла і безпосереднім надсиланням його до &ca;. Вам слід буде вказати назву файла або адресу електронної пошти, на яку буде надіслано запит на сертифікацію.

### Керування сховищем ключів

Окрім показу списку і перевірки, пошуку і імпортування сертифікатів, а також створення нових сертифікатів, у &kleopatra; є деякі менше вживані функції, які допоможуть вам керувати вашим локальним сховищем ключів.

Серед цих функцій вилучення сертифікатів з локального сховища сертифікатів за допомогою пункту Del Сертифікати Вилучити, а також функції ручного керування списками скасованих сертифікатів ( Інструменти Освіжити сертифікати , Інструменти Спорожнити кеш CRL, Інструменти Скинути кеш CRL).

## Довідник з меню

### Меню Файл

&Ctrl;N Файл Створити сертифікат...

  Створює нову пару ключів (відкритого і закритого) і надає змогу надіслати відкриту частину до служби сертифікації (&ca;) для підписування. Отриманий сертифікат буде повернуто вам або збережено на сервері LDAP для наступного звантаження до локального сховища сертифікатів, звідки ви зможете скористатися ним для підписування і розшифрування повідомлень електронної пошти.

  Такий режим роботи називається децентралізованим створенням ключів, оскільки всі ключі створюються локально. &kleopatra; (і &gpgsm;) безпосередньо не підтримують централізованого створення ключів, але ви можете імпортувати зв’язку відкритих/закритих ключів, яку ви отримали від &ca; у форматі PKCS#12 за допомогою пункту меню Файл Імпортувати сертифікати....

&Ctrl;I Файл Імпортувати сертифікати...

  Імпортує сертифікати і/або закриті ключі з файлів до локального сховища ключів.

  Формат файла сертифіката має підтримуватися &gpgsm;. Будь ласка, зверніться до підручника з &gpgsm;, щоб переглянути список підтримуваних форматів.

&Ctrl;E Файл Експортувати сертифікати...

  Експортує вибрані сертифікати до файла.

  За допомогою цього пункту меню можна експортувати лише відкриті ключі, навіть якщо ви маєте і закритий ключ. Для експорту до файла пари ключів (відкритого і закритого) скористайтеся пунктом меню Файл Експортувати закритий ключ..., але пам’ятайте, що виконання такого експорту може призвести до дуже небажаних наслідків для безпеки вашої системи.

Файл Експортувати закритий ключ...

  Експортує як відкритий, так і закритий ключі до файла (PKCS#12).

  Потреба у використанні цього пункту виникатиме рідко, якщо ж вона виникатиме, вам слід все ретельно спланувати. Планування перенесення закритого ключа полягає зокрема у виборі носія для перенесення і надійному вилученні даних ключа з попередньої системи, а також з носія для перенесення.

&Ctrl;Q Файл Вийти

  Завершує роботу &kleopatra;.

### Меню Перегляд

F5 Перегляд Показати повторно

  Повторно визначає відомості з вибраних сертифікатів або оновлює список сертифікатів.

  Якщо було виділено певні сертифікати, дію з оновлення буде застосовано лише до цих сертифікатів.

  Якщо у поточному вікні показано результати запиту (до віддаленого або локального сховища сертифікатів), запит буде надіслано повторно, а результати його виконання буде показано замість попередніх результатів.

  Якщо запитів не виконувалося, вміст всього сховища ключів буде повторно отримано і показано.

  Ви можете скористатися цим пунктом, якщо ви змінили вміст сховища ключів поза програмою &kleopatra; (наприклад, за допомогою інтерфейсу командного рядка &gpgsm;).

Esc Перегляд Зупинити операцію

  Зупиняє (скасовує) всі операції з черги, наприклад, операції з пошуку або звантаження.

  Залежно від сервера, послугами якого ви користуєтеся, скасування пошуку у віддаленому сховищі може заблокувати роботу &kleopatra; на декілька секунд, протягом яких програма чекатиме на завершення роботи сервера виконання дій. Така поведінка програми є нормальною і очікуваною.

Перегляд Подробиці про сертифікат

  Показує відомості щодо поточного обраного сертифіката.

  Доступ до цієї функціональної можливості можна також отримати наведенням вказівника миші на відповідну позначку у списку ключів з наступним подвійним клацанням лівою кнопкою миші.

Перегляд Ієрархічний список сертифікатів

  Перемикає показ між режимами ієрархічного і плоского списків ключів.

  У режимі перегляду ієрархії сертифікати буде впорядковано за параметрами видавця/предмета, таким чином, ви легко зможете побачити, до якої ієрархії сертифікатів належить той чи інший сертифікат, але знайти потрібний сертифікат буде складніше (хоча ви, звичайно ж, можете скористатися панеллю пошуку).

  У плоскому режимі всі сертифікати буде показано як плоский список, впорядкований за абеткою. У цьому режимі легше знайти потрібний сертифікат, але вам буде непросто визначити, до якого кореневого сертифіката належить потрібний вам сертифікат.

&Ctrl;. Перегляд Розгорнути всі

  (Ця функціональна можливість стане доступною, лише якщо позначено пункт меню Перегляд Ієрархічний список сертифікатів.)

  Розгортає всі записи перегляду списку сертифікатів, тобто робить всі записи видимими.

  Це типовий параметр після входу до режиму ієрархічного списку ключів.

  Ви, звичайно ж, можете розгорнути або згорнути кожен з записів окремо.

&Ctrl;, Перегляд Згорнути всі

  (Ця функціональна можливість стане доступною, лише якщо позначено пункт меню Перегляд Ієрархічний список сертифікатів.)

  Згортає всі пункти перегляду списку сертифікатів, тобто ховає всі підлеглі елементи елементів вищого рівня.

  Ви, звичайно ж, можете розгорнути або згорнути кожен з записів окремо.

### Меню Сертифікати

Del Сертифікати Вилучити

  Вилучає виділені сертифікати з локального сховища ключів.

  За допомогою цього пункту можна вилучити з вашого локального сховища ключі, які не використовуються. Але, оскільки сертифікати типово долучаються до підписаних повідомлень електронної пошти, перевірка поштової скриньки може призвести до того, що щойно вилучений ключ знову з’явиться у сховищі ключів. Отже, вам, ймовірно, слід, за можливості, уникати використання цього пункту. Якщо вам важко розібратися у списку сертифікатів, скористайтеся панеллю пошуку або пунктом меню Перегляд Ієрархічний список ключів, щоб розібратися великому сховищі сертифікатів.

Сертифікати Створити дамп сертифіката

  Докладно показує вміст кешу CRL &gpgsm;.

### Меню Інструменти

Інструменти Переглядач журналу GnuPG...

  Запускає &kwatchgnupg;, інструмент для показу даних, які виводить програма GnuPG. Якщо раптом з незрозумілих причин стає непрацездатним підписування, шифрування або перевірка, ви можете знайти причину у даних, які виводить ця програма.

Інструменти Освіжити сертифікати X.509 або OpenPGP

  Для оновлення сертифікатів X.509 або OpenPGP програмі доведеться звантажити всі сертифікати і CRL, щоб перевірити, чи не було часом відкликано деякі з них.

  Подібне звантаження може значно навантажити ваше мережеве з’єднання та інші мережеві з’єднання, а отже може тривати годину або більше, залежно від швидкості з’єднання та кількості сертифікатів, які слід перевірити.

Інструменти Спорожнити кеш CRL

  Спорожняє кеш CRL &gpgsm;.

  Ймовірно, що цей пункт ніколи вам не знадобиться. Замість цього пункту ви можете освіжити кеш CRL у примусовому порядку вибором всіх сертифікатів з наступним використанням пункту Сертифікати Освіжити сертифікати.

Інструменти Скинути кеш CRL

  Докладно показує вміст кешу CRL &gpgsm;.

Параметри Налаштувати сервер GnuPG...

  Відкриває діалогове вікно, за допомогою якого ви зможете налаштувати всі аспекти &gpgsm; та інших модулів-серверів.

  Вміст цього діалогового вікна створюється у динамічному режимі на основі даних, виведених програмою &gpgconf;, а тому може змінюватися за оновлення модулів серверів обробки.

### Меню Параметри

Параметри Показати смужку стану

  Вмикає або вимикає показ смужки стану у нижній частині вікна програми.

Параметри Налаштувати скорочення...

  Відкриває стандартне діалогове вікно налаштування клавіатурних скорочень &kde;, у цьому вікні ви зможете призначити або змінити призначення клавіатурних скорочень для всіх пунктів меню програми.

Параметри Налаштувати &kleopatra;...

  Відкриває діалогове вікно налаштування &kleopatra;.

  Докладніші відомості можна знайти у розділі .

### Меню Вікно

За допомогою меню Вікно ви можете керувати вкладками. Пункти цього меню призначено для перейменування вкладки, додавання нової вкладки, дублювання поточної вкладки, та пересування вкладки ліворуч або праворуч.

Наведення вказівника миші на вкладку з наступним клацанням правою кнопкою миші відкриває контекстне меню, за допомогою якого ви зможете виконати ці самі дії.

### Меню Довідка

У меню Довідка містяться стандартні пункти довідкового меню &kde;.

&help.menu.documentation;

## Довідник з параметрів командного рядка

Тут ви знайдете перелік параметрів, які специфічні для &kleopatra;. Як і у інших програмах &kde;, повний список параметрів можна переглянути за допомогою команди ``kleopatra `--help```.

`--external`

  Запустити лише сервер інтерфейсу користувача, сховати головне вікно

`-p` `--openpgp`

  Використовувати OpenPGP для наступної дії

`-c` `--cms`

  Використовувати CMS (X.509, S/MIME) для наступної дії

`-i` `--import-certificate`

  Визначає файл або адресу &URL;, з якої слід імпортувати сертифікати (або закриті ключі).

  Ця команда є еквівалентом пункту меню Файл Імпортувати сертифікати....

`-e` `--encrypt`

  Зашифрувати файл(и)

`-s` `--sign`

  Підписати файл(и)

`-E` `--encrypt-sign`

  Зашифрувати і/або підписати файл(и)

`-d` `--decrypt`

  Розшифрувати файл(и)

`-V` `--verify`

  Перевірити файл або підпис

`-D` `--decrypt-verify`

  Розшифрувати і/або перевірити файл(и)

## Як налаштувати &kleopatra;

Відкрити діалогове вікно налаштування &kleopatra; можна за допомогою пункту меню Параметри Налаштувати &kleopatra;....

Кожну з його сторінок описано у подальших розділах.

### Налаштування Служб каталогів

За допомогою цієї сторінки ви зможете вказати сервери LDAP, які буде використано для пошуку сертифікатів. Крім того, ви можете налаштувати порядок цих серверів, а також деякі вибрані параметри, пов’язані з LDAP, отримані з динамічного діалогового вікна налаштування серверів обробки, доступ до якого можна отримати за допомогою пункту меню Інструменти Налаштувати сервер GnuPG....

Щоб додати новий сервер, натисніть кнопку Створити. У діалоговому вікні, що відкриється, ви можете вказати Назву сервера, Порт сервера (початково у відповідному полі вказано типовий порт LDAP), Базовий &dn; (іноді його ще називають коренем пошуку або базою пошуку), звичайне Ім’я користувача і Пароль, останні два параметри потрібні, якщо для роботи з сервером потрібне розпізнавання.

Щоб вилучити сервер зі списку пошуку, оберіть його позначку у списку і натисніть кнопку Вилучити.

Щоб встановити час очікування LDAP, тобто максимальний проміжок часу, протягом якого локальний сервер обробки очікуватиме на відповідь віддаленого сервера, просто скористайтеся полем для введення з міткою Тайм-аут LDAP (хвилини:секунди).

Якщо на одному з ваших серверів міститься велика база даних, настільки велика, що навіть у результаті звичайного пошуку чогось на зразок `Smith`, кількість отриманих результатів перевищить максимальну кількість результатів запиту, ви можете розширити межі значень. Дізнатися про перевищення обмеження на кількість результатів можна дуже просто, оскільки у такому випадку програма відкриває контекстне вікно, у якому повідомляє про те, що буде показано лише частину результатів.

Деякі з серверів можуть накладати власні обмеження на кількість елементів, які буде повернуто у відповідь на запит. У такому випадку, збільшення максимальної кількості результатів за допомогою цього діалогового вікна не призведе до збільшення кількості показаних результатів.

### Налаштування Вигляду

У &kleopatra; ви можете налаштувати вигляд (перевірених) ключів у перегляді списку ключів. Можна змінити колір тексту і тла, а також шрифт символів тексту.

Кожній з Категорії ключів, перелічених ліворуч, відповідає набір кольорів і шрифт, яким буде показано пункти ключів, що належать до відповідної категорії. Списком категорій можна скористатися також для перегляду параметрів. Список категорій може бути змінено довільним чином адміністратором або досвідченим користувачам, щоб дізнатися, як це зробити, див. розділ у главі .

Щоб змінити колі тексту категорії, оберіть її позначку у списку і натисніть кнопку Встановити колір тексту.... Програма відкриє стандартне діалогове вікно вибору кольору у &kde;, за допомогою якого ви зможете обрати або створити новий колір.

Зміну кольору тла можна виконати у той же спосіб, просто натисніть позначку Встановити колір тла....

Для зміни шрифту ви можете скористатися одним з таких варіантів:

1. Змінити стандартний шрифт, який використовуватиметься у всіх переглядах списків &kde;

2. Використовувати нетиповий шрифт.

Перший варіант дозволить вам вказати колір, який збігатиметься з кольорами, які використовуються скрізь у стільничному середовищі &kde;, а другий варіант дозволить обрати будь-який колір, який вам подобається. Вибір за вами.

Щоб змінити вигляд стандартного шрифту, оберіть потрібну категорію у списку, а потім позначте або зніміть позначки з пунктів модифікаторів вигляду шрифту, Курсив, Жирний і/або Перекреслений. Результат можна одразу побачити за допомогою шрифту символів тексту позначки відповідної категорії у списку.

Щоб вказати шрифт самостійно, натисніть кнопку Встановити шрифт.... Програма відкриє стандартне діалогове вікно &kde; для вибору шрифту, за допомогою цього вікна ви зможете обрати новий шрифт. Зауважте, що ви зможете також скористатися зміною гарнітури обраного шрифту, у той же спосіб, що і для стандартного шрифту.

Щоб перемкнутися знову на стандартний шрифт, вам слід натиснути кнопку Типовий вигляд.

### Налаштування Порядку атрибутів &dn;

Хоча &dn; маю ієрархічну природу, порядок окремих компонентів (які називають відносними &dn; (relative &dn; або RDN) або атрибутами &dn;) не визначено. Таким чином, порядок, у якому атрибути буде показано, є предметом особистих уподобань або правил компанії. Ось чому цей порядок можна налаштувати за допомогою &kleopatra;.

Значення цього параметра стосуватиметься не лише &kleopatra;, але й усіх програм, які використовують технології &kleopatra;. На час написання цього підручника серед цих програм були &kmail;, &kaddressbook;, а також сама &kleopatra;.

Ця сторінка налаштувань в основному складається з двох списків, у одному з цих списків перелічено відомі атрибути (Наявні атрибути), у іншому описано Поточний порядок атрибутів.

У обох списках містяться записи, які є скороченнями назв атрибутів (наприклад, CN), а також повна назва атрибута (Common Name).

Список Наявні атрибути завжди буде впорядковано за абеткою, у списку ж Поточний порядок атрибутів порядок пунктів відповідає налаштованому порядку атрибутів &dn;: перший атрибут у списку відповідає першому атрибуту, який буде показано.

Буде показано лише атрибути явно переліченої у Поточному порядку атрибутів. Решту атрибутів типово буде сховано.

Якщо ж запис заповнювача _X_ (All others) буде переведено до поточного списку, всі не перелічені у списку атрибути (відомі чи ні) буде вставлено на місце _X_ у початковому відносному порядку.

Ось невеличкий приклад, який має все прояснити:

Якщо вказати для &dn;:

> O=&kde;, C=US, CN=Dave Devel, X-BAR=foo, OU=&kleopatra;, X-FOO=bar,

за використання типового порядку атрибутів CN, L, _X_, OU, O, C буде створено такий форматований &dn;:

> CN=Dave Devel, X-BAR=foo, X-FOO=bar, OU=&kleopatra;, O=&kde;, C=US

використання ж порядку атрибутів CN, L, OU, O, C дасть

> CN=Dave Devel, OU=&kleopatra;, O=&kde;, C=US

Щоб додати атрибут до списку порядку показу, оберіть атрибут у списку Наявні атрибути і натисніть кнопку Додати до поточного порядку атрибутів.

Щоб вилучити атрибут зі списку порядку показу атрибутів, виберіть його позначку у списку Поточний порядок атрибутів і натисніть кнопку Вилучити з поточного порядку атрибутів.

Щоб пересунути атрибут на початок (в кінець) списку, оберіть атрибут у списку Поточний порядок атрибутів, а потім натисніть кнопку Пересунути вверх (Пересунути вниз).

Щоб пересунути атрибут вгору (вниз) на одну позицію, оберіть атрибут у списку Поточний порядок атрибутів, а потім натисніть кнопку Пересунути вверх на один (Пересунути вниз на один).

## Довідник адміністратора

У «Довіднику адміністратора» описано способи налаштування &kleopatra;, доступ до яких не можна отримати за допомогою графічного інтерфейсу: ці параметри налаштовуються лише за допомогою файлів налаштування.

У цьому розділі ми припускаємо, що читач знайомий з технологіями, які використовуються у налаштуванні програм &kde;, зокрема компонуванням вікна програми, структурою файлової системи і ієрархією файлів налаштування &kde;, а також оболонкою KIOSK.

### Налаштування майстра створення сертифікатів

&kleopatra; надає вам змогу налаштувати поля, значення яких буде дозволено вводити користувачеві для створення власного сертифіката.

Створіть групу з назвою `CertificateCreationWizard` у загальносистемному файлі `kleopatrarc`. Якщо вам потрібен специфічний порядок атрибутів, або якщо вам потрібно, щоб у списку атрибутів були лише певні записи, створіть у файлі ключ з назвою `DNAttributeOrder`. Аргументом ключа може бути одне або декілька значень, `CN,SN,GN,L,T,OU,O,PC,C,SP,DC,BC,EMAIL` Якщо ви бажаєте, щоб якесь з полів початково містило певне значення, введіть щось на зразок Атрибут=значення. Якщо вам потрібно, щоб програма вважала атрибут необхідним, додайте знак оклику (наприклад, `CN!,L,OU,O!,C!,EMAIL!`, які є типовими у налаштуваннях).

За використання режиму KIOSK модифікатор `$e` надає змогу отримувати значення зі змінних середовища і виводу скрипту або бінарного файла. Якщо ви бажаєте заборонити редагування відповідного поля, скористайтеся модифікатором `$i`. Якщо ви бажаєте заборонити використання кнопки Вставити мою адресу встановіть для змінної `ShowSetWhoAmI` значення false.

Природа оболонки KIOSK &kde; за використання прапорця блокування (`$i`) зробить неможливим для користувача зняття цього прапорця. Так зроблено навмисне. Прапорцями `$i` і `$e` можна скористатися і у інших ключах налаштування програм &kde;.

У наведеному нижче прикладі у загальних рисах показано можливості налаштування:

    [CertificateCreationWizard]
    ;Заборонити копіювання особистих даних з адресної книги, не дозволяти локальне перевизначення
    ShowSetWhoAmI[$i]=false

    ;встановити значення імені користувача рівним змінній $USER
    CN[$e]=$USER

    ;встановити назву компанії «Моя компанія», заборонити зміну назви
    O[$i]=Моя компанія

    ;встановити назву відділу у значення, яке буде повернуто скриптом
    OU[$ei]=$(lookup_dept_from_ip)

    ; встановити назву країни у значення UA, але дозволити зміну назви користувачем
    C=UA

### Створення і редагування категорій ключів

У &kleopatra; користувач може налаштувати візуальне представлення ключів на основі концепції з назвою Категорії ключів. Категорії ключів також використовуються для фільтрування списку сертифікатів. У цьому розділі описано редагування наявних категорій, а також способи додавання нових.

Під час пошуків категорії, до якої належить ключ &kleopatra; намагається пропустити ключ крізь послідовність фільтрів ключів, які налаштовано у файлі `libkleopatrarc`. Збіг ключа з певним фільтром визначає категорію ключа за допомогою концепції специфічності, яку описано далі за текстом.

Кожен з фільтрів ключів визначається у групі налаштування з назвою `Key Filter #n`, де n є номером фільтра, нумерація розпочинається з `0`.

Єдиними обов’язковими ключами у групі `Key Filter #n` є `Name`, у цьому ключі міститься назва категорії, яку буде показано у діалоговому вікні налаштування, і `id`, який використовується для посилання на фільтр з інших розділів налаштування (наприклад, `View #n`).

містить перелік всі ключів, які визначають параметри показу ключів, які належать до відповідної категорії (тобто тих ключів, які може бути налаштовано за допомогою діалогового вікна налаштувань), а у міститься перелік всіх ключів, які визначають критерій, за яким визначається належність ключа до категорії.

#### Ключі налаштування фільтрів ключів, які визначають властивості показу

Ключ налаштування | Тип | Опис
--- | --- | ---
`background-color` | колір | Колір тла, який буде використано. Якщо не вказано, типове значення кольору тла буде взято з загальних параметрів для переглядів списком.
`foreground-color` | колір | Колір тексту, який буде використано. Якщо не вказано, типове значення кольору тексту буде взято з загальних параметрів для переглядів списком.
`font` | шрифт | Назва нетипового шрифту. Розміри символів шрифту буде змінено відповідно до розміру, вказаного для переглядів списком, також буде застосовано всі атрибути шрифту (див. нижче).
`font-bold` | булеве | Якщо встановлено значення `true`, а значення `font` не встановлено, буде використано типовий шрифт перегляду списку напівжирної гарнітури (якщо таку передбачено шрифтом). Цей ключ буде проігноровано за наявності ключа `font`.
`font-italic` | булеве | Аналогічний до `font-bold`, але з використанням курсивної гарнітури замість напівжирної.
`font-strikeout` | булеве | Якщо має значення `true`, символи шрифту буде перекреслено центральною горизонтальною рискою. Буде застосовано, навіть якщо не вказано значення для параметра `font`.
`icon` | текст | Назва піктограми, яку буде показано у першому стовпчику. Ще не реалізовано.

#### Ключі налаштування фільтра ключів, які визначають критерії фільтрування

Ключ налаштування | Тип | Якщо вказано, фільтр спрацьовуватиме, якщо...
--- | --- | ---
`is-revoked` | булеве | цей ключ було відкликано.
`match-context` | context Контекстом є список з таких можливих значень: `appearance`, `filtering` і `any`. | контекст, у якому застосовується цей фільтр.
`is-expired` | булеве | строк дії цього ключа вичерпано.
`is-disabled` | булеве | ключ було вимкнено (знято позначку використання) користувачем. Ігнорується для ключів &smime;.
`is-root-certificate` | булеве | ключ є кореневим сертифікатом. Ігнорується для ключів OpenPGP.
`can-encrypt` | булеве | цей ключ можна використовувати для шифрування.
`can-sign` | булеве | цей ключ можна використовувати для підписування.
`can-certify` | булеве | ключ можна використовувати для підписування (сертифікації) інших ключів.
`can-authenticate` | булеве | цей ключ можна використовувати для розпізнавання (наприклад, як клієнтський сертифікат TLS).
`is-qualified` | булеве | цей ключ може бути використано для створення придатних підписів (Qualified Signatures) за визначенням німецьких законів про цифровий підпис.
`is-cardkey` | булеве | дані цього ключа зберігаються на картці пам’яті (поза межами комп’ютера).
`has-secret-key` | булеве | закритий ключ цієї пари доступний.
`is-openpgp-key` | булеве | ключ належить до ключів OpenPGP (`true`), або є ключем &smime; (`false`).
`was-validated` | булеве | цей ключ було підтверджено.

`префікс-ownertrust`

validity Validity (чинність) є (впорядкованим) переліком таких можливих значень: `unknown`, `undefined`, `never`, `marginal`, `full`, `ultimate`. Докладний опис значень можна знайти у підручниках з &gpg; і &gpgsm;.

ключ може точно відповідати (префікс = `is`), точно не відповідати (префікс = `is-not`), мати принаймні (префікс = `is-at-least`) або не вищий за (префікс = `is-at-most`) рівень надійності, який буде вказано яка значення ключа налаштування. Якщо у одній групі буде вказано декілька ключів `префікс-рівень_надійності` (з різними значеннями префікса), група вважатиметься невизначеною.

`префікс-validity` | validity | Аналогічний до `префікс-ownertrust`, але для перевірки ключів, а не для довіри до власника.

Найцікавіші критерії, зокрема `is-revoked` or `is-expired`, працюватимуть лише для перевірених ключів, ось чому, типово, лише перевірені ключі перевіряються на скасування і завершення строку дії, хоча ви можете і вилучити ці додаткові перевірки.

Окрім ключів налаштування, описаних вище, у фільтрі ключів можуть бути ключі `id` і `match-contexts`.

За допомогою ключа `id` фільтра, типовим значенням якого є назва групи налаштування фільтра, якщо вона не є порожньою, ви можете посилатися на фільтр ключів у інших місцях налаштувань, наприклад, у налаштуваннях перегляду &kleopatra;. Ключ `id` не обробляється програмою &kleopatra;, отже ви можете використовувати будь-який бажаний рядок, який втім не повинен повторюватися.

Ключ `match-contexts` визначає обмеження застосовності фільтра. У поточній версії можна визначити дві області застосування: область застосування `appearance` використовується для визначення розфарбовування і властивостей шрифтів для перегляду. Область застосування `filtering` використовується для вибіркового включення (або виключення) сертифікатів з перегляду. Для визначення всіх визначених областей застосування можна скористатися значенням `any`, це значення є типовим, якщо не вказано ключа `match-contexts` або іншим чином не створено області застосування. Таким чином забезпечується відсутність мертвих фільтрів ключів, тобто фільтрів, які взагалі не застосовуються.

Форматом цього запису є список елементів, відокремлених символами, які не належать до символів слів. Кожен з елементів може мати префікс у вигляді знаку оклику (`!`), який позначає зміну значення елемента на протилежне. Елементи буде використано у порядку внутрішнього списку областей застосування, який на початку є порожнім. Найкраще це можна зрозуміти з прикладу: `any !apperance` це те саме, що і `filtering`, а `appearance !appearance` дасть порожню множину, тобто те саме, що і `!any`. Останні два випадки буде замінено на `any`, оскільки вони визначають порожні області застосування.

Загалом кажучи, невказані критерії (тобто критерії, не встановлені записом у налаштуваннях) не будуть перевірятися. Якщо критерій буде вказано, програма перевірить відповідність йому ключа, фільтр вважатиметься пройденим, якщо ключ відповідатиме всім критеріям, тобто результат відповідності буде булівським добутком результатів відповідності критеріям.

Кожен з фільтрів має власну специфічність, яка використовується для впорядкування списку фільтрів, які було пройдено ключем. Специфічніший фільтр матиме перевагу над менш специфічним. Якщо два фільтри матимуть однаковий рівень специфічності, першим з них вважатиметься той, який першим записано у файлі налаштувань. Специфічність фільтра пропорційна до кількості критеріїв, які він містить.

#### Приклади фільтрів ключів

Щоб дістати список всіх кореневих сертифікатів, строк дії яких було вичерпано, але які не було відкликано, вам слід скористатися таким фільтром ключів:

    [Key Filter #n]
    Name=строк дії збіг, але не відкликано
    was-validated=true
    is-expired=true
    is-revoked=false
    is-root-certificate=true
    ; ( specificity 4 )

Щоб дістати список всіх вимкнених ключів OpenPGP (це ще не підтримується &kleopatra;), з рівнем довіри до власника не нижчим за обмежено надійний, скористайтеся фільтром:

    [Key Filter #n]
    Name=вимкнені ключі OpenPGP з рівнем довіри, вищим за обмежену
    is-openpgp=true
    is-disabled=true
    is-at-least-ownertrust=marginal
    ; ( specificity 3 )

## Подяки і ліцензія

Авторські права на програму &kleopatra; належать &Steffen.Hansen;, &Matthias.Kalle.Dalheimer; і &Jesper.Pedersen;, ©2002, &Daniel.Molkentin;, © 2004 Klarälvdalens Datakonsult AB, ©2004

Авторські права на документацію належать &Steffen.Hansen;, ©2002, &Daniel.Molkentin;, ©2004, Klarälvdalens Datakonsult AB, ©2004

### Учасники розробки

- &Marc.Mutz; &Marc.Mutz.mail;

- &David.Faure; &David.Faure.mail;

- &Steffen.Hansen; hansen@kde.org

- &Matthias.Kalle.Dalheimer; &Matthias.Kalle.Dalheimer.mail;

- &Jesper.Pedersen; &Jesper.Pedersen.mail;

- &Daniel.Molkentin; &Daniel.Molkentin.mail;

Переклад українською: Юрій Чорноіванyurchor@ukr.net

&underFDL; &underGPL;

&documentation.index;