Ten sam zamek, własne drzwi

Aplikacja Home Assistant przez Cloudflare, zamknięta na certyfikat umieszcza zamek na brzegu sieci Cloudflare. Telefon ma certyfikat, Cloudflare go sprawdza, a nic bez certyfikatu nigdy nie dociera do domu. Działa, jest za darmo i oznacza, że Cloudflare trzyma bramę i czyta ruch, który przez nią przechodzi.

Tu jest ten sam zamek, z drzwiami we własnym domu. Certyfikat sprawdza nginx albo Caddy. Wystawia go twój własny urząd certyfikacji. Nikogo innego nie ma na ścieżce. Strona logowania dalej jest niewidoczna dla wszystkiego, co nie ma certyfikatu, więc zmienia się nie to, czy obcy wejdą. Zmienia się to, kto wykonuje pracę i kto ponosi ryzyko, gdy coś pójdzie nie tak.

Wszystko tutaj zostało zbudowane i przetestowane: nginx 1.30.5 i Caddy 2.11.7 w Podmanie, certyfikaty ze step-ca 0.30.2, każde proxy odpytane bez certyfikatu, z dobrym certyfikatem, z unieważnionym i z przejściem na WebSocket, po IPv4 i IPv6. Backendem w teście był mały zastępnik, który odsyła z powrotem nagłówki, jakie dostaje, więc wyniki pokazują dokładnie to, co dostałby Home Assistant.

Co się zmienia, gdy Cloudflare znika

mTLS w domu z nginx albo CaddyTelefonma cert.Każdy innybrak cert.Zalew ruchucert. zbędnySieć domowaRouterport 443brak tarczyDDoSnginx albo Caddyłańcuch do twojego CA?nieunieważniony?IPv4 i IPv6step-caHome Assistantufa proxyOdrzuconyw handshake'uprzejścieodmowa
Teraz wszystko trafia do twojego routera. Proxy odrzuca wszystko bez dobrego certyfikatu, zanim zobaczy to Home Assistant. Zalew ruchu nie potrzebuje certyfikatu, a skoro po drodze nie ma nikogo, kto by go wchłonął, ląduje na twoim łączu.
Wersja z Cloudflarenginx albo Caddy w domu
Kto sprawdza certyfikatbrzeg sieci Cloudflare, regułą WAFtwoje proxy, w trakcie handshake’u TLS
Urząd certyfikacjizarządzany przez Cloudflaretwój własny, step-ca dla certyfikatów klienta
Kto widzi ruch odszyfrowanyCloudflare, potem Home Assistanttwoje proxy i Home Assistant, nikt więcej
Wejście z zewnątrztunel, tylko wychodzącyprzekierowanie portu na proxy
Atak DDoS ląduje naCloudflaretwoim domowym łączu
Połączenie obcego kosztujenic w domuhandshake TLS na proxy, nigdy logowanie do Home Assistant
IPv4 i IPv6oba, Cloudflare odpowiada na każdeoba, jeśli łącze ma oba, a proxy nasłuchuje na obu
Unieważnianiewbudowane, sprawdzane przez regułęnginx sprawdza CRL; Caddy trzyma listę dozwolonych
Gdy dostawca leżybrak dostępu zdalnegonic się nie zmienia
Koszty utrzymaniadarmowy planza darmo, plus twój czas na CA

Dwa najważniejsze wiersze ciągną w przeciwne strony. Nikt inny nie czyta twojego ruchu ani nie może cię wyłączyć, i to jest suwerenność, cały powód, żeby to robić. Ale przekierowanie portu wraca, więc skany i zalewy ruchu trafiają w twoje łącze zamiast w łącze Cloudflare. Różnica względem zwykłego przekierowania portu z porównania w artykule o Cloudflare polega na tym, co zastają, gdy dotrą: proxy, które zrywa połączenie w trakcie handshake’u, a nie stronę logowania Home Assistant.

Miej jasność, co to daje, a czego nie. Własne reverse proxy nie daje żadnej ochrony przed DDoS. mTLS powstrzymuje obcego przed wejściem. Nie robi nic, żeby powstrzymać obcego przed zapchaniem twojego łącza, a zalew ruchu nie potrzebuje certyfikatu, żeby je zapchać. Cloudflare wchłania to za ciebie w każdym planie, łącznie z darmowym1. Tutaj nikt po drodze tego nie wchłonie, więc wystarczająco duży zalew odcina cały dom od internetu, a proxy może odrzucać tylko te połączenia, które w ogóle do niego dotrą.

nginx czy Caddy

Oba spełniają zadanie. Różnią się w jednym miejscu, które ma znaczenie. Unieważnianie.

Unieważnianie z nginx i z Caddynginx: CRL pobierana timeremstep-caunieważnij, nowa CRL/1.0/crlzwykły HTTPTimerpobierz, przeładujnginxsprawdza łańcuchCaddy: lista dozwolonych, ręcznieTykażde odnowienieListakonkretne certyPrzeładujpo każdej edycjiCaddyweryfikator leaf
nginx dostaje CRL od timera i sprawdza ją przy każdym połączeniu. Caddy nie obsługuje CRL, więc unieważnianie to lista konkretnych certyfikatów, którą prowadzisz ręcznie.
nginx 1.30.5Caddy 2.11.7
Brak certyfikatuhandshake się kończy, 400 No required SSL certificate was senthandshake odrzucony, curl kończy kodem 55
Unieważniony certyfikatodrzucony, 400 The SSL certificate errorwpuszczony bez przeszkód przy samej kontroli CA
Metoda unieważnianiaCRL, sprawdzana w całym łańcuchulista dozwolonych certyfikatów, weryfikator leaf
WebSocket dla aplikacjitrzeba ustawić nagłówki Upgrade i Connectiondziała bez dodatkowej konfiguracji
IPv6tylko po dodaniu listen [::]:443domyślnie nasłuchuje na obu
Konfiguracjaokoło 30 liniiokoło 15 linii

Unieważnianie to to, o czym trzeba zdecydować. Dokumentacja Caddy wymienia dokładnie jeden weryfikator dostarczany ze standardowym Caddy, leaf, i sprawdza on, czy certyfikat „is one of a defined set of permitted certificates”2. Nie ma CRL ani OCSP dla certyfikatów klienta. Wskaż Caddy samo CA, a unieważniony telefon wejdzie. Test pokazał dokładnie to: phone2, unieważniony godzinę wcześniej, dostał 200. Lista dozwolonych zamyka tę lukę. To też lista, którą prowadzisz ręcznie, tak długo, jak to utrzymujesz.

Konfiguracja nginx

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name ha.example.com;

    ssl_certificate         /etc/nginx/pki/server-chain.pem;
    ssl_certificate_key     /etc/nginx/pki/server.key;
    ssl_protocols           TLSv1.2 TLSv1.3;

    # The mTLS half: only certificates from our CA, and not revoked.
    ssl_client_certificate  /etc/nginx/pki/client-ca.pem;
    ssl_verify_client       on;
    ssl_verify_depth        2;
    ssl_crl                 /etc/nginx/pki/crl-chain.pem;

    location / {
        proxy_pass http://192.0.2.10:8123;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
    }
}
LiniaPo co tam jest
listen [::]:443 sslbez niej nginx działa tylko po IPv4, a telefon w sieci IPv6 nie ma gdzie wylądować
ssl_verify_client onbez certyfikatu nie ma wejścia. optional przepuściłoby żądanie, żeby ocenić je później
ssl_verify_depth 2step-ca podpisuje z certyfikatu pośredniego, więc łańcuch to telefon, pośredni, główny. Domyślne 1 nie sięga do końca3
ssl_client_certificatecertyfikat pośredni i główny w jednym pliku
ssl_crlCRL ze step-ca i CRL z głównego CA w jednym pliku. nginx sprawdza każde ogniwo łańcucha, więc potrzebuje obu
Upgrade i Connectionaplikacja rozmawia z Home Assistant przez WebSocket. Bez nich aplikacja się ładuje, a potem stoi

Plik CRL to część, która wymaga uwagi, i wszystko o nim jest w certyfikatach klienta ze step-ca: dlaczego CRL ze step-ca jest odrzucana, dopóki szablon nie poprawi jej zakresu, dlaczego nginx chce też CRL z głównego CA i timer, który odświeża ją, zanim wygaśnie. Pomiń to, a nginx zablokuje każdy telefon, dobre też.

Co wróciło z testu:

KlientIPv4IPv6
Brak certyfikatu400 No required SSL certificate was sent400
phone1200, X-Forwarded-For: 127.0.0.1200, X-Forwarded-For: ::1
phone2, unieważniony400 The SSL certificate error400
phone1, przejście na WebSocket200, Upgrade: websocket przekazany dalej200, Upgrade: websocket przekazany dalej

Zanim weszła linia listen dla IPv6, żądanie po IPv6 w ogóle się nie łączyło. curl kończył kodem 7.

Konfiguracja Caddy

ha.example.com {
	tls /etc/caddy/pki/server-chain.pem /etc/caddy/pki/server.key {
		client_auth {
			mode require_and_verify
			trust_pool file /etc/caddy/pki/client-ca.pem
			verifier leaf {
				file /etc/caddy/pki/allowed-phones.pem
			}
		}
	}
	reverse_proxy 192.0.2.10:8123
}

require_and_verify oznacza, że certyfikat musi być i musi prowadzić łańcuchem do CA2. verifier leaf to unieważnianie. Wchodzą tylko certyfikaty z allowed-phones.pem, więc unieważnienie telefonu oznacza usunięcie jego certyfikatu z tego pliku i przeładowanie.

KlientIPv4IPv6
Brak certyfikatuhandshake odrzuconyhandshake odrzucony
phone1, na liście200, X-Forwarded-For: 127.0.0.1200, X-Forwarded-For: ::1
phone2, unieważniony, tylko kontrola CA200
phone2, spoza listyhandshake odrzuconyhandshake odrzucony
phone1, przejście na WebSocket po HTTP/1.1200, Upgrade: websocket przekazany dalej

Lista dozwolonych ma własną pułapkę i test wpadł w nią prosto. Lista trzyma konkretne certyfikaty, a nie nazwy. Wystaw telefonowi nowy certyfikat, a nowego nie ma na liście. phone1 dostał nowy certyfikat w połowie testów i Caddy odrzucał go z tls alert bad certificate, dopóki lista nie została przebudowana. Każde odnowienie to teraz dwie roboty. Wystaw certyfikat, potem zaktualizuj listę. Zapomnij o drugiej, a telefon jest zablokowany za nic.

Caddy przy starcie zapisuje też w logu enabling strict SNI-Host enforcement because TLS client auth is configured. To robi dokładnie to, co trzeba: żądanie musi prosić o tę samą nazwę hosta w handshake’u co w żądaniu HTTP, więc nikt nie przejdzie kontroli certyfikatu dla jednej strony, by potem poprosić o inną.

Strona Home Assistant

Te same ustawienia co w wersji z Cloudflare, wycelowane w inne proxy. W Ustawienia → System → Sieć → Serwer HTTP4:

UstawienieWartośćDlaczego
Ufaj X-Forwarded-Forwłączonebez tego Home Assistant odrzuca żądania przez proxy
Zaufane proxytylko adres proxy, IPv4 i IPv6, na przykład 192.0.2.20 i 2001:db8::20tylko ta maszyna może twierdzić, że przekazuje ruch za kogoś
Włącz blokowanie IPwłączoneblokady trafiają w prawdziwy adres klienta, który przekazuje proxy
Adres URL Home Assistant, Internethttps://ha.example.comaplikacja bierze go jako swój adres zewnętrzny

Wpisz adres IPv6 proxy, a nie tylko IPv4. Test pokazuje, że nginx po IPv6 przekazuje ::1 jako adres klienta, a w praktyce przekazuje to, z czego przyszedł telefon. Jeśli Home Assistant ufa tylko adresowi IPv4 proxy, każde żądanie, które dociera do niego od proxy po IPv6, zostaje odrzucone.

Telefon

Ze step-ca telefon potrzebuje trzech plików. Wszystko to opisuje artykuł o certyfikatach klienta ze step-ca, a uruchomienie samego CA Twój własny urząd certyfikacji.

PlikZainstaluj jako
Certyfikat głównycertyfikat CA
Certyfikat pośrednicertyfikat CA
Plik PKCS12 telefonucertyfikat użytkownika VPN i aplikacji5

Certyfikat serwera na proxy też pochodzi ze step-ca. Aplikacja Home Assistant na Androida ufa certyfikatom CA instalowanym przez użytkownika6, więc go przyjmuje, i to jest drugi zamek, a nie utrapienie. Urządzenie, które nie ma twojego certyfikatu głównego, nie ufa serwerowi, zanim w ogóle pojawi się pytanie o jego własny certyfikat.

Potem ustaw poziom bezpieczeństwa połączenia w aplikacji na Most secure, tak samo jak w wersji z Cloudflare7.

Gdzie to zawodzi

PrzypadekCo się dziejeCo zrobić
CRL wygasanginx odrzuca każdy telefonodświeżaj ją timerem, jak w artykule o step-ca
CRL głównego CA wygasato samo, rok późniejdata w kalendarzu
Caddy, telefon unieważnionywchodzi, chyba że zniknął z listy dozwolonychprowadź listę albo użyj nginx
Caddy, telefon z nowym certyfikatemzablokowany, dopóki lista nie zostanie zaktualizowanaaktualizuj listę przy każdym certyfikacie
Domowe łącze za carrier-grade NAT, bez IPv6nic nie dosięgnie przekierowania portuIPv6 albo wersja z Cloudflare
Zalew ruchu wycelowany w domowe łączeodcina cały dom, a nie tylko Home Assistantwersja z Cloudflare, jeśli to martwi cię bardziej niż ktoś trzeci
iPhone, Wear OStak samo jak w wersji z Cloudflare: udokumentowana aplikacja to Android, Wear OS chce PKCS12 przy konfiguracji5przetestuj, zanim zaczniesz na tym polegać

Nic z tego nie jest ukryte. Każde to robota. Zapisz ją z datą albo poleceniem obok, a zostanie robotą, a nie niespodzianką.

Cała rzecz na własność

Wersja z Cloudflare i ta trzymają z dala tego samego obcego. Różnica polega na tym, komu musisz przy tym ufać.

Z Cloudflare ufasz firmie, że utrzyma bramę, odszyfruje ruch i dalej będzie to dawać za darmo. Tutaj ufasz sobie, że odświeżysz CRL, utrzymasz listę w porządku i zauważysz, kiedy nadejdzie jakaś data. Żadne nie obywa się bez zaufania. Jedno rozkłada je na kogoś, komu nic nie płacisz i do kogo nie możesz zadzwonić. Drugie trzyma je w domu, gdzie widzisz, jak się psuje, i możesz to naprawić.

Jeśli chodzi o frontowe drzwi domu, wiem, co wolę. Robota to kilka plików i timer. Jedyne, o co to naprawdę prosi, to żebyś o to dbał, i to właśnie zawsze znaczyło mieć coś na własność.


  1. Cloudflare — DDoS Protection — automatyczne wykrywanie i łagodzenie DDoS, „Available on all plans”. ↩︎

  2. Caddy — tls directive, client_auth — require_and_verify „Require clients to present a valid certificate that is verified”; „The one verifier, currently, shipped in standard Caddy is leaf”, który sprawdza, czy certyfikat „is one of a defined set of permitted certificates”. ↩︎ ↩︎

  3. nginx — ngx_http_ssl_module — ssl_verify_depth domyślnie 1; ssl_crl: „When using intermediate certificates, their CRLs should be specified in the same file.” ↩︎

  4. Home Assistant — HTTP integration — reverse proxy, zaufane proxy i blokowanie IP; ustawienia w interfejsie od 2026.8. ↩︎

  5. Home Assistant Companion — Getting Started, TLS client authentication — instalacja jako „VPN & app user certificate”; Wear OS wymaga podania certyfikatu jako PKCS12 przy wdrażaniu. ↩︎ ↩︎

  6. home-assistant/android — network_security_config.xml — kotwice zaufania to system plus user: „Additionally trust user added CAs”. ↩︎

  7. Home Assistant Companion — Connection security level — Most secure używa nieszyfrowanego adresu URL tylko w sieci domowej. ↩︎