본문으로 건너뛰기
Documentation

세션 감사

마지막 게시: 2026-07-21 19:00

세션 감사

세션 감사에서는 원격 연결이 요청된 시점부터 허용, 연결, 실패와 종료까지의 상태를 추적하고 같은 시간대의 감사 이벤트를 확인합니다. 사용자 문의, 접속 거부와 비정상 종료 원인을 조사할 때 사용합니다.

개요

세션 메뉴에는 연결 단위의 상태가 표시되고, 감사 로그 메뉴에는 클라이언트와 서버가 기록한 개별 이벤트가 표시됩니다. 두 화면의 장치 ID, 사용자, 연결 ID와 시각을 비교하면 하나의 접속 흐름을 재구성할 수 있습니다.

세션 상태

상태 의미
requested 연결 요청이 접수됨
allowed 권한 또는 상대방 승인으로 연결 허용
connected 원격 채널이 연결됨
failed 인증, 권한, 네트워크 등의 이유로 실패
ended 연결이 정상 또는 사용자 요청으로 종료

상태가 requested에 오래 머물면 상대방 승인 대기, Grant 처리와 서버 통신을 확인합니다. allowed 이후 연결되지 않으면 Relay와 네트워크 경로를 확인합니다.

세션 검색

사용자, 장치, 상태와 실패 사유로 세션을 필터링할 수 있습니다. 처음에는 문의가 발생한 시간대와 장치 ID를 기준으로 좁히고, 결과가 없으면 상태와 사유 필터를 해제합니다.

세션 목록에서는 다음 정보를 함께 확인합니다.

  • 연결 ID
  • source 장치와 target 장치
  • tenant와 사용자
  • 현재 상태, 결과와 실패 사유
  • 요청·허용·연결·종료 시각
  • 클라이언트와 서버가 남긴 추가 정보

실패 원인 확인

실패 유형 우선 확인할 항목
permission denied 사용자 직접 권한과 접근 역할
device inactive 주소록 장치의 활성 상태
authentication failure 로그인 세션, tenant와 토큰 만료
timeout 또는 offline 장치 Heartbeat와 네트워크 이력
relay/network error API 상태, Relay 상태와 방화벽

실패 사유 문자열만으로 결론 내리지 말고 같은 연결 ID의 감사 이벤트와 장치 상태를 함께 확인합니다.

감사 이벤트 검색

감사 로그는 eventType, deviceId와 사용자로 검색할 수 있습니다. 각 이벤트에는 서버 기록 시각, 장치와 대상 장치, 연결 ID, 결과, 사유와 추가 메타데이터가 포함될 수 있습니다. 메타데이터는 view를 열어 확인합니다.

이벤트는 한 번의 세션에서 여러 건이 발생할 수 있습니다. 이벤트 수를 실제 사용자 작업 수와 동일하게 계산하지 않습니다.

조사 절차

  1. 사용자에게 발생 시각, 원격 ID와 수행한 작업을 확인합니다.
  2. 세션 화면에서 사용자 또는 장치로 검색합니다.
  3. 연결 ID와 상태 변화 시각을 기록합니다.
  4. 감사 로그에서 같은 연결 ID와 시간대의 이벤트를 확인합니다.
  5. 권한 문제는 기업 접근 정책, 오프라인 문제는 장치 상세와 Heartbeat를 확인합니다.
  6. 조치 후 테스트 연결을 실행하고 새 세션이 connectedended로 기록되는지 확인합니다.

로그인 세션과의 구분

클라이언트 로그인 세션은 사용자가 WaveDesk 기업 계정으로 인증한 상태이고, 접속 세션은 실제 원격 장치 연결입니다. 로그인에 성공해도 해당 장치에 대한 접근 역할이 없으면 접속 Grant는 거부될 수 있습니다.

감사 정보 취급

세션과 감사 로그에는 사용자, 장치, IP와 업무 시간이 포함될 수 있습니다. 필요한 관리자만 조회하고 외부 전달 시 IP, 토큰과 메타데이터의 민감정보를 가립니다. 운영 조사에 필요한 보존 기간 동안 기록을 유지합니다.

기록이 없을 때

  • 필터와 조회 시간 범위를 해제해 다시 확인합니다.
  • 마지막 수집 시각과 DB 연결 상태를 확인합니다.
  • 장치가 이벤트 API에 접근할 Agent Key를 갖고 있는지 확인합니다.
  • 클라이언트와 서버 시각 차이가 큰지 확인합니다.
  • 같은 장치의 다른 ID 또는 재설치 후 새 장치 ID가 사용됐는지 확인합니다.

수정 이력

이 문서의 변경 내역을 시간순으로 볼 수 있습니다.

표시할 수정 이력이 없습니다.

An unhandled error has occurred. Reload 🗙

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.