добавлены Инструкция по сборке.md и Инструкция по установке.md

This commit is contained in:
alashkova 2024-09-12 13:35:57 +03:00
parent 6bea066cac
commit 8e81edc58a
3 changed files with 158 additions and 54 deletions

View file

@ -28,66 +28,21 @@ $ curl -v http://127.0.0.1:8080/sign -H "Content-Type: text/plain" -d "test"
urlSafeBase64_of_signed_string_test urlSafeBase64_of_signed_string_test
``` ```
## Сборка и установка ## Сборка из исходников
### Подготовка Инструкции по сборке из исходников см. "Инструкция по сборке.md"
1. Установить КриптоПро. Примечание. Чтобы задать произвольное имя конфигурационного файла, при сборке приложения необходимо задать параметр CONFIG_NAME.
2. Установить сертификат для пользователя, под которым будет запускаться данное приложение.
3. Установить nginx.
4. В настройках nginx добавить перенаправление на данное приложение:
```
location = /sign {
fastcgi_pass localhost:9009;
include fastcgi_params;
}
```
### Cборка из исходников
Для **сборки** необходимы следующие библиотеки:
- cmake
- gcc
- gcc10
- glib2-devel
- libfcgi-devel
- lsb-cprocsp-base
- lsb-cprocsp-rdr-64
- lsb-cprocsp-kc1-64
- lsb-cprocsp-capilite-64
- cprocsp-curl-64
- lsb-cprocsp-ca-certs
- cprocsp-pki-cades-64
- lsb-cprocsp-devel
Для **установки** необходимы следующие библиотеки:
- glib2
- libfcgi
- lsb-cprocsp-base
- lsb-cprocsp-rdr-64
- lsb-cprocsp-kc1-64
- lsb-cprocsp-capilite-64
- cprocsp-curl-64
- lsb-cprocsp-ca-certs
- cprocsp-pki-cades-64
Для сборки и установки приложения из исходников, выполните следующие команды:
```
$ mkdir .build && cd .build
$ cmake ..
$ make -j$(nproc)
```
Чтобы задать произвольное имя конфигурационного файла, при сборке приложения необходимо задать параметр CONFIG_NAME.
Пример: Пример:
``` ```
cmake -DCONFIG_NAME=/opt/ervu-sign-module.conf cmake -DCONFIG_NAME=/opt/ervu-sign-module.conf ..
``` ```
### Настройка ## Установка
Инструкции по установке см. "Инструкция по установке.md"
## Настройка
Приложение настраивается в конфигурационном файле, заданном на этапе сборки (по умолчанию, /etc/ervu-sign-module.conf). Приложение настраивается в конфигурационном файле, заданном на этапе сборки (по умолчанию, /etc/ervu-sign-module.conf).

View file

@ -0,0 +1,33 @@
## Сборка модуля подписания
### Установка КриптоПро
1. Скачать КриптоПро 5 R3 КС3.
2. Установить КриптоПро. Для этого выполнить команды от имени root:
``` bash
tar -zxvf linux-amd64.tgz && cd ./linux-amd64/
./install.sh
apt-get install ./cprocsp-pki-cades-64-2.0.14815-1.amd64.rpm
apt-get install ./lsb-cprocsp-devel-5.0.12800-7.noarch.rpm
cd -
```
### Сборка ervu-sign-module
1. Установить зависимости для сборки приложения:
``` bash
apt-get install cmake gcc gcc10
apt-get install glib2-devel libfcgi-devel
```
2. Собрать приложение из исходников:
``` bash
cd ervu-sign-module/
mkdir .build && cd .build
cmake ..
make -j$(nproc)
```
Результатом сборки будет файл ervu-sign-module в папке .build/

View file

@ -0,0 +1,116 @@
## Установка модуля подписания
### Создание пользователя ervu
1. Создать пользователя ervu. Для этого выполнить команды от имени root:
``` bash
adduser --system --no-create-home --user-group ervu
```
### Установка и настройка КриптоПро
1. Скачать КриптоПро 5 R3 КС3.
2. Установить КриптоПро. Для этого выполнить команды от имени root:
``` bash
tar -zxvf linux-amd64.tgz && cd ./linux-amd64/
./install.sh
apt-get install ./cprocsp-pki-cades-64-2.0.14815-1.amd64.rpm
cd -
```
3. Активировать лицензию:
``` bash
/opt/cprocsp/sbin/amd64/cpconfig -license -set "Номер"
```
4. Установить сертификат для пользователя ervu (команды выполняются от имени **ervu**):
``` bash
mkdir /var/opt/cprocsp/keys/ervu/
cp -r key_cont.000/ /var/opt/cprocsp/keys/ervu/
chmod 700 /var/opt/cprocsp/keys/ervu/key_cont.000
chmod 600 /var/opt/cprocsp/keys/ervu/key_cont.000/*
chown -R ervu:ervu /var/opt/cprocsp/keys/ervu/key_cont.000/
/opt/cprocsp/bin/amd64/csptest -absorb -certs -autoprov
```
### Установка и настройка nginx
Дальнейшие шаги выполняются от имени root:
1. Установить nginx:
``` bash
apt-get install nginx
```
2. Скопировать файл настроек для nginx:
``` bash
cp conf/nginx.conf /etc/nginx/
```
3. Запустить nginx:
``` bash
systemctl start nginx
```
### Установка и настройка ervu-sign-module
1. Установить зависимости для запуска приложения:
``` bash
apt-get install glib2 libfcgi
```
2. Скопировать исполняемый файл:
``` bash
mkdir /opt/ervu-sign-module/
cp ./ervu-sign-module /opt/ervu-sign-module/
```
3. Скопировать файл настроек:
``` bash
cp conf/ervu-sign-module.conf /etc/
```
4. Скопировать юнит:
``` bash
cp ./ervu-sign-module.service /etc/systemd/system/
```
4. Включить запуск службы при загрузке:
``` bash
systemctl enable ervu-sign-module
```
5. Запустить службу:
``` bash
systemctl start ervu-sign-module
```
### Проверка
Для проверки работы модуля выполните команду:
``` bash
curl -v http://127.0.0.1/sign -H "Content-Type: text/plain" -d "test"
```
Вывод должен быть примерно таким (статус-код ответа должен быть равен 200 OK)
```
* Trying 127.0.0.1:80...
* Connected to 127.0.0.1 (127.0.0.1) port 80
> POST /sign HTTP/1.1
> Host: 127.0.0.1
> User-Agent: curl/8.4.0
> Accept: */*
> Content-Type: text/plain
> Content-Length: 4
>
< HTTP/1.1 200 OK
< Server: nginx/1.24.0
< Date: Tue, 20 Aug 2024 12:00:25 GMT
< Content-Type: text/plain
< Transfer-Encoding: chunked
< Connection: keep-alive
<
REFlyzGQrCjX9DvA7hWwN9vf5kPqBxcG4TLYnXUHnAS9_G-sLAFvaJei2OhxpaWNraHbOv_mMsM_bcDsXWiC0Q
* Connection #0 to host 127.0.0.1 left intact
```