Różnice pomiędzy wersjami 4 i 8 (Spinanie 4 wersji)
⇤ ← Wersja 4 z 2016-02-07 21:43:19 →
Rozmiar: 1766
Edytor: wtps0n
Komentarz: * przebudowa: etap 1
← Wersja 8 z 2019-05-05 22:43:20 → ⇥
Rozmiar: 11093
Edytor: wtps0n
Komentarz: * uzupełnienie konfiguracji do generowania certyfikatu klienta
Usunięcia zostały oznaczone w ten sposób. Dodatki zostały oznaczone w ten sposób.
Linia 4: Linia 4:
<<Action(print, Wydrukuj tę dokumentację)>><<Action(SlideShow,Pokaż jako slajdy)>><<BR>>
Linia 10: Linia 11:
Przede wszystkiem [[http://www.openssl.org/|OpenSSL|target="_blank"]] [[FreshPorts:security/openssl|z ports]] albo z systemu bazowego. Dodatkowo

== Certyfikat Root CA ==

== Certyfikat Intermediate CA ==

== Certyfikat dla serwera ==

== Certyfikat dla użytkownika ==
Przede wszystkiem [[http://www.openssl.org/|OpenSSL|target="_blank"]] z [[FreshPorts:security/openssl|ports]] albo z systemu bazowego. Dodatkowo potrzebny będzie `Makefile` z [[UniMaster|repozytroum skryptów]] jak również pliki konfiguracyjne dla [[http://www.openssl.org/|OpenSSL|target="_blank"]]a. Wszystkie te pliki muszę wylądować w katalogu `/usr/local/etc/ssl`<<FootNote(Jest to kolejny katalog w poszukiwaniu certyfikatów przez oporgramowanie instalowane we [[https://www.FreeBSD.org|FreeBSD|target="_blank"]].)>>.

== Lokalne zmiany dla make ==
Plik `Makefile` do generowania certyfikatów posiada dużo zmiennych, które można ustawić wg lokalnych potrzeb serwera. Wszystkie te zmiany powinny znaleźć się w pliku `__makefile_include__`. Przykładowa zawartość może wyglądać następująco:
{{{#!highlight bsdmake numbers=off
# ustawienia lokalne dla wybranych zmiennych
#
BSD_SERWIS_LOCAL_CA_OPERATIONS= yes
CRT_HOSTNAME= lab.wtp3.local

DAYS= 3685
CA_SIGN_DFLT_EXT= server_cert
CA_SIGN_CATRUE_EXT= v3_intermediate_ca
CSR_DFLT_EXT= server_cert
CSR_CATRUE_EXT= server_cert_ca
OPENSSL_CNF= ca-root.cnf
SHCRT_PARAMS= -text

CAKEY_CIPHER= aes128

CACRLFILE=$(CRT_SELFDIR)/crl/lab.ca.crl.pem
CAKEYFILE=$(CRT_SELFDIR)/private/lab.key.pem
CACRTFILE=$(CRT_SELFDIR)/certs/lab.crt.pem
}}}

== Zmiany w konfiguracji OpenSSL ==
Pliki konfiguracyjne dla [[http://www.openssl.org/|OpenSSL|target="_blank"]] są utrzymywane w [[UniMaster|repozytirum skryptów]]. Niemniej w razie potrzeby za pomocą autorskiego skryptu `unimaster` będzie możliwość zachowania lokalnych zmian. Druga możliwość do wpisywanie za każdym razem lokalnych ustawień domyślnych :)

=== string mask oraz policy_match ===
W trakcie tworzenia kolejnych certyfikatów może się pojawić komunikat o niezgodności polityki zgodności pomiędzy certyfikatem ''CA'' a nowo wygenerowanym ''csr''/ Należy sprawdzić ustawienia dotyczące '''string_mask''' oraz '''policy_match''':
{{{#!highlight ini numbers=off
# For the CA policy
[ policy_match ]
countryName = match
stateOrProvinceName = match

[req]
# This sets a mask for permitted string types. There are several options.
# default: PrintableString, T61String, BMPString.
# pkix : PrintableString, BMPString (PKIX recommendation before 2004)
# utf8only: only UTF8Strings (PKIX recommendation after 2004).
# nombstr : PrintableString, T61String (no BMPStrings or UTF8Strings).
# MASK:XXXX a literal mask value.
# WARNING: ancient versions of Netscape crash on BMPStrings or UTF8Strings.
string_mask = utf8only
}}}

W razie czego trzeba zmienić jedno z w/w ustawień:
{{{#!highlight ini numbers=off
[ policy_match ]
countryName = match
stateOrProvinceName = supplied

[req]
string_mask = pkix
}}}

= Certyfikat Root CA =
Po wykonaniu wszystkich modyfikacji dla lokalnego serwera można przystąpić do generowania certyfikatu głównego (''Root CA''):
{{{#!highlight bash numbers=off
cd /usr/local/etc/ssl/
make rand cakey ca
}}}

Weryfikację certyfikatu można wykonać poprzez wydanie polecenia:
{{{#!highlight bash numbers=off
cd /usr/local/etc/ssl/
make CRT_HOSTNAME=www.moj.serwer shca
}}}

= Certyfikat Intermediate CA =
Certyfikat potrzebny w przypadku konfiguracji [[SerwerProxy|serwera proxy]], który potrafi "''rozszywać''" SSL. Certyfikat pośredni posiada atrybut (w ramach swoich rozszerzeń) '''CA:true'''. Generowanie takiego certyfikatu jest już wykonane za pomocą dedykowanego pliku `Makefile`. W katalogu z certyfikatami wystarczy umieścić plik `__makefile_include__` z następującymi ustawieniami:
{{{#!highlight bsdmake numbers=off
# ustawienia lokalne dla wybranych zmiennych
#
BSD_SERWIS_LOCAL_CA_OPERATIONS= yes
CACRLFILE= $(CRT_SELFDIR)/crl/domena.ca.16.crl.pem
CAKEYFILE= $(CRT_SELFDIR)/private/domena.ca.16.key.pem
CACRTFILE= $(CRT_SELFDIR)/certs/domena.ca.16.crt.pem
CACRTFILE_DER= $(CRT_SELFDIR)/certs/domena.ca.16.crt.der
CRT_HOSTNAME= w3c.domena.local

DAYS= 3685
CA_SIGN_DFLT_EXT= server_cert
CA_SIGN_CATRUE_EXT= v3_intermediate_ca
CSR_DFLT_EXT= server_cert
CSR_CATRUE_EXT= v3_intermediate_ca
OPENSSL_CNF= ca-root.cnf

# parametry inne
SHCRT_PARAMS= -text
SHCA_PARAMS= -text

CAKEY_CIPHER= aes128

CRTFILE= $(CRT_SELFDIR)/certs/$(CRT_HOSTNAME).crt.pem
KEYFILE= $(CRT_SELFDIR)/private/$(CRT_HOSTNAME).key.pem
DHFILE= $(CRT_SELFDIR)/dh/$(CRT_HOSTNAME).$(CRT_SEED).dh.pem
CSRFILE= $(CRT_SELFDIR)/csr/$(CRT_HOSTNAME).csr.pem
CRT_SIGNED_FILE= $(CRT_SELFDIR)/certs/$(CRT_HOSTNAME).signed.pem
CRT_SIGNED_FILE_DER= $(CRT_SELFDIR)/certs/$(CRT_HOSTNAME).signed.der
}}}

Plik `ca-root.cnf` jest umieszczony w [[UniMaster|repozytorium skryptów]].

= Certyfikat dla serwera =
Po wygenerowaniu certyfikatu głównego oraz (ewentualnie) certyfikatu pośredniczącego można wygenerować prośbę o certyfikat dla konkretnego serwera:
{{{#!highlight bash numbers=off
cd /usr/local/etc/ssl/
make CRT_HOSTNAME=www.moj.serwer rand key csr
}}}

oraz sam certyfikat:
{{{#!highlight bash numbers=off
cd /usr/local/etc/ssl/
make CRT_HOSTNAME=www.moj.serwer sign
}}}

Weryfikację certyfikatu można wykonać poprzez wydanie polecenia:
{{{#!highlight bash numbers=off
cd /usr/local/etc/ssl/
make CRT_HOSTNAME=www.moj.serwer shcrt
}}}

= Certyfikat dla użytkownika =

== Wygenerowanie samego certyfikatu ==
Posiadając już gotowy ''Makefile'' należy wydać polecenia:
{{{#!highlight bash numbers=off
cd /usr/local/etc/ssl/
make CRT_HOSTNAME=win10.wtp3.local CA_SIGN_DFLT_EXT=usr_cert CSR_DFLT_EXT=usr_cert sign
}}}

W kolejnym kroku należwy wygenerować certyfikat w formacie p12, który można zaimportować do przeglądarki:
{{{#!highlight bash numbers=off
cd /usr/local/etc/ssl/
make CRT_HOSTNAME=win10.wtp3.local p12
}}}

== Instalacja w przeglądarkach ==

=== Firefox ===
W pierwszym kroku należy zainstalować certyfikat CA jako zaufanego wystawcę. Następnie należy zaimportować certyfikat w formacie ''p12'' do zakładki ''Użytkownicy''

I tu ciekawostka: pomimo poprawnego wygenerowania Firefox podaje komunikat (stan na dzień '''06.05.2019'''), że certyfikatu nie można zweryfikować z powodu "''nieznanego błędu''". Niemniej użycie tego certyfikatu jest możliwe oraz działa poprawnie po stronie [[NginxWebServer|serwera webowego]].

=== Chrome ===
W pierwszym kroku należy zainstalować certyfikat CA jako zaufanego wystawcę. Następnie należy zaimportować certyfikat w formacie ''p12'' do zakładki ''Osobisty''

== Konfiguracja po stronie serwera www ==
W [[NginxWebServer|konfiguracji serwera www]] należy zapewnić konfigurację, które autentykuje użytkownika po certyfikacie zamiast prostego "login/hasło".

= Utworzenie CRL =
Utworzenie pliku CRL to jedno. Drugą ważną rzeczą jest opublikowanie lity odwołanych certyfikatów. W konfiguracji [[http://www.openssl.org/|OpenSSL|target="_blank"]]a należy w odpowiedniej sekcji dodać następującą konfigurację:
{{{#!highlight ini numbers=off
[ CA_default ]
# Directory and file locations.
dir = ./
crl_dir = $dir/crl

# For certificate revocation lists.
crlnumber = $dir/crl/crlnumber
crl = $dir/crl/ca.crl.pem
crl_extensions = crl_ext
default_crl_days = 30

[ server_cert ]
# Extensions for server certificates (`man x509v3_config`).
crlDistributionPoints = http://ca.bsdserwis.com/ca.crl.pem

[ crl_ext ]
# Extension for CRLs (`man x509v3_config`).
authorityKeyIdentifier=keyid:always
}}}

Następnie przystępujemy do generowania listy:
{{{#!highlight bash numbers=off
cd /usr/local/etc/ssl/
make gencrl
}}}

Powstały CRL należy skopiować do katalogu, który jest upubliczniany przez [[SerwerWebowy|serwer webowy]]

= Utworzenie OCSP =
[[PlWikiPedia:Online_Certificate_Status_Protocol|OCSP]] ma w założeniu być protokołem (mechanizmem) pozwalającym na sprawdzanie ważności certyfikatów w czasie rzeczywistym. W przypadku OCSP serwer nie jest uruchamiany poprzez np. [[FreshPorts:www/apache24]], tylko poprzez samego [[http://www.openssl.org/|OpenSSL|target="_blank"]]a.

/!\ Na chwilę obecną uruchomienie OCSP wymaga prac ''skryptowych'' w celu poprawnego działania.

/!\ /!\ /!\ Do ukończenia.
Linia 21: Linia 202:
Linia 24: Linia 204:
(!) Plik iznajdujące się w katalogu `/etc/ssl` muszą być w formacie '''PEM''', zaś nazwy plików muszą być z rozszerzeniem `.pem`. Po każdej zmianie zawartości katalogu należy wykonać jest aktualizację:

{{{#!shell numbers=off
(!) Pliki znajdujące się w katalogu `/etc/ssl` muszą być w formacie '''PEM''', zaś nazwy plików muszą być z rozszerzeniem `.pem`. Po każdej zmianie zawartości katalogu należy wykonać jego aktualizację:

{{{#!highlight bash numbers=off
Linia 32: Linia 212:
 * [[https://www.digitalocean.com/community/tutorials/how-to-configure-ocsp-stapling-on-apache-and-nginx||target="_blank"]]
 * [[https://support.globalsign.com/customer/portal/articles/1618853-ocsp-stapling||target="_blank"]]
 * [[https://jamielinux.com/docs/openssl-certificate-authority/online-certificate-status-protocol.html|openssl OCSP howto|target="_blank"]]

Wydrukuj tę dokumentacjęPokaż jako slajdy

Wykonanie własnego CA

W chwili obecnej dostępne są darmowe certyfikaty, niemniej może być przydatne utworzenie własnego CA np. na potrzeby deszyfracji ruchu webowego dla przeglądarek. Dodatkowo własne CA pozwala na wykorzystanie uwierzytelniania z wykorzystaniem certyfikatu klienta zamiast klasycznego login/hasło.

Wymagane komponenty

Przede wszystkiem OpenSSL z ports albo z systemu bazowego. Dodatkowo potrzebny będzie Makefile z repozytroum skryptów jak również pliki konfiguracyjne dla OpenSSLa. Wszystkie te pliki muszę wylądować w katalogu /usr/local/etc/ssl1.

Lokalne zmiany dla make

Plik Makefile do generowania certyfikatów posiada dużo zmiennych, które można ustawić wg lokalnych potrzeb serwera. Wszystkie te zmiany powinny znaleźć się w pliku __makefile_include__. Przykładowa zawartość może wyglądać następująco:

# ustawienia lokalne dla wybranych zmiennych
#
BSD_SERWIS_LOCAL_CA_OPERATIONS=         yes
CRT_HOSTNAME=                           lab.wtp3.local

DAYS=                                   3685
CA_SIGN_DFLT_EXT=                       server_cert
CA_SIGN_CATRUE_EXT=                     v3_intermediate_ca
CSR_DFLT_EXT=                           server_cert
CSR_CATRUE_EXT=                         server_cert_ca
OPENSSL_CNF=                            ca-root.cnf
SHCRT_PARAMS=                           -text

CAKEY_CIPHER=                           aes128

CACRLFILE=$(CRT_SELFDIR)/crl/lab.ca.crl.pem
CAKEYFILE=$(CRT_SELFDIR)/private/lab.key.pem
CACRTFILE=$(CRT_SELFDIR)/certs/lab.crt.pem

Zmiany w konfiguracji OpenSSL

Pliki konfiguracyjne dla OpenSSL są utrzymywane w repozytirum skryptów. Niemniej w razie potrzeby za pomocą autorskiego skryptu unimaster będzie możliwość zachowania lokalnych zmian. Druga możliwość do wpisywanie za każdym razem lokalnych ustawień domyślnych :)

string mask oraz policy_match

W trakcie tworzenia kolejnych certyfikatów może się pojawić komunikat o niezgodności polityki zgodności pomiędzy certyfikatem CA a nowo wygenerowanym csr/ Należy sprawdzić ustawienia dotyczące string_mask oraz policy_match:

# For the CA policy
[ policy_match ]
countryName             = match
stateOrProvinceName     = match

[req]
# This sets a mask for permitted string types. There are several options.
# default: PrintableString, T61String, BMPString.
# pkix   : PrintableString, BMPString (PKIX recommendation before 2004)
# utf8only: only UTF8Strings (PKIX recommendation after 2004).
# nombstr : PrintableString, T61String (no BMPStrings or UTF8Strings).
# MASK:XXXX a literal mask value.
# WARNING: ancient versions of Netscape crash on BMPStrings or UTF8Strings.
string_mask = utf8only

W razie czego trzeba zmienić jedno z w/w ustawień:

[ policy_match ]
countryName             = match
stateOrProvinceName     = supplied

[req]
string_mask = pkix

Certyfikat Root CA

Po wykonaniu wszystkich modyfikacji dla lokalnego serwera można przystąpić do generowania certyfikatu głównego (Root CA):

cd /usr/local/etc/ssl/
make rand cakey ca

Weryfikację certyfikatu można wykonać poprzez wydanie polecenia:

cd /usr/local/etc/ssl/
make CRT_HOSTNAME=www.moj.serwer shca

Certyfikat Intermediate CA

Certyfikat potrzebny w przypadku konfiguracji serwera proxy, który potrafi "rozszywać" SSL. Certyfikat pośredni posiada atrybut (w ramach swoich rozszerzeń) CA:true. Generowanie takiego certyfikatu jest już wykonane za pomocą dedykowanego pliku Makefile. W katalogu z certyfikatami wystarczy umieścić plik __makefile_include__ z następującymi ustawieniami:

# ustawienia lokalne dla wybranych zmiennych
#
BSD_SERWIS_LOCAL_CA_OPERATIONS=         yes
CACRLFILE=                              $(CRT_SELFDIR)/crl/domena.ca.16.crl.pem
CAKEYFILE=                              $(CRT_SELFDIR)/private/domena.ca.16.key.pem
CACRTFILE=                              $(CRT_SELFDIR)/certs/domena.ca.16.crt.pem
CACRTFILE_DER=                          $(CRT_SELFDIR)/certs/domena.ca.16.crt.der
CRT_HOSTNAME=                           w3c.domena.local

DAYS=                                   3685
CA_SIGN_DFLT_EXT=                       server_cert
CA_SIGN_CATRUE_EXT=                     v3_intermediate_ca
CSR_DFLT_EXT=                           server_cert
CSR_CATRUE_EXT=                         v3_intermediate_ca
OPENSSL_CNF=                            ca-root.cnf

# parametry inne
SHCRT_PARAMS=                           -text
SHCA_PARAMS=                            -text

CAKEY_CIPHER=                           aes128

CRTFILE=                                $(CRT_SELFDIR)/certs/$(CRT_HOSTNAME).crt.pem
KEYFILE=                                $(CRT_SELFDIR)/private/$(CRT_HOSTNAME).key.pem
DHFILE=                                 $(CRT_SELFDIR)/dh/$(CRT_HOSTNAME).$(CRT_SEED).dh.pem
CSRFILE=                                $(CRT_SELFDIR)/csr/$(CRT_HOSTNAME).csr.pem
CRT_SIGNED_FILE=                        $(CRT_SELFDIR)/certs/$(CRT_HOSTNAME).signed.pem
CRT_SIGNED_FILE_DER=                    $(CRT_SELFDIR)/certs/$(CRT_HOSTNAME).signed.der

Plik ca-root.cnf jest umieszczony w repozytorium skryptów.

Certyfikat dla serwera

Po wygenerowaniu certyfikatu głównego oraz (ewentualnie) certyfikatu pośredniczącego można wygenerować prośbę o certyfikat dla konkretnego serwera:

cd /usr/local/etc/ssl/
make CRT_HOSTNAME=www.moj.serwer rand key csr

oraz sam certyfikat:

cd /usr/local/etc/ssl/
make CRT_HOSTNAME=www.moj.serwer sign

Weryfikację certyfikatu można wykonać poprzez wydanie polecenia:

cd /usr/local/etc/ssl/
make CRT_HOSTNAME=www.moj.serwer shcrt

Certyfikat dla użytkownika

Wygenerowanie samego certyfikatu

Posiadając już gotowy Makefile należy wydać polecenia:

cd /usr/local/etc/ssl/
make CRT_HOSTNAME=win10.wtp3.local CA_SIGN_DFLT_EXT=usr_cert CSR_DFLT_EXT=usr_cert sign

W kolejnym kroku należwy wygenerować certyfikat w formacie p12, który można zaimportować do przeglądarki:

cd /usr/local/etc/ssl/
make CRT_HOSTNAME=win10.wtp3.local p12

Instalacja w przeglądarkach

Firefox

W pierwszym kroku należy zainstalować certyfikat CA jako zaufanego wystawcę. Następnie należy zaimportować certyfikat w formacie p12 do zakładki Użytkownicy

I tu ciekawostka: pomimo poprawnego wygenerowania Firefox podaje komunikat (stan na dzień 06.05.2019), że certyfikatu nie można zweryfikować z powodu "nieznanego błędu". Niemniej użycie tego certyfikatu jest możliwe oraz działa poprawnie po stronie serwera webowego.

Chrome

W pierwszym kroku należy zainstalować certyfikat CA jako zaufanego wystawcę. Następnie należy zaimportować certyfikat w formacie p12 do zakładki Osobisty

Konfiguracja po stronie serwera www

W konfiguracji serwera www należy zapewnić konfigurację, które autentykuje użytkownika po certyfikacie zamiast prostego "login/hasło".

Utworzenie CRL

Utworzenie pliku CRL to jedno. Drugą ważną rzeczą jest opublikowanie lity odwołanych certyfikatów. W konfiguracji OpenSSLa należy w odpowiedniej sekcji dodać następującą konfigurację:

[ CA_default ]
# Directory and file locations.
dir               = ./
crl_dir           = $dir/crl

# For certificate revocation lists.
crlnumber         = $dir/crl/crlnumber
crl               = $dir/crl/ca.crl.pem
crl_extensions    = crl_ext
default_crl_days  = 30

[ server_cert ]
# Extensions for server certificates (`man x509v3_config`).
crlDistributionPoints           = http://ca.bsdserwis.com/ca.crl.pem

[ crl_ext ]
# Extension for CRLs (`man x509v3_config`).
authorityKeyIdentifier=keyid:always

Następnie przystępujemy do generowania listy:

cd /usr/local/etc/ssl/
make gencrl

Powstały CRL należy skopiować do katalogu, który jest upubliczniany przez serwer webowy

Utworzenie OCSP

OCSP ma w założeniu być protokołem (mechanizmem) pozwalającym na sprawdzanie ważności certyfikatów w czasie rzeczywistym. W przypadku OCSP serwer nie jest uruchamiany poprzez np. www/apache24, tylko poprzez samego OpenSSLa.

/!\ Na chwilę obecną uruchomienie OCSP wymaga prac skryptowych w celu poprawnego działania.

/!\ /!\ /!\ Do ukończenia.

Skonfigurowanie katalogu z certyfikatami SSL (certyfikatami CA)

(!) Istnieje katalog /etc/ssl zawierający wszelkie CA zainstalowane w systemie. Jest tam zestaw certyfikatów zainstalowanych przez security/ca_root_nss. W tym katalogu powinny znaleźć się również wszystkie certyfikaty CA wygenerowane samodzielnie w ramach własnego CA (patrz wyżej). Ten katalog (/etc/ssl) można podawać jako parametr CApath w różnych programach (np. security/stunnel albo www/apache22).

(!) Pliki znajdujące się w katalogu /etc/ssl muszą być w formacie PEM, zaś nazwy plików muszą być z rozszerzeniem .pem. Po każdej zmianie zawartości katalogu należy wykonać jego aktualizację:

c_rehash /etc/ssl

Źródła w sieci internet


{i}  (c) 2004 - 2026 BSD Serwis Krzysztof Stryjek. W przypadku błędów, poprawek proszę kontaktować się z administratorem wiki.


  1. Jest to kolejny katalog w poszukiwaniu certyfikatów przez oporgramowanie instalowane we FreeBSD. (1)

CertyfikatySsl (ostatnio edytowane 2019-11-17 09:31:57 przez wtps0n)