O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Integrar o Axonius ao Google SecOps

Neste documento, descrevemos como integrar o Axonius ao Google Security Operations (Google SecOps).

Casos de uso

Realizar ações de enriquecimento.

Parâmetros de integração

Use os seguintes parâmetros para configurar a integração:

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Raiz da API	String	https://{root}	Sim	Raiz da API Axonius
Chave de API	String	N/A	Sim	Chave de API do Axonius
Chave secreta da API	Senha	N/A	Sim	Chave secreta da API Axonius
Verificar SSL	Caixa de seleção	Selecionado	Sim	Se selecionada, a integração valida o certificado SSL ao se conectar ao servidor Axonius.

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

Se necessário, você pode fazer mudanças depois. Depois de configurar uma instância de integração, é possível usá-la em playbooks. Para mais informações sobre como configurar e oferecer suporte a várias instâncias, consulte Como oferecer suporte a várias instâncias.

Ações

Para mais informações sobre ações, consulte Responder a ações pendentes na sua mesa de trabalho e Executar uma ação manual no seu caso.

Ping

Teste a conectividade com o Axonius.

Corrida

A ação não é executada em entidades nem tem parâmetros de entrada obrigatórios.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor
is_success	is_success=False
is_success	is_success=True

Painel de casos

Tipo de resultado	Valor / Descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se for bem-sucedido: "Conexão com o servidor Axonius estabelecida com os parâmetros fornecidos!" A ação deve falhar e interromper a execução de um playbook: Se não for bem-sucedida: "Falha ao se conectar ao servidor do Axonius! O erro é {0}".format(exception.stacktrace)	Geral

Tipo de resultado

Valor / Descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se for bem-sucedido: "Conexão com o servidor Axonius estabelecida com os parâmetros fornecidos!"

A ação deve falhar e interromper a execução de um playbook:

Se não for bem-sucedida: "Falha ao se conectar ao servidor do Axonius! O erro é {0}".format(exception.stacktrace)

Geral

Enriquecer entidades

Enriqueça entidades usando informações do Axonius. As entidades compatíveis incluem nome do host, endereço IP, endereço MAC, usuário e endereços de e-mail (entidades de usuário que correspondem à expressão regular de e-mail).

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Criar insight de endpoint	Caixa de seleção	Verdadeiro	Não	Se ativada, a ação vai criar um insight com informações sobre os endpoints.
Criar insight do usuário	Caixa de seleção	Verdadeiro	Não	Se ativada, a ação vai criar um insight com informações sobre o usuário.
Número máximo de notas a serem retornadas	Inteiro	50	Não	Especifique quantas notas serão mostradas na tabela do mural de casos.

Corrida

Essa ação é executada nas seguintes entidades:

Nome do host
Endereço IP
Endereço MAC
Usuário
E-mail

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor
is_success	is_success=False
is_success	is_success=True

Resultado JSON para o endpoint:

{
    "adapters": [
        {
            "accurate_for_datetime": "Sun, 21 Mar 2021 03:44:19 GMT",
            "client_used": "DOMAIN\\axoniusSvc",
            "raw": {
                "ad_distinguished_name": "CN=DESKTOP-ID,OU=Computers,DC=demo,DC=local",
                "ad_object_class": [
                    "top",
                    "person",
                    "organizationalperson",
                    "user",
                    "computer"
                ],
                "ad_sAMAccountName": "",
                "ad_site_location": "Richmond",
                "ad_site_name": "",
                "device_disabled": false,
                "device_managed_by": "Example User",
                "domain": "example.example",
                "hostname": "HOSTNAME",
                "id": "CN=ID,OU=Computers,DC=demo,DC=local",
                "last_seen": "Tue, 16 Mar 2021 19:44:05 GMT",
                "name": "NAME",
                "network_interfaces": [
                    {
                        "ips": [
                            "IP"
                        ],
                        "ips_raw": [
                            "IP_RAW"
                        ],
                        "ips_v4": [
                            "IP_V4"
                        ],
                        "ips_v4_raw": [
                            "IP_V4_RAW"
                        ]
                    }
                ],
                "os": {
                    "bitness": 64,
                    "distribution": "10",
                    "is_windows_server": false,
                    "os_str": "windows 10 pro 64-bit",
                    "type": "Windows",
                    "type_distribution": "Windows 10"
                },
                "part_of_domain": true
            },
            "plugin_name": "",
            "plugin_type": "Adapter",
            "plugin_unique_name": "",
            "quick_id": "active_directory_adapter_0!CN=ID,OU=OU,DC=DOMAIN,DC=DOMAIN",
            "type": "entitydata"
        },
        {
            "accurate_for_datetime": "Sun, 21 Mar 2021 03:43:52 GMT",
            "client_used": "https://DOMAIN",
            "raw": {
                "hostname": "HOSTNAME",
                "id": "ID",
                "last_seen": "Sun, 21 Mar 2021 01:50:28 GMT",
                "name": "NAME",
                "network_id": "NETWORK_ID",
                "network_interfaces": [
                    {
                        "ips": [
                            "IP"
                        ],
                        "ips_raw": [
                            "IP_RAW"
                        ],
                        "ips_v4": [
                            "IP_V4"
                        ],
                        "ips_v4_raw": [
                            "IP_V4_RAW"
                        ],
                        "mac": "01:23:45:AB:CD:EF",
                        "manufacturer": "(Intel Corporate)"
                    }
                ]
            },
            "plugin_name": "Example",
            "plugin_type": "Adapter",
            "plugin_unique_name": "Example",
            "quick_id": "ID",
            "type": "entitydata"
        }
    ],
"Notes": [],
    "internal_axon_id": "",
    "labels": []
}

Resultado em JSON para usuários:

{
    "adapters": [
        {
            "accurate_for_datetime": "Sun, 21 Mar 2021 03:45:01 GMT",
            "client_used": "DOMAIN\\axoniusSvc",
            "raw": {
                "account_disabled": false,
                "ad_display_name": "",
                "ad_distinguished_name": "CN=example, DC=example",
                "ad_sid": "S-1-5-21-70119-3234025",
                "ad_uac_dont_expire_password": false,
                "ad_uac_password_not_required": false,
                "display_name": "",
                "domain": "example.example",
                "employee_id": "ID",
                "first_name": "Example",
                "id": "CN=example, DC=example",
                "is_admin": false,
                "is_local": false,
                "is_locked": false,
                "last_name": "Example",
                "last_password_change": "Wed, 17 Mar 2021 09:12:11 GMT",
                "last_seen": "Thu, 18 Mar 2021 09:25:08 GMT",
                "mail": "email@example.com",
                "password_never_expires": false,
                "password_not_required": false,
                "user_city": "Boston",
                "user_telephone_number": "(800) 555-0175",
                "username": "user@example.com"
            },
            "user_city": "Boston",
            "user_telephone_number": "(800) 555-0175",
            "username": "user@example.com",
            "plugin_name": "active_directory_adapter",
            "plugin_type": "Adapter",
            "plugin_unique_name": "active_directory_adapter_0",
            "quick_id": "active_directory_adapter_0!CN=example,DC=example",
            "type": "entitydata"
        }
    ],
"Notes": [],
    "internal_axon_id": "",
    "labels": []
}

Enriquecimento de entidades para endpoints:

Nome do campo de enriquecimento	Lógica: quando aplicar
object_classes	Quando disponível em JSON
site_name	Quando disponível em JSON
device_disabled	Quando disponível em JSON
device_managed_by	Quando disponível em JSON
nome do host	Quando disponível em JSON
ad_distinguished_name	Quando disponível em JSON
asset_name	Quando disponível em JSON
IPs	Quando disponível em JSON
os	Quando disponível em JSON
ID	Quando disponível em JSON
link	Quando disponível em JSON

Enriquecimento de entidades para usuários:

Nome do campo de enriquecimento	Lógica: quando aplicar
account_disabled	Quando disponível em JSON
ad_display_name	Quando disponível em JSON
ad_distinguished_name	Quando disponível em JSON
ad_sid	Quando disponível em JSON
employee_id	Quando disponível em JSON
is_admin	Quando disponível em JSON
is_local	Quando disponível em JSON
is_locked	Quando disponível em JSON
carta	Quando disponível em JSON
user_telephone_number	Quando disponível em JSON
ID	Quando disponível em JSON
link	Quando disponível em JSON

Painel de casos

Tipo de resultado	Valor/Descrição	Tipo (entidade \ geral)
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se enriquecido some(is_success = true): "Successfully enriched the following entities using Axonius:\n".format(entity.identifier) Se não tiver enriquecido algumas (is_success = true): "A ação não conseguiu enriquecer as seguintes entidades usando o Axonius:\n".format(entity.identifier) Se não tiver enriquecido todas (is_success = false): "Nenhuma entidade foi enriquecida". A ação deve falhar e interromper a execução de um playbook: Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Enriquecer entidades'. Motivo: {0}''.format(error.Stacktrace)	Geral
Tabela de entidades		Entidade
Tabela do painel de casos (se os atributos/dados/lista de dados tiverem valores)	Nome: {entity.identifier}: Observações Coluna: Nome de usuário Observação Hora	Geral

Tipo de resultado

Valor/Descrição

Tipo (entidade \ geral)

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se enriquecido some(is_success = true): "Successfully enriched the following entities using Axonius:\n".format(entity.identifier)

Se não tiver enriquecido algumas (is_success = true): "A ação não conseguiu enriquecer as seguintes entidades usando o Axonius:\n".format(entity.identifier)

Se não tiver enriquecido todas (is_success = false): "Nenhuma entidade foi enriquecida".

A ação deve falhar e interromper a execução de um playbook:

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Enriquecer entidades'. Motivo: {0}''.format(error.Stacktrace)

Geral

Tabela de entidades

Entidade

Tabela do painel de casos

(se os atributos/dados/lista de dados tiverem valores)

Nome: {entity.identifier}: Observações

Coluna:

Nome de usuário
Observação
Hora

Geral

Adicionar nota

Adicione uma observação às entidades no Axonius. As entidades compatíveis incluem nome do host, endereço IP, endereço MAC, usuário e endereços de e-mail (entidades de usuário que correspondem à expressão regular de e-mail).

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Observação	String	N/A	Sim	Especifique qual nota precisa ser adicionada.

Corrida

Essa ação é executada nas seguintes entidades:

Nome do host
Endereço IP
Endereço MAC
Usuário
Endereço de e-mail

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor
is_success	is_success=False
is_success	is_success=True

Resultado do JSON

{
    "data": {
        "attributes": {
            "accurate_for_datetime": "2021-03-21T15:55:10.876568+00:00",
            "note": "example",
            "user_id": "",
            "user_name": "internal/apiNAME",
            "uuid": ""
        },
        "type": "notes_details_schema"
    }
}

Painel de casos

Tipo de resultado	Valor/Descrição	Tipo (entidade \ geral)
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se pelo menos uma for bem-sucedida(is_success = true): "Successfully added note to the following entities in Axonius: {0}".format(entities) Se pelo menos uma falhar(is_success = true): "Action wasn't able to add a note to the following entities in Axonius: {0}".format(entities) Se falhar para todos (is_success = false): "A nota não foi adicionada às entidades fornecidas". A ação deve falhar e interromper a execução de um playbook: Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: "Erro ao executar a ação 'Adicionar nota'. Motivo: {0}''.format(error.Stacktrace)	Geral

Tipo de resultado

Valor/Descrição

Tipo (entidade \ geral)

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se pelo menos uma for bem-sucedida(is_success = true): "Successfully added note to the following entities in Axonius: {0}".format(entities)

Se pelo menos uma falhar(is_success = true): "Action wasn't able to add a note to the following entities in Axonius: {0}".format(entities)

Se falhar para todos (is_success = false): "A nota não foi adicionada às entidades fornecidas".

A ação deve falhar e interromper a execução de um playbook:

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: "Erro ao executar a ação 'Adicionar nota'. Motivo: {0}''.format(error.Stacktrace)

Geral

Adicionar tags

Adicione tags a entidades no Axonius. Entidades compatíveis: nome do host, IP, endereço MAC, usuário, endereços de e-mail (entidades de usuário que correspondem ao regex de e-mail).

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Tags	CSV		Sim	Especifique uma lista separada por vírgulas de tags que precisam ser adicionadas às entidades.

Corrida

Essa ação é executada nas seguintes entidades:

Nome do host
Endereço IP
Endereço MAC
Usuário
Endereço de e-mail

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor
is_success	is_success=False
is_success	is_success=True

Painel de casos

Tipo de resultado	Valor/Descrição	Tipo (entidade \ geral)
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se pelo menos uma for bem-sucedida(is_success = true): "Successfully added tags to the following entities in Axonius: {0}".format(entities) Se houver falha em pelo menos uma(is_success = true): "Action wasn't able to add tags to the following entities in Axonius: {0}".format(entities) Se falhar para todos (is_success = false): "As tags não foram adicionadas às entidades fornecidas". A ação deve falhar e interromper a execução de um playbook: Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Adicionar tags'. Motivo: {0}''.format(error.Stacktrace)	Geral

Tipo de resultado

Valor/Descrição

Tipo (entidade \ geral)

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se pelo menos uma for bem-sucedida(is_success = true): "Successfully added tags to the following entities in Axonius: {0}".format(entities)

Se houver falha em pelo menos uma(is_success = true): "Action wasn't able to add tags to the following entities in Axonius: {0}".format(entities)

Se falhar para todos (is_success = false): "As tags não foram adicionadas às entidades fornecidas".

A ação deve falhar e interromper a execução de um playbook:

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Adicionar tags'. Motivo: {0}''.format(error.Stacktrace)

Geral

Remover tags

Remova tags de entidades no Axonius. Entidades compatíveis: nome do host, IP, endereço MAC, usuário, endereços de e-mail (entidades de usuário que correspondem ao regex de e-mail).

Parâmetros

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Tags	CSV		Sim	Especifique uma lista separada por vírgulas de tags que precisam ser removidas das entidades.

Corrida

Essa ação é executada nas seguintes entidades:

Nome do host
Endereço IP
Endereço MAC
Usuário
Endereço de e-mail

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor
is_success	is_success=False
is_success	is_success=True

Painel de casos

Tipo de resultado	Valor/Descrição	Tipo (entidade \ geral)
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se pelo menos uma for bem-sucedida(is_success = true): "Successfully removed tags from the following entities in Axonius: {0}".format(entities) Se houver falha em pelo menos uma(is_success = true): "Action wasn't able to remove tags from the following entities in Axonius: {0}".format(entities) Se falhar para todas (is_success = false): "As tags não foram removidas das entidades fornecidas". A ação deve falhar e interromper a execução de um playbook: Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Remover tags'. Motivo: {0}''.format(error.Stacktrace)	Geral

Tipo de resultado

Valor/Descrição

Tipo (entidade \ geral)

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se pelo menos uma for bem-sucedida(is_success = true): "Successfully removed tags from the following entities in Axonius: {0}".format(entities)

Se houver falha em pelo menos uma(is_success = true): "Action wasn't able to remove tags from the following entities in Axonius: {0}".format(entities)

Se falhar para todas (is_success = false): "As tags não foram removidas das entidades fornecidas".

A ação deve falhar e interromper a execução de um playbook:

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for relatado: "Erro ao executar a ação 'Remover tags'. Motivo: {0}''.format(error.Stacktrace)

Geral

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