AccountSnapshot > 사용자

The UserSnapshot field contains data related to VPN users in the account. When you run a query for all users in the account (the ID argument is empty), then the API call returns data for users that are currently connected to the VPN and the Cato Cloud.

If you use the ID argument to run a query for specific users, the API call returns data for those users even when they aren't connected to the VPN.

UserSnapshot 필드

The UserSnapshot fields contain data for connected VPN users and their connections to the Cato Cloud. Use the IDs argument to specify which VPN users are included in the query.

These are the details that the UserSnapshot fields can return for the query:

id - VPN user ID
connectivityStatus - Cato Cloud에 대한 연결성 (중첩 필드가 있는 배열)
operationalStatus - status for a site or VPN user (array with nested fields)
name - name of the VPN user
deviceName - 컴퓨터 또는 장치의 이름
uptime - 클라이언트가 Cato Cloud에 연결된 시간 (초 단위)
lastConnected - timestamp for when the VPN user connected to the PoP
version - 클라이언트 소프트웨어 버전 (문자열)
versionNumber - 클라이언트 소프트웨어 버전 (정수)
popID - 클라이언트가 연결된 PoP의 ID
popName - VPN 사용자가 연결된 PoP의 이름
RemoteIP - IP address of the Client
RemoteIPInfo - 클라이언트와 관련된 IP 주소, ISP, 위치 정보
internalIP - IP address of the PoP that the Client is connected to
osType - 클라이언트가 실행되고 있는 장치의 운영 체제
osVersion - 장치 운영 체제의 버전
devices - 클라이언트와 관련된 데이터 (중첩 필드가 있는 배열)
connectedInOffice - shows if the Client is connected to the VPN using Office Mode
metrics - real-time (based on the last 30 seconds) traffic metrics and data for the Client (array with nested fields)
info - general information about the VPN user (array with nested fields)
recentConnections - data related to the most recent completed VPN connections (array with nested queries and fields)

ID

Shows the unique VPN user internal ID for the account, this value isn't shown in the Cato Management Application.

connectivityStatus

The Users > connectivityStatus field shows the connectivity for a VPN user:

연결됨 Cato Cloud에
연결 해제됨 Cato Cloud에서

operationalStatus

The Users > operationalStatus field shows the VPN user status:

활성 - 트래픽 전달 중
비활성화됨 - Cato 관리 애플리케이션에서 비활성화됨
locked - account for this VPN user is locked
new - not relevant for VPN users
pending_user_configuration - waiting for the VPN user to confirm the account
pending_mfa_configuration - waiting for the VPN user to configure the MFA settings
pending_code_generation - waiting for the VPN user to enter the registration code

이름

The name field shows the name of the VPN user in the Cato Management Application.

DeviceName

The deviceName field shows the name of the computer or device that is connected to the Cato Cloud.

uptime

The uptime field shows the total amount of time in seconds, that the VPN user is connected to the Cato Cloud.

lastConnected

For a VPN user that isn't connected to the Cato Cloud, the lastConnected field shows the time stamp for the last time the Client connected to the Cato Cloud.

버전

버전 필드는 유형 STRING으로 클라이언트의 버전을 보여줍니다．

versionNumber

VersionNumber 필드는 유형 INT으로 클라이언트의 버전을 보여줍니다．

PopID

사용자 > PoPID 필드는 클라이언트가 연결된 PoP의 ID를 보여줍니다．

PopName

사용자 > 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 > 사이트 > 장치에서 사용됩니다
interfaces - 클라이언트에 대한 실시간 데이터를 보여줍니다 (중첩된 쿼리와 필드가 있는 배열)
DeviceSnapshot의 인터페이스 필드에 대한 자세한 내용은 Cato API - AccountSnapshot > 사이트 > 장치 > 인터페이스를 참조하십시오．
lastConnected - 클라이언트가 Cato 클라우드에 연결된 시간의 타임스탬프
lastDuration - 클라이언트가 Cato 클라우드에 연결된 총 시간
connectedSince - 클라이언트가 Cato 클라우드에 활성 연결된 기간의 타임스탬프를 보여줍니다
lastPopName - 클라이언트가 연결된 PoP의 이름
lastPopID - 클라이언트가 연결된 PoP의 ID
metrics - 소켓에 대한 실시간 트래픽 메트릭스와 데이터 (중첩된 쿼리와 필드가 있는 배열)
DeviceSnapshot의 메트릭스 필드에 대한 자세한 내용은 Cato API - AccountSnapshot > 사이트 > 장치 > 인터페이스를 참조하십시오．
recentConnections - 가장 최근 완료된 트래픽 흐름과 관련된 데이터 (중첩된 쿼리와 필드가 있는 배열)
DeviceSnapshot의 recentConnections 필드에 대한 더 많은 정보는 Cato API - 계정 스냅샷 > 사이트 > 장치에서 확인하십시오．
유형 - 장치 유형을 보여줍니다
uptimeSeconds - 이 클라이언트가 활성화된 초 수를 보여줍니다
socketInfo - 이 필드는 스냅샷 > 사이트 > 장치에서 사용됩니다
interfacesLinkState - 이 필드는 스냅샷 > 사이트 > 장치에서 사용됩니다
osType - 클라이언트가 실행 중인 장치의 운영 체제
osVersion - 장치의 운영 체제 버전
버전 - 클라이언트 소프트웨어 버전, 예를 들어 4.4.1234 (문자열)
versionNumber - 클라이언트 주요 소프트웨어 버전, 예를 들어 4 (INT)
releaseGroup - 예를 들어, 클라이언트의 릴리스 상태를 보여줍니다, GA 또는 EA
mfaExpirationTime - MFA 토큰이 만료되기 전까지의 남은 시간을 보여줍니다

connectedInOffice

connectedInOffice 필드는 boolean 값입니다．true인 경우, 클라이언트가 오피스 모드를 사용하여 네트워크에 연결되어 있음을 보여줍니다．

메트릭스 대시보드

사용자 > 메트릭스 필드는 클라이언트의 실시간 트래픽 분석을 보여줍니다． 다음은 볼 수 있는 데이터입니다：

지속 시간 - 클라이언트 데이터의 총 시간량
세분성 - 단일 메트릭 버킷의 지속 시간 초
bytesDownstream - 총 하향 트래픽 (Cato 클라우드로부터 클라이언트로)
bytesUpstream - 총 상향 트래픽 (클라이언트로부터 Cato 클라우드로)
bytesTotal - 클라이언트의 총 트래픽
lostDownstream - 하향 트래픽의 손실된 패킷 수
lostDownstreamPcnt - 하향 트래픽의 손실된 패킷 백분율
lostUpstream - 상향 트래픽의 손실된 패킷 수
lostUpstreamPcnt - 상향 트래픽의 손실된 패킷 백분율
packetsDownstream - 총 하향 패킷
packetsUpstream - 총 상향 패킷
jitterUptstream - 상향 트래픽의 지터 (데이터 패킷 간의 시간 지연 차이, 밀리초(ms) 단위)
jitterDownstream - 하향 트래픽의 지터 (데이터 패킷 간의 시간 지연 차이, 밀리초(ms) 단위)
packetsDiscardedDownstream - 하향 트래픽에 대해 폐기된 패킷 총계
packetsDiscardedUpstream - 상향 트래픽에 대해 폐기된 패킷 총계
rtt - 클라이언트에서 Cato 클라우드까지의 왕복 시간

정보

UserInfo 필드는 명확한 지사로 VPN 사용자의 기본 정보를 보여줍니다． 다음은 필드의 세부 정보입니다：

이름 - VPN 사용자의 이름
상태 - STRING 유형의 클라이언트 상태
이메일 - VPN 사용자의 이메일 주소
creationTime - 계정에서 VPN 사용자가 생성된 타임스탬프
전화번호 - VPN 사용자의 전화번호
원점 - VPN 사용자가 계정에 추가된 방법을 보여줍니다：
- 일반 - Cato 관리 애플리케이션에 수동으로 추가됨
- LDAP - LDAP 동기화로 추가됨
authMethod - 이 VPN 사용자의 다중 요소 인증 (MFA) 설정：
- 없음 - VPN 사용자는 클라이언트에 인증하기 위해 MFA 가 필요하지 않습니다
- MFA - VPN 사용자는 클라이언트에 인증하기 위해 MFA 가 필요합니다

최근 연결

사용자 > 최근연결 필드는 클라이언트의 가장 최근 Cato 클라우드 연결에 관련된 데이터를 보여줍니다． 이 필드가 쿼리에 대해 반환할 수 있는 세부 정보는 다음과 같습니다：

지속 시간 - 쿼리 데이터의 총 시간량
interfaceName - Cato 관리 애플리케이션에서 포트의 이름
deviceName - 클라이언트가 설치된 장치의 이름
lastConnected - 클라이언트가 카토 클라우드에 연결한 시간 표시
popID - 클라이언트가 연결된 PoP 의 ID
popName - 클라이언트가 연결된 PoP 의 이름
remoteIP - 클라이언트의 IP 주소
remoteIPInfo - 트래픽 흐름이 연결된 PoP 관련 IP 주소, ISP 및 지리 정보

스냅샷 > 사용자 ID 인자

쿼리가 반환하는 데이터의 VPN 사용자 ID 입력． 이 인자가 비어 있으면 쿼리가 Cato 클라우드에 연결된 모든 VPN 사용자를 반환합니다．

Cato API - 계정 스냅샷 > 사용자