Conector de dados Bitsight (usando o Azure Functions) conector para Microsoft Sentinel

O BitSight Data Connector suporta monitoramento de risco cibernético baseado em evidências trazendo dados BitSight no Microsoft Sentinel.

Trata-se de conteúdo gerado automaticamente. Para alterações, entre em contato com o provedor da solução.

Atributos do conector

Atributo do conector	Description
Código do aplicativo de função do Azure	https://aka.ms/sentinel-BitSight-functionapp
Tabela(s) do Log Analytics	Alerts_data_CL BitsightBreaches_data_CL BitsightCompany_details_CL BitsightCompany_rating_details_CL BitsightDiligence_historical_statistics_CL BitsightDiligence_statistics_CL BitsightFindings_data_CL BitsightFindings_summary_CL BitsightGraph_data_CL BitsightIndustrial_statistics_CL BitsightObservation_statistics_CL
Suporte a regras de coleta de dados	Não é suportado atualmente
Apoiado por	Suporte BitSight

Exemplos de consulta

BitSight Alert Events - Evento de alertas para todas as empresas em portfólio.

Alerts_data_CL

| sort by TimeGenerated desc

BitSight Breaches Events - Evento de Violações para todas as Empresas em portfólio.

BitsightBreaches_data_CL

| sort by TimeGenerated desc

BitSight Company Details Events - Evento de Detalhes da Empresa para todas as Empresas em portfólio.

BitsightCompany_details_CL

| sort by TimeGenerated desc

BitSight Company Ratings Events - Evento de Classificações de Empresas para todas as Empresas.

BitsightCompany_rating_details_CL

| sort by TimeGenerated desc

BitSight Diligence Historical Statistics Events - Evento de Estatísticas Históricas de Diligência para todas as Empresas.

BitsightDiligence_historical_statistics_CL

| sort by TimeGenerated desc

BitSight Diligence Statistics Events - Evento de estatísticas de diligência para todas as empresas.

BitsightDiligence_statistics_CL

| sort by TimeGenerated desc

BitSight Findings Events - Evento de Constatações para todas as Empresas.

BitsightFindings_data_CL

| sort by TimeGenerated desc

BitSight Findings Summary Events - Evento de Resumo de Constatações para todas as Empresas.

BitsightFindings_summary_CL

| sort by TimeGenerated desc

BitSight Graph Events - Evento gráfico para todas as empresas.

BitsightGraph_data_CL

| sort by TimeGenerated desc

BitSight Industrial Statistics Events - Evento de Estatísticas Industriais para todas as Empresas.

BitsightIndustrial_statistics_CL

| sort by TimeGenerated desc

BitSight Observation Statistics Events - Evento de Estatísticas de Observação para todas as Empresas.

BitsightObservation_statistics_CL

| sort by TimeGenerated desc

Pré-requisitos

Para integrar com o conector de dados Bitsight (usando o Azure Functions), certifique-se de ter:

• Permissões Microsoft.Web/sites: são necessárias permissões de leitura e gravação no Azure Functions para criar um Aplicativo de Função. Consulte a documentação para saber mais sobre o Azure Functions.
• Credenciais/permissões da API REST: o Token da API BitSight é necessário. Consulte a documentação para saber mais sobre o API Token.

Instruções de instalação do fornecedor

Nota

Esse conector usa o Azure Functions para se conectar à API do BitSight para extrair seus logs para o Microsoft Sentinel. Isso pode resultar em custos adicionais de ingestão de dados. Consulte a página de preços do Azure Functions para obter detalhes.

(Etapa opcional) Armazene com segurança a(s) chave(s) de autorização do espaço de trabalho e da API ou código(s) no Cofre de Chaves do Azure. O Azure Key Vault fornece um mecanismo seguro para armazenar e recuperar valores de chave. Siga estas instruções para usar o Azure Key Vault com um Aplicativo de Função do Azure.

PASSO 1 - Passos para Criar/Obter o Bitsight API Token

Siga estas instruções para obter um BitSight API Token.

1. Para SPM App: Consulte a guia Preferências do Usuário da página Conta, vá para Configurações > do Token da API de Preferências > do Usuário da Conta>.
2. Para TPRM App: Consulte a guia Preferências do Usuário da sua página Conta, vá para Configurações > do Token da API de Preferências > do Usuário da Conta>.
3. Para BitSight Clássico: Vá para a página Conta , Vá para Configurações > do Token da API da Conta > .

PASSO 2 - Passos de Registo da Aplicação na Aplicação no Microsoft Entra ID

Essa integração requer um registro de aplicativo no portal do Azure. Siga as etapas nesta seção para criar um novo aplicativo no Microsoft Entra ID:

1. Inicie sessão no portal do Azure.
2. Procure e selecione Microsoft Entra ID.
3. Em Gerir, selecione Registos de > aplicações Novo registo.
4. Insira um Nome de exibição para seu aplicativo.
5. Selecione Registrar para concluir o registro inicial do aplicativo.
6. Quando o registro for concluído, o portal do Azure exibirá o painel Visão geral do registro do aplicativo. Você vê a ID do aplicativo (cliente) e a ID do locatário. O ID do cliente e o ID do locatário são necessários como parâmetros de configuração para a execução do BitSight Data Connector.

Link de referência: /azure/active-directory/develop/quickstart-register-app

PASSO 3 - Adicionar um segredo do cliente para aplicação no Microsoft Entra ID

Às vezes chamado de senha de aplicativo, um segredo do cliente é um valor de cadeia de caracteres necessário para a execução do BitSight Data Connector. Siga as etapas nesta seção para criar um novo segredo do cliente:

1. No portal do Azure, em Registros de aplicativos, selecione seu aplicativo.
2. Selecione Certificados & segredos Segredos do > cliente Novo segredo do > cliente.
3. Adicione uma descrição do segredo do cliente.
4. Selecione uma expiração para o segredo ou especifique um tempo de vida personalizado. O limite é de 24 meses.
5. Selecione Adicionar.
6. Registe o valor do segredo para uso no código da aplicação cliente. Este valor secreto nunca mais é apresentado depois de sair desta página. O valor secreto é necessário como parâmetro de configuração para a execução do BitSight Data Connector.

Link de referência: /azure/active-directory/develop/quickstart-register-app#add-a-client-secret

PASSO 4 - Atribuir a função de Colaborador à aplicação no Microsoft Entra ID

Siga as etapas nesta seção para atribuir a função:

1. No portal do Azure, vá para Grupo de Recursos e selecione seu grupo de recursos.
2. Vá para Controle de acesso (IAM) no painel esquerdo.
3. Clique em Adicionar e, em seguida, selecione Adicionar atribuição de função.
4. Selecione Colaborador como função e clique em avançar.
5. Em Atribuir acesso a, selecione User, group, or service principal.
6. Clique em adicionar membros , digite o nome do aplicativo que você criou e selecione-o.
7. Agora clique em Rever + atribuir e, em seguida, clique novamente em Rever + atribuir.

Link de referência: /azure/role-based-access-control/role-assignments-portal

ETAPA 5 - Escolha UMA das duas opções de implantação a seguir para implantar o conector e a Função do Azure associada

IMPORTANTE: Antes de implantar o conector de dados BitSight, tenha o ID do espaço de trabalho e a chave primária do espaço de trabalho (pode ser copiado do seguinte) prontamente disponíveis.., bem como o token da API BitSight.

Opção 1 - Modelo do Azure Resource Manager (ARM)

Use este método para a implantação automatizada do conector BitSight.

1. Clique no botão Implantar no Azure abaixo.

   

2. Selecione a Subscrição, o Grupo de Recursos e a Localização preferidos.

3. Insira as informações abaixo:

   • Nome da Função
   • ID da área de trabalho
   • Chave do espaço de trabalho
   • API_token
   • Empresas
   • Azure_Client_Id
   • Azure_Client_Secret
   • Azure_Tenant_Id
   • Portfolio_Companies_Table_Name
   • Alerts_Table_Name
   • Breaches_Table_Name
   • Company_Table_Name
   • Company_Rating_Details_Table_Name
   • Diligence_Historical_Statistics_Table_Name
   • Diligence_Statistics_Table_Name
   • Findings_Summary_Table_Name
   • Findings_Table_Name
   • Graph_Table_Name
   • Industrial_Statistics_Table_Name
   • Observation_Statistics_Table_Name
   • Nível do registo
   • Agenda
   • Schedule_Portfolio

4. Marque a caixa de seleção Concordo com os termos e condições mencionados acima.

5. Clique em Comprar para implantar.

Opção 2 - Implantação manual do Azure Functions

Use as instruções passo a passo a seguir para implantar o conector de dados BitSight manualmente com o Azure Functions (Implantação por meio do Visual Studio Code).

1. Implantar um aplicativo de função

NOTA: Você precisará preparar o código VS para o desenvolvimento da função do Azure.

1. Baixe o arquivo do Aplicativo Azure Function. Extraia o arquivo para o computador de desenvolvimento local.

2. Inicie o VS Code. Escolha Arquivo no menu principal e selecione Abrir pasta.

3. Selecione a pasta de nível superior dos arquivos extraídos.

4. Escolha o ícone do Azure na barra de atividades e, em seguida, na área Azure: Funções , escolha o botão Implantar para o aplicativo funcional. Se ainda não tiver sessão iniciada, escolha o ícone do Azure na barra de atividades e, em seguida, na área Azure: Funções , selecione Iniciar sessão no Azure Se já tiver sessão iniciada, avance para o passo seguinte.

5. Forneça as seguintes informações nos pedidos:

   a. Selecionar pasta: escolha uma pasta no seu espaço de trabalho ou navegue até uma que contenha seu aplicativo de função.

   b. Selecione Assinatura: escolha a assinatura a ser usada.

   c. Selecione Criar novo aplicativo de função no Azure (Não escolha a opção Avançado)

   d. Insira um nome globalmente exclusivo para o aplicativo de função: digite um nome válido em um caminho de URL. O nome digitado é validado para garantir que seja exclusivo no Azure Functions. (por exemplo, BitSightXXXXX).

   e. Selecione um tempo de execução: Escolha Python 3.8 ou superior.

   f. Selecione um local para novos recursos. Para um melhor desempenho e custos mais baixos, escolha a mesma região onde o Microsoft Sentinel está localizado.

6. A implantação será iniciada. Depois de criar a aplicação de funções, é apresentada uma notificação e o pacote de implementação é aplicado.

7. Vá para o Portal do Azure para a configuração do Aplicativo de Função.

2. Configurar o aplicativo de função

1. No Aplicativo de Função, selecione o Nome do Aplicativo de Função e selecione Configuração.
2. Na guia Configurações do aplicativo, selecione + Nova configuração do aplicativo.
3. Adicione cada uma das seguintes configurações do aplicativo individualmente, com seus respetivos valores (diferencia maiúsculas de minúsculas):
   • ID da área de trabalho
   • Chave do espaço de trabalho
   • API_token
   • Empresas
   • Azure_Client_Id
   • Azure_Client_Secret
   • Azure_Tenant_Id
   • Portfolio_Companies_Table_Name
   • Alerts_Table_Name
   • Breaches_Table_Name
   • Company_Table_Name
   • Company_Rating_Details_Table_Name
   • Diligence_Historical_Statistics_Table_Name
   • Diligence_Statistics_Table_Name
   • Findings_Summary_Table_Name
   • Findings_Table_Name
   • Graph_Table_Name
   • Industrial_Statistics_Table_Name
   • Observation_Statistics_Table_Name
   • Nível do registo
   • Agenda
   • Schedule_Portfolio
4. Depois que todas as configurações do aplicativo tiverem sido inseridas, clique em Salvar.

Próximos passos

Para obter mais informações, vá para a solução relacionada no Azure Marketplace.