로그인과 화면 구성
로그인
로그인 화면에서 이메일 / 비밀번호를 입력하고 로그인을 누릅니다. OAuth2/SSO가 구성된 인스턴스라면 하단의 SSO로 로그인 버튼을 사용할 수 있습니다.
계정에 2단계 인증(TOTP)이 설정되어 있으면 2단계 인증 화면으로 전환됩니다. Google Authenticator 등 인증 앱에 표시된 6자리 OTP 코드를 입력하고 인증을 누르면 로그인이 완료됩니다. 2FA 등록 방법은 계정 설정을 참고하세요.
비밀번호를 잊었을 때
로그인 화면의 비밀번호를 잊으셨나요? 를 누르고 가입한 이메일을 입력하면 재설정 링크가 발송됩니다. 관리자에게 요청하지 않아도 본인이 직접 재설정할 수 있습니다.
재설정 링크에는 유효 기간이 있습니다. 만료되면 같은 방법으로 다시 요청하세요.
계정이 있든 없든 같은 안내가 표시됩니다. 어떤 이메일이 가입되어 있는지 외부에서 알아낼 수 없게 하기 위한 동작이라, 메일이 오지 않는다고 해서 계정이 없다는 뜻은 아닙니다 — 입력한 주소를 다시 확인해보세요.
짧은 시간에 여러 번 요청하면 일시적으로 차단됩니다. 셀프호스팅 인스턴스에서는 관리자가 이 기능을 꺼둘 수도 있으며, 그 경우 관리자에게 재설정을 요청해야 합니다.
계정 활성화 (처음 초대받은 경우)
관리자가 계정을 발급하면 활성화 링크(/auth/activate?token=...)를 전달받습니다. 링크를 열어
비밀번호(8자 이상)를 설정하고 활성화 및 로그인을 누르면 즉시 로그인됩니다.
화면 구성
로그인하면 좌측 사이드바 + 상단 헤더 + 본문으로 구성된 콘솔이 열립니다.
사이드바
역할별로 운영 / 관리 / 시스템 / 계정 섹션의 메뉴가 노출됩니다(전체 메뉴 지도는 매뉴얼 개요 참조). 사이드바는 접기/펼치기가 가능하며, 하단에 로그인한 사용자와 플랫폼 버전이 표시됩니다.
헤더
- 글로벌 검색 — "장치, 자산, 대시보드 검색..." 입력창에 이름을 입력하면 장치/자산/대시보드를 통합 검색하고, 결과를 클릭하면 해당 상세 화면으로 이동합니다.
- 언어 전환 — KO ↔ EN 토글 (브라우저에 저장).
- 테마 토글 — 다크/라이트 모드 전환.
- 알림 벨 — 읽지 않은 알림 수를 배지로 표시합니다. 클릭하면 최근 알림 10건이 열리고, 모두 읽음 처리 또는 전체 보기로 알림 센터에 진입할 수 있습니다. 알림은 WebSocket으로 실시간 수신됩니다.
- 사용자 아바타 — 계정 메뉴.
홈 화면
인덱스(/)는 역할별 오버뷰를 렌더합니다.
테넌트 홈 (테넌트 관리자)
- 장치 카드 (활성/비활성/전체), 알람 카드 (Critical/미확인/활성)
- 활동 — 최근 30일 텔레메트리 수신량 차트
- 시작하기 체크리스트 — 장치 추가 → 대시보드 생성 → 고객 생성 & 공유 → 알람 확인
- 대시보드 카드 — 최근/즐겨찾기 탭. 별(★) 아이콘으로 즐겨찾기, 핀(📌) 아이콘으로 홈 대시보드 지정이 가능합니다.
- 대시보드 템플릿 캐러셀, 빠른 링크, 관리 바로가기, 사용량(엔티티 수/한도)
홈 대시보드 지정: 대시보드 카드의 핀 아이콘을 클릭하면 이후 홈(/) 진입 시 오버뷰 대신 그
대시보드가 바로 렌더됩니다. 상단의 오버뷰 버튼으로 오버뷰를 다시 볼 수 있고, 핀 해제 아이콘으로
지정을 해제합니다. (지정은 브라우저별로 저장됩니다.)
시스템 홈 (시스템 관리자)
테넌트/테넌트 프로파일 수, 플랫폼 엔티티 수, 최근 30일 전역 텔레메트리 차트, 구성된 기능 (이메일/Slack/화이트라벨/OAuth2/2FA), 서버 리소스(CPU/메모리/디스크 사용률), 버전 정보를 보여줍니다.
고객 홈 (고객 사용자)
고객 사용자도 자기 범위에 맞춘 오버뷰를 봅니다 — 장치 현황(활성/비활성), 알람 현황, 할당된 대시보드·장치·자산 수. 모두 자신의 고객사에 할당된 리소스만 집계되므로, 같은 화면이라도 사용자마다 보이는 범위가 다릅니다.
운영 메뉴(대시보드/장치/자산/알람 등)에서도 동일하게 할당된 리소스만 조회됩니다. 관리자가 아직 아무것도 할당하지 않았다면 목록이 비어 보이는데, 이는 데이터가 없는 것이 아니라 할당이 안 된 상태입니다.