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

## Вступ

&kleopatra; — це інструмент &kde; для керування сертифікатами &x509; і &openpgp; у наборах ключів &gpgsm; і &gpg;, а також для отримання сертифікатів з серверів &ldap;.

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

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

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

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

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

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

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

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

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

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

Щоб дізнатися, які з сертифікатів є кореневими, ви можете перемкнути програму у режим ієрархічного списку ключів за допомогою пункту меню view-hierarchical-key-list.

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

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

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

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

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

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

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

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

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

За допомогою пункту меню file-new-key-pair можна відкрити майстер створення пари ключів, який допоможе вам виконати декілька кроків створення запиту на сертифікат.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

#### Відкликання ключа

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

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

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

Ще одним способом створення сертифіката відкликання є використання &gpg; безпосередньо з командного рядка: `gpg --output `сертифікат_відкликання`.asc --gen-revoke `ваш_ключ``. Аргументом `ваш_ключ` має бути специфікатор ключа, ідентифікатор вашої основної пари ключів або частина ідентифікатора користувача. Цей ідентифікатор має однозначно визначати вашу пару ключів.

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

### Меню «Файл»

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

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

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

&Ctrl;&Shift;I Файл Пошук сертифікатів на сервері...

- Шукає і імпортує сертифікати з серверів сертифікатів до локального сховища ключів. Докладніше про імпорт можна дізнатися з розділу functions-search.

  Для того, щоб скористатися цим пунктом, вам слід вказати параметри серверів ключів. Докладніше про це у розділі configuration-directory-services.

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

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

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

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

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

  Вибраний вами суфікс назви експортованого файла визначає формат експортованих даних:

  - Для сертифікатів &openpgp; `gpg` і `pgp` призведуть до збереження бінарного файла, а `asc` — шифрованого файла &ascii;.

  - Для сертифікатів &smime; `der` призведе до збереження бінарного файла у кодуванні &der;, а `pem` — шифрованого файла &ascii;.

  Якщо не було позначено декілька сертифікатів, &kleopatra; запропонує назву файла для експортування ``відбиток`.{asc,pem}`.

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

  За допомогою цього пункту меню можна експортувати лише відкриті ключі, навіть якщо ви маєте і закритий ключ. Для експорту до файла закритого ключа скористайтеся пунктом меню file-export-secret-key.

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

- Експортує закритий ключ до файла.

  У діалоговому вікні, яке буде відкрито після вибору цього пункту, ви зможете вказати, чи слід створювати бінарний файл чи шифрований файл &ascii; (ASCII armor). Далі, натисніть піктограму теки праворуч від поля Вихідний файл і виберіть теку та назву експортованого файла. Під час експортування закритих ключів &smime; ви також зможете вибрати Набір символів пароля. Докладніше про це можна дізнатися з обговорення параметра `--p12-charset `набір символів`` на сторінці підручника (man) &gpgsm;.

  Цим пунктом можна буде скористатися, лише якщо позначено точно один сертифікат і доступний закритий ключ сертифіката.

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

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

- Оприлюднює позначені сертифікати на сервері ключів (лише для &openpgp;).

  Якщо буде визначено цей пункт, сертифікат буде надіслано на сервер сертифікації для &openpgp; (див. configuration-directory-services), інакше сертифікат буде надіслано на сервер `keys.gnupg.net`.

  Цим пунктом можна буде скористатися, лише якщо позначено принаймні один сертифікат &openpgp; (а не сертифікат &smime;).

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

  Більшість відкритих серверів сертифікатів &openpgp; виконують перехресну синхронізацію сертифікатів, отже навряд чи варто надсилати сертифікати одразу на декілька серверів.

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

Файл Розшифрувати/Перевірити файли...

- Розшифрувати файли і/або перевірити підписи.

Файл Підписати/Зашифрувати файли...

- Підписати і/або зашифрувати файли.

&Ctrl;W Файл Закрити

- Закрити головне вікно &kleopatra;. Розкрити головне вікно можна за допомогою піктограми системного лотка.

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

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

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

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

- Оновлює список сертифікатів.

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

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

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

  Цим пунктом можна буде скористатися, лише якщо задіяно принаймні одну дію.

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

  У такому випадку, єдиним способом відновити порядок є аварійне завершення процесів &scdaemon;, &dirmngr;, &gpgsm; і &gpg;, саме у такому порядку, за допомогою відповідних інструментів операційної системи (`top`, засобу керування завданнями тощо), аж доки дію не буде розблоковано.

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

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

  Цим пунктом можна буде скористатися, лише якщо позначено точно один сертифікат.

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

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

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

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

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

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

  Ієрархічний показ у поточній версії реалізовано лише для сертифікатів &smime;. Серед розробників немає одностайності щодо належного способу показу ієрархічної структури сертифікатів &openpgp; (на базовому рівні «батьківський елемент = підписувач» або «батьківський елемент = адресат підписування»).

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

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

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

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

  Ця функціональна можливість стане доступною, лише якщо позначено пункт меню view-hierarchical-key-list.

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

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

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

  Ця функціональна можливість стане доступною, лише якщо позначено пункт меню view-hierarchical-key-list.

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

Сертифікати Змінити рівень надійності власника...

- Змінити рівень надійності власника позначеного сертифіката &openpgp;.

  Цим пунктом можна буде скористатися, лише якщо позначено точно один сертифікат &openpgp;.

Сертифікати Встановити надійність кореневого сертифіката

- Позначити поточний кореневий сертифікат (&smime;) як надійний.

  У певному сенсі, цей пункт є тотожним до пункту certificates-change-owner-trust для кореневих сертифікатів &smime;, але ваш вибір обмежується, у термінах &openpgp;, «повною» довірою або «повною недовірою».

  Сервер (у нашому випадку, &gpgagent;) під час імпортування кореневих сертифікатів надішле вам запит щодо визначення надійності (рівня довіри) імпортованих сертифікатів. Цю функціональну можливість слід явно увімкнути у налаштуваннях сервера (`allow-mark-trusted` у `gpg-agent.conf` або один з пунктів меню Система GnuPG GPG Agent Allow clients to mark keys as "trusted" або Перевірка S/MIME Allow to mark root certificates as trusted у вікні configuration).

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

  Через брак підтримки цієї можливості з боку допоміжних програм, &kleopatra; доводиться працювати безпосередньо з базою даних надійних сертифікатів &gpgsm; (`trustlist.txt`). Якщо ви маєте намір скористатися цим пунктом, переконайтеся, що не виконується жодних дій, які можуть завадити &kleopatra; внести зміни до бази даних.

  Цим пунктом можна буде скористатися, лише якщо позначено точно один кореневий сертифікат &smime; і цей сертифікат ще не позначено як надійний.

  Скористайтеся пунктом certificates-distrust-root, щоб скасувати дію цього пункту.

Сертифікати Скасувати надійність кореневого сертифіката

- Позначити поточний кореневий сертифікат (&smime;) як ненадійний.

  Цим пунктом можна буде скористатися, лише якщо позначено точно один кореневий сертифікат &smime; і цей сертифікат ще не позначено як надійний.

  Призначено для скасування дії пункту certificates-trust-root.

Сертифікати Засвідчити сертифікат...

- Надає вам змогу засвідчити інший сертифікат &openpgp;.

  Цим пунктом можна буде скористатися, лише якщо позначено точно один сертифікат &openpgp;.

Сертифікати Змінити дату строку дії...

- Надає вам змогу змінити дату завершення строку дії вашого сертифіката &openpgp;.

  Скористайтеся цим пунктом для збільшення строку дії ваших сертифікатів &openpgp; замість створення нових або встановлення необмеженого строку дії сертифікатів (never expires).

  Цим пунктом можна буде скористатися, лише якщо позначено точно один сертифікат &openpgp; і доступний закритий ключ сертифіката.

Сертифікати Змінити пароль…

- Надає змогу змінити пароль до вашого закритого ключа.

  Цим пунктом можна скористатися, лише якщо позначено точно один сертифікат, і ви маєте закритий ключ цього сертифіката. Для того, щоб ви могли скористатися цим пунктом, у системі має бути встановлено нову версію сервера, оскільки у програмі змінено реалізацію роботи з безпосереднього виклику &gpg; та &gpgsm; на виклик, заснований на &gpgme;.

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

Сертифікати Додати ІД користувача...

- Надає вам змогу додати новий ідентифікатор користувача до вашого сертифіката &openpgp;.

  Скористайтеся цим пунктом для додавання нових профілів до існуючого сертифіката, замість створення нової пари ключів. Ідентифікатор користувача &openpgp; має бути використано у такому форматі:

      Справжнє ім’я (Коментар) <Адреса електронної пошти>

  У діалоговому вікні, яке &kleopatra; відкриє у відповідь на вибір пункту, програма запитає вас про значення трьох параметрів (`Справжнє ім’я`, `Коментар` та `Адресу ел. пошти`) окремо, а потім покаже попередній перегляд результатів.

  Ці параметри підлягають тим самим адміністративним обмеженням, як і нові сертифікати. Докладніше про це у розділах functions-newkey і admin-certificate-request-wizard.

  Цим пунктом можна буде скористатися, лише якщо позначено точно один сертифікат &openpgp; і доступний закритий ключ сертифіката.

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

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

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

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

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

  Через ієрархічну природу сертифікатів &smime; вилучення сертифіката видавця &smime; (сертифіката &ca;), буде також вилучено всі підлеглі сертифікати.

  Схема вилучення нагадує схему файлової системи: якщо ви вилучаєте теку, ви вилучаєте всі файли і підтеки, що у ній містяться.

  Природно, цим пунктом можна буде скористатися, лише якщо було позначено принаймні один пункт сертифіката.

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

- Показує всі відомості, які &gpgsm; може зібрати для позначеного сертифіката (&smime;).

  Див. обговорення щодо параметра `--dump-key `ключ`` у підручнику з &gpgsm;, щоб дізнатися більше про виведені командою дані.

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

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

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

  Цим пунктом не можна скористатися у &Windows;, оскільки відповідні механізми не реалізовано у допоміжній програмі для цієї платформи.

Інструменти Освіжити сертифікати OpenPGP

- Оновлює дані всіх сертифікатів &openpgp; за допомогою команди

      gpg --refresh-keys

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

  Докладніші відомості щодо недоліків можна знайти у розділі certificates-refresh-x509.

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

- Оновлює дані всіх сертифікатів &smime; за допомогою команди

      gpgsm -k --with-validation --force-crl-refresh --enable-crl-checks

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

  Для оновлення сертифікатів &x509; або &openpgp; програмі доведеться отримати всі сертифікати і &crl;, щоб перевірити, чи не було часом відкликано деякі з них.

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

Інструменти Імпортувати CRL з файла...

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

  Зазвичай, обробка списків анулювання (відкликання) сертифікатів (Certificate Revocation Lists або &crl;) виконується сервером у прозорому режимі, але іноді корисно імпортувати &crl; вручну до локального кешу &crl;.

  Для того, щоб можна було здійснювати імпортування &crl;, програму &dirmngr; має бути встановлено у одному з каталогів, визначених системною змінною `PATH`. Якщо цей пункт меню буде неактивним, вам слід повідомити адміністратора вашої системи про те, що слід встановити &dirmngr;.

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

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

  Ймовірно, що цей пункт ніколи вам не знадобиться. Замість цього пункту ви можете освіжити кеш &crl; у примусовому порядку вибором всіх сертифікатів з наступним використанням пункту certificates-refresh-x509.

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

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

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

У &kleopatra; передбачено типове меню Параметри &kde;, яке описано у підручнику з основ &kde;, з одним додатковим пунктом:

Параметри Виконати самоперевірку

- Виконує набір дій з самоперевірки та показує результат їх виконання.

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

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

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

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

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

У &kleopatra; передбачено типове меню Довідка &kde;, яке описано у підручнику з основ &kde;.

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

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

`--uiserver-socket` `параметр`

- Розташування сокета, на якому слухає сервер інтерфейсу користувача

`--daemon`

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

`-p` `--openpgp`

- Використовувати &openpgp; для наступної дії

`-c` `--cms`

- Використовувати CMS (&x509;, S/&MIME;) для наступної дії

`-i` `--import-certificate`

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

  Ця команда є еквівалентом пункту меню file-import-certificates.

`-e` `--encrypt`

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

`-s` `--sign`

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

`-E` `--encrypt-sign`

- Зашифрувати і/або підписати файли. Те саме, що і `--sign-encrypt`, не використовуйте.

`-d` `--decrypt`

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

`-V` `--verify`

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

`-D` `--decrypt-verify`

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

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

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

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

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

За допомогою цієї сторінки ви можете визначити, які сервери &ldap; слід використовувати для пошуку сертифікатів &smime;, і те, які сервери ключів слід використовувати для пошуку сертифікатів &openpgp;.

Цей пункт є зручнішою для користувачів версією керування параметрами, описаними у розділі configuration-gnupg-system. Будь-які параметри, які можна налаштувати за допомогою цього пункту, можна налаштувати і за допомогою вікна налаштування &gnupg;.

#### Нотатка щодо параметрів проксі-сервера

Параметри проксі-сервера можна налаштувати для серверів &http; і &ldap; у розділі configuration-smime-validation, але лише для &gpgsm;. Для &gpg; через складність параметрів сервера ключів &gpg; і брак належної підтримки цих параметрів у &gpgconf;, у поточній версії вам доведеться вносити зміни до файла налаштувань `gpg.conf` вручну. Будь ласка, зверніться до підручника з &gpg;, щоб дізнатися більше. &kleopatra; зважатиме на встановленні значення, але у програмі ще не передбачено можливості змінювати ці параметри за допомогою графічного інтерфейсу.

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

Призначення стовпчиків у цій таблиці:

Схема

- Визначає мережевий протокол, який буде використано для доступу до сервера. Серед розповсюджених схем ldap (на його відповідник з шифруванням &ssl;, ldaps) для серверів &ldap; (загальний протокол &smime;; єдиний підтримуваний &gpgsm;) і hkp або протокол сервера ключів Горовіца (Horowitz Keyserver Protocol), сучасний протокол обміну даними з серверами ключів &http;, заснований на &http; протокол, який підтримують майже всі публічні сервери ключів &openpgp;.

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

Назва сервера

- Доменна назва сервера, наприклад `keys.gnupg.net`.

Порт сервера

- Порт мережі, на якому сервер очікує на з’єднання.

  Значення цього параметра буде автоматично повернуто до типового у разі зміни значення параметра configuration-directory-services-scheme, якщо його не було змінено до нетипового. Якщо ви змінили типовий номер порту і не можете повернути його, спробуйте встановити для параметра configuration-directory-services-scheme значення `http`, а для параметра configuration-directory-services-server-port — `80` (типове значення для &http;).

Кореневий DN

- Кореневий &dn; (лише для &ldap; і &ldaps;), тобто корінь ієрархії &ldap;. Цей корінь часто називають «коренем пошуку» або «основою пошуку».

  Значення зазвичай подібне до `c=ua,o=Foo` визначається як частина адреси &ldap;.

Ім'я користувача

- Ім’я користувача, якщо вказано, буде використано для реєстрації на сервері.

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

Пароль

- Пароль, якщо вказано, буде використано для реєстрації на сервері.

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

X.509

- Цей стовпчик призначено для записів, які слід використовувати для пошуків сертифікатів &x509; (&smime;).

  Підтримку &smime; передбачено лише для серверів &ldap; (і &ldaps;).

OpenPGP

- Цей стовпчик призначено для записів, які слід використовувати для пошуків сертифікатів &openpgp;.

Ви можете налаштувати довільну кількість серверів &smime; (&x509;), але одночасно використовувати можна лише один сервер &openpgp;. Графічний інтерфейс просто не дозволить вам виконати інше налаштування.

Щоб додати новий запис сервера, натисніть кнопку Створити. Позначений запис, якщо ви позначили якийсь запис, буде здубльовано або буде створено типовий сервер &openpgp;. Після цього ви зможете встановити значення параметрів configuration-directory-services-server-name, configuration-directory-services-server-port, configuration-directory-services-base-dn і, звичайно ж, configuration-directory-services-password та configuration-directory-services-user-name (значення обох цих параметрів слід встановити, лише якщо для доступу до сервера слід пройти розпізнавання).

Щоб безпосередньо вставити запис сертифіката &x509;, скористайтеся пунктом Створити X.509. Для &openpgp; слід скористатися пунктом Створити OpenPGP.

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

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

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

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

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

#### Налаштування Підказок

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

ІД ключа буде показано завжди. Так зроблено для того, щоб підказки для різних сертифікатів відрізнялися (це особливо важливо, якщо було позначено лише пункт tooltips-validity).

Ви можете незалежно вмикати або вимикати такі набори даних:

Показати чинність

- Показує відомості щодо чинності сертифіката: поточний стан, &dn; видавця (лише &smime;), строк дії (якщо такий передбачено) і прапорці використання сертифіката.

  Приклад:

      Цей сертифікат є чинним.
      Видавець:            CN=Test-ZS 7,O=Intevation GmbH,C=DE
      Чинний:          from 25.08.2009 10:42 through 19.10.2010 10:42
      Використання сертифіката: Підписування ел.листів і файлів, Шифрування ел.листів і файлів
      ІД ключа:            DC9D9E43

Показати інформацію про власника

- Показує відомості щодо власника сертифіката: &dn; об’єкта (лише &smime;), ідентифікатори користувачів (зокрема адреси електронної пошти) і довіру до власника (лише &openpgp;).

  Приклад &openpgp;:

      ІД користувача:      Gpg4winUserA <gpg4winusera@test.hq>
      ІД ключа:            C6BF6664
      Довіра до власника:  необмежена

  Приклад &smime;:

      Предмет:           CN=Gpg4winTestuserA,OU=Testlab,O=Gpg4win Project,C=DE
      також відомий як:  Gpg4winUserA@test.hq
      ІД ключа:          DC9D9E43

Показати технічні подробиці

- Показує технічні відомості щодо сертифіката: серійний номер (лише &smime;), тип, відбиток та адресу сховища.

  Приклад:

      Серійний номер:    27
      Тип сертифіката:   1.024-бітовий RSA (доступний закритий сертифікат)
      ІД ключа:          DC9D9E43
      Відбиток:       854F62EEEBB41BFDD3BE05D124971E09DC9D9E43
      Збережено:          на цьому комп’ютері

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

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

Кожній з категорій сертифікатів у списку відповідає піктограма (необов’язкова), набір кольорів і шрифт, яким буде показано пункти сертифікатів, що належать до відповідної категорії. Списком категорій можна скористатися також для перегляду параметрів. Список категорій може бути змінено довільним чином адміністратором або досвідченим користувачам, щоб дізнатися, як це зробити, див. розділ admin-key-filters у главі admin.

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

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

Щоб змінити колір (наприклад тексту) категорії, оберіть її позначку у списку і натисніть кнопку Встановити колір тексту.... Програма відкриє стандартне діалогове вікно вибору кольору у &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

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

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

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

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

### Налаштування «Дій з шифрування»

#### Налаштування Роботи з електронною поштою

Тут ви можете налаштувати деякі з аспектів обробки електронної пошти &uiserver; &kleopatra;. У поточній версії ви можете лише налаштувати «Швидкий режим» для підписування та шифрування електронної пошти, відповідно.

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

#### Налаштування Дій над файлами

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

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

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

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

### Налаштування параметрів «Перевірки S/&MIME;»

За допомогою цієї сторінки ви зможете змінити певні аспекти перевірки сертифікатів &smime;.

Здебільшого, цей пункт є зручнішою для користувачів версією керування параметрами, описаними у розділі configuration-gnupg-system. Будь-які параметри, які можна налаштувати за допомогою цього пункту, можна налаштувати і за допомогою вікна налаштування &gnupg;, за винятком параметра configuration-smime-validation-refresh-interval, який є специфічним для &kleopatra;.

Призначення параметрів:

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

Перевіряти чинність сертифіката кожні `N` годин

- За допомогою цього пункту можна визначити інтервал перевірки чинності сертифікатів. Крім того, ви можете вказати інтервал між перевірками (у годинах). Ефект перевірки збігатиметься з ефектом використання пункту меню view-redisplay; пунктів зміни інтервалів перевірки, що відповідають пунктам меню certificates-refresh-openpgp і certificates-refresh-x509, не передбачено.

  Перевірка виконується неявно у разі зміни значущих файлів `~/.gnupg`. Цей пункт подібний до пунктів меню certificates-refresh-openpgp і certificates-refresh-x509, отже визначається зовнішніми факторами чинності сертифікатів.

#### Налаштування способу перевірки

Перевіряти сертифікати з використанням CRL

- Якщо буде позначено цей пункт, сертифікати &smime; будуть перевірятися на наявність у списках анулювання сертифікатів (&crl;).

  Опис альтернативного способу перевірки чинності сертифікатів можна знайти у розділі щодо пункту configuration-smime-validation-use-ocsp.

Інтерактивна перевірка сертифікатів (OCSP)

- Якщо позначити цей пункт, програма перевірятиме сертифікати &smime; за допомогою мережевого протоколу стану сертифікатів (Online Certificates Status Protocol або OCSP).

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

  Щоб скористатися цим способом, вас слід ввести адресу відповідача &ocsp; у поле configuration-smime-validation-ocsp-url.

  Опис традиційнішого способу перевірки чинності сертифікатів, без витоку інформації щодо вашого обміну повідомленнями можна знайти у розділі щодо пункту configuration-smime-validation-use-ocsp.

Адреса OCSP-відповідача

- Введіть тут адресу сервера для миттєвої перевірки сертифікатів (&ocsp;-відповідача). Типово адреса починається з `http://`.

Підпис OCSP-відповідача

- Тут ви можете вибрати сертифікат, за допомогою якого сервер &ocsp; підписуватиме відповіді.

Ігнорувати службову адресу (URL) сертифікатів

- У кожному з сертифікатів &smime; зазвичай міститься адреса відповідача &ocsp; його видавця (подивитися, чи містить сертифікат ці відомості, можна за допомогою пункту меню certificates-dump-certificate).

  Позначення цього пункту призведе до ігнорування &gpgsm; відповідних адрес і переходу до використання однієї з вказаних адрес.

  Скористайтеся цим пунктом, щоб, наприклад, визначити примусове використання загального проксі-сервера &ocsp; установи.

#### Як налаштувати параметри перевірки

Не перевіряти правила сертифікатів

- Типово &gpgsm; використовує файл `~/.gnupg/policies.txt` для перевірки чи дозволені правила сертифікатів. Якщо буде позначено цей пункт, правила не перевіряються.

Ніколи не звертатися до CRL

- Якщо буде позначено цей пункт, списки скасування сертифікатів ніколи не використовуватимуться для перевірки сертифікатів &smime;.

Дозволити позначення кореневих сертифікатів як надійних

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

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

  Вмикання цих функціональних можливостей у сервері може призвести до появи контекстних вікон &pinentry; у незручний час (наприклад, під час перевірки підписів), а отже може заблокувати обробку небажаних поштових повідомлень. З цієї причини, а також оскільки бажано мати можливість скасувати надійність кореневих сертифікатів, у &kleopatra; передбачено можливість налаштування рівня надійності вручну за допомогою пунктів меню certificates-trust-root і certificates-distrust-root.

  Вказане у цьому пункті значення не впливає на роботу &kleopatra;.

Надіслати запит щодо сертифікатів видавця, яких не вистачає

- Якщо позначено цей параметр, за потреби надсилатиметься запит для сертифікатів з відсутнім видавцем (це стосується обох методів перевірки, &crl; і &ocsp;).

#### Налаштування параметрів запитів &http;

Не виконувати жодних запитів HTTP

- Повністю вимкнути використання &http; для роботи з &smime;.

Ігнорувати HTTP-точки розподілу CRL-сертифікатів

- Для відшукання місця, де знаходиться &crl;, сертифікат, який слід перевірити, зазвичай, містить те, що відоме як записи «Точок розподілу &crl;» (DP), які є адресами URL, що описують спосіб доступ до потрібного &crl;.

  Якщо буде позначено цей пункт, при пошуку адреси точки розповсюдження всі записи, що вказують використовувати протокол &http;, будуть проігноровані.

Використовувати системний проксі

- Якщо буде позначено, для всіх &http; запитів буде використовуватися &http;-проксі вказаний праворуч (це значення визначається змінною оточення `http_proxy`).

Для запитів HTTP використовувати проксі

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

  Сервер буде використано для всіх запитів &HTTP;, пов’язаних з S/&MIME;.

  Синтаксис запису має бути таким: ``вузол``:``порт``. Приклад: `myproxy.nowhere.com:3128`.

#### Налаштування параметрів запитів &ldap;

Не виконувати жодних запитів LDAP

- Повністю вимкнути використання &ldap; для запитів &smime;.

Ігнорувати LDAP-точки розподілу CRL-сертифікатів

- Для відшукання місця, де знаходиться &crl;, сертифікат, який слід перевірити, зазвичай, містить те, що відоме як записи «Точок розподілу &crl;» (DP), які є адресами URL, що описують спосіб доступ до потрібного &crl;.

  Якщо буде позначено цей пункт, при пошуку адреси точки розповсюдження всі записи, що вказують використовувати протокол &ldap;, будуть проігноровані.

Основний вузол для LDAP-запитів

- Введення адреси сервера &ldap; у це поле призведе до того, що всі запити &ldap; спочатку проходитимуть через вказаний сервер. Якщо точніше, вказані в цьому пункті дані перевизначатимуть значення параметрів `вузол` і `порт` адреси &ldap;, їх також буде використано, якщо у адресі не буде вказано `вузла` і `порту`.

  Інші сервери &ldap; буде використано, лише якщо з’єднання з «проксі-сервером» встановити не вдасться. Формат має бути таким: ``вузол`` або ``вузол``:``порт``. Якщо `порт` не буде вказано, програма використовуватиме порт 389 (стандартний порт &ldap;).

### Налаштування «Системи &gnupg;»

Цю частину даних діалогового вікна буде автоматично визначено на основі даних, виведених командою `gpgconf `--list-components``, а також для кожного з виведених цією командою `компонентів`, даних, виведених командою `gpgconf `--list-options` `компонент``.

Найкорисніші з цих пунктів продубльовано на окремих сторінках діалогового вікна налаштувань &kleopatra;. Довідку з вибраних пунктів цієї частини діалогового вікна, використаних на двох сторінках діалогового вікна налаштувань, можна знайти у розділах configuration-directory-services і configuration-smime-validation.

Точний перелік пунктів цієї частини діалогового вікна залежить від встановленої у вашій системі версії сервера &gnupg; і, потенційно, програмної платформи. Ми обговоримо лише загальне компонування діалогового вікна, зокрема відповідність параметрів &gpgconf; елементам керування графічного інтерфейсу &kleopatra;.

&gpgconf; повертає дані щодо налаштування багатьох компонентів. У межах кожного компонента окремі пункти об’єднано у групи.

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

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

### Відповідність типів &gpgconf; графічним елементам керування

Тип &gpgconf; | Елемент керування у &kleopatra;
для списків | не для списків
`none` | Лічильник | Поле для позначки
`string` | Немає | Рядок введення тексту
`int32` | Рядок введення тексту (без форматування) | Поле лічильника
`uint32`
`pathname` | Немає | спеціалізований елемент керування
`ldap server` | спеціалізований елемент керування | Немає
`key fingerprint` | Немає
`pub key`
`sec key`
`alias list`

Докладніші відомості з налаштування та способів налаштування можна знайти на сторінці довідки (man) &gpgconf;.

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

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

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

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

#### Налаштування полів &dn;

&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; надає змогу обмежити тип сертифікатів, які може створювати користувач. Однак, ви маєте пам’ятати, що ці обмеження дуже легко обійти за допомогою відповідних команд, відданих у командному рядку.

##### Алгоритми відкритих ключів

Щоб обмежити перелік алгоритмів, якими можна користуватися, додайте ключ налаштування `PGPKeyType` (і `CMSKeyType`, але для CMS все одно підтримується лише RSA) до розділу `CertificateCreationWizard` файла `kleopatrarc`.

Можливими значеннями є `RSA` для ключів RSA, `DAS` для ключів DSA (лише підписування) та `DSA+ELG` для ключів DSA (лише підписування) з підключем Elgamal для шифрування.

Типові значення буде прочитано з &gpgconf; або `RSA`, якщо у &gpgconf; не вказано типового значення.

##### Розмір відкритого ключа

Щоб обмежити перелік доступних розмірів ключів алгоритму створення відкритого ключа, додайте до ключ налаштування ``<Алгоритм>`KeySizes` (де `Алгоритм` може приймати значення `RSA`, `DSA` або `ELG`) до розділу `CertificateCreationWizard` файла `kleopatrarc`, зі списком відокремлених комами розмірів ключів (у бітах). Типовий розмір ключа позначається додаванням до відповідного запису знаку «мінус» (`-`).

    RSAKeySizes = 1536,-2048,3072

Наведений вище запис обмежить дозволені розміри ключів RSA значеннями 1536, 2048 і 3072. Типовим буде значення 2048.

Окрім самих розмірів ключів, ви можете також вказати мітки для кожного з розмірів. Для цього просто встановіть значення ключа налаштування ``Алгоритм`KeySizeLabels` (слід вказати список відокремлених комами міток).

    RSAKeySizeLabels = weak,normal,strong

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

    weak (1536-бітовий)
                  normal (2048-бітовий)
                  strong (3072-бітовий)

Типовими значеннями будуть такі:

    RSAKeySizes = 1536,-2048,3072,4096
                  RSAKeySizeLabels =
                  DSAKeySizes = -1024,2048
                  DSAKeySizeLabels = v1,v2
                  ELGKeySizes = 1536,-2048,3072,4096

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

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

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

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

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

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

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

Ключ налаштування | Тип | Опис
`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 !appearance` це те саме, що і `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; надає змогу адміністраторам (і досвідченим користувачам) налаштовувати список архіваторів, які буде показано у діалоговому вікні підписування/шифрування файлів.

Кожен з архіваторів визначається у файлі `libkleopatrarc` окремою групою `Archive Definition #`n`` з такими обов’язковими ключами:

`extensions`

- Відокремлений комами список суфіксів назв файлів, який зазвичай відповідає форматів, з якими працює архіватор.

`id`

- Унікальний ідентифікатор, який програма використовуватиме для розпізнавання архіваторів. Якщо не знаєте, який ідентифікатор використати, вкажіть команду архівування.

`Name` (з можливістю перекладу)

- Видима користувачеві назва архіватора, яку буде показано у спадному меню діалогового вікна підписування/шифрування файлів.

`pack-command`

- Команда, яку буде використано для архівування файлів. Ви можете використовувати будь-яку команду, для виконання якої не потрібна зовнішня оболонка. Файл програми система шукатиме у каталогах, описаних у змінній середовища `PATH`, якщо ви не вкажете абсолютний шлях до файла. Можна використовувати лапки, подібно до того, як лапки використовуються у командній оболонці:

      pack-command="/opt/ZIP v2.32/bin/zip" -r -

Оскільки у файлах налаштування &kde; зворотна похила риска (`\`) є керівним символом, вам слід подвоювати такі риски у адресах файлів:

    pack-command=C:\\Programs\\GNU\\tar\\gtar.exe ...

У самій команді (на відміну від її параметрів) ви можете використовувати прямі похилі риски (`/`) у адресах всіх платформ:

    pack-command=C:/Programs/GNU/tar/gtar.exe ...

Використовувати прямі риски у параметрах не можна, оскільки у більшості програм &Windows; прямі риски використовуються для визначення параметрів. Наприклад, наведена нижче команда не працюватиме, оскільки `C:/myarchivescript.bat` є параметром програми `cmd.exe`, а `/` не буде перетворено на `\` у параметрах, таке перетворення можливе лише у командах:

    pack-command=cmd.exe C:/myarchivescript.bat

Цей ключ слід записати так:

    pack-command=cmd.exe C:\\myarchivescript.bat

#### Як передати назву файла `pack-command`

Існує три способи передавання назв файлів команді пакування. Для кожного з цих способів у ключі `pack-command` передбачено окремий синтаксис:

1. Як параметр командного рядка.

   Приклад (tar):

       pack-command=tar cf -

   Приклад (zip):

       pack-command=zip -r - %f

   У цьому випадку назви файлів передаються у командному рядку, подібно до того, як вони передаються у звичайному командному рядку. &kleopatra; не використовуватиме для виконання команд командну оболонку. Тому цей спосіб передавання назв файлів є безпечним, хоча на деяких програмних платформах ви можете перевищити обмеження на довжину команди. Замінник `%f`, якщо такий вказано, позначає назви файлів, які буде додано до архіву. Якщо такий замінник не буде вказано, назви файлів буде просто додано до рядка команди. Таким чином, приклад з zip, наведений вище, можна також записати як:

       pack-command=zip -r -

2. За допомогою стандартного джерела даних з розділенням записів окремих файлів символами розриву рядка: достатньо вказати перед командою `|`.

   Приклад (&GNU;-tar):

       pack-command=|gtar cf - -T-

   Приклад (ZIP):

       pack-command=|zip -@ -

   У цьому випадку назви файлів буде передано архіватору через stdin, по одному на рядок. Таким чином, буде усунуто проблеми з накладанням деякими програмними платформами жорстких обмежень на кількість параметрів рядка команди. Цей спосіб є непридатним, якщо у назвах файлів містяться символи розриву рядків.

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

3. За допомогою стандартного джерела даних з розділенням записів окремих файлів NUL-байтами: достатньо вказати перед командою `|`.

   Приклад (&GNU;-tar):

       pack-command=0|gtar cf - -T- --null

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

### Налаштування програм обчислення контрольних сум для створення/перевірки контрольних сум

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

Щоб програмою можна було скористатися у &kleopatra;, виведені програмою обчислення контрольних сум дані (запис файла контрольної суми та вивід у stdout під час перевірки контрольної суми) мають бути сумісними з даними &GNU; `md5sum` і `sha1sum`.

Зокрема, файл контрольної суми має бути поділено на рядки, кожен з яких має бути записано у такому форматі:

    КОНТРОЛЬНА_СУМА ' ' ( ' ' | '*' ) НАЗВА_ФАЙЛА

, де `КОНТРОЛЬНА_СУМА` має складатися лише з шістнадцяткових цифр. Якщо у назві файла `НАЗВА_ФАЙЛА` міститься символ розриву рядка, рядок файла має бути таким:

    \КОНТРОЛЬНА_СУМА ' ' ( ' ' | '*' ) НАЗВА_ФАЙЛА_З_ЕКРАНУВАННЯМ

де `НАЗВА_ФАЙЛА_З_ЕКРАНУВАННЯМ` — назва файла, у якій символи розриву рядків замінено на `\n`, а зворотні похилі риски подвоєно (`\`↦`\\`).

Так само, дані, виведені checksum-definition-verify-command має бути записано у форматі

    НАЗВА_ФАЙЛА ( ': OK' | ': FAILED' )

з поділом на рядки. У виведених даних не повинно бути екранування символів розриву рядків та інших символів.

Так, ці програми було написано без врахування потреб у графічному інтерфейсі. &kleopatra; не зможе правильно обробити результати для файлів, назви яких містять рядок ": OK" або символ розриву рядка.

Кожна з програм для обчислення контрольних сум визначається у файлі `libkleopatrarc` окремою групою `Checksum Definition #`n`` з такими обов’язковими ключами:

`file-patterns`

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

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

  Врахування регістру символів у шаблонах залежить від використаної вами програмної платформи.

`output-file`

- Типова назва файла з виведеними даними для цієї програми обчислення контрольних сум (звичайно ж, має відповідати одному зі значень checksum-definition-file-patterns). Цю назву &kleopatra; використовуватиме для визначення назви файла з виведеними даними контрольної суми відповідного типу.

`id`

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

`Name` (з можливістю перекладу)

- Показана користувачеві у спадному меню діалогового вікна налаштування &kleopatra; назва програми обчислення контрольних сум.

`create-command`

- Команда, за допомогою якої будуть створюватися файли контрольних сум. Синтаксис команди, обмеження та можливості передавання параметрів такі самі, як описані для ключа archive-definition-pack-command у розділі admin-archive-definitions.

`verify-command`

- Те саме, що і checksum-definition-create-command, але для перевірки контрольних сум.

Ось повний текст прикладу:

    [Checksum Definition #1]
              file-patterns=sha1sum.txt
              output-file=sha1sum.txt
              id=sha1sum-gnu
              Name=sha1sum (GNU)
              Name[de]=sha1sum (GNU)
              ...
              create-command=sha1sum -- %f
              verify-command=sha1sum -c -- %f

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

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

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

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

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