Guía de referencia de API
Esta guía de referencia de OpenAPI de Kaspersky Security Center está diseñada para ayudar en las siguientes tareas:
- Automatización y personalización. Puede automatizar las tareas que no quiera manejar manualmente utilizando la Consola de administración. También puede implementar escenarios personalizados que aún no son compatibles con la Consola de administración. Por ejemplo, como administrador, puede utilizar OpenAPI de Kaspersky Security Center para crear y ejecutar scripts que faciliten el desarrollo de la estructura de los grupos de administración y mantengan dicha estructura actualizada.
- Desarrollo personalizado. Por ejemplo, puede desarrollar una Consola de administración basada en MMC alternativa para sus clientes, que permita un conjunto limitado de acciones.
Puede usar el campo de búsqueda en la parte derecha de la pantalla para encontrar la información que necesita en la guía de referencia de OpenAPI.
Muestras de scripts
La guía de referencia de OpenAPI contiene muestras de los scripts de Python que se enumeran en la siguiente tabla. Los ejemplos muestran cómo puede llamar a métodos OpenAPI y realizar automáticamente varias tareas para proteger su red, por ejemplo, crear una jerarquía "primario/secundario", ejecutar tareas en Kaspersky Security Center, o asignar puntos de distribución. Puede ejecutar los ejemplos o crear sus propios scripts basados en los ejemplos.
Para llamar a los métodos OpenAPI y ejecutar scripts:
- Descargue el archivo KlAkOAPI.tar.gz. Este archivo incluye el paquete KlAkOAPI y las muestras (puede copiarlas del archivo o de la guía de referencia de OpenAPI). El archivo KlAkOAPI.tar.gz también se encuentra en la carpeta de instalación de Kaspersky Security Center.
- Instale el paquete KlAkOAPI del archivo KlAkOAPI.tar.gz en un dispositivo donde esté instalado el Servidor de administración.
Puede llamar a los métodos de OpenAPI, ejecutar las muestras y sus propios scripts solo en dispositivos donde estén instalados el Servidor de administración y el paquete KlAkOAPI.
Coincidencia entre escenarios de usuario y ejemplos de métodos OpenAPI de Kaspersky Security Center
Ejemplo
Propuesta del ejemplo
Escenario
Puede extraer y procesar datos utilizando la estructura de datos
KlAkParams. La muestra indica cómo trabajar con esta estructura de datos.La salida de la muestra se puede presentar de diferentes maneras. Puede obtener los datos para enviar un método HTTP o para usarlo en su código.
Puede agregar un Servidor de administración secundario para establecer una jerarquía "principal/secundario". Alternativamente, puede desconectar de la jerarquía el Servidor de administración secundario.
Crear la jerarquía de grupo con una estructura basada en la unidad de Active Directory
Puede sondear la unidad de Active Directory y formar una jerarquía de grupos con los dispositivos descubiertos.
Crear la jerarquía de grupo con una estructura basada en la unidad de Active Directory en caché
Puede formar una jerarquía de los grupos de dispositivos administrados en función de la unidad de Active Directory sondeada anteriormente. Si después del último sonde aparecen nuevos dispositivos en el directorio activo, no se los añade al grupo porque no están en los resultados de sondeo guardados.
Crear subredes IP basadas en el sitio y los servicios de Active Directory
Puede crear una subred IP según la unidad de Active Directory que use.
La muestra inicia el sondeo del rango de IP especificado y elimina las subredes descubiertas para impedir que entren en conflicto con una nueva subred. Por lo tanto, no ejecute esta muestra en la red donde sea importante mantener las subredes.
Después de realizar el sondeo, la muestra recurre a Active Directory, examina cada dispositivo en él y crea la subred IP. Para ello, la muestra utiliza las máscaras y las direcciones IP de todos los dispositivos.
Registrar puntos de distribución para los dispositivos de un grupo
Puede asignar dispositivos administrados como puntos de distribución (antes conocidos como agentes de actualización).
Actualización de las bases de datos y las aplicaciones de Kaspersky
Puede realizar varias acciones en los grupos de administración: El ejemplo muestra cómo hacer lo siguiente:
- Obtener un identificador del grupo raíz "Dispositivos administrados"
- Moverse a través de la jerarquía de grupo
- Recuperar la jerarquía completa y ampliada de los grupos, junto con sus nombres y nivel de anidación
Enumerar las tareas, consultar las estadísticas de las tareas y ejecutar una tarea
Puede averiguar la siguiente información:
- Historial de progreso de la tarea.
- Estado de la tarea actual.
- Número de tareas en diferentes estados.
También puedes ejecutar una tarea. De forma predeterminada, la muestra ejecuta una tarea después de emitir sus estadísticas.
Puede crear una tarea. Especifique los siguientes parámetros de la tarea en la muestra:
- Tipo.
- Método de ejecución.
- Nombre.
- Grupo de dispositivos para el cual se utilizará la tarea.
De forma predeterminada, la muestra crea una tarea con el tipo "Mostrar mensaje". Puede ejecutar esta tarea para todos los dispositivos administrados del Servidor de administración. Si es necesario, puede especificar sus propios parámetros de tarea.
Puede obtener una lista de todas las claves de licencia activas para aplicaciones Kaspersky instaladas en dispositivos administrados de Administration Server. La lista contiene datos detallados sobre cada clave de licencia, como un nombre, tipo o fecha de vencimiento.
Visualización de información sobre las claves de licencia en uso
Puede crear una cuenta para un trabajo adicional.
Seleccionar la cuenta para iniciar el Servidor de administración
Puede crear la categoría de aplicación con los parámetros necesarios.
Creación de una categoría de aplicaciones con contenido agregado manualmente
Puede usar la clase SrvView para solicitar información detallada al Servidor de administración de Kaspersky Security Center. Por ejemplo, puede obtener una lista de usuarios utilizando esta muestra.