# Підручник з &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;
2007-12-19
1.9.0

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

KDE
Kapp
X509
LDAP
gpg
gpgsm

## Вступ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

### Меню Файл

Файл Створити пару ключів...

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

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

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

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

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

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

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

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

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

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

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

Файл Імпортувати CRL-и...

  Надає вам змогу вручну імпортувати CRL з файлів.

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

  Для того, щоб запрацював імпорт CRL, вам слід розташувати програму dirmngr у одній з тек, описаних у змінній середовища `PATH`. Якщо цей пункт меню буде дезактивовано, вам слід зв’язатися з системним адміністратором і попросити його встановити програму dirmngr.

  Переглянути вміст локального кешу CRL можна за допомогою пункту меню CRL Скинути кеш CRL . У відповідь на вибір пункту меню програма відкриє діалогове вікно з відомостями щодо CRL у кеші і відбитками сертифікатів для кожного з CRL.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

&Shift;F5 Сертифікати Перевірити

  Перевіряє виділені (або всі) ключі.

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

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

Сертифікати Освіжити список сертифікатів

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

  Ця дія стосуватиметься лише на сертифікатів, у яких визначено джерело поширення CRL. Залежно від використаного сервера, сертифікати, налаштовані на виконання перевірки за допомогою OCSP не буде оновлено.

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

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

  Користуйтеся цим пунктом з обережністю.

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

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

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

Сертифікати Звантажити

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

### Меню CRL

CRL Спорожнити кеш CRL

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

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

CRL Скинути кеш CRL

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

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

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

  Запускає &kwatchgnupg;

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

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

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

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

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

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

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

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

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

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

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

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

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

&help.menu.documentation;

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

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

&commandline-option-external;

  Визначає, що за використання параметра &commandline-option-query; слід виконувати пошук на віддаленому сервері, а не у локальному сховищі ключів.

&commandline-option-query;

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

&commandline-option-import-certificate;

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

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

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

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

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

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

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

Щоб додати новий сервер, натисніть кнопку Додати службу.... У діалоговому вікні, що відкриється, ви можете вказати Назву сервера, Порт (початково у відповідному полі вказано типовий порт 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`, у цьому ключі міститься назва категорії, яку буде показано у діалоговому вікні налаштування.

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

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

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

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

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

`префікс-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; належать © 2002 &Steffen.Hansen;, &Matthias.Kalle.Dalheimer; і &Jesper.Pedersen;., © 2004 &Daniel.Molkentin;, © 2004 Klarälvdalens Datakonsult AB

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

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

- &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;