Partilhar via


Censys

Importante

Algumas informações neste artigo estão relacionadas com um produto pré-lançado que pode ser substancialmente modificado antes do lançamento comercial. A Microsoft não faz garantias, expressas ou implícitas, quanto às informações fornecidas aqui.

Este plug-in permite aos utilizadores Security Copilot enriquecer as investigações com informações sobre ameaças da Plataforma Censys. Atualmente, são suportadas as seguintes funcionalidades:

  • Gerar e executar consultas do Censys com linguagem natural
  • Pesquisar o Índice Global do Censys
  • Agregar resultados de pesquisa por campos específicos
  • Obter informações detalhadas sobre endereços IP
  • Procurar informações de certificado por hash SHA256
  • Obter informações de propriedades Web por domínio e porta

Pré-requisitos

  • Acesso a uma conta de Plataforma do Censys
  • Um Token de Acesso Pessoal (PAT) do Censys
  • O ID da Organização do Censys

Observação

Este artigo contém informações sobre plug-ins não Microsoft. Esta documentação de orientação é fornecida para ajudar a concluir cenários de integração. No entanto, a Microsoft não fornece suporte de resolução de problemas para plug-ins que não sejam da Microsoft. Contacte o fornecedor para obter suporte.

Antes de começar

A integração com Security Copilot funciona com uma combinação de um Token de Acesso Pessoal (PAT) e ID da Organização. Tem de efetuar os seguintes passos antes de utilizar o plug-in.

Configuração da Autenticação

  1. Inicie sessão na sua Conta do Censys.

  2. Navegue para o separador Tokens de Acesso Pessoal e selecione Criar Novo Token.

  3. Atribua um nome descritivo ao token (por exemplo, "Security Copilot Token") e selecione Criar.

  4. Localize o ID da Organização a partir do URL da Plataforma do Censys (aparece como ?org=ORG_ID).

  5. Combine o PAT e o ID da Organização com um separador de dois pontos: PAT:ORG_ID

Configuração do Plug-in

  1. Quando lhe for pedido para configurar a autenticação, introduza o PAT combinado e o ID da Organização no seguinte formato:
PAT:ORG_ID
  1. Selecione Guardar para concluir a configuração.

Competências Disponíveis

O Plug-in do Censys para Microsoft Security Copilot expõe as seguintes competências:

  • Geração de Consultas
    • Criar consultas do Censys a partir de linguagem natural
    • Converter a intenção do utilizador em sintaxe do CenQL
  • Pesquisa de Índice Global
    • Executar consultas na base de dados do Censys
    • Obter e formatar resultados de pesquisa
  • Agregação de Dados
    • Agregar resultados por campos especificados
    • Gerar resumos estatísticos
  • Informações do Recurso
    • Pesquisas de endereços IP
    • Obtenção de informações do certificado
    • Análise de propriedades Web

Com o plug-in do Censys para Microsoft Security Copilot, pode invocar interações com o Censys no contexto de uma conversação natural. Veja um exemplo:

  1. Um utilizador pode perguntar sobre endereços IP ou domínios de interesse específicos
  2. Em seguida, o utilizador pode utilizar pedidos de seguimento, tais como "Que outros recursos estão associados a este IP?"
  3. O utilizador pode investigar mais aprofundadamente ao pedir dados agregados sobre ativos ou certificados semelhantes

Exemplo Prompts

Habilidade Prompt
Gerar Consulta Generate a Censys query to find all the nginx servers
Pesquisar Índice Global Query Censys for host.location.country: "Netherlands"
Resultados agregados What are the top 10 ASNs in the world?
Pesquisa de IP What does Censys know about IP 1.1.1.1?
Pesquisa de MÚLTIPLOS IP Get information about 1.1.1.1 and 2.2.2.2
Pesquisa de Certificados Get the certificate 14e641e9f3eb7cf4bdf6b0bc364bd8529feafdb78904c45a49ce25d7daecc824
Pesquisa de Propriedades Web Get the web property google.com:443
Várias Propriedades Look up google.com:443 and censys.io:443

Microsoft Security Copilot mantém o contexto entre consultas, permitindo fluxos de conversação naturais. Por exemplo, depois de procurar um endereço IP, pode fazer perguntas de seguimento sobre certificados relacionados ou propriedades Web sem ter de especificar novamente o IP.

Resolver problemas do plug-in do Censys

Ocorrem erros

Se encontrar erros, como Não foi possível concluir o pedido ou Ocorreu um erro desconhecido, marcar:

  1. Certifique-se de que o plug-in está ativado
  2. Verifique se o PAT e o ID da Organização estão corretamente formatados
  3. Verifique se o seu PAT não expirou
  4. Confirme que tem créditos de API suficientes na sua conta do Censys
  5. Se os problemas persistirem, termine sessão no Security Copilot e volte a iniciar sessão

Prompts não estão a invocar as capacidades corretas

Se os pedidos não invocarem as capacidades corretas ou se os pedidos invocarem outro conjunto de capacidade:

  • Certifique-se de que está a utilizar formatos de pedido suportados
  • Experimente utilizar a invocação direta de competências com "/"
  • Verificar se outros plug-ins podem estar a intercetar consultas semelhantes

Faça comentários

Para fornecer feedback, contacte a equipa do Censys.

Confira também

Outros plug-ins para Microsoft Security Copilot

Gerir plug-ins no Microsoft Security Copilot