Integre o Microsoft Entra ID com o Google SecOps

Este documento fornece orientações sobre como integrar o Microsoft Entra ID com o Google Security Operations (Google SecOps).

Versão da integração: 18.0

Esta integração usa um ou mais componentes de código aberto. Pode transferir uma cópia comprimida do código-fonte completo desta integração a partir do contentor do Cloud Storage.

Exemplos de utilização

A integração do Microsoft Entra ID com o Google SecOps pode ajudar a resolver os seguintes exemplos de utilização:

  • Gestão de contas de utilizador: use as capacidades do Google SecOps para automatizar a desativação e a ativação de contas de utilizador no Microsoft Entra ID com base em eventos de segurança, como comprometimento suspeito ou desvinculação de funcionários.

  • Reposição de palavras-passe: use as capacidades do Google SecOps para orquestrar reposições de palavras-passe para contas comprometidas ou utilizadores que perderam o acesso às suas contas. A reposição de palavras-passe pode ajudar a simplificar o processo de recuperação de palavras-passe e reduzir os pedidos de ajuda técnica.

  • Gestão de grupos: use as capacidades do Google SecOps para automatizar a criação, a modificação e a eliminação de grupos do Microsoft Entra ID.

  • Aplicação de políticas de acesso condicional: use as políticas de acesso condicional do Microsoft Entra ID nos manuais de procedimentos do Google SecOps para controlar dinamicamente o acesso com base no contexto e permitir o controlo detalhado do acesso aos recursos com base em fatores como a localização, o dispositivo e o risco do utilizador.

  • Alertas de segurança e resposta a incidentes: integre os alertas de segurança do Microsoft Entra ID no Google SecOps para automatizar os fluxos de trabalho de resposta a incidentes.

Antes de começar

Antes de configurar a integração na plataforma Google SecOps, conclua os seguintes passos:

  1. Configure o acesso à rede.

  2. Crie a app Microsoft Entra.

  3. Configure as autorizações da API para a sua app.

  4. Crie um segredo do cliente.

Configure o acesso à rede

Para ativar o acesso à API do Google SecOps ao Microsoft Entra ID, permita o tráfego através da porta 443.

Crie uma aplicação do Microsoft Entra

  1. Inicie sessão no portal do Azure como administrador de utilizadores ou administrador de palavras-passe.

  2. Selecione Microsoft Entra ID.

  3. Aceda a Registos de apps > Novo registo.

  4. Introduza o nome da aplicação.

  5. Clique em Registar.

  6. Guarde os valores do ID da aplicação (cliente) e do ID do diretório (inquilino) para os usar mais tarde quando configurar os parâmetros de integração.

Configure autorizações da API

  1. Aceda a Autorizações da API > Adicionar uma autorização.

  2. Selecione Microsoft Graph > Autorizações da aplicação.

  3. Na secção Selecionar autorizações, selecione as seguintes autorizações:

  4. Clique em Adicionar autorizações.

  5. Clique em Conceder consentimento de administrador para YOUR_ORGANIZATION_NAME.

    Quando for apresentada a caixa de diálogo Confirmação de concessão de consentimento do administrador, clique em Sim.

Crie um segredo do cliente

  1. Navegue para Certificados e segredos > Novo segredo do cliente.

  2. Forneça uma descrição para um segredo do cliente e defina o respetivo prazo de validade.

  3. Clique em Adicionar.

  4. Guarde o valor do segredo do cliente (não o ID do segredo) para o usar como o valor do parâmetro Client Secret ao configurar a integração. O valor do segredo do cliente só é apresentado uma vez.

Integre o Microsoft Entra ID com o Google SecOps

A integração do Microsoft Entra ID requer os seguintes parâmetros:

Parâmetro Descrição
Login API Root Opcional

A raiz da API usada para autenticar com a plataforma de identidade da Microsoft.

O valor predefinido é https://login.microsoftonline.com.
API Root Opcional

A raiz da API da instância do Azure Active Directory.

O valor predefinido é https://graph.microsoft.com.
Client ID Obrigatório

O valor do ID da aplicação (cliente) da sua conta do Microsoft Entra ID.
Client Secret Obrigatório

O valor do segredo do cliente da sua conta do Microsoft Entra ID.
Directory ID Obrigatório

O valor do ID do diretório (inquilino) da sua conta do Microsoft Entra ID.
Verify SSL Opcional

Se esta opção estiver selecionada, a integração verifica se o certificado SSL usado para estabelecer ligação ao servidor do Microsoft Entra ID é válido.

Selecionado por predefinição.

Para obter instruções sobre como configurar uma integração no Google SecOps, consulte o artigo Configurar integrações.

Se necessário, pode fazer alterações numa fase posterior. Depois de configurar uma instância de integração, pode usá-la em manuais de soluções. Para mais informações sobre a configuração e o suporte de várias instâncias, consulte o artigo Suporte de várias instâncias.

Ações

Para mais informações sobre ações, consulte os artigos Responda a ações pendentes a partir do seu espaço de trabalho e Execute uma ação manual.

Adicione um utilizador a um grupo

Use a ação Adicionar utilizador a um grupo para adicionar um utilizador ao grupo específico do Microsoft Entra ID. Esta ação espera que configure a entidade User no formato username@domain.

Esta ação é executada na entidade User do Google SecOps.

Dados de ações

A ação Adicionar utilizador a um grupo requer os seguintes parâmetros:

Parâmetro Descrição
Group ID Obrigatório

O ID do grupo do Microsoft Entra ID ao qual adicionar o utilizador, como 00e40000-1971-439d-80fc-d0e000001dbd.

Resultados da ação

A ação Adicionar utilizador a um grupo fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Não disponível
Tabela de enriquecimento Não disponível
Resultado JSON Não disponível
Mensagens de saída Disponível
Resultado do script Disponível
Mensagens de saída

A ação Adicionar utilizador a um grupo pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

Member USER_ID was added to the group GROUP_ID successfully.

Some errors occurred. Please check the logs.

 A ação foi bem-sucedida.
Member could not be added successfully.

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte indica o valor do resultado do script quando usa a ação Adicionar utilizador a um grupo:

Nome do resultado do script Valor
is_success True ou False

Desative a conta

Use a ação Desativar conta para desativar uma conta no Microsoft Entra ID. Esta ação espera que configure a entidade User no formato username@domain.

Para executar a ação Desativar conta, conceda privilégios administrativos à conta do Microsoft Entra ID que usa na integração.

Esta ação é executada na entidade User do Google SecOps.

Configure autorizações adicionais

A ação Desativar conta requer que configure adicionalmente a seguinte autorização da API para a aplicação:

  • User.EnableDisableAccount.All

Para orientações sobre como configurar autorizações da API no Microsoft Entra ID, consulte a secção Configurar autorizações da API deste documento.

Dados de ações

Nenhum.

Resultados da ação

A ação Desativar conta fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Não disponível
Tabela de enriquecimento Não disponível
Resultado JSON Não disponível
Mensagens de saída Disponível
Resultado do script Disponível
Mensagens de saída

A ação Desativar conta pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

User account disabled successfully.

Some errors occurred. Please check the logs.

 A ação foi bem-sucedida.
Disable user account was not successful.

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte apresenta o valor do resultado do script quando usa a ação Desativar conta:

Nome do resultado do script Valor
is_success True ou False

Ative a conta

Use a ação Ativar conta para ativar uma conta no Microsoft Entra ID. Esta ação espera que configure a entidade User no formato username@domain.

Esta ação é executada na entidade User do Google SecOps.

Configure autorizações adicionais

A ação Ativar conta requer que configure adicionalmente a seguinte autorização da API para a aplicação:

  • User.EnableDisableAccount.All

Para orientações sobre como configurar autorizações da API no Microsoft Entra ID, consulte a secção Configurar autorizações da API deste documento.

Dados de ações

Nenhum.

Resultados da ação

A ação Ativar conta fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Não disponível
Tabela de enriquecimento Não disponível
Resultado JSON Não disponível
Mensagens de saída Disponível
Resultado do script Disponível
Mensagens de saída

A ação Ativar conta pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

User account was enabled successfully.

Some errors occurred. Please check the logs.

 A ação foi bem-sucedida.
Enable user account was not successful.

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte apresenta o valor do resultado do script quando usa a ação Enable Account:

Nome do resultado do script Valor
is_success True ou False

Anfitrião de enriquecimento

Use a ação Enrich Host para enriquecer a entidade do Google SecOps Host com informações do Microsoft Entra ID. Esta ação encontra uma correspondência para uma entidade Host fornecida através do campo displayName no Microsoft Entra ID.

Esta ação é executada na entidade Host do Google SecOps.

Dados de ações

Nenhum.

Resultados da ação

A ação Enrich Host fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Não disponível
Tabela de enriquecimento de entidades Disponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Tabela de enriquecimento de entidades

A ação Enrich Host suporta o seguinte enriquecimento de entidades:

Campo de enriquecimento Lógica
AAD_Name Devolve se existir no resultado JSON.
AAD_Enabled Devolve se existir no resultado JSON.
AAD_Property Device ID Devolve se existir no resultado JSON.
AAD_OS Devolve se existir no resultado JSON.
AAD_Version Devolve se existir no resultado JSON.
AAD_Profile Type Devolve se existir no resultado JSON.
AAD_Compliant Devolve se existir no resultado JSON.
AAD_Last Sign In Devolve se existir no resultado JSON.
Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação Enrich Host:

[
    {
        "EntityResult": {
            "deletedDateTime": "1234569",
            "complianceExpirationDateTime": "1234567",
            "profileType": "RegisteredDevice",
            "key": "007",
            "if":"889922-aaaa-123123"
        },
        "Entity": "us-lt-v13001"
    }
]
Mensagens de saída

A ação Enrich Host pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

Host details were fetched successfully: HOSTNAME.

Some errors occurred. Please check log.

 A ação foi bem-sucedida.
Host details were not found.

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Enrich Host:

Nome do resultado do script Valor
is_success True ou False

Enriquecer utilizador

Use a ação Enrich User para enriquecer a entidade do Google SecOps User com informações do Microsoft Entra ID. Esta ação espera que configure a entidade User no formato username@domain.

Esta ação é executada na entidade Host do Google SecOps.

Dados de ações

Nenhum.

Resultados da ação

A ação Enriquecer utilizador fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Não disponível
Tabela de enriquecimento de entidades Disponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Tabela de enriquecimento de entidades

A ação Enriquecer utilizador suporta o seguinte enriquecimento de entidades:

Campo de enriquecimento Lógica
AAD_Name Devolve se existir no resultado JSON.
AAD_Mobile Phone Devolve se existir no resultado JSON.
AAD_Preferred Language Devolve se existir no resultado JSON.
AAD_Job Title Devolve se existir no resultado JSON.
AAD_Username Devolve se existir no resultado JSON.
Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação Enrich User:

[
    {
        "EntityResult": {
            "displayName": "Test User",
            "mobilePhone": "(800) 555-0175",
            "preferredLanguage": "English",
            "jobTitle": "Engineer",
            "userPrincipalName":"ser@example.com"
        },
        "Entity": "user@example.com"
    }
]
Mensagens de saída

A ação Enrich User pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

User details were fetched successfully: USERNAME.

Some errors occurred. Please check the logs.

 A ação foi bem-sucedida.
Users list fetch was not successful.

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa a ação Enriquecer utilizador:

Nome do resultado do script Valor
is_success True ou False

Forçar atualização da palavra-passe

Use a ação Forçar atualização da palavra-passe para forçar uma atualização da palavra-passe para o utilizador. Esta ação exige que o utilizador altere a palavra-passe na próxima tentativa de início de sessão.

A ação Force Password Update espera que configure a entidade User no formato username@domain.

Esta ação é executada na entidade User do Google SecOps.

Configure autorizações adicionais

A ação Forçar atualização da palavra-passe requer que configure adicionalmente a seguinte autorização da API para a aplicação:

  • User-PasswordProfile.ReadWrite.All

Para orientações sobre como configurar autorizações da API no Microsoft Entra ID, consulte a secção Configurar autorizações da API deste documento.

Atribua uma função à sua aplicação

A ação Forçar atualização da palavra-passe requer que atribua a função Password Administrator à sua aplicação.

Para atribuir a função Password Administrator à sua aplicação, conclua os seguintes passos:

  1. Inicie sessão no portal do Azure com a sua conta Microsoft.
  2. No Microsoft Entra ID, pesquise Funções e administradores.
  3. Selecione ou pesquise a função Password Administrator na lista.
  4. Clique em Adicionar trabalho.
  5. Selecione uma conta (membro) que usa na integração e clique em Seguinte.
  6. Introduza uma justificação para a atribuição de uma função.
  7. Clique em Atribuir.

Dados de ações

Nenhum.

Resultados da ação

A ação Forçar atualização da palavra-passe fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Não disponível
Tabela de enriquecimento Não disponível
Resultado JSON Não disponível
Mensagens de saída Disponível
Resultado do script Disponível
Mensagens de saída

A ação Forçar atualização da palavra-passe pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

Force password update on the user was successful.

Some errors occurred. Please check the logs.

 A ação foi bem-sucedida.
Attempt to Force user password update was not successful.

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte indica o valor do resultado do script quando usa a ação Forçar atualização da palavra-passe:

Nome do resultado do script Valor
is_success True ou False

Obtenha os detalhes de contacto do gestor

Use a ação Get Manager Contact Details para obter os detalhes de contacto do gestor do utilizador.

A ação Get Manager Contact Details espera que configure a entidade no formato username@domain.User

Esta ação é executada na entidade User do Google SecOps.

Dados de ações

Nenhum.

Resultados da ação

A ação Get Manager Contact Details fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Disponível
Tabela de enriquecimento de entidades Disponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Mesa de parede para caixas

A ação Get Manager Contact Details pode devolver a seguinte tabela no Google SecOps:

Nome da tabela: Contacto do gestor

Colunas:

  • Nome
  • Número de telefone
Tabela de enriquecimento de entidades

A ação Get Manager Contact Details suporta o seguinte enriquecimento de entidades:

Campo de enriquecimento Lógica
Display Name Devolve se existir no resultado JSON.
Mobile Phone Devolve se existir no resultado JSON.
@odata.context Devolve se existir no resultado JSON.
AAD_Job Title Devolve se existir no resultado JSON.
AAD_Username Devolve se existir no resultado JSON.
Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação Get Manager Contact Details:

[
    {
        "EntityResult":
        {
            "displayName": "manager@example.com",
            "mobilePhone": "(800) 555-0175",
            "@odata.context": "graph.microsoft.com"
        },
        "Entity": "user@example.com"
    }
]
Mensagens de saída

A ação Get Manager Contact Details pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

User manager details were fetched successfully.

Some errors occurred. Please check the logs.

 A ação foi bem-sucedida.
Could not fetch user manager's details successfully.

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte indica o valor do resultado do script quando usa a ação Get Manager Contact Details:

Nome do resultado do script Valor
is_success True ou False

Is User in Group

Use a ação O utilizador está no grupo para verificar se o utilizador é membro de um grupo específico do Microsoft Entra ID. Esta ação espera que configure a entidade User no formato username@domain.

Esta ação é executada na entidade User do Google SecOps.

Dados de ações

A ação O utilizador está no grupo requer os seguintes parâmetros:

Parâmetro Descrição
Group ID Obrigatório

O ID do grupo do Microsoft Entra ID ao qual adicionar o utilizador, como 00e40000-1971-439d-80fc-d0e000001dbd.

Resultados da ação

A ação O utilizador está no grupo fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Não disponível
Tabela de enriquecimento Não disponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação Is User in Group:

[
    {
        "EntityResult": "true",
        "Entity": "user@example.com"
    }
]
Mensagens de saída

A ação O utilizador está no grupo pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

The following user was found in the group: USER_ID.

Some errors occurred. Please check the logs.

 A ação foi bem-sucedida.
User was not found in the group.

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte indica o valor do resultado do script quando usa a ação Is User in Group:

Nome do resultado do script Valor
is_success True ou False

Listar grupos

Use a ação List Groups para listar grupos do Microsoft Entra ID através dos critérios de pesquisa especificados.

Para a ação List Groups, a filtragem funciona com o campo Name.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação List Groups requer os seguintes parâmetros:

Parâmetro Descrição
Order By Opcional

A ordem para ordenar os grupos devolvidos pelo respetivo nome.

O valor predefinido é ASC.

Os valores possíveis são os seguintes:

  • DESC
  • ASC
Results Limit Opcional

O número máximo de grupos a devolver.
Filter Logic Opcional

A lógica para filtrar grupos pelo respetivo nome.

O valor predefinido é Equal.

Os valores possíveis são os seguintes:

  • Equal
  • Contains
Filter Value Opcional

O valor para filtrar grupos através da lógica de filtro selecionada. Este valor aplica-se ao nome do grupo.

Se selecionar Equal, a ação tenta encontrar a correspondência exata entre os resultados. Se selecionar Contain, a ação tenta encontrar resultados que contenham a subcadeia de carateres fornecida.

Se não definir um valor, o filtro não é aplicado.

Resultados da ação

A ação List Groups fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Disponível
Tabela de enriquecimento de entidades Disponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Mesa de parede para caixas

A ação List Groups pode devolver a seguinte tabela no Google SecOps:

Nome da tabela: Grupos

Colunas:

  • Nome
  • ID
  • Descrição
  • Mail
  • Data de criação
  • Tipo de grupo
Tabela de enriquecimento de entidades

A ação List Groups suporta o seguinte enriquecimento de entidades:

Campo de enriquecimento Lógica
Group Type Devolve se existir no resultado JSON.
ID Devolve se existir no resultado JSON.
Name Devolve se existir no resultado JSON.
Description Devolve se existir no resultado JSON.
Created Time Devolve se existir no resultado JSON.
Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação List Groups:

[
    {
        "Group Type": "managed",
        "Id": "ID",
        "Name": "Example",
        "Description": "Example",
        "Created Time":"2019-10-24T19:10:18Z"
    }
]
Mensagens de saída

A ação List Groups pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

Groups list was fetched successfully.

Some errors occurred. Please check the logs.

 A ação foi bem-sucedida.
Groups list fetch was not successful.

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte indica o valor do resultado do script quando usa a ação List Groups:

Nome do resultado do script Valor
is_success True ou False

Listar membros no grupo

Use a ação Listar membros no grupo para listar os membros no grupo do Microsoft Entra ID especificado.

A lógica de filtragem funciona com base no valor do parâmetro Filter Key.

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação List Members in the Group requer os seguintes parâmetros:

Parâmetro Descrição
Max Records To Return Opcional

O número máximo de registos a devolver.

O valor predefinido é 50.
Group Name Opcional

O nome do grupo do Microsoft Entra ID para listar os membros.
Group ID Opcional

O ID do grupo do Microsoft Entra ID para listar os membros. Se configurar os parâmetros Group Name e Group ID, a ação usa o valor do parâmetro Group ID.
Filter Key Opcional

O campo pelo qual filtrar os membros do grupo, como User Display Name.

Os valores possíveis são os seguintes:

  • Select One
  • User Display Name
  • User Principal Name
  • User Mail Name
Filter Logic Opcional

A lógica a aplicar ao filtro.

Os valores possíveis são os seguintes:

  • Not Specified
  • Equal
  • Contains
Filter Value Opcional

O valor a usar para filtrar membros do grupo com base nos valores dos parâmetros Filter Key e Filter Logic selecionados.

Se selecionar Equal, a ação tenta encontrar a correspondência exata entre os resultados. Se selecionar Contain, a ação tenta encontrar resultados que contenham a subcadeia de carateres fornecida.

Se não definir um valor, o filtro não é aplicado.

Resultados da ação

A ação List Members in the Group (Listar membros no grupo) fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Disponível
Tabela de enriquecimento Não disponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Mesa de parede para caixas

A ação Listar membros no grupo pode devolver a seguinte tabela no Google SecOps:

Nome da tabela: Membros disponíveis do grupo

Colunas:

  • ID
  • Nome principal do utilizador
  • Nome a apresentar
  • Apelido
  • Nome próprio
  • Mail
  • Cargo
  • Telemóveis empresariais
  • Telemóvel
  • Localização do escritório
  • Idioma preferido
Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação List Members in the Group:

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(Edm.String)",
    "value": [
        "ID",
        "ID",
        "ID",
    ]
}
Mensagens de saída

A ação List Members in the Group pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

Successfully found members for the provided criteria in Azure AD group.

No members were found for the provided criteria in Azure AD group.

The filter was not applied, because parameter "Filter Value" has an empty value.

 A ação foi bem-sucedida.
Error executing action "List Members in the Group". Reason: ERROR_REASON

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte indica o valor do resultado do script quando usa a ação List Members in the Group (Listar membros no grupo):

Nome do resultado do script Valor
is_success True ou False

Listar a associação a grupos do utilizador

Use a ação List User's Groups Membership para listar os grupos do Microsoft Entra ID dos quais o utilizador é membro.

Pode fornecer o nome de utilizador como uma entidade ou um parâmetro de entrada de ação. Se configurar o nome de utilizador como a entidade e o parâmetro de entrada, a ação usa o parâmetro de entrada.

Para configurar o nome de utilizador, siga o formato username@domain.

Esta ação é executada na entidade Username do Google SecOps.

Dados de ações

A ação List User's Groups Membership requer os seguintes parâmetros:

Parâmetro Descrição
User Name Opcional

Uma lista de nomes de utilizador separados por vírgulas para os quais pretende obter as associações a grupos, como username@domain. Se não definir um valor, a ação usa os identificadores do utilizador da entidade Username.
Return Only Security Enabled Groups Opcional

Se estiver selecionada, a ação devolve apenas grupos com segurança ativada aos quais o utilizador pertence.

Não selecionado por predefinição.
Return Detailed Groups Information Opcional

Se estiver selecionada, a ação devolve informações detalhadas sobre os grupos do Microsoft Entra ID.

Não selecionado por predefinição.
Filter Key Opcional

A chave a usar para filtrar grupos.

O valor predefinido é Select One.

Os valores possíveis são os seguintes:

  • Select One
  • Group Display Name
  • Group Description
Filter Logic Opcional

A lógica a aplicar ao filtrar os grupos.

O valor predefinido é Not Specified.

Os valores possíveis são os seguintes:

  • Not Specified
  • Equal
  • Contains
Filter Value Opcional

O valor a usar para filtrar grupos.

Se selecionar Equal, a ação tenta encontrar a correspondência exata entre os resultados. Se selecionar Contain, a ação tenta encontrar resultados que contenham a subcadeia de carateres fornecida.

Se não definir um valor, o filtro não é aplicado.
Max Records To Return Opcional

O número máximo de registos a devolver. Se não definir um valor, a ação devolve 50 registos por predefinição.

Resultados da ação

A ação List User's Groups Membership fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Disponível
Tabela de enriquecimento Não disponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Mesa de parede para caixas

A ação List User's Groups Membership pode devolver a seguinte tabela no Google SecOps:

Nome da tabela: Apoios de grupos

Colunas:

  • ID
  • Nome a apresentar
  • Descrição
  • Segurança ativada
  • Identificador de segurança
  • Data/hora de criação
  • Classificação
  • Visibilidade
  • Mail
  • Correio ativado
  • Alcunha do email
Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação List User's Groups Membership:

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(Edm.String)",
    "value": [
        "ID",
        "ID",
        "ID",
    ]
}
Mensagens de saída

A ação List User's Groups Membership pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

Successfully found groups for the provided criteria for the following entities: ENTITY_ID

The following entities were not found in the Azure AD: ENTITY_ID

No groups were found in Azure Active Directory for the following entities: ENTITY_ID

The filter was not applied, because parameter "Filter Value" has an empty value.

 A ação foi bem-sucedida.
Error executing action "List User's Groups Membership". Reason: ERROR_REASON

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte indica o valor da saída do resultado do script quando usa a ação List User's Groups Membership (Listar a associação do utilizador a grupos):

Nome do resultado do script Valor
is_success True ou False

Listar utilizadores

Use a ação List Users para listar os utilizadores do Microsoft Entra ID através dos critérios de pesquisa especificados.

Para a ação Listar utilizadores, a filtragem funciona com o campo Username (userPrincipalName).

Esta ação não é executada em entidades do Google SecOps.

Dados de ações

A ação List Users requer os seguintes parâmetros:

Parâmetro Descrição
Filter Opcional

Os campos a incluir nos resultados.

O valor predefinido é All Fields.

Os valores possíveis são os seguintes:

  • All Fields
  • displayName
  • userPrincipalName
  • id
  • jobTitle
  • mail
  • mobilePhone
  • preferredLanguage
  • surname
  • givenName
Order By Field Opcional

O campo pelo qual os resultados devem ser ordenados.

O valor predefinido é displayName.

Os valores possíveis são os seguintes:

  • displayName
  • userPrincipalName
Order By Opcional

A ordem dos resultados (ascendente ou descendente).

O valor predefinido é ASC.

Os valores possíveis são os seguintes:

  • DESC
  • ASC
Results Limit Opcional

O número máximo de utilizadores a devolver.
Advanced Filter Logic Opcional

A lógica a usar para a filtragem avançada que se aplica ao campo Username (userPrincipalName).

O valor predefinido é Equal.

Os valores possíveis são os seguintes:

  • Equal
  • Contains
Advanced Filter Value Opcional

O valor a usar no filtro avançado para o campo Username (userPrincipalName).

Se selecionar Equal, a ação tenta encontrar a correspondência exata entre os resultados. Se selecionar Contain, a ação tenta encontrar resultados que contenham a subcadeia de carateres fornecida.

Se não definir um valor, o filtro não é aplicado.

Resultados da ação

A ação List Users (Listar utilizadores) fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Disponível
Tabela de enriquecimento de entidades Disponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Mesa de parede para caixas

A ação List Users pode devolver a seguinte tabela no Google SecOps:

Nome da tabela: Users

Colunas:

  • Nome
  • Nome de utilizador
  • ID
  • Nome próprio
  • Idioma preferido
  • Mail
  • Telemóvel
  • Apelido
  • Cargo
Tabela de enriquecimento de entidades

A ação List Users suporta o seguinte enriquecimento de entidades:

Campo de enriquecimento Lógica
Username Devolve se existir no resultado JSON.
Surname Devolve se existir no resultado JSON.
Name Devolve se existir no resultado JSON.
Job Title Devolve se existir no resultado JSON.
Mail Devolve se existir no resultado JSON.
Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação List Users:

[
    {
        "Group Type": "managed",
        "Id": "ID",
        "Name": "Example",
        "Description": "Example",
        "Created Time":"2019-10-24T19:10:18Z"
    }
]
Mensagens de saída

A ação List Users pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

List of users was fetched successfully.

Some errors occurred. Please check the logs.

 A ação foi bem-sucedida.
User list fetch was not successful.

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte apresenta o valor da saída do resultado do script quando usa a ação Listar utilizadores:

Nome do resultado do script Valor
is_success True ou False

Tchim-tchim

Use a ação Ping para testar a conetividade ao Microsoft Entra ID.

Esta ação é executada em todas as entidades do Google SecOps.

Dados de ações

Nenhum.

Resultados da ação

A ação Ping fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Não disponível
Tabela de enriquecimento Não disponível
Resultado JSON Não disponível
Mensagens de saída Disponível
Resultado do script Disponível
Mensagens de saída

A ação Ping pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

Connection established successfully.

 A ação foi bem-sucedida.
Connection could not be established successfully.

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Ping:

Nome do resultado do script Valor
is_success True ou False

Remova o utilizador do grupo

Use a ação Remover utilizador do grupo para remover um utilizador do grupo especificado no Microsoft Entra ID.

Pode fornecer o nome de utilizador como uma entidade ou um parâmetro de entrada de ação. Se configurar o nome de utilizador como a entidade e o parâmetro de entrada, a ação usa o parâmetro de entrada.

Para configurar o nome de utilizador, siga o formato username@domain.

Esta ação é executada na entidade Username do Google SecOps.

Dados de ações

A ação Remover utilizador do grupo requer os seguintes parâmetros:

Parâmetro Descrição
User Name Opcional

Uma string de nomes de utilizador separados por vírgulas a remover do grupo especificado. Para configurar o valor deste parâmetro, use o formato username@domain.

Se não definir um valor, a ação é executada nos nomes de utilizador das entidades de utilizador de um incidente de ação.
Group Name Opcional

O nome do grupo do qual quer remover o utilizador.
Group ID Opcional

O ID do grupo do qual o utilizador vai ser removido.

Se definir os parâmetros Group Name e Group ID, a ação dá prioridade ao valor Group ID.

Resultados da ação

A ação Remover utilizador do grupo fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Não disponível
Tabela de enriquecimento Não disponível
Resultado JSON Não disponível
Mensagens de saída Disponível
Resultado do script Disponível
Mensagens de saída

A ação Remover utilizador do grupo pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

Successfully removed the following entities from the Azure AD group: ENTITY_ID

The following entities were not found in the Azure AD: ENTITY_ID

No usernames were removed from the Azure AD group.

 A ação foi bem-sucedida.
Error executing action "Remove User from the Group". Reason: ERROR_REASON

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte indica o valor da saída do resultado do script quando usa a ação Remover utilizador do grupo:

Nome do resultado do script Valor
is_success True ou False

Reposição da palavra-passe do utilizador

Use a ação Repor palavra-passe do utilizador para repor a palavra-passe do utilizador para a que especificar na ação. Esta ação exige que o utilizador altere a respetiva palavra-passe na próxima tentativa de início de sessão.

A ação Repor palavra-passe do utilizador espera que configure a entidade User no formato username@domain.

Esta ação é executada na entidade User do Google SecOps.

Atribua uma função à sua aplicação

A ação Repor palavra-passe do utilizador requer que atribua a função Password Administrator à sua aplicação.

Para atribuir a função Password Administrator à sua aplicação, conclua os seguintes passos:

  1. Inicie sessão no portal do Azure com a sua conta Microsoft.
  2. No Microsoft Entra ID, pesquise Funções e administradores.
  3. Selecione ou pesquise a função Password Administrator na lista.
  4. Clique em Adicionar trabalho.
  5. Selecione uma conta (membro) que usa na integração e clique em Seguinte.
  6. Introduza uma justificação para a atribuição de uma função.
  7. Clique em Atribuir.

Dados de ações

A ação Repor palavra-passe do utilizador requer os seguintes parâmetros:

Parâmetro Descrição
Password Obrigatório

A nova palavra-passe a definir para o utilizador.

Resultados da ação

A ação Repor palavra-passe do utilizador fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Não disponível
Tabela de enriquecimento Não disponível
Resultado JSON Não disponível
Mensagens de saída Disponível
Resultado do script Disponível
Mensagens de saída

A ação Repor palavra-passe do utilizador pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

User password was reset successfully.

Some errors occurred. Please check the logs.

 A ação foi bem-sucedida.
User password reset was not successful.

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte indica o valor do resultado do script quando usa a ação Repor palavra-passe do utilizador:

Nome do resultado do script Valor
is_success True ou False

Revogue a sessão do utilizador

Use a ação Revogar sessão de utilizador para revogar uma sessão de utilizador.

Esta ação é executada nas seguintes entidades do Google SecOps:

  • Username
  • Email Address

Dados de ações

Nenhum.

Resultados da ação

A ação Revogar sessão do utilizador fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Não disponível
Tabela de enriquecimento Não disponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Resultado JSON

Os exemplos seguintes mostram as saídas de resultados JSON recebidas quando usa a ação Revoke User Session:

  • Se o utilizador existir:

    {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Edm.Boolean",
    "value": true
}

  • Se o utilizador não for encontrado:

    {
    "error": "User not found."
}
Mensagens de saída

A ação Revoke User Session pode devolver as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

Successfully revoked sessions for the following users in Azure AD: ENTITY_ID

Action wasn't able to find the following users in Azure AD: ENTITY_ID

None of the provided users were found in Azure AD.

 A ação foi bem-sucedida.
Error executing action "Revoke User Session". Reason: ERROR_REASON

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte indica o valor da saída do resultado do script quando usa a ação Revogar sessão do utilizador:

Nome do resultado do script Valor
is_success True ou False

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais da Google SecOps.