Coletar registros do OpenText Access Manager (antigo NetIQ Access Manager)
Neste documento, explicamos como ingerir registros do OpenText Access Manager (antigo NetIQ Access Manager) no Google Security Operations usando o Bindplane.
O OpenText Access Manager é uma solução de gerenciamento de identidade e acesso no local que oferece logon único (SSO), autenticação multifator, federação e controle de acesso baseado em políticas para aplicativos e serviços da Web. Ele atua como um gateway seguro entre usuários e recursos protegidos, aplicando políticas de autenticação e autorização em ambientes corporativos.
Antes de começar
Verifique se você tem os pré-requisitos a seguir:
- Uma instância do Google SecOps.
- Um host que executa o Windows 2016 ou mais recente ou um host Linux com
systemd. - Conectividade de rede: se estiver em execução atrás de um proxy, verifique se as portas do firewall estão abertas de acordo com os requisitos do agente do BindPlane.
- Acesso privilegiado ao console de administração do OpenText Access Manager.
Receber credenciais do Google SecOps para o agente do Bindplane
Para autenticar o agente do Bindplane no Google SecOps, escolha um dos seguintes métodos:
- Novas implantações: use a API Chronicle (opção 1).
- Implantações legadas: continue usando o arquivo de autenticação de ingestão (opção 2) até que a API Ingestion seja desativada em 20 de julho de 2027.
Opção 1: criar uma conta de serviço para a API Chronicle (recomendado)
- Faça login no console doGoogle Cloud e selecione o projeto do Google Cloud vinculado à sua instância do Google SecOps.
- Acesse IAM e administrador > Contas de serviço.
- Clique em Criar conta de serviço.
- Informe os seguintes detalhes de configuração:
- Nome da conta de serviço: insira um nome para a conta (por exemplo,
bindplane-ingest). - Descrição da conta de serviço: insira uma descrição (por exemplo,
Bindplane agent log ingestion).
- Nome da conta de serviço: insira um nome para a conta (por exemplo,
- Clique em Criar e continuar.
- Na seção Conceder a essa conta de serviço acesso ao projeto, clique em Selecionar um papel e escolha Editor do Chronicle.
- Clique em Continuar e depois em Concluído.
- Clique na conta de serviço que você criou e acesse a guia Chaves.
- Clique em Adicionar chave > Criar nova chave.
- Selecione JSON e clique em Criar. O download do arquivo de chave é feito no seu computador.
- Salve o arquivo de chave como
ingestion-auth.jsonno diretório do coletor do BindPlane (/opt/observiq-otel-collector/ingestion-auth.jsonno Linux ouC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonno Windows) ou atualizecreds_file_pathemconfig.yamlpara corresponder ao caminho em que você o salvou. - Acesse IAM e administrador > Configurações e copie o Número do projeto. Você vai precisar dele para configurar o exportador.
Opção 2: fazer o download do arquivo de autenticação de ingestão (legado)
- Faça login no console do Google SecOps.
- Acesse Configurações > Gerenciamento de dados > Agentes de coleta. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Agentes de coleta.
- Faça o download do arquivo de autenticação de ingestão.
- Salve o arquivo com segurança no sistema em que o agente do Bindplane será instalado.
Receber o ID de cliente do Google SecOps
- Faça login no console do Google SecOps.
- Acesse Configurações > Administração > Perfil. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Perfil.
- Copie e salve o ID de cliente na seção Detalhes da organização.
Instalar o agente do BindPlane
Instale o agente do Bindplane no seu sistema operacional Windows ou Linux de acordo com as instruções a seguir.
Instalação do Windows
- Abra o Prompt de comando ou o PowerShell como administrador.
Execute este comando:
msiexec /i "[https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi](https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi)" /quiet
Instalação do Linux
- Abra um terminal com privilégios de raiz ou sudo.
Execute este comando:
sudo sh -c "$(curl -fsSlL [https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh](https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh))" install_unix.sh
Outros recursos de instalação
Para mais opções de instalação, consulte este guia de instalação.
Configurar o agente do Bindplane para ingerir o Syslog e enviar ao Google SecOps
Acesse o arquivo de configuração:
- Localize o arquivo
config.yaml. Normalmente, ele fica no diretório/opt/observiq-otel-collectorno Linux ou no diretório de instalação no Windows. - Abra o arquivo usando um editor de texto (por exemplo,
nano,viou Bloco de Notas).
- Localize o arquivo
Edite o arquivo
config.yamlda seguinte forma:receivers: tcplog: listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: protocol: https # Region of your instance, for example us, europe, asia-southeast1 location: <LOCATION> # Project number of the Google Cloud project linked to the instance project: '<PROJECT_NUMBER>' compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: '<customer_id>' endpoint: chronicle.googleapis.com log_type: NETIQ_ACCESS_MANAGER raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - tcplog exporters: - chronicle/chronicle_w_labels
- Substitua a porta e o endereço IP conforme necessário na sua infraestrutura.
- Substitua
<LOCATION>pela região da sua instância do Google SecOps (por exemplo,us,europeouasia-southeast1). O exportador prefixachronicle.googleapis.comcom esse valor. - Substitua
<PROJECT_NUMBER>pelo número do projeto em IAM e administrador > Configurações. - Substitua
<customer_id>pelo ID de cliente real. - Atualize
/path/to/ingestion-authentication-file.jsonpara o caminho do arquivo em que o arquivo de chave da conta de serviço (Opção 1) foi salvo nas etapas anteriores.
Exportador da API de ingestão legada
Se você usar o arquivo de autenticação de ingestão da Opção 2, substitua o bloco
exporterspelo seguinte. Definacreds_file_pathcomo o caminho para o arquivo de autenticação de ingestão e, se a instância estiver fora dos EUA, substituamalachiteingestion-pa.googleapis.compelo endpoint regional (por exemplo,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/chronicle_w_labels: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: NETIQ_ACCESS_MANAGER raw_log_field: body ingestion_labels:
Reinicie o agente do BindPlane para aplicar as mudanças:
Para reiniciar o agente do Bindplane no Linux, execute o seguinte comando:
sudo systemctl restart observiq-otel-collectorPara reiniciar o agente do Bindplane no Windows, use o console Serviços ou digite o seguinte comando:
net stop observiq-otel-collector && net start observiq-otel-collector
Configurar o encaminhamento de syslog do OpenText Access Manager
- Faça login no console de administração do OpenText Access Manager.
- Acesse Auditoria > Syslog.
- Marque a caixa de seleção Ativar Syslog.
- Informe os seguintes detalhes de configuração:
- Endereço do servidor Syslog: insira o endereço IP do host do agente do BindPlane.
- Porta: insira
514. - Recurso: selecione o recurso de syslog apropriado (por exemplo, LOCAL0).
- Na seção Eventos de auditoria, selecione as categorias de eventos que serão encaminhadas:
- Eventos de autenticação
- Eventos de autorização
- Eventos de administração
- Eventos do sistema
- Clique em Aplicar para salvar a configuração do syslog.
Tabela de mapeamento de UDM
| Campo de registro | Mapeamento de UDM | Lógica |
|---|---|---|
version |
about.resource.attribute.labels |
Mesclado |
_field |
additional.fields |
Mesclado |
I |
extensions.auth.type |
Mapeado: "002E0505","002E001E","002E0046" → AUTHTYPE_UNSPECIFIED, "002E0007","002E000C"... |
host_name |
intermediary.hostname |
Mapeado diretamente |
D |
metadata.description |
Mapeado diretamente |
stringValue3 |
metadata.description |
Mapeado diretamente |
timestamp |
metadata.event_timestamp |
Analisado como RFC 3339 |
I |
metadata.event_type |
Mapeado: "002E0505","002E001E","002E0046" → USER_LOGIN, 002E0525 → `NETWORK_UNCATEGORIZ... |
has_principal |
metadata.event_type |
Mapeado: true → NETWORK_CONNECTION, true → STATUS_UPDATE |
has_user |
metadata.event_type |
Mapeado: true → USER_UNCATEGORIZED |
id_sub_event |
metadata.product_event_type |
Mapeado diretamente |
I |
metadata.product_log_id |
Mapeado diretamente |
eventId |
metadata.product_log_id |
Mapeado diretamente |
event_id |
metadata.product_log_id |
Mapeado diretamente |
product |
metadata.product_name |
Mapeado diretamente |
product_version |
metadata.product_version |
Mapeado diretamente |
vendor |
metadata.vendor_name |
Mapeado diretamente |
T |
network.http.user_agent |
Mapeado diretamente |
L |
network.session_id |
Mapeado diretamente |
subTarget |
network.session_id |
Mapeado diretamente |
F |
principal.application |
Mapeado diretamente |
appName |
principal.application |
Mapeado diretamente |
host |
principal.asset.hostname |
Mapeado diretamente |
host_name |
principal.asset.hostname |
Mapeado diretamente |
originator |
principal.asset.hostname |
Mapeado diretamente |
src_ip |
principal.asset.ip |
Mesclado |
host |
principal.hostname |
Mapeado diretamente |
host_name |
principal.hostname |
Mapeado diretamente |
originator |
principal.hostname |
Mapeado diretamente |
src_ip |
principal.ip |
Mesclado |
stringValue1 |
principal.user.userid |
Mapeado diretamente |
I |
security_result.action |
Mapeado: "002E0505","002E001E","002E0046" → security_action, 002E0525 → `security_actio... |
security_action |
security_result.action |
Mesclado |
name |
security_result.action_details |
Mapeado diretamente |
g_label |
security_result.detection_fields |
Mesclado |
h_label |
security_result.detection_fields |
Mesclado |
impersonatee_session_id_label |
security_result.detection_fields |
Mesclado |
m_label |
security_result.detection_fields |
Mesclado |
v_label |
security_result.detection_fields |
Mesclado |
priority |
security_result.priority_details |
Mapeado diretamente |
A |
security_result.rule_id |
Mapeado diretamente |
severity |
security_result.severity_details |
Valores mapeados (5 no total, por exemplo, 1 → TRACE, 2 → DEBUG, 4 → INFO) |
result |
security_result.summary |
Mapeado diretamente |
process_name |
target.application |
Mapeado diretamente |
dst_ip |
target.asset.ip |
Mesclado |
dst_ip |
target.ip |
Mesclado |
B |
target.resource.id |
Mapeado diretamente |
O |
target.resource.name |
Mapeado diretamente |
Y |
target.url |
Mapeado diretamente |
_group_identifier |
target.user.group_identifiers |
Mesclado |
U |
target.user.userid |
Mapeado diretamente |
device_name |
target.user.userid |
Mapeado diretamente |
| N/A | extensions.auth.type |
Constante: AUTHTYPE_UNSPECIFIED |
| N/A | metadata.event_type |
Constante: USER_LOGIN |
| N/A | metadata.product_name |
Constante: Netiq_Access_Manager |
| N/A | metadata.vendor_name |
Constante: Netiq |
| N/A | security_result.severity_details |
Constante: TRACE |
"2" |
event.idm.read_only_udm.additional.fields |
Mapeado do registro de alterações |
"3" |
event.idm.read_only_udm.additional.fields |
Mapeado do registro de alterações |
"host_name" |
event.idm.read_only_udm.intermediary.hostname |
Mapeado do registro de alterações |
1 |
event.idm.read_only_udm.additional.fields |
Mapeado do registro de alterações |
stringValue2 |
event.idm.read_only_udm.security_result.detection_fields |
Mapeado do registro de alterações |
eventId |
event.idm.read_only_udm.metadata.product_log_id |
Mapeado do registro de alterações |
subTarget |
event.idm.read_only_udm.network.session_id |
Mapeado do registro de alterações |
stringValue1 |
event.idm.read_only_udm.principal.user.userid |
Mapeado do registro de alterações |
stringValue3 |
event.idm.read_only_udm.metadata.description |
Mapeado do registro de alterações |
originator |
event.idm.read_only_udm.principal.asset.hostname |
Mapeado do registro de alterações |
originator |
event.idm.read_only_udm.principal.hostname |
Mapeado do registro de alterações |
G","H","M" and "V |
security_result.detection_fields |
Mapeado do registro de alterações |
L |
event.idm.read_only_udm.network.session_id |
Mapeado do registro de alterações |
T |
event.idm.read_only_udm.network.http.user_agent |
Mapeado do registro de alterações |
Registro de alterações
Confira o registro de alterações deste analisador
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.