본문으로 건너뛰기

초기 비밀번호 변경 (커미셔닝 필수)

설치 직후의 Edge 게이트웨이는 모든 설치본이 똑같은 기본 계정을 갖고 있습니다. 현장에 인계하기 전에 반드시 바꾸세요.

운영 중 정기 교체와 키 회전 전반은 비밀번호 · API 키 변경 에 있습니다. 이 페이지는 설치 직후 한 번 하는 일만 다룹니다.

바꿔야 하는 것​

키무엇기본값
edge.admin_passwordUI 로그인 비밀번호 (아이디는 admin 고정)admin123!
edge.rest.api.keyREST API 호출 키설치본마다 다름
mqtt.server.password상위 플랫폼으로 보내는 MQTT 계정설치본마다 다름

Edge 는 사용자 계정이 admin 하나입니다. 사람마다 계정을 나눠 주는 구조가 아니므로, 이 비밀번호를 아는 사람이 곧 게이트웨이를 만질 수 있는 사람입니다.

바꾸는 법​

bin/config.sh 로 바꿉니다. 여러 개를 한 번에 바꾸고 마지막에 한 번만 재시작하세요.

cd /opt/kopens/plantpulse-edge/bin

./config.sh --get edge.admin_password        # 현재 값 확인
./config.sh --set edge.admin_password '<새비번>'
./config.sh --set edge.rest.api.key    '<새키>'
./config.sh --set mqtt.server.password '<새비번>'

./config.sh --diff                           # 직전 백업과 비교 — 의도한 것만 바뀌었는지
./config.sh --restart                        # 마지막에 한 번만
옛 버전의 config.sh --set 은 값을 조용히 잃습니다

정본 실파일이 아니라 호환용 경로에 쓰는 버전이 있었습니다. 바꿨다고 나오는데 실제로는 반영되지 않습니다. 아래로 반드시 확인하세요 — 자세한 버전 조건은 비밀번호 · API 키 변경 에 있습니다.

인프라 계정과 API 키​

Edge 는 위 세 개 말고도 키를 더 갖고 있습니다. 커미셔닝 때 한 번에 훑으세요 — 같은 config.sh --set 으로 바꾸고 마지막에 한 번만 재시작하면 됩니다.

키무엇초기값
edge.admin_passwordUI 로그인 비밀번호 (admin)admin123!
edge.rest.api.keyREST API 인증 키 (X-API-Key / Bearer)고정 기본값
mqtt.server.password내장 HiveMQ 브로커 (Sparkplug 송신)edge123!
opc.ua.server.passwordOPC UA 서버 (북향)edge123!
tse.server.password내장 시계열 엔진(TSE)tse123!
server.api_key플랫폼 연동 토큰설치 시 주입
ai.api.keyAI 기능 키비움
tse.server.password 는 화면에 없습니다

앞의 여섯은 환경 설정 화면(/ui/system/config)에 나오지만 TSE 비밀번호는 화면에 없어 설정 파일 또는 config.sh 로만 바꿉니다.

server.api_key 와 ai.api.key 는 상대편에서도 함께 바꿔야 합니다 — 플랫폼 쪽 토큰과 AI 게이트웨이 키를 각각 발급받아 맞추세요.

바꾼 뒤 확인​

# 1. 파일에 실제로 들어갔는가
grep '^edge.admin_password' /etc/kopens/conf/app.properties

# 2. 옛 비밀번호로 로그인이 막히는가 — 브라우저에서 직접

admin123! 로 로그인이 되면 안 됩니다. 된다면 재시작이 안 됐거나 값이 반영되지 않은 것입니다.

화면에서 확인할 때

설정 화면(/ui/system/config)에서 edge.admin_password 는 눈 아이콘 없이 마스킹되어 값이 드러나지 않습니다. 현재 값을 보려면 위의 config.sh --get 을 쓰세요.

관련 문서​