|
|
.TH CL-API-SERVER 1 "11 марта 2012" "Calculate Utilities" "Calculate API Сервер"
|
|
|
.SH НАЗВАНИЕ
|
|
|
.PP
|
|
|
cl-core - Серверная часть пакета calculate-core
|
|
|
.SH СИНТАКСИС
|
|
|
[-l] [-p] [-c] [--req] [--sc] [-d] [--db] [--rm] [--right-add] [--right-del]
|
|
|
[--gen-root-cert] [--gen-cert-by] [--get-cert-from] [--use-root-as-server]
|
|
|
[--sign-client] [--sign-server] [--del-req] [--rv] [--version] [-h]
|
|
|
.SH ОПИСАНИЕ
|
|
|
.PP
|
|
|
cl-core - временно нет описания.
|
|
|
.SH ПАРАМЕТРЫ
|
|
|
.PP
|
|
|
Параметры команды
|
|
|
\fBcl-core\fR:
|
|
|
.PP
|
|
|
\fB\-l\fR, \fB\-\-lang\fR \fILANG\fR
|
|
|
.RS 4
|
|
|
Выбор языка. LANG - язык для перевода, например ru, english, en.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-p\fR, \fB\-\-port\fR \fIномер порта\fR
|
|
|
.RS 4
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-c\fR, \fB\-\-cert\fR \fIID\fR
|
|
|
.RS 4
|
|
|
Операции с сертификатами. ID - номер сертификата или 'all'. При использовании этой опции сервер не запускается.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-r\fR, \fB\-\-show-request\fR \fIREQ_ID\fR
|
|
|
.RS 4
|
|
|
Просмотр клиентских запросов на подпись сертификата. ID - номер запроса или 'all'. При использовании этой опции сервер не запускается.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-\-sc\fR, \fB\-\-server-cert\fR \fICERT_ID\fR
|
|
|
.RS 4
|
|
|
Просмотр серверных сертификатов и запросов на подпись сертификата. CERT_ID - номер сертификата (запроса) или 'all'. При использовании этой опции сервер не запускается.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-d\fR, \fB\-\-dump\fR
|
|
|
.RS 4
|
|
|
Дамп. Используйте с ключами '-c' или '-r'. При использовании с параметром 'all' выдаст подробную информацию обо всех сертификатах. При указании номера сертификата выдаст его содержимое.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-\-db\fR, \fB\-\-debug\fR
|
|
|
.RS 4
|
|
|
Режим отладки (debug).
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-\-rm\fR, \fB\-\-remove\fR
|
|
|
.RS 4
|
|
|
Удаление сертификата. Используйте с ключом '-c'.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-\-right-add\fR \fIRIGHT_ADD\fR
|
|
|
.RS 4
|
|
|
Добавить права для сертификата. Поддерживается список сертификатов и список прав (через ','). Используйте с ключом -c [ID]. При использовании с --right-del сначала добавляются права, затем удаляются.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-\-right-del\fR \fIRIGHT_DEL\fR
|
|
|
.RS 4
|
|
|
Удалить права сертификата. Поддерживается список сертификатов и список прав (через ','). Используйте с ключом -c [ID]. При использовании с --right-add сначала добавляются права, затем удаляются.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-\-gen-root-cert\fR
|
|
|
.RS 4
|
|
|
Генерировать корневой сертификат (сертификат удостоверяющего центра, CA).
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-\-gen-cert-by\fR \fIHOST\fR
|
|
|
.RS 4
|
|
|
Отправить запрос на подписание корневого сертификата. HOST - сетевой адрес хоста назначения (IP или HOSTNAME).
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-\-get-cert-from\fR \fIROOT_HOST\fR
|
|
|
.RS 4
|
|
|
Получить подписанный сертификат с сервера. ROOT_HOST - сетевой адрес хоста назначения (IP или HOSTNAME).
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-\-use-root-as-server\fR
|
|
|
.RS 4
|
|
|
Использовать корневой сертификат как сертификат сервера.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-\-sign-client\fR \fIID_CLIENT_REQ\fR
|
|
|
.RS 4
|
|
|
Подписать сертификатом сервера клиентский запрос на подписание сертификата. ID_CLIENT_REQ - номер запроса.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-\-sign-server\fR \fIID_SERVER_REQ\fR
|
|
|
.RS 4
|
|
|
Подписать корневым сертификатом серверный запрос на подписание сертификата. ID_SERVER_REQ - номер запроса.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-\-del-req\fR \fIID_DEL_REQ\fR
|
|
|
.RS 4
|
|
|
Отвергнуть запрос на подпись сертификата. ID_DEL_REQ - номер запроса.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-\-rv\fR, \fB\-\-revoke-cert\fR \fIREVOKE_CERT_ID\fR
|
|
|
.RS 4
|
|
|
Отозвать ранее подписанный сертификат сервера (удостоверяющего центра). Используйте значение rm для REVOKE_CERT_ID для удаления списка отзыва.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-\-version\fR
|
|
|
.RS 4
|
|
|
Вывод версии программы и выход.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
|
.RS 4
|
|
|
Показать краткую справку и закончить работу.
|
|
|
.RE
|
|
|
.SH СМ. ТАКЖЕ
|
|
|
.PP
|
|
|
cl-console-gui(1)
|
|
|
.SH ПРИМЕРЫ
|
|
|
.PP
|
|
|
Генерация корневого сертификата
|
|
|
.nf
|
|
|
cl-core --gen-root-cert
|
|
|
.fi
|
|
|
.PP
|
|
|
Отправка запроса на удалённый сервер с адресом 192.168.0.155
|
|
|
.nf
|
|
|
cl-core -gen-cert-by 192.168.0.155
|
|
|
.fi
|
|
|
.PP
|
|
|
Для сертификатов с номерами 1,2 и 5 добавить права на методы user-mod и group-mod и удалить права на метод cl-install.
|
|
|
.nf
|
|
|
cl-core -c 1,2,5 --right-add user-mod,group-mod --right-del cl-install
|
|
|
.fi
|
|
|
.PP
|
|
|
Просмотреть информацию о всех сертификатах.
|
|
|
.nf
|
|
|
cl-core -c all -d
|
|
|
.fi
|
|
|
.PP
|
|
|
Запустить сервер в отладочном режиме с английской локализацией.
|
|
|
.nf
|
|
|
cl-core --debug --lang en
|
|
|
.fi
|
|
|
.PP
|
|
|
Удаление сертификата с номером 7.
|
|
|
.nf
|
|
|
cl-core -c 7 --remove
|
|
|
.fi
|
|
|
.SH ФАЙЛЫ
|
|
|
.PP
|
|
|
\fB/var/calculate/server
|
|
|
.RS 4
|
|
|
Директория с запросами и подписанными сертификатами клиентов и серверов, права групп и сертификатов, информации о сессиях и процессах.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB/var/calculate/server/ca
|
|
|
.RS 4
|
|
|
Директория с сертификатом сервера, корневым сертификатом и сертификатом Удостоверяющего центра.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB/var/calculate/server/client_certs
|
|
|
.RS 4
|
|
|
Запросы на подпись сертификатов и подписанные сертификаты клиентов.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB/var/calculate/server/server_certs
|
|
|
.RS 4
|
|
|
Запросы на подпись сертификатов и подписанные сертификаты серверов.
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB/var/calculate/server/conf/group_right.conf
|
|
|
.RS 4
|
|
|
Список методов, разрешенных группам.
|
|
|
.nf
|
|
|
Пример содержимого:
|
|
|
.fi
|
|
|
.nf
|
|
|
manager pid_info,list_pid,cl_template,cl_login
|
|
|
.fi
|
|
|
.RE
|
|
|
.PP
|
|
|
\fB/var/calculate/server/conf/right.conf
|
|
|
.RS 4
|
|
|
Список номеров сертификатов, которым разрешено (запрещено) запускать метод.
|
|
|
.nf
|
|
|
Пример содержимого:
|
|
|
.fi
|
|
|
.nf
|
|
|
pid_info 2 -1
|
|
|
.fi
|
|
|
.RE
|
|
|
.RS 4
|
|
|
Сертификат номер 2 имеет права на метод "pid_info", и сертификат номер 1 не имеет прав на этод метод. Используйте ключи --right-add и --right-del.
|
|
|
.RE
|
|
|
.SH АВТОРЫ
|
|
|
.PP
|
|
|
Calculate Utilities разрабатываются компанией Калкулэйт http://www.calculate.ru
|
|
|
.SH АВТОР
|
|
|
.PP
|
|
|
Компания "Калкулэйт" http://www.calculate.ru
|