====== Пакет OpenSSL ======

===== Статьи =====

  * [[http://habrahabr.ru/company/tuthost/blog/150433/|Цифровые SSL сертификаты. Разновидности, как выбрать?]]
  * [[http://citforum.ru/security/cryptography/openssl/|Основы работы с OpenSSL]]
  * [[https://jamielinux.com/articles/2013/08/create-an-intermediate-certificate-authority/|How to create an intermediate certificate authority (CA)]]
  * [[https://ssltools.geotrust.com/checker/views/certCheck.jsp|Check your certificate installation]]

===== Проверка производительности CPU =====
<code>
$ openssl speed
</code>

===== Интерактивное подключение по ssl =====
<code>
$ openssl s_client -connect ru.wikipedia.org:443

$ openssl s_client -CApath /etc/ssl/certs/ -showcerts -connect student.bmstu.ru:443

$ openssl s_client -showcerts -connect webinar6.bmstu.ru:443 2>/dev/null | openssl x509 -noout -dates #-text | grep bmstu

$ faketime -f "+500d" wget -q -O /dev/null https://webinar7.bmstu.ru && echo Ok || echo Err

$ openssl s_client -CApath /etc/ssl/certs/ -starttls smtp -crlf -connect mailhub.bmstu.ru:25

$ openssl s_client -cert user1.crt -key user1.key -connect www.corpX.un:443
</code><code>
GET /cgi-bin/test-cgi HTTP/1.1
Host: www.corpX.un
</code><code>
$ openssl s_client -cert user1.crt -key user1.key -connect server.corpX.un:993
</code><code>
01 AUTHENTICATE EXTERNAL =
</code>

===== Использование алгоритмов симметричного шифрования ======
<code>
# openssl enc -aes-256-cbc -e -md md5 -in /root/spa-000E08NNNNNN.cfg -out spa-000E08NNNNNN.enc -pass pass:spapassword

# openssl enc -aes-256-cbc -d -md md5 -in spa-000E08NNNNNN.enc -out spa-000E08NNNNNN.cfg -pass pass:spapassword
</code>

===== Использование алгоритмов с открытым ключем =====

==== Создание пары приватный/публичный ключ ====
<code>
user1@server:~$ openssl genrsa 2048 > key.private

user1@server:~$ openssl rsa -pubout < key.private > key.public

user1@server:~$ scp key.public user2@www:
</code>

==== Шифрование данных ====
<code>
user2@www:~$ openssl rsautl -encrypt -inkey key.public -pubin < data.txt > data.enc

user2@www:~$ scp data.enc user1@server:

user1@server:~$ openssl rsautl -decrypt -inkey key.private < data.enc > data.txt
</code>

==== Цифровая подпись ====
<code>
user1@server:~$ openssl dgst -sha256 -sign key.private -out data.sign data.txt

user1@server:~$ scp data.* user2@www:

user2@www:~$ openssl dgst -sha256 -verify key.public -signature data.sign data.txt
</code>

===== Создание параметра DH =====
<code>
# time openssl dhparam -out /etc/openvpn/dh2048.pem 2048
real    0m24.676s
</code>

===== Создание самоподписанного сертификата =====

  * *.corpX.un для wild card сертификата
==== Создание приватного ключа ====
<code>
server# openssl genrsa -out server.key 2048

server# chmod 400 server.key
</code>

==== Создание сертификата ====
<code>
server# openssl req -new -x509 -days 3650 -key server.key -out server.crt -addext 'subjectAltName=DNS:server.corpX.un'
</code><code>
...
Country Name (2 letter code) [AU]:RU
State or Province Name (full name) [Some-State]:Moscow region
Locality Name (eg, city) []:Moscow
Organization Name (eg, company) [Internet Widgits Pty Ltd]:cko       
Organizational Unit Name (eg, section) []:noc
Common Name (eg, YOUR name) []:server.corpX.un       !!!! для некоторых сервисов (ovpn) не должно быть пустым
Email Address []:noc@corpX.un
</code>

ИЛИ

<code>
openssl req -new -x509 -days 3650 -key wild.key -out wild.crt -subj '/CN=*.corpX.un/O=CKO/C=RU' -addext 'subjectAltName=DNS:*.corpX.un'
</code>
==== Просмотр содержимого файла сертификата ====
<code>
server# openssl x509 -text -noout -in server.crt

server# openssl x509 -text -noout
-----BEGIN CERTIFICATE-----
...

$ cat ~/.kube/config | grep client-certificate-data | cut -f2 -d : | tr -d ' ' | base64 -d | openssl x509 -text -out -
</code>

===== Импорт сертификата центра сертификации =====

  * Материалы по Windows [[Материалы по Windows#Экспорт корневого сертификата]]
==== Проверка ====
<code>
server# openssl verify server.crt
...
error 20 at 0 depth lookup: unable to get local issuer certificate
error server.crt: verification failed
</code>

==== Debian ====
<code>
server# cp corpX-PDC-CA.crt /usr/local/share/ca-certificates/

# update-ca-certificates
Updating certificates in /etc/ssl/certs...
1 added, 0 removed; done.
...

server# ls /etc/ssl/certs | grep corp
...

server# openssl verify server.crt
server.crt: OK

# wget -O - https://www.corpX.un
</code>

===== Удаление сертификата центра сертификации =====
<code>
server# rm /usr/local/share/ca-certificates/corpX-PDC-CA.crt

server# rm /etc/ssl/certs/corpX-PDC-CA.pem

server# update-ca-certificates
</code>
===== Создание центра сертификации =====

  * [[http://gagravarr.org/writing/openssl-certs/ca.shtml|Certificate Management and Generation with OpenSSL]]
  * [[http://www.opennet.ru/base/sec/ssl_cert.txt.html|Авторизация с помощью клиентских SSL сертификатов]]
  * [[https://arminreiter.com/2022/01/create-your-own-certificate-authority-ca-using-openssl/|Create your own Certificate Authority (CA) using OpenSSL]]
  * [[https://www.golinuxcloud.com/openssl-ca-vs-openssl-x509-comparison/|openssl ca vs openssl x509 comparison]]

==== Зачем может понадобиться свой УЦ? ====

  * [[https://community.letsencrypt.org/t/can-i-create-client-certificates-for-a-received-letsencrypt-certificate/78627|Can I create client certificates for a received LetsEncrypt certificate?]]
==== Синхронизация времени ====

  * [[Сервис NTP]]

==== Настройка атрибутов базы CA в конфигурации ssl ====
<code>
lan# cat /etc/ssl/openssl.cnf
</code><code>
...
[ CA_default ]

dir           = /root/CA

...

certificate   = /var/www/html/ca.crt

crl           = /var/www/html/ca.crl

private_key   = $dir/ca.key

[ policy_match ]
...
</code><code>
cd
mkdir -p /var/www/html/
mkdir CA
mkdir CA/certs
mkdir CA/newcerts
mkdir CA/crl
touch CA/index.txt
echo "01" > CA/serial
echo "01" > CA/crlnumber
</code>

==== Создание зашифрованного приватного ключа ====
<code>
lan# openssl genrsa -des3 -out CA/ca.key 2048
</code><code>
Generating RSA key, 2048 bits
Enter PEM pass phrase:Pa$$w0rd
Verifying - Enter PEM pass phrase:Pa$$w0rd
</code>

==== Настройка атрибутов организации в конфигурации ssl ====
<code>
lan# cat /etc/ssl/openssl.cnf
</code><code>
...
[ req_distinguished_name ]
...
countryName_default           = RU
stateOrProvinceName_default   = Moscow region
localityName_default          = Moscow
0.organizationName_default    = cko
organizationalUnitName_default = noc
emailAddress_default          = noc@corpX.un

[ req_attributes ]
...
</code>

==== Создание самоподписанного корневого сертификата ====
<code>
lan# openssl req -new -x509 -days 3650 -key CA/ca.key -out /var/www/html/ca.crt
</code><code>
Enter pass phrase for ca.key:Pa$$w0rd
...
Common Name (eg, YOUR name) []:corpX.un
</code>

==== Инициализация списка отозванных сертификатов ====
<code>
lan# openssl ca -gencrl -out /var/www/html/ca.crl
</code><code>
Enter pass phrase for ./CA/ca.key:Pa$$w0rd
</code>

===== Создание сертификата сервиса, подписанного CA =====

==== Создание приватного ключа сервиса ====
<code>
www# openssl genrsa -out www.key 2048
</code>

==== Создание запроса на сертификат ====

  * *.corpX.un для wild card сертификата

<code>
lan# scp /etc/ssl/openssl.cnf www:/etc/ssl/

www# openssl req -new -key www.key -out www.req   #-sha256
</code><code>
...
Common Name (eg, YOUR name) []:www.corpX.un
...
</code>

=== Добавление расширений в запрос на сертификат ===

<code>
# cat /etc/ssl/openssl.cnf
</code><code>
...
[ req ]
...
req_extensions = v3_req

[ req_distinguished_name ]
...
[ v3_req ]
...
subjectAltName = @alt_names

[ alt_names ]
DNS.1 = corpX.un
DNS.2 = www.corpX.un
#DNS.1 = *.corpX.un
</code>
==== Передача и просмотр содержимого запроса на сертификат ====
<code>
www# scp www.req lan:

lan# openssl req -text -noout -in www.req
</code>

==== Подпись запроса на сертификат центром сертификации ====
<code>
lan# openssl ca -days 365 -in www.req -out www.crt

lan# cat CA/index.txt

lan# ls CA/newcerts/
</code>

=== Добавление расширений при подписи запроса на сертификат ===

<code>
# cat www.ext
</code><code>
subjectAltName = @alt_names
[alt_names]
DNS.1 = corpX.un
DNS.2 = www.corpX.un
#DNS.1 = *.corpX.un
</code><code>
lan# openssl ca ... -extfile www.ext
</code>

==== Копирование подписанного сертификата на целевой сервер ====
<code>
lan# scp www.crt www:

www# rm www.req
</code>

==== Проверка подписи сертификата ====
<code>
www# wget http://lan.corpX.un/ca.crt

www# openssl verify -CAfile ca.crt www.crt
</code>

==== Проверка соответствия ключа и сертификата ====
<code>
$ openssl x509 -noout -modulus -in www.crt | openssl md5

$ openssl rsa -noout -modulus -in www.key | openssl md5
</code>
==== Шифрование ключа сервера ====
<code>
www# openssl rsa -des3 -in www.clkey -out www.enckey
</code>



===== Создание пользовательского сертификата, подписанного CA =====

==== Создание приватного ключа пользователя ====
<code>
$ openssl genrsa -out user1.key 2048
</code>

==== Создание запроса на сертификат ====
<code>
$ openssl req -new -key user1.key -out user1.req
...
Organizational Unit Name (eg, section) [noc]:group1
Common Name (eg, YOUR name) []:user1
Email Address [noc@corpX.un]:user1@corpX.un
...
</code>

==== Подпись запроса на сертификат центром сертификации ====
<code>
lan# openssl ca -days 365 -in user1.req -out user1.crt

lan# cat CA/index.txt

lan# ls CA/newcerts/
</code>

==== Оформление сертификата и ключа в формате PKS#12 с парольной защитой ====

!!! Сразу импортировать в хранилище сертификатов на клиенте !!!

<code>
$ openssl pkcs12 -export -in user1.crt -inkey user1.key -out user1.p12 -passout pass:ppassword1

$ openssl pkcs12 -info -in user1.p12
</code>

===== Отзыв сертификатов =====
<code>
lan# less CA/index.txt

lan# openssl ca -revoke CA/newcerts/02.pem

lan# less CA/index.txt

lan# openssl ca -gencrl -out /var/www/html/ca.crl
</code>