Guia de referência de API
Este guia de referência da OpenAPI do Kaspersky Security Center foi projetado para ajudar nas seguintes tarefas:
- Automação e personalização. É possível automatizar tarefas que pode não querer tratar manualmente usando o Console de Administração. Você também pode implementar cenários personalizados que ainda não são compatíveis no Console de Administração. Por exemplo, como administrador, é possível usar o Kaspersky Security Center OpenAPI para criar e executar scripts que facilitarão o desenvolvimento da estrutura dos grupos de administração e manterão essa estrutura atualizada.
- Desenvolvimento personalizado. Por exemplo, é possível desenvolver um Console de Administração baseado em MMC alternativo para seus clientes, que permite um conjunto limitado de ações.
É possível usar o campo de pesquisa à direita da tela para localizar as informações de que precisa no guia de referência da OpenAPI.
Exemplos de scripts
O guia de referência do OpenAPI contém exemplos dos scripts Python listados na tabela abaixo. Os exemplos mostram como você pode chamar métodos OpenAPI e realizar automaticamente várias tarefas para proteger sua rede, por exemplo, criar uma hierarquia "principal/secundária", executar tarefas no Kaspersky Security Center ou atribuir pontos de distribuição. Você pode executar as amostras como estão ou criar seus próprios scripts com base nos exemplos.
Para chamar os métodos OpenAPI e executar scripts:
- Baixe o arquivo KlAkOAPI.tar.gz. Este arquivo inclui o pacote e exemplos KlAkOAPI (você pode copiá-los do arquivo ou do guia de referência OpenAPI). O arquivo KlAkOAPI.tar.gz também está localizado na pasta de instalação do Kaspersky Security Center.
- Instale o pacote KlAkOAPI do arquivo KlAkOAPI.tar.gz em um dispositivo onde o Servidor de Administração está instalado.
Você poderá chamar os métodos OpenAPI, executar os exemplos e seus próprios scripts somente em dispositivos onde o Servidor de Administração e o pacote KlAkOAPI estiverem instalados.
Correspondência entre cenários de usuário e exemplos de métodos de OpenAPI do Kaspersky Security Center
Exemplo
Objetivo do exemplo
Cenário
É possível extrair e processar dados usando a estrutura de dados
KlAkParams. O exemplo mostra como trabalhar com essa estrutura de dados.A saída, nesse exemplo, pode estar presente de maneiras diferentes. É possível obter os dados para enviar um método HTTP ou para usar em seu código.
Você pode adicionar um Servidor de Administração secundário e estabelecer uma hierarquia "primária/secundária". Como alternativa, é possível desconectar o Servidor de Administração secundário da hierarquia.
Criar a hierarquia do grupo com uma estrutura baseada na unidade do Active Directory
É possível pesquisar a unidade do Active Directory e formar uma hierarquia de grupos de dispositivos descobertos.
Criar a hierarquia do grupo com uma estrutura baseada na unidade do Active Directory em cache
É possível formar uma hierarquia dos grupos de dispositivos gerenciados com base na unidade do Active Directory pesquisada anteriormente. Se novos dispositivos aparecerem no Active Directory após a última pesquisa, eles não serão adicionados ao grupo porque não estão nos resultados de pesquisa salvos.
Criar subredes IP com base no site e nos serviços do Active Directory
É possível criar uma subrede IP com base na unidade do Active Directory usada por você.
No exemplo, é iniciada a pesquisa do intervalo de IP especificado, excluindo as subredes descobertas para evitar conflito com uma nova subrede. Portanto, não execute as operações desse exemplo em uma rede onde é importante salvar subredes.
Após a pesquisa, o exemplo é referenciado no Active Directory, examina todos os dispositivos nele e cria a subrede IP. Para tanto, no exemplo são usadas máscaras e endereços IP de todos os dispositivos.
Registrar os pontos de distribuição para dispositivos em um grupo
É possível atribuir dispositivos gerenciados como pontos de distribuição (anteriormente conhecidos como agentes de atualização).
Atualização dos bancos de dados e dos aplicativos da Kaspersky
É possível executar as seguintes ações nos grupos de administração: No exemplo é mostrado como fazer o seguinte:
- Obtenha um identificador do grupo raiz "Dispositivos gerenciados"
- Percorra a hierarquia do grupo
- Recupere a hierarquia completa e expandida de grupos, junto com seus nomes e aninhamento
Enumerar tarefas, consultar estatísticas de tarefas e executar uma tarefa
É possível descobrir as seguintes informações:
- Histórico de progresso da tarefa
- Status da tarefa atual
- Número de tarefas em diferentes status
É possível também executar uma tarefa. Por padrão, a amostra executa uma tarefa depois de gerar estatísticas.
É possível criar uma tarefa. Especifique os seguintes parâmetros de tarefa no exemplo:
- Tipo
- Método de execução
- Nome
- Grupo de dispositivos para o qual a tarefa será usada
Por padrão, no exemplo é criada uma tarefa do tipo "Mostrar mensagem". É possível executar esta tarefa para todos os dispositivos gerenciados do Servidor de Administração. Se necessário, é possível especificar seus próprios parâmetros de tarefa.
É possível obter uma lista de todas as chaves de licença ativas para os aplicativos Kaspersky instalados em dispositivos gerenciados do Servidor de Administração. A lista contém dados detalhados sobre cada chave de licença, como nome, tipo ou data de término.
É possível criar uma conta para trabalhos futuros.
É possível criar a categoria do aplicativo com os parâmetros necessários.
Criar uma categoria de aplicativos com conteúdo adicionado manualmente
É possível usar a classe SrvView
https://click.kaspersky.com/?hl=KSCAPI&link=online_help&pid=KSC&version=13.0.0&helpid=a00549para solicitar informações detalhadas do Servidor de Administração do Kaspersky Security Center. Por exemplo, é possível obter uma lista de usuários usando este exemplo.