Erste Anlage verbinden
Kunde anlegen, Zugangsdaten prüfen und die erste STARFACE-Anlage synchronisieren.
Eine Anlage muss in STARcontrol immer einem Kunden zugeordnet sein. Lege deshalb zuerst einen Kunden an oder erstelle ihn direkt im Anlagen-Assistenten.
Vorher bereitlegen
- Die vollständige Host-URL inklusive
https://und gegebenenfalls Port, ohne abschließenden Schrägstrich. - Eine Firewall-Freigabe, über die STARcontrol die Anlage per HTTPS erreicht (siehe unten).
- Die Login-ID und das Passwort eines geeigneten STARFACE-Benutzers.
- Den Module-Key des Management-Moduls. Er wird für Synchronisierung und Updates benötigt.
- Für erweiterte STARFACE-10-Funktionen optional das Client Secret von
rest-client-headless.
Produktivsysteme bewusst anbinden
STARcontrol liest nicht nur Zustände. Abhängig von deinen Berechtigungen können über die Anlagenansicht auch Änderungen ausgelöst werden. Prüfe Zugang und Zuordnung vor dem Speichern.
Firewall-Freigabe
STARcontrol baut die Verbindung zur Anlage selbst auf. Die Firewall vor der Anlage muss deshalb eingehendes HTTPS von STARcontrol erlauben:
| Richtung | Quelle | Ziel | Protokoll |
|---|---|---|---|
| Eingehend zur Anlage | 144.76.124.85 (starcontrol.app) | STARFACE-Anlage, HTTPS-Port nach Wahl | TCP / HTTPS |
Den Port legt der Kunde selbst fest. Ein anderer Port als 443 wird einfach in der Host-URL mitgegeben, zum Beispiel https://starface.test.de:56443. Die Freigabe muss dann genau diesen Port auf die HTTPS-Oberfläche der Anlage weiterleiten.
Nur STARcontrol freigeben
Beschränke die Regel auf die Quell-IP 144.76.124.85. Unterstützt deine Firewall Hostnamen als
Quelle, kannst du alternativ starcontrol.app verwenden. Eine weltweite Öffnung des Ports ist für
STARcontrol nicht nötig.
Anlage anlegen
- Öffne Anlagen und wähle Neue Anlage.
- Ordne die Anlage einem Kunden zu. Vergib einen eindeutigen Anzeigenamen und wähle Typ sowie Update-Level.
- Trage Host-URL, Login-ID, Passwort und Module-Key ein.
- Aktiviere den STARFACE-10-REST-Zugriff nur, wenn das Client Secret vorhanden ist.
- Prüfe die Zusammenfassung und führe den Verbindungstest aus.
- Speichere die Anlage.
Nach dem Speichern
STARcontrol nimmt die Anlage in die Überwachung auf. Der Verfügbarkeitsstatus erscheint zuerst, umfangreichere Bestandsdaten folgen mit der nächsten Synchronisierung. Unter Anlagen erkennst du am Zeitstempel, wie aktuell die Daten sind.
Wenn der Verbindungstest fehlschlägt
Prüfe in dieser Reihenfolge:
- Ist die Host-URL vollständig und ohne abschließenden Schrägstrich eingetragen?
- Sind Login-ID, Passwort und Module-Key für dieselbe Anlage gültig?
- Ist die Anlage von der STARcontrol-Umgebung aus erreichbar? Die Firewall muss HTTPS von
144.76.124.85auf den Port aus der Host-URL durchlassen. - Bei aktiviertem REST-Zugriff: Gehört das Client Secret zu
rest-client-headless?
Du kannst eine Anlage trotz fehlgeschlagenem Test speichern und die Verbindung später korrigieren. Für einen sauberen Start sollte der Test jedoch erfolgreich sein.