Różnice pomiędzy wersjami 1 i 5 (Spinanie 4 wersji)
⇤ ← Wersja 1 z 2014-03-10 11:20:50 →
Rozmiar: 1079
Edytor: wtps0n
Komentarz:
← Wersja 5 z 2016-02-08 03:19:48 → ⇥
Rozmiar: 5046
Edytor: wtps0n
Komentarz: * przebudowa: etap 2
Usunięcia zostały oznaczone w ten sposób. Dodatki zostały oznaczone w ten sposób.
Linia 4: Linia 4:
= Skonfigurowanie katalogu z certyfikatmi SSL (CA) = <<TableOfContents()>>
Linia 6: Linia 6:
W ramach instalacji ports pojawił się zapewne pakiet [[http://www.freshports.org/security/ca_root_nss|ca_root_nss|target="_blank"]]. Dodatkowo możemy mieć własne CA dla certyfikatów na różne usługi. Wiele programów (np. [[[[http://www.freshports.org/security/stunnel|stunnel|target="_blank"]] chętnie skorzysta ze wszystkich tych certyfikatów. Ale format musi być odpowiedni - certyfikaty muszą być w formacie PEM oraz nazwy plików muszą być z rozszerzeniem '''.pem'''. Zatem należy wykonać następujące kroki: = Wykonanie własnego CA =
W chwili obecnej dostępne są [[LetsEncrypt|darmowe certyfikaty]], niemniej może być przydatne utworzenie własnego CA np. na potrzeby [[SerwerProxy|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 [[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:
{{{#!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 :)

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

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

== Certyfikat Intermediate CA ==
/!\ /!\ /!\ Do ukończenia. Aktualnie nie korzystam z certyfikatów pośrednich (patrz źródła w siec internet).

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

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

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

== Certyfikat dla użytkownika ==
/!\ /!\ /!\ Do ukończenia.

== 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ą linijkę:
{{{
crlDistributionPoints = http://ca.bsdserwis.com/ca.crl.pem
}}}

Następnie przystępujemy do generowania listy

== Utworzenie OCSP ==
/!\ /!\ /!\ 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 [[FreshPorts:security/ca_root_nss|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. [[FreshPorts:security/stunnel|security/stunnel]] albo [[FreshPorts:www/apache22|www/apache22]]).

(!) 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ę:
Linia 9: Linia 93:
# skopiować właśne certyikaty do katalogu /etc/ssl (powinien tam już być link symboliczny
# do /usr/local/share/certs/ca-root-nss.crt jako /etc/ssl/cert.pem)
#
Linia 14: Linia 95:
Należy też pamiętać, że każda zmiana (dodanie, odjęcie certyfikatu) musi się kończyć wykonaniem polecenia '''c_rehash'''.
Linia 16: Linia 96:
W plikach konfiguracyjnych (np w/w stunnel-a) wpisujemy takie oto dyrektywy:
{{{
CApath = /etc/ssl
}}}
= Źródła w sieci internet =
 * [[https://jamielinux.com/docs/openssl-certificate-authority/||target="_blank"]]

-----
{i} ` `<<GetVal(SlownikNewBsd,adm-podpis)>>
----

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 :)

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

/!\ /!\ /!\ Do ukończenia. Aktualnie nie korzystam z certyfikatów pośrednich (patrz źródła w siec internet).

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

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

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ą linijkę:

crlDistributionPoints           = http://ca.bsdserwis.com/ca.crl.pem

Następnie przystępujemy do generowania listy

Utworzenie OCSP

/!\ /!\ /!\ 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).

(!) 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ę:

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)