A API de eventos do usuário permite importar eventos relacionados à segurança dos seus usuários ou atividades de treinamento de fontes externas e enviá-los ao console do KSAT. Após a importação, todos os eventos personalizados aparecerão na linha do tempo dos usuários afetados e poderão afetar o nível de risco pessoal deles.
Para obter detalhes completos sobre a API de eventos do usuário, bem como solicitações de amostra, acesse a documentação de desenvolvedor da API de eventos do usuário documentação de desenvolvedor da API de eventos do usuário (o link abre em uma nova janela). Se você optar pelo uso da API de eventos do usuário da KnowBe4, consulte as seções abaixo para saber como gerenciar o uso da API e como os eventos personalizados podem aprimorar seu treinamento de conscientização em segurança.
Console de gerenciamento da API de eventos do usuário
O console de gerenciamento é um local central para monitorar, criar e acompanhar o uso das chaves da API de eventos do usuário. É possível acessar o console de gerenciamento na seção Integrações da conta da página Configurações da conta no KSAT. O console de gerenciamento é dividido em três guias principais: Histórico de chamada, Estatísticas e Chave da API. Para obter mais informações sobre cada guia, consulte a tabela a seguir.
A guia Histórico de chamada exibirá uma tabela com todas as chamadas de API processadas pelo console do KSAT.
| ID de status | Chave da API | Eventos criados | Erros | Data de processamento |
|---|---|---|---|---|
| Um identificador exclusivo gerado para cada chamada de API. | O nome da chave da API usada para fazer a chamada. | O número de eventos do usuário criados como resultado da chamada de API. | Todos os erros recebidos durante a chamada de API. | A data e hora em que a solicitação da API foi processada. Formato: mm/dd/aaaa, h:mm a |
Acesse a guia Estatísticas para acompanhar os usos mensal e anual da sua API.
- Cota mensal: esse gráfico circular de progresso mostra o uso mensal da sua API. O gráfico apresenta a porcentagem de chamadas de API realizadas em relação ao número de chamadas de API permitidas. Você tem direito a 10 chamadas por licença ao dia, mensalmente.
- Cota anual: esse gráfico de barras mostra o uso anual da sua API. Os dados são detalhados por cota mensal, mostrando cada mês ao longo de um período de 12 meses.
Use a guia Chave da API para criar uma ou mais chaves da API. Sua chave da API será usada para autenticar seu console do KSAT ao fazer uma chamada ou solicitação de API. Para criar uma chave da API, siga estas etapas:
- No campo Nome, insira um nome exclusivo para a sua chave da API. Se você pretende criar várias chaves da API, é recomendável usar um nome significativo que represente melhor o uso previsto da chave.
- Clique no botão Criar chave da API. A janela pop-up Token da API de eventos do usuário será aberta.
- Clique no token da API de eventos do usuário para copiá-lo. Certifique-se de salvar o token da API copiado em um lugar de fácil acesso. Depois de fechar essa janela, você não conseguirá ver esse token novamente.
- Clique em OK.
Repita as etapas anteriores para criar quantas chaves da API desejar. Após a criação, todas as suas chaves da API serão listadas em uma tabela na guia Chave da API.
| Chave | Nome | Ações |
|---|---|---|
| Um identificador exclusivo usado para autenticar uma solicitação de API associada ao seu console do KSAT. | O nome personalizado que você atribuiu à sua chave da API quando ela foi criada. |
Você tem a opção de excluir permanentemente uma chave da API. Para excluir uma chave, clique no ícone de lixeira.
Observação: se você excluir uma chave da API, um registro de uso da chave ainda ficará disponível na guia Histórico de chamada. |
Casos de uso da API de eventos do usuário
Veja a seguir alguns exemplos de como os eventos personalizados podem ser usados para aprimorar seu treinamento de conscientização em segurança. Para criar um Grupo inteligente com eventos personalizados, consulte a seção Critérios de evento personalizado da Visão geral dos Grupos inteligentes.
| Tipo de evento | Exemplos de eventos | Caso de uso |
|---|---|---|
| Segurança física |
|
Inscrever os usuários em uma campanha de treinamento específica ao evento. Por exemplo, você pode atribuir um módulo de treinamento de segurança física da ModStore a todos os usuários envolvidos em um evento de segurança física. |
| Engenharia social |
|
Inscrever os usuários em uma campanha de phishing personalizada com base nas informações dos funcionários. Por exemplo, você pode enviar um modelo de e-mail com um cupom de um restaurante local a todos os usuários que fazem aniversário no mês atual. |
| Segurança de terceiros |
|
Acompanhar o envolvimento de um usuário em um incidente de segurança de terceiros. Você pode usar essas informações para selecionar conteúdos de treinamento específicos ao evento na ModStore para inscrição. |
| Desenvolvimento profissional | Certificações e treinamento de outro LMS | Acompanhar os treinamentos externos e as conquistas de um usuário que contribuem para a conscientização em segurança. |