Passwort · API-Key ändern

Die Anmeldedaten des Edge sind im Auslieferungszustand auf allen Boxen identisch. Sie werden bei der Inbetriebnahme einmal geändert und dann nicht mehr angefasst.

Edge funktioniert anders als die anderen Produkte

Platform · AI · Studio werden über ein Rotationswerkzeug namens bin/passwd.sh geändert. Der Edge hat dieses Werkzeug nicht. Beim Edge sind die Anmeldedaten ausschließlich Konfigurationsschlüssel aus app.properties, also werden sie wie andere Einstellungswerte über die Oberfläche geändert und anschließend neu gestartet.

Wo befinden sich die Standardwerte?

Nach der Installation wird einmalig eine Datei mit den werksseitigen Zugangsdaten erzeugt.

sudo cat /etc/kopens/credentials.txt

Position	Wert
Berechtigung	`0600`, `root:root` — nur root kann lesen
Erzeugungszeitpunkt	`install.sh` beim ersten Start, einmalig
Inhalt	UI-Login · REST-API-Key · MQTT · OPC UA · TSE · Keystore-Passwort

Verschieben Sie diese Datei nach der Inbetriebnahme

Diese Datei wurde erstellt, um sie einmalig auszugeben und zusammen mit der versiegelten Box zu versenden. Sie ist nicht dafür gedacht, dauerhaft auf der Box zu liegen. Nachdem alle Anmeldedaten geändert wurden, verschieben Sie sie in einen Betriebs-Tresor (Vault) und löschen Sie sie von der Box.

Diese Datei übernimmt keine geänderten Werte. Sie enthält die ursprünglichen Standardwerte zum Installationszeitpunkt. Wenn Sie sich nach einer Passwortänderung auf diese Datei verlassen, sehen Sie die alten Werte.

Was wird geändert?

Schlüssel	Was	Standardwert
`edge.admin_password`	UI-Login-Passwort (`admin`)	`admin123!`
`edge.rest.api.key`	REST-API-Authentifizierungsschlüssel (`X-API-Key` / `Bearer`)	Fester Standardwert
`mqtt.server.password`	Eingebauter HiveMQ-Broker (Sparkplug-Übertragung)	`edge123!`
`opc.ua.server.password`	OPC-UA-Server (nach Norden)	`edge123!`
`server.api_key`	Plattform-Anbindungs-Token	Bei Installation injiziert
`ai.api.key`	KI-Funktionsschlüssel	Leer
`tse.server.password`	Eingebaute Zeitreihen-Engine (TSE)	`tse123!`

Die ersten sechs werden in der Konfigurationsoberfläche angezeigt. tse.server.password ist dort nicht sichtbar und wird in der Konfigurationsdatei geändert.

Der Benutzername wird nicht geändert — edge.admin_user · mqtt.server.user etc. bleiben unverändert und es wird nur das Passwort geändert; das ist der Standardbetrieb.

Methode ① Über die Oberfläche (wenn ein oder zwei Werte geändert werden)

https://<gateway-ip>/ui/main anmelden
Oben rechts das Zahnrad-Symbol(fa-cog) → Umgebungskonfiguration (/ui/system/config)
Im entsprechenden Tab den Schlüssel suchen und den neuen Wert eingeben — alle Schlüssel aus der Tabelle oben werden als Passwort-Eingabefeld gerendert (bei edge.admin_password gibt es nicht einmal ein Augen-Symbol, der Wert ist also nicht sichtbar)
Oben rechts Speichern(fa-save)
Neustart — Speichern allein wirkt nicht

Speichern und Anwenden sind nicht dasselbe

Speichern schreibt lediglich die app.properties-Datei. Der laufende Prozess verwendet die Werte vom Startzeitpunkt, daher ist ein Neustart erforderlich, damit die neuen Werte aktiv werden. Der Neustart über die Oberfläche beendet den Container nicht, sondern startet nur Tomcat neu (30–90 Sekunden).

Weitere Details finden Sie unter Neustart.

Methode ② Per Befehl (Inbetriebnahme — mehrere Werte auf einmal)

bin/config.sh ändert die Schlüssel. Da mehrere Werte auf einmal geändert werden können und nur am Ende ein einziger Neustart nötig ist, ist diese Methode bei der Inbetriebnahme schneller.

cd /opt/kopens/install/bin

./config.sh --get edge.admin_password            # 현재 값 확인
./config.sh --set edge.admin_password '<new-password>'
./config.sh --set edge.rest.api.key    '<new-key>'
./config.sh --set mqtt.server.password '<new-password>'
./config.sh --diff                               # 직전 백업과 비교
./config.sh --restart                            # 마지막에 한 번만

Wenn es ohne Argumente ausgeführt wird, öffnet es die Datei in einem Editor und fragt nach dem Speichern, ob neu gestartet werden soll.

Bei jeder Änderung wird automatisch ein app.properties.bak.YYYYMMDD_HHMMSS-Backup erstellt.

Nur ab 2026.08-20260825 verwenden

Bei früheren Versionen verliert config.sh --set die Werte stillschweigend. Statt der echten Zieldatei wurde ein Kompatibilitäts- Symlink auf sed -i gesetzt, sodass die Änderung die Anwendung nicht erreichte und beim nächsten Neustart überschrieben wurde. Genau hierher stammt das Symptom „Änderung wird angezeigt, greift aber nicht".

Überprüfen Sie das Image-Tag, das auf der Box läuft — IMAGE_TAG ist die richtige Version.

grep '^IMAGE_TAG=' /etc/kopens/version.env

Bei älteren Versionen verwenden Sie Methode ③ (direkte Bearbeitung) oder ändern Sie die Werte über die Oberfläche.

Methode ③ Datei direkt bearbeiten

Die maßgebliche Konfigurationsdatei ist genau eine echte Datei.

sudo vi /etc/kopens/conf/app.properties
sudo systemctl restart plantpulse-edge.service

Bearbeiten Sie unbedingt die echte Datei innerhalb von conf/

Pfad	Identität
`/etc/kopens/conf/app.properties`	Maßgebliche echte Datei — die Anwendung liest sie direkt über `-Dpe.conf.dir`
`/etc/kopens/app.properties`	Symlink — ein Komfortname, der auf die obige Datei zeigt

Wenn Sie den Symlink im Editor öffnen, wird die echte Datei geändert, daher können Sie für vi beide verwenden. Aber selbst erstellte sed -i-Skripte löschen den Symlink und erzeugen an seiner Stelle eine neue reguläre Datei. Dadurch bleiben die Änderungen in /etc/kopens/app.properties, während die von der Anwendung gelesene conf/app.properties unverändert bleibt — also gespeichert, aber nichts geändert. (Mit sed -i --follow-symlinks lässt sich das verhindern.)

Prüfen Sie nach der Änderung, ob der Wert in der echten Datei angekommen ist.

grep '^edge.admin_password' /etc/kopens/conf/app.properties

Überprüfung

# 실파일에 새 값이 들어갔는지
sudo grep -E '^(edge.admin_password|edge.rest.api.key|mqtt.server.password)' \
     /etc/kopens/conf/app.properties

# UI 로그인 — 새 비밀번호로 접속되는지
# REST API — 새 키로 통과하는지 (키가 «필요한» 경로로 확인한다)
curl -k -H "X-API-Key: <new-key>"  https://<gateway-ip>/api/v1/opc   # 200
curl -k -H "X-API-Key: 틀린키"  https://<gateway-ip>/api/v1/opc   # 401

Mit /api/v1/system/* lässt sich der Schlüssel nicht überprüfen

/api/v1/system/health · /ready · /version und /api/health sind Pfade, die ohne Authentifizierung offen sind (REST API). Wenn Sie einen beliebigen Wert als Schlüssel eingeben, erhalten Sie trotzdem 200, daher ist damit nicht bestätigt, dass „der Schlüssel geändert wurde". Erst wenn wie oben mit einem falschen Schlüssel 401 zurückkommt, ist die Prüfung erfolgreich.

Sidecar enthält die Standardwerte

In /etc/kopens/env.sh.generated(0600) sind die bei der Installation festgelegten Werte in der Form export ADMIN_PASS=... hinterlegt. Wenn eine Neuinstallation oder ein Upgrade app.properties neu erstellt, werden zunächst die vorhandenen Werte aus app.properties gelesen und bewahrt, sodass geänderte Werte aus Oberfläche oder Datei nicht durch ein Upgrade zurückgesetzt werden.

Der Sidecar selbst wird jedoch nicht aktualisiert; betrachten Sie die Werte in dieser Datei daher ebenfalls als Standardwerte.

Wo befinden sich die Standardwerte?​

Was wird geändert?​

Methode ① Über die Oberfläche (wenn ein oder zwei Werte geändert werden)​

Methode ② Per Befehl (Inbetriebnahme — mehrere Werte auf einmal)​

Methode ③ Datei direkt bearbeiten​

Überprüfung​

Verwandte Dokumente​