계정스냅샷 > 사용자

사용자스냅샷 필드는 계정 내 VPN 사용자와 관련된 데이터를 포함합니다. 계정 내 모든 사용자를 쿼리할 경우(ID 인수가 비어 있는 경우), API 호출은 현재 VPN 및 카토 클라우드에 연결된 사용자에 대한 데이터를 반환합니다.

특정 사용자를 쿼리하기 위해 ID 인수를 사용하는 경우, API 호출은 해당 사용자의 데이터가 VPN에 연결되어 있지 않아도 반환합니다.

사용자스냅샷 필드

사용자스냅샷 필드는 연결된 VPN 사용자와 그들의 카토 클라우드 연결 데이터를 포함합니다. 쿼리에 포함할 VPN 사용자를 지정하려면 ID 인수를 사용하십시오.

사용자스냅샷 필드가 쿼리에 반환할 수 있는 세부 정보는 다음과 같습니다:

• id - VPN 사용자 ID
• connectivityStatus - 카토 클라우드와의 연결 상태(중첩 필드를 가진 배열)
• operationalStatus - 사이트 또는 VPN 사용자의 상태(중첩 필드를 가진 배열)
• name - VPN 사용자의 이름
• deviceName - 컴퓨터 또는 장치의 이름
• uptime - 클라이언트가 카토 클라우드에 연결된 시간(초 단위)
• lastConnected - VPN 사용자가 PoP에 연결된 타임스탬프
• version - 클라이언트 소프트웨어 버전(문자열)
• versionNumber - 클라이언트 소프트웨어 버전(정수)
• popID - 클라이언트가 연결된 PoP의 ID
• popName - VPN 사용자가 연결된 PoP의 이름
• RemoteIP - 클라이언트의 IP 주소
• RemoteIPInfo - 클라이언트와 관련된 IP 주소, ISP 및 지리적 정보
• internalIP - 클라이언트가 연결된 PoP의 IP 주소
• osType - 클라이언트가 실행되고 있는 장치의 운영 체제
• osVersion - 장치 운영 체제의 버전
• devices - 클라이언트와 관련된 데이터(중첩 필드를 가진 배열)
• connectedInOffice - 클라이언트가 Office Mode를 사용하여 VPN에 연결되어 있는지 여부를 표시합니다.
• info - VPN 사용자의 일반 정보(중첩 필드를 가진 배열)
• recentConnections - 가장 최근에 완료된 VPN 연결과 관련된 데이터(중첩 쿼리 및 필드를 가진 배열)

ID

핵심 관리 애플리케이션에서는 계정의 고유한 VPN 사용자 내부 ID를 표시하지 않습니다.

connectivityStatus

사용자 > connectivityStatus 필드는 VPN 사용자의 연결 상태를 보여줍니다:

• 커넥트됨 카토 클라우드에
• 연결이 끊겼습니다 카토 클라우드에서

operationalStatus

사용자 > operationalStatus 필드는 VPN 사용자 상태를 보여줍니다:

• 활성 - 트래픽 통과 중
• 비활성화됨 - Cato 관리 애플리케이션에서 비활성화됨
• 잠김 - 이 VPN 사용자의 계정이 잠김
• 신규 - VPN 사용자와 관련 없음
• 보류 중 사용자 구성 - VPN 사용자가 계정을 확인할 때까지 대기 중
• 보류 중 MFA 구성 - VPN 사용자가 MFA 설정을 구성할 때까지 대기 중
• 보류 중 코드 생성 - VPN 사용자가 등록 코드를 입력할 때까지 대기 중

이름

이름 필드는 Cato 관리 애플리케이션에서 VPN 사용자의 이름을 표시합니다.

DeviceName

deviceName 필드는 Cato 클라우드에 연결된 컴퓨터 또는 장치의 이름을 보여줍니다.

uptime

uptime 필드는 VPN 사용자가 Cato 클라우드에 연결된 총 시간을 초 단위로 표시합니다.

lastConnected

Cato 클라우드에 연결되어 있지 않은 VPN 사용자의 경우, lastConnected 필드는 클라이언트가 마지막으로 Cato 클라우드에 연결된 타임스탬프를 표시합니다.

버전

버전 필드는 클라이언트의 버전을 문자열 유형으로 보여줍니다.

versionNumber

versionNumber 필드는 클라이언트의 버전을 정수 유형으로 보여줍니다.

PopID

Users > PoPID 필드는 클라이언트가 연결된 PoP의 ID를 보여줍니다.

PopName

Users > PoPName 필드는 클라이언트가 연결된 PoP의 이름을 보여줍니다.

RemoteIP

사용자 > RemoteIP 필드에는 클라이언트의 IP 주소가 표시됩니다.

RemoteIPInfo

사용자 > RemoteIPInfo 필드는 클라이언트가 연결된 PoP의 IP 주소, ISP 및 물리적 위치와 관련된 데이터를 표시합니다. 이 필드에 대한 세부 정보는 다음과 같습니다:

• ip - PoP에 대한 WAN 연결의 IP 주소
• countryCode - PoP의 물리적 위치에 대한 코드(IP 주소 지리적 위치 기준)
• countryName - PoP의 물리적 위치에 해당하는 국가(IP 주소 지리적 위치 기준)
• city - PoP가 위치한 도시(IP 주소 지리적 위치 기준)
• state - PoP가 위치한 주(IP 주소 지리적 위치 기준)
• provider - Cato 클라우드와 PoP 간의 최종 구간 연결을 위한 ISP 제공업체
• latitude - PoP의 위도(IP 주소 지리적 위치 기준)
• longitude - PoP의 경도(IP 주소 지리적 위치 기준)

InternalIP

사용자 > internalIP 필드는 클라이언트가 연결된 PoP의 IP 주소를 표시합니다.

osType

osType 필드는 클라이언트가 설치된 장치의 운영 체제를 나타냅니다.

osVersion

osVersion 필드는 클라이언트가 설치된 장치의 운영 체제 버전을 표시합니다.

장치

사용자 > DeviceSnapshot 필드는 Cato 클라우드에 연결된 장치의 메트릭과 데이터를 표시합니다. DeviceSnapshot의 일부 필드는 데이터를 보다 유연하게 제공하기 위해 반복됩니다. 또한, 동일한 DeviceSnapshot 인프라가 VPN 사용자와 사이트에 사용되며, 일부 필드는 사용자나 사이트에만 관련이 있습니다.

다음은 볼 수 있는 데이터입니다:

• id - 장치에 대한 고유 내부 Cato ID
• name - 장치의 이름
• identifier - 장치의 고유 식별자
• connected - 클라이언트가 Cato 클라우드에 연결되어 있는지 여부를 나타내는 불리언 값
• haRole - SiteSnapshot > Site> Devices에서 사용되는 필드입니다
• interfaces - 클라이언트의 실시간 데이터를 표시합니다(중첩된 쿼리 및 필드가 있는 배열)

  DeviceSnapshot의 인터페이스 필드에 대한 추가 정보는 Cato API - AccountSnapshot > Sites > Devices > Interfaces를 참조하십시오.

• lastConnected - 클라이언트가 Cato 클라우드에 연결된 시간의 타임스탬프
• lastDuration - 클라이언트가 Cato 클라우드에 연결된 총 시간
• connectedSince - 클라이언트가 Cato 클라우드에 활발히 연결된 시간을 나타내는 타임스탬프
• lastPopName - 클라이언트가 연결된 PoP의 이름
• lastPopID - 클라이언트가 연결된 PoP의 ID
• recentConnections - 가장 최근에 완료된 트래픽 플로우와 관련된 데이터(중첩된 쿼리 및 필드가 있는 배열)

  DeviceSnapshot의 최근 연결 필드에 대한 추가 정보는 Cato API - AccountSnapshot > Sites > Devices를 참조하십시오.

• type - 장치 유형을 표시합니다
• uptimeSeconds - 이 클라이언트가 활성 상태인 초 수를 표시합니다
• socketInfo - SiteSnapshot > Site> Devices에서 사용되는 필드입니다
• interfacesLinkState - SiteSnapshot > Site> Devices에서 사용되는 필드입니다
• osType - 클라이언트가 실행 중인 장치의 운영 체제
• osVersion - 장치의 운영 체제 버전
• version - 클라이언트 소프트웨어 버전, 예를 들어 4.4.1234 (문자열)
• versionNumber - 클라이언트 주요 소프트웨어 버전, 예를 들어 4 (정수)
• releaseGroup - 클라이언트의 릴리스 상태를 보여줍니다, 예를 들어 GA 또는 EA
• mfaExpirationTime - MFA 토큰이 만료되기까지 남은 시간을 표시합니다

connectedInOffice

connectedInOffice 필드는 불리언 값이며, true일 때 클라이언트가 오피스 모드를 사용하여 네트워크에 연결되어 있음을 나타냅니다.

정보

UserInfo 필드는 VPN 사용자의 기본 정보를 간결하게 표시합니다. 이 필드에 대한 세부 정보는 다음과 같습니다:

• name - VPN 사용자의 이름
• status - 문자열 유형의 클라이언트 상태
• email - VPN 사용자의 이메일 주소
• creationTime - 계정에서 VPN 사용자 생성 시의 타임스탬프
• phoneNumber - VPN 사용자의 전화번호
• origin - VPN 사용자가 계정에 추가된 방법을 보여줍니다:
  • regular - Cato 관리 애플리케이션에 수동 추가
  • LDAP - LDAP 동기화로 추가
• authMethod - 이 VPN 사용자의 다중 인증 설정:
  • None - VPN 사용자가 클라이언트에 인증할 때 MFA가 필요하지 않습니다
  • MFA - VPN 사용자가 클라이언트에 인증하려면 MFA가 필요합니다

최근 연결

사용자 > RecentConnections 필드는 Cato 클라우드에서 가장 최근 클라이언트 연결과 관련된 데이터를 표시합니다. 이 필드가 질의에 대해 반환할 수 있는 세부 정보는 다음과 같습니다:

• duration - 질의 데이터의 총 시간
• interfaceName - Cato 관리 애플리케이션의 포트 이름
• deviceName - 클라이언트가 설치된 장치의 이름
• lastConnected - 클라이언트가 Cato 클라우드에 연결을 시작한 시간의 타임스탬프를 표시합니다
• popID - 클라이언트가 연결된 PoP의 ID
• popName - 클라이언트가 연결된 PoP의 이름
• remoteIP - 클라이언트의 IP 주소
• remoteIPInfo - 트래픽 플로우가 연결된 PoP와 관련된 IP 주소, ISP 및 지리적 정보

Snapshot > 사용자 ID 인수

질의가 반환한 데이터에 대한 VPN 사용자 ID를 입력하세요. 이 인수가 비어 있을 때, Cato 클라우드에 연결된 모든 VPN 사용자를 질의합니다.