Beschikbaar voor Windows-, macOS- en Linux-systemen (inclusief Raspberry Pi), de open-source Home Assistant software fungeert als een centrale hub voor het bedienen van al uw slimme apparaten voor al uw behoeften op het gebied van domotica.
Als je op afstand toegang wilt krijgen tot je Home Assistant-server, of je nu DDNS of Cloudflare Tunnel gebruikt, moet je de bron versleutelen met een SSL/TLS-certificaat. Gelukkig kun je de gratis Lets Encrypt add-on gebruiken om het SSL/TLS-certificaat op Home Assistant te genereren en configureren en aan je server toe te voegen.
Methoden om SSL/TLS-certificaat op Home Assistant te installeren
Let's Encrypt is een populaire manier om gratis SSL/TLS instellen op websites. We kunnen Let's Encrypt ook gebruiken om onze Home Assistant-server te beveiligen door een van de volgende methoden te volgen:
- HTTP-uitdaging: Bij deze methode gebruik je de gratis DDNS-service en stel je port forwarding (poort 80) in op je router.
- DNS-uitdaging: Bij deze methode registreer je een gratis of betaald domein en gebruik je een veilige Cloudflare Tunnel. U hoeft geen poorten op uw router te openen en is dus veiliger.
Bovendien is de HTTP-uitdagingsmethode veel langer en complexer. De DNS-uitdagingsmethode met een veilige Cloudflare-tunnel is gemakkelijker te volgen en te implementeren.
Voor deze handleiding zullen we dus Cloudflare en Let's Encrypt gebruiken om onze Home Assistant-instantie te beveiligen en deze op afstand te openen via een HTTPS-verbinding. Als u echter nog steeds met de DDNS-methode wilt werken, volgt u de officiële Home Assistant-gids.
Vereisten om SSL te genereren
Om het SSL-certificaat op Home Assistant in te stellen en te implementeren met behulp van de DNS-uitdagingsmethode voor beveiligde toegang, hebt u het volgende nodig:
- Een Cloudflare-account.
- Een geregistreerde domeinnaam. U kunt een gratis domein krijgen van Freenom.com of registreer een nieuw domein bij een serviceprovider, zoals GoDaddy.
Nadat u het domein heeft geregistreerd, voegt u het toe aan uw Cloudflare-account en schakelt u de HTTPS optie onder SSL/TLS instellingen in Cloudflare.
Kies voor nu Flexibel. Zodra u het SSL-certificaat op onze Home Assistant-server hebt geïmplementeerd met Let's Encrypt, kunt u de Vol optie voor end-to-end encryptie.
Nadat u de HTTPS-optie hebt ingeschakeld, gaat u verder met het volgen van de volgende stappen om Let's Encrypt te installeren en het SSL-certificaat op de server te implementeren.
Cloudflare-tunnel implementeren
Door Cloudflare Tunnel in te zetten, heb je op afstand toegang tot de Home Assistant-server via HTTPS. Dit helpt ook bij het voltooien van de DNS-uitdaging voor het installeren van de SSL-certificaten op onze Home Assistant-server. De stappen zijn als volgt:
- Bezoek de Cloudflared add-on link en klik Open link.
- Klik Toevoegen om de Cloudflared-repository toe te voegen aan uw Home Assistant-server.
- Zoek nu en klik op de Cloudflared toevoegen.
- Klik Installeren. Wacht tot de installatie is voltooid.
- Klik na het installeren van de Cloudflared-add-on op de Configuratie tabblad.
- Klik op de drie puntjes rechtsboven en plak de volgende code.
extra_hosts:
-hostnaam: UwDomeinnaam.com
dienst: http://HomeAssistentIPAdres: 8123
externe_hostnaam: UwDomeinnaam.com
tunnel_name: huisassistent
tunnel_token: ""
nginx_proxy_manager: vals
log_level: debuggen
warp_enable: WAAR
warp_routes:
- 192.168.0.2/24 - Klik Opslaan.
- Voeg ook de volgende code toe aan de configuratie.yaml het dossier.
http:
use_x_forwarded_for: WAAR
vertrouwde_proxy's: - 172.30.33.0/24 - Opslaan en start de Home Assistant Server opnieuw.
- Start na de herstart de Cloudflared-add-on en schakel de Begin bij het opstarten optie voor deze add-on.
- Open de Logboek tabblad op de Cloudflared-add-onpagina en kopieer de weergegeven web-URL naar uw webbrowser. Dit opent de Cloudflare-pagina.
- Log in op Cloudflare met uw geregistreerde e-mailaccount en selecteer vervolgens de domeinnaam.
- Klik Toestemming geven.
- Ga terug naar de Logboek van uw Home Assistant Cloudflared-add-on en controleer of de authenticatie is gelukt. Als dat het geval is, wordt er een beveiligde tunnel gemaakt om uw Home Assistant-server via HTTPS op internet te plaatsen. Het is echter nog niet end-to-end versleuteld.
De Cloudflare API-sleutel verkrijgen
Je hebt de Cloudflare API nodig om de DNS-uitdaging te voltooien die vereist is voor het implementeren van het SSL/TLS-certificaat op je Home Assistant-server. De stappen zijn als volgt:
- Log in op uw Cloudflare-account en ga naar de https://dash.cloudflare.com/profile bladzijde.
- Klik API-tokens.
- Klik API-token maken en klik vervolgens op de Sjabloon gebruiken knop naast de Zone-DNS bewerken keuze.
- Kies de Specifieke zone optie en selecteer vervolgens uw domeinnaam uit de vervolgkeuzelijsten onder de Zonebronnen sectie.
- Klik Doorgaan naar samenvatting en klik vervolgens op Token maken.
- Kopieer het gegenereerde API-token en bewaar het op een veilige plek. Deze heb je nodig tijdens de configuratie van Let's Encrypt.
Installeer de Let's Encrypt Add-On
Volg deze stappen op uw Home Assistant-server om de Let's Encrypt-add-on te installeren.
- Ga naar Instellingen > Add-ons.
- Klik op de AANVULLENDE WINKEL knop.
- Zoek naar en klik op letencrypt.
- Klik op de INSTALLEREN knop.
- Start de add-on nog niet.
Configureer Let's Encrypt
Je moet details van ons domein en Cloudflare API toevoegen aan het Let's Encrypt-configuratiebestand om het certificaat op de server te installeren. Volg hiervoor de onderstaande stappen:
- Klik op de Let's Encrypt-configuratiepagina op de Configuratie tabblad.
- Klik op de drie stippen in de rechterbovenhoek en kies Bewerken in YAML.
- In de Opties veld, plak de volgende code. Zorg ervoor dat u vervangt UwDomeinnaam.com met uw domeinnaam. Bewerk ook de e-mail-ID, Cloudflare-e-mail en API-token (je hebt deze in eerdere stappen gegenereerd, dus plak ze hier).
domeinen: -
"*.UwDomeinNaam.com"
e-mail: Uw.E-mail@gmail.com
sleutelbestand: privésleutel.pem
certificaatbestand: volledige keten.pem
uitdaging: dns
dns:
provider: dns-cloudflare
cloudflare_email: Uw.CloudflareE-mail@gmail.com
cloudflare_api_token: YWrT6HXwMn5hHYKor6B - Klik Opslaan.
Genereer het SSL/TLS-certificaat
Zodra de informatie is opgeslagen, gaat u naar de Info tabblad van de Let's Encrypt-add-on op uw Home Assistant-server en klik op Begin.
Hiermee wordt de Let's Encrypt-add-on gestart, die de door u in de configuratie verstrekte informatie zal gebruiken bestand om de DNS-uitdaging te voltooien en het vereiste SSL/TLS-certificaat op uw Home Assistant-server te installeren.
Dit zal enige tijd duren om te voltooien. We raden u ten zeerste aan om op de Logboek tabblad en houd de logs in de gaten (blijf vernieuwen). Als er een fout is, zoals een ongeldige API of inloggegevens, kunt u deze repareren en de Let's Encrypt-add-on opnieuw starten om de installatie van het SSL/TLS-certificaat op uw Home Assistant-server te voltooien.
Als alles goed gaat, worden de certificaten gegenereerd en geïnstalleerd. Het gratis certificaat is drie maanden geldig. Na drie maanden of net voordat de derde maand afloopt, kunt u de Let's Encrypt add-on opnieuw starten om de certificaten te vernieuwen.
In dit stadium kun je inloggen op je Cloudflare-account en inschakelen Volledige modus onder SSL/TLS voor end-to-end encryptie.
Gefeliciteerd! U hebt met succes een SSL/TLS-certificaat gegenereerd en geïnstalleerd op uw Home Assistant-server.
Gratis SSL en toegang op afstand
Met deze gedetailleerde handleiding over het instellen van SSL/TLS-certificaten op de Home Assistant-server, kan iedereen snel de certificaten instellen en installeren en zijn Home Assistant-serverinstantie beveiligen. Met Cloudflare Tunnel is je Home Assistant-instantie ook end-to-end versleuteld. Hierdoor heb je ook overal ter wereld toegang tot je Home Assistant-server en al je apparaten en lokale servers.