Netzwerk- und Firewall-Anforderungen
Konnektivitäts- und Sicherheitsanforderungen des SDA Gateways
Überblick
Das SDA Gateway benötigt ausschließlich ausgehende Internetkonnektivität, um sicher mit den SDA Cloud Services zu kommunizieren.
Alle SDA-Service-Domains verwenden Zertifikate, die von der Zertifizierungsstelle Amazon Root CA 1 signiert sind.
Sie müssen sicherstellen, dass der vertrauenswürdige Zertifikatsspeicher Ihres Systems dieses Root-Zertifikat enthält, damit eine korrekte SSL/TLS-Validierung möglich ist.
Sicherheitsaspekte
- Keine eingehenden Verbindungen
Das Gateway initiiert jede Kommunikation ausgehend. Es sind keine eingehenden Firewall-Regeln oder Port-Weiterleitungen erforderlich. - Nur Port 443
Der gesamte SDA-Datenverkehr nutzt standardmäßiges HTTPS/SSL über TCP 443, was die Firewall-Konfiguration vereinfacht und in der Regel mit den Sicherheitsrichtlinien von Unternehmen vereinbar ist. - DNS-Anforderungen
Die DNS-Auflösung muss für alle SDA-Domains verfügbar sein, um Folgendes zu unterstützen:- Lastverteilung,
- Service Discovery,
- und Failover zwischen SDA Cloud Endpoints.
- Proxy-kompatibel
Mandantenspezifische Domain
SDA Services sind pro Mandant abgegrenzt. Überall, wo {tenant_id} erscheint, ersetzen Sie diesen Platzhalter durch die von SDA Support bereitgestellte Tenant ID.
Beispiel
Tenant ID:
11111111-2222-3333-4444-555555555555
Mandanten-Domain:
11111111-2222-3333-4444-555555555555.eu1.sdaconsole.io
Diese Domain – und der Wildcard darunter – müssen vom Gateway aus erreichbar sein.
Erforderliche Domains und Ports
| Domain | Port | Protokoll | Beschreibung |
iot.eu1.sdaconsole.io | 443 | SSL/TCP (WebSocket Secure) | AWS IoT Broker – hält die dauerhafte, sichere Verbindung für Nachrichtenaustausch, Telemetrie und Steuerung/Kontrolle aufrecht. |
{tenant_id}.eu1.sdaconsole.io*.{tenant_id}.eu1.sdaconsole.io | 443 | HTTPS, SSL/TCP (OpenVPN) | Tenant Connectivity Servers – dienen dem bedarfsgesteuerten Aufbau dynamischer VPN-Tunnel; DNS liefert eine lastverteilte Liste zurück. |
api.eu1.sdaconsole.io | 443 | HTTPS | SDA APIs – Gateway-Authentifizierung, Control-Plane-Vorgänge und Zugriff auf die Web Console. Wird primär während des Onboardings/der Ersteinrichtung genutzt. |
repository.eu1.sdaconsole.io | 443 | HTTPS | Application Repository – lädt SDA-Komponenten, Glue-Updates, Agent-Pakete und Sicherheitspatches herunter. Wird bei der Installation und bei periodischen Update-Prüfungen verwendet. |
repository.sdaconsole.io (optional) | 443 | HTTPS | Global Repository Mirror – alternative Update-Quelle (geplante Erweiterung). |
Traffic Inspection bei SDA Services
Einige Organisationen setzen SSL Inspection / TLS Interception (z. B. Zscaler SSL Inspection, Palo Alto Decryption) für ausgehenden Datenverkehr ein. Diese Werkzeuge können die SDA-Konnektivität unterbrechen, wenn sie SDA-Zertifikate verändern oder neu signieren, da SDA Services Zertifikate verwenden, deren Kette auf Amazon Root CA 1 zurückgeht.
So vermeiden Sie Verbindungsfehler:
- SDA-Domains von der Inspektion ausnehmen (Bypass / No-Inspect)
Fügen Sie die oben genannten SDA-Domains (API, IoT, Mandanten-Domain, Repository) einer Do-not-inspect-Liste hinzu. - MQTT über WebSocket Secure (WSS) zulassen
Das SDA-IoT-Messaging nutzt MQTT über WSS auf Port 443. Stellen Sie sicher, dass dieses Protokoll zugelassen ist. - VPN-Tunnel mit SSL-Overlay
Wird ein Unternehmens-VPN verwendet und der Datenverkehr inspiziert, stellen Sie sicher, dass der Tunnel ein SSL-Overlay unterstützt, damit die Inspektion die Ende-zu-Ende-TLS-Verbindung zu SDA nicht beeinträchtigt.
Falls die Inspektion nicht umgangen werden kann, koordinieren Sie sich mit dem SDA Team hinsichtlich freigegebener Zertifikate und des Inspektionsverhaltens.
Checkliste für Firewall-Whitelisting und Netzwerkvalidierung
Nutzen Sie diese Checkliste zur Übergabe an die IT-/Sicherheitsabteilung des Kunden.
| Kategorie | Punkt | Anforderung / Validierungsschritt | Status (✓/✗) |
| Netzwerkkonnektivität | Ausgehendes Internet | Das Gateway kann ausschließlich ausgehende Sitzungen ins Internet initiieren. | |
| Port 443 | TCP 443 ist ausgehend zu den SDA-Domains geöffnet. | ||
| DNS | DNS löst alle oben aufgeführten SDA-Domains auf. | ||
| Zertifikate & Verschlüsselung | Amazon Root CA 1 | Das Root-CA-Zertifikat ist im vertrauenswürdigen Speicher vorhanden, sodass die TLS-Validierung erfolgreich ist. | |
| TLS-/SSL-Inspektion | Die Egress-Inspektion ersetzt SDA-Zertifikate nicht bzw. SDA-Domains werden ausgenommen. | ||
| Traffic Inspection / VPN | Bypass der SSL-Inspektion | SDA-Domains sind von der SSL/TLS-Interception ausgenommen (Zscaler, Palo Alto usw.). | |
| MQTT über WSS | WSS auf Port 443 ist zugelassen (wird vom IoT Broker genutzt). | ||
| VPN-Overlay | Falls ein VPN verwendet wird, erlaubt es Ende-zu-Ende-TLS zur SDA Cloud. | ||
| Mandantenkonfiguration | Domain {tenant_id} | {tenant_id}.eu1.sdaconsole.io und *.{tenant_id}.eu1.sdaconsole.io sind erreichbar. | |
| Repository-Zugriff | Updates | repository.eu1.sdaconsole.io ist für Updates und Patches erreichbar. |
Validierungsschritte (CLI-freundlich)
-
DNS
nslookup api.eu1.sdaconsole.ionslookup iot.eu1.sdaconsole.ionslookup <your-tenant-id>.eu1.sdaconsole.io -
HTTPS / Port 443
curl -v https://api.eu1.sdaconsole.io -
TLS-Kette
openssl s_client -connect api.eu1.sdaconsole.io:443 -servername api.eu1.sdaconsole.ioPrüfen Sie, dass die Kette bei Amazon Root CA 1 endet.
-
Gateway-Logs
Prüfen Sie die System-/Service-Logs des Gateways auf erfolgreiche MQTT- (WSS) und HTTPS-Sitzungen. -
Update-Test
Lösen Sie eine Repository-Synchronisierung oder ein Agent-Update aus, um den Download-Zugriff zu verifizieren.
Netzwerktopologie-Diagramm
Der Abschnitt Architecture/SDA Connectivity Services beschreibt mehrere Konfigurationen für das SDA Gateway. \
Support
Sollte eine der oben genannten Prüfungen fehlschlagen oder die SSL-Inspektion in Ihrer Umgebung nicht umgangen werden können, wenden Sie sich an:
SDA Support
📧 support@softwaredefinedautomation.io
Geben Sie dabei an:
- Ihre Tenant ID,
- die Gateway-Version,
- eine Kopie der Ausgaben Ihrer Konnektivitätstests (curl / openssl / nslookup),
- sowie relevante Firewall-Logs (blockierter Port 443, fehlgeschlagenes TLS).