AccountSnapshot > ユーザー

UserSnapshotフィールドには、アカウント内のVPNユーザーに関連するデータが含まれています。アカウント内のすべてのユーザーに対してクエリを実行する場合（ID引数が空の場合）、APIコールは現在VPNおよびCato Cloudに接続されているユーザーのデータを返します。

特定のユーザーに対してクエリを実行するためにID引数を使用した場合、APIコールは、そのユーザーがVPNに接続されていなくても、データを返します。

UserSnapshot フィールド

UserSnapshotフィールドには、接続されたVPNユーザーおよびCato Cloudへの接続に関するデータが含まれています。 IDs引数を使用して、クエリに含めるVPNユーザーを指定してください。

UserSnapshotフィールドがクエリに対して返すことができる詳細は以下の通りです。

id - VPNユーザーID
connectivityStatus - Cato Cloudへの接続状況（ネストされたフィールドを持つ配列）
operationalStatus - サイトまたはVPNユーザーのステータス（ネストされたフィールドを持つ配列）
name - VPNユーザーの名前
deviceName - コンピュータまたはデバイスのデバイス名
uptime - クライアントがCato Cloudにどれだけ接続されていたか（秒単位）
lastConnected - VPNユーザーがPoPに接続したタイムスタンプ
version - クライアントのバージョン（文字列）
versionNumber - クライアントのバージョン（INT）
popID - クライアントが接続しているPoPのID
popName - VPNユーザーが接続しているPoPの名前
RemoteIP - クライアントのIPアドレス
RemoteIPInfo - クライアントのIPアドレス、ISP、地理情報
internalIP - クライアントが接続しているPoPのIPアドレス
osType - クライアントが動作しているデバイスのオペレーティングシステム
osVersion - デバイスのオペレーティングシステムのバージョン
devices - クライアントに関連するデータ（ネストされたフィールドを持つ配列）
connectedInOffice - クライアントがOfficeモードを使用してVPNに接続されているかを表示
info - VPNユーザーに関する一般情報（ネストされたフィールドを持つ配列）
recentConnections - 最近完了したVPN接続に関連するデータ（ネストされたクエリとフィールドを持つ配列）

ID

アカウントのユニークなVPNユーザー内部IDを表示します。この値はCato管理画面には表示されません。

connectivityStatus

ユーザー > connectivityStatusフィールドは、VPNユーザーの接続状況を表示します。

接続済み Cato Cloudに
切断 Cato Cloudから

operationalStatus

ユーザー > operationalStatusフィールドは、VPNユーザーのステータスを表示します。

active - トラフィックを通過中
disabled - Cato管理画面で無効化されています
locked - このVPNユーザーのアカウントはロックされています
new - VPNユーザーには関連しません
pending_user_configuration - VPNユーザーがアカウントを確認するのを待っています
pending_mfa_configuration - VPNユーザーがMFA設定を構成するのを待っています
pending_code_generation - VPNユーザーが登録コードを入力するのを待っています

Name

名前フィールドは、Cato管理画面でのVPNユーザーの名前を表示します。

DeviceName

deviceNameフィールドは、Cato Cloudに接続されているコンピュータまたはデバイスのデバイス名を表示します。

uptime

uptimeフィールドは、VPNユーザーがCato Cloudに接続されていた合計時間を秒単位で表示します。

lastConnected

Cato Cloudに接続されていないVPNユーザーの場合、lastConnectedフィールドは、クライアントが最後にCato Cloudに接続したタイムスタンプを表示します。

version

versionフィールドは、クライアントのバージョンをテキスト文字列として表示します。

versionNumber

versionNumberフィールドは、クライアントのバージョンをINTとして表示します。

PopID

ユーザー > PoPIDフィールドは、クライアントが接続しているPoPのIDを表示します。

PopName

ユーザー > PoPNameフィールドは、クライアントが接続しているPoPの名前を表示します。

リモートIP

ユーザー > リモートIP フィールドには、クライアントのIPアドレスが表示されます。

リモートIP情報

ユーザー > リモートIP情報フィールドには、クライアントが接続しているPoPのIPアドレス、ISP、および物理的な場所に関連するデータが表示されます。フィールドの詳細は次のとおりです。

ip - PoPへのWAN接続のIPアドレス
countryCode - PoPの物理的な場所のコード(IPアドレスのジオロケーションに基づく)
countryName - PoPの物理的な場所の国(IPアドレスのジオロケーションに基づく)
city - PoPが位置する都市(IPアドレスのジオロケーションに基づく)
state - PoPが位置する州(IPアドレスのジオロケーションに基づく)
provider - Cato CloudとPoP間のラストマイル接続のISPプロバイダー
latitude - PoPの緯度(IPアドレスのジオロケーションに基づく)
longitude - PoPの経度(IPアドレスのジオロケーションに基づく)

内部IP

ユーザー > 内部IP フィールドには、クライアントが接続しているPoPのIPアドレスが表示されます。

OSタイプ

osTypeフィールドには、クライアントがインストールされているデバイスのオペレーティングシステムが表示されます。

OSバージョン

osVersionフィールドには、クライアントがインストールされているデバイスのオペレーティングシステムのバージョンが表示されます。

デバイス

ユーザー > デバイススナップショットフィールドには、Catoクラウドに接続されているデバイスのメトリクスとデータが表示されます。 DeviceSnapshotの一部のフィールドは、データに柔軟性を持たせるために繰り返されます。また、同じDeviceSnapshotインフラストラクチャがVPNユーザーとサイトに使われており、いくつかのフィールドはユーザーまたはサイトのみに関連しています。

これは、お客様が確認できるデータです。

id - デバイスの一意の内部Cato ID
name - デバイスの名前
identifier - デバイスの一意の識別子
connected - クライアントがCatoクラウドに接続されているかを示すブール値
haRole - このフィールドは SiteSnapshot > サイト > デバイスに使用されます。
interfaces - クライアントのリアルタイムデータを表示(ネストされたクエリとフィールドが含まれる配列)
DeviceSnapshotのインターフェースフィールドの詳細については、Cato API - アカウントスナップショット > サイト > デバイス > インターフェースを参照してください。
lastConnected - クライアントがCatoクラウドに接続した際のタイムスタンプ
lastDuration - クライアントがCatoクラウドに接続された合計時間
connectedSince - クライアントがCatoクラウドにアクティブに接続されている期間のタイムスタンプを表示
lastPopName - クライアントが接続しているPoPの名前
lastPopID - クライアントが接続しているPoPのID
recentConnections - 最新の完了したトラフィックフローに関連するデータ(ネストされたクエリとフィールドが含まれる配列)
DeviceSnapshotのrecentConnectionsフィールドの詳細については、Cato API - アカウントスナップショット > サイト > デバイスを参照してください。
type - デバイスタイプを表示
uptimeSeconds - このクライアントがアクティブな秒数を表示
socketInfo - このフィールドは SiteSnapshot > サイト > デバイスに使用されます。
interfacesLinkState - このフィールドは SiteSnapshot > サイト > デバイスに使用されます。
osType - クライアントが実行されているデバイスのオペレーティングシステム
osVersion - デバイス用のオペレーティングシステムのバージョン
version - クライアントソフトウェアのバージョン、例えば4.4.1234(文字列)
versionNumber - クライアントの主要ソフトウェアバージョン、例えば4(INT)
releaseGroup - クライアントのリリースステータスを表示、例えばGAまたはEA
mfaExpirationTime - MFAトークンが有効期限切れになる前の残り時間

connectedInOffice

connectedInOfficeフィールドはブール値で、それがtrueの場合、クライアントがオフィスモードを使用してネットワークに接続されていることを示します。

情報

UserInfoフィールドは、VPNユーザーに関する基本的な情報を簡潔に表示します。フィールドの詳細は次のとおりです。

name - VPNユーザーの名前
status - クライアントのステータス(STRING型)
email - VPNユーザーのメールアドレス
creationTime - VPNユーザーがアカウントに作成されたタイムスタンプ
phoneNumber - VPNユーザーの電話番号
origin - VPNユーザーがどのようにアカウントに追加されたかを表示:
- regular - 手動でCato管理画面に追加
- LDAP - LDAP同期で追加
authMethod - このVPNユーザーの多要素認証(MFA)の設定:
- None - VPNユーザーはクライアントに認証するためにMFAを必要としません
- MFA - VPNユーザーはクライアントに認証するためにMFAを必要とします

スナップショット > ユーザーID引数

クエリが返すデータのためにVPNユーザーIDを入力してください。この引数が空の場合、クエリはCatoクラウドに接続されたすべてのVPNユーザーを返します。

Cato API - AccountSnapshot > ユーザー