AccountSnapshot > Usuarios

El campo UserSnapshot contiene datos relacionados con los usuarios VPN en la cuenta. Cuando ejecutas una consulta para todos los usuarios de la cuenta (el argumento ID está vacío), la llamada API devuelve datos para los usuarios que actualmente están conectados a la VPN y la Nube de Cato.

Si utilizas el argumento ID para ejecutar una consulta para usuarios específicos, la llamada API devuelve datos para esos usuarios incluso cuando no están conectados a la VPN.

Campos UserSnapshot

Los campos UserSnapshot contienen datos para los usuarios VPN conectados y sus conexiones a la Nube de Cato. Usa el argumento IDs para especificar qué usuarios VPN se incluyen en la consulta.

Estos son los detalles que los campos UserSnapshot pueden devolver para la consulta:

• id - ID del usuario VPN
• connectivityStatus - conectividad a la Nube de Cato (array con campos anidados)
• operationalStatus - estado para un sitio o usuario VPN (array con campos anidados)
• name - nombre del usuario VPN
• deviceName - nombre del ordenador o dispositivo
• uptime - cuánto tiempo el Cliente ha estado conectado a la Nube de Cato (en segundos)
• lastConnected - timestamp de cuando el usuario VPN se conectó al PoP
• version - versión del software del Cliente (cadena)
• versionNumber - versión del software del Cliente (INT)
• popID - ID del PoP al que está conectado el Cliente
• popName - nombre del PoP al que el usuario VPN está conectado
• RemoteIP - dirección IP del Cliente
• RemoteIPInfo - dirección IP, proveedor de servicios de internet (ISP), y información geográfica relacionada con el Cliente
• internalIP - dirección IP del PoP al que está conectado el Cliente
• osType - sistema operativo del dispositivo en el que el Cliente está funcionando
• osVersion - versión del sistema operativo para el dispositivo
• devices - datos relacionados con el Cliente (array con campos anidados)
• connectedInOffice - muestra si el Cliente está conectado a la VPN usando el Modo Oficina
• info - información general sobre el usuario VPN (array con campos anidados)
• recentConnections - datos relacionados con las conexiones VPN completas más recientes (array con consultas y campos anidados)

ID

Muestra el ID interno único del usuario VPN para la cuenta, este valor no se muestra en la Aplicación de Gestión de Cato.

connectivityStatus

El campo Users > connectivityStatus muestra la conectividad para un usuario VPN:

• conectado a la Nube de Cato
• desconectado de la Nube de Cato

operationalStatus

El campo Users > operationalStatus muestra el estado del usuario VPN:

• active - pasando tráfico
• disabled - deshabilitado en la Aplicación de Gestión de Cato
• locked - cuenta para este usuario VPN está bloqueada
• new - no relevante para usuarios VPN
• pending_user_configuration - esperando que el usuario VPN confirme la cuenta
• pending_mfa_configuration - esperando que el usuario VPN configure la Configuración de MFA
• pending_code_generation - esperando que el usuario VPN ingrese el código de registro

Nombre

El campo nombre muestra el nombre del usuario VPN en la Aplicación de Gestión de Cato.

DeviceName

El campo deviceName muestra el nombre del ordenador o dispositivo que está conectado a la Nube de Cato.

uptime

El campo uptime muestra el tiempo total en segundos que el usuario VPN está conectado a la Nube de Cato.

lastConnected

Para un usuario VPN que no está conectado a la Nube de Cato, el campo lastConnected muestra la marca de tiempo de la última vez que el Cliente se conectó a la Nube de Cato.

versión

El campo versión muestra la versión del Cliente como el tipo STRING.

versionNumber

El campo versionNumber muestra la versión del Cliente como el tipo INT.

PopID

El campo Users > PoPID muestra el ID del PoP al que está conectado el Cliente.

PopName

El campo Users > PoPName muestra el nombre del PoP al que está conectado el Cliente.

RemoteIP

El campo Usuarios > RemoteIP muestra la dirección IP del Cliente.

RemoteIPInfo

El campo Usuarios > RemoteIPInfo muestra datos relacionados con la dirección IP, el ISP y la ubicación física del PoP al que está conectado el Cliente. Estos son los detalles para los campos:

• ip - Dirección IP de la conexión WAN al PoP
• countryCode - código para la ubicación física del PoP (basado en la geolocalización de la dirección IP)
• countryName - país que es la ubicación física del PoP (basado en la geolocalización de la dirección IP)
• city - ciudad donde se encuentra el PoP (basado en la geolocalización de la dirección IP)
• state - estado/provincia donde se encuentra el PoP (basado en la geolocalización de la dirección IP)
• provider - Proveedor ISP para la conexión de última milla entre Cato Cloud y el PoP
• latitude - latitud del PoP (basado en la geolocalización de la dirección IP)
• longitude - longitud del PoP (basado en la geolocalización de la dirección IP)

InternalIP

El campo Usuarios > InternalIP muestra la dirección IP del PoP al que está conectado el Cliente.

osType

El campo osType muestra el sistema operativo del dispositivo en el que está instalado el Cliente.

osVersion

El campo osVersion muestra la versión del sistema operativo del dispositivo en el que está instalado el Cliente.

Dispositivos

Los campos Usuarios > DeviceSnapshot muestran métricas y datos del dispositivo que está conectado a Cato Cloud. Algunos campos en DeviceSnapshot se repiten para darte mayor flexibilidad con los datos. Además, la misma infraestructura de DeviceSnapshot se utiliza para usuarios VPN y para sitios, y algunos de los campos son solo relevantes para usuarios o sitios.

Estos son los datos que puedes ver:

• id - ID interno único de Cato para el dispositivo
• nombre - nombre del dispositivo
• identificador - identificador único para el dispositivo
• conectado - un valor booleano que indica si el Cliente está conectado a Cato Cloud
• haRole - este campo se usa en SiteSnapshot > Sitio > Dispositivos
• interfaces - muestra datos en tiempo real para el Cliente (matriz con consultas y campos anidados)

  Para más información sobre los campos Interfaces para DeviceSnapshot, consulta Cato API - AccountSnapshot > Sites > Devices > Interfaces.

• lastConnected - marca de tiempo de cuando el Client se conectó a la Cato Cloud
• lastDuration - cantidad total de tiempo que el Cliente ha estado conectado a Cato Cloud
• connectedSince - muestra la marca de tiempo de cuánto tiempo el Cliente está activamente conectado a Cato Cloud
• lastPopName - el nombre del PoP al que está conectado el Cliente
• lastPopID - el ID del PoP al que está conectado el Cliente
• recentConnections - datos relacionados con los flujos de tráfico más recientes completados (matriz con consultas y campos anidados)

  Para más información sobre los campos recentConnections para DeviceSnapshot, consulta Cato API - AccountSnapshot > Sites > Devices.

• tipo - muestra el tipo de dispositivo
• uptimeSeconds - muestra el número de segundos que este Cliente ha estado activo
• socketInfo - este campo se usa en SiteSnapshot > Sitio > Dispositivos
• interfacesLinkState - este campo se usa en SiteSnapshot > Sitio > Dispositivos
• osType - sistema operativo del dispositivo en el que se ejecuta el Cliente
• osVersion - versión del sistema operativo para el dispositivo
• versión - versión del software del Cliente, por ejemplo, 4.4.1234 (cadena)
• versionNumber - versión principal del software del Cliente, por ejemplo, 4 (INT)
• releaseGroup - muestra el estado de lanzamiento para el Cliente, como GA o EA
• mfaExpirationTime - Muestra la cantidad de tiempo restante antes de que el token MFA expire.

connectedInOffice

El campo connectedInOffice es un valor booleano, y cuando es true, muestra que el Cliente está conectado a la red usando el Modo Oficina.

Información

Los campos UserInfo muestran información básica sobre el usuario VPN, en una rama concisa. Estos son los detalles para los campos:

• nombre - nombre del usuario VPN
• estado - estado del Cliente como el tipo STRING
• correo electrónico - dirección de correo electrónico del usuario VPN
• creationTime - marca de tiempo de cuándo se creó el usuario VPN en la cuenta
• número de teléfono - número de teléfono para el usuario VPN
• origen - muestra cómo se agregó el usuario VPN a la cuenta:
  • regular - agregado manualmente en la Aplicación de Gestión de Cato
  • LDAP - agregado con sincronización LDAP
• authMethod - Configuración de Autenticación Multifactor (MFA) para este usuario VPN:
  • Ninguna - el usuario VPN no requiere MFA para autenticarse en el Cliente
  • MFA - el usuario VPN requiere MFA para autenticarse en el Cliente

RecentConnections

El campo Usuarios > RecentConnections muestra datos relacionados con las conexiones más recientes del Cliente a Cato Cloud. Estos son los detalles que este campo puede devolver para una consulta:

• duración - cantidad total de tiempo para los datos de la consulta
• nombre de interfaz - Nombre para el puerto en la Aplicación de Gestión de Cato
• nombre del dispositivo - Nombre del dispositivo en el que está instalado el Cliente
• última conexión - Muestra la marca de tiempo cuando el Cliente inició la conexión con Cato Cloud
• popID - El ID del PoP al que estaba conectado el Cliente
• popName - El nombre del PoP al que estaba conectado el Cliente
• remoteIP - Dirección IP del Cliente
• remoteIPInfo - Dirección IP, ISP e información geográfica relacionada con el PoP al que estaba conectado el flujo de tráfico

Instantánea > IDs de Usuarios Argumento

Introduce los IDs de usuario VPN para los datos que devuelve la consulta. Cuando este argumento está vacío, la consulta devuelve todos los usuarios VPN conectados a Cato Cloud.