パスワード・API キー変更

Edge の認証情報は初期値がすべてのボックスで同じです。コミッショニング時に一度だけ変更して終わりです。

Edge は他製品と方式が異なります

Platform · AI · Studio は bin/passwd.sh という回転ツールで変更します。Edge にはそのツールがありません。 Edge は認証情報がすべて app.properties の設定キーなので、他の設定値と同じように画面から修正して再起動します。

初期値はどこにあるか

インストール完了後、出荷用サマリーファイルが一度だけ生成されます。

sudo cat /etc/kopens/credentials.txt

項目	値
権限	`0600` · `root:root` — root だけが読みます
生成時点	`install.sh` 初回実行時に 1 回
内容	UI ログイン · REST API キー · MQTT · OPC UA · TSE · keystore パスワード

コミッショニング完了後はこのファイルを移動してください

出荷前に一度だけ印刷して密閉ボックスと共に送るために作成されたファイルです。ボックスに置き続けるファイルではありません。 認証情報をすべて変更した後は、運用ボールト(vault)に移動してボックスから削除してください。

このファイルは変更した値に追従しません。 インストール時点の初期値がそのまま残っているため、パスワードを変更した後でこのファイルを信頼すると古い値が見えます。

何を変更するか

キー	内容	初期値
`edge.admin_password`	UI ログインパスワード (`admin`)	`admin123!`
`edge.rest.api.key`	REST API 認証キー (`X-API-Key` / `Bearer`)	固定デフォルト値
`mqtt.server.password`	組み込み HiveMQ ブローカー (Sparkplug 送信)	`edge123!`
`opc.ua.server.password`	OPC UA サーバー (北向き)	`edge123!`
`server.api_key`	プラットフォーム連携トークン	インストール時に注入
`ai.api.key`	AI 機能キー	空白
`tse.server.password`	組み込み時系列エンジン(TSE)	`tse123!`

最初の 6 つは環境設定画面に表示されます。 tse.server.password は画面に表示されないため、設定ファイルから修正します。

ユーザー ID は変更しません — edge.admin_user · mqtt.server.user などはそのままにして、パスワードだけを変更するのが基本的な運用です。

方法 ① 画面から (1～2 個を変更する場合)

https://<gateway-ip>/ui/main でログイン
右上の歯車アイコン(fa-cog) → 環境設定 (/ui/system/config)
該当するタブでキーを探し、新しい値を入力します — 上表のキーはすべてパスワード入力欄としてレンダリングされます(edge.admin_password はアイコンも表示されないため値が画面に露出しません)
右上の保存(fa-save)
再起動 — 保存だけでは適用されません

保存と適用は異なります

保存は app.properties ファイルを書き込むところまでです。実行中のプロセスは起動時の値を保持しているため、再起動して初めて新しい値が反映されます。 画面からの再起動はコンテナを停止せず Tomcat だけを再起動します(30～90 秒)。

詳細は再起動を参照してください。

方法 ② コマンドで (コミッショニング — 複数を一度に)

bin/config.sh がキーを変更します。複数を一度に変更でき、最後に一度だけ再起動すればよいため、コミッショニング時にはこちらが高速です。

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                            # 마지막에 한 번만

引数なしで実行すると、エディターでファイルを開き、保存後に再起動の有無を問い合わせます。

変更するたびに app.properties.bak.YYYYMMDD_HHMMSS バックアップが自動的に残ります。

2026.08-20260825 以上でのみ使用してください

それより前のバージョンの config.sh --set は値を暗黙のうちに失います。 本体実ファイルの代わりに互換性シンボリックリンクを sed -i に修正したため、修正がアプリに到達せず、次の再起動時に上書きされました。「変更されたように見えるが反映されない」という症状はここから発生しました。

ボックスが実行しているイメージタグを確認してください — IMAGE_TAG が本体です。

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

低いバージョンの場合は、以下の ③ 方法(直接編集)を使用するか、画面から変更してください。

方法 ③ ファイルを直接編集

設定ファイルの本体は実ファイル 1 つです。

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

必ず conf/ 内の実ファイルを修正してください

パス	正体
`/etc/kopens/conf/app.properties`	本体実ファイル — アプリが `-Dpe.conf.dir` として直接読み込みます
`/etc/kopens/app.properties`	シンボリックリンク — 上記ファイルを指す便宜上の名前です

エディターでシンボリックリンクを開くと実ファイルが修正されるため、vi はどちらを使用しても構いません。ただし、独自の sed -i スクリプトはシンボリックリンクを削除し、その場に新しい通常ファイルを作成します。 その場合、修正内容は /etc/kopens/app.properties に残り、アプリが読む conf/app.properties は古い値のままになるため、保存はされたが何も変わらない状態になります。 (sed -i --follow-symlinks を使用すれば防ぐことができます。)

修正後は、実ファイルに反映されているか確認してください。

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

確認

# 실파일에 새 값이 들어갔는지
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/system/status

サイドカーは初期値を保持しています

/etc/kopens/env.sh.generated (0600)には、インストール時に決定された値が export ADMIN_PASS=... 形式で残っています。再インストール・アップグレード時に app.properties を再生成する場合は、既存の app.properties の値をあらかじめ読み込んで保存するため、画面・ファイルから変更した値がアップグレードで戻されることはありません。

ただしサイドカー自体は更新されないため、そのファイルの値も初期値として扱ってください。

初期値はどこにあるか​

何を変更するか​

方法 ① 画面から (1～2 個を変更する場合)​

方法 ② コマンドで (コミッショニング — 複数を一度に)​

方法 ③ ファイルを直接編集​

確認​

関連ドキュメント​

初期値はどこにあるか

何を変更するか

方法 ① 画面から (1～2 個を変更する場合)

方法 ② コマンドで (コミッショニング — 複数を一度に)

方法 ③ ファイルを直接編集

確認

関連ドキュメント