Coletar registros do Akamai Enterprise Application Access
Versão do analisador: 3.0
Neste documento, explicamos como ingerir registros do Akamai Enterprise Application Access (EAA) no Google Security Operations usando o Akamai Unified Log Streamer (ULS) e o Bindplane. O Akamai EAA é uma solução de acesso à rede de confiança zero que fornece acesso seguro e com reconhecimento de identidade a aplicativos corporativos sem uma VPN tradicional. O EAA produz dados operacionais na forma de registros de acesso, registros de auditoria de administrador, métricas de integridade do conector, inventário de dispositivos e informações de integridade do diretório. O analisador extrai campos dos registros JSON, realiza transformações de dados, como conversões de strings e extração de endereços IP, e mapeia esses campos para o UDM, processando vários tipos de eventos, incluindo NETWORK_HTTP e USER_UNCATEGORIZED, com base na presença de campos específicos.
Antes de começar
Verifique se você tem os pré-requisitos a seguir:
- Uma instância do Google SecOps.
- Um host do Windows Server 2016 ou posterior ou do Linux com
systemdpara executar o agente do Bindplane. - Host Linux com Python 3.9 ou posterior ou um ambiente conteinerizado (Docker ou Kubernetes) para executar o Unified Log Streamer.
- 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.
- Locatário do Akamai EAA com acesso administrativo.
Credenciais da API Akamai:
- Para feeds de auditoria de acesso e administração: chave de API e secret legados do EAA (criados no Enterprise Center).
- Para feeds de integridade do conector, inventário de dispositivos e integridade do diretório: credenciais da API OPEN da Akamai (autenticação EdgeGrid) com acesso de leitura e gravação à API Enterprise Application Access.
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" /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)" install_unix.sh
Outros recursos de instalação
Para mais opções de instalação, consulte o guia de instalação do agente do BindPlane.
Configurar o agente do Bindplane para ingerir registros e enviá-los ao Google SecOps
Abra o arquivo de configuração do agente do Bindplane em um editor de texto:
Linux:
sudo nano /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"Edite o arquivo
config.yamlda seguinte forma:receivers: tcplog: listen_address: "0.0.0.0:5140" exporters: chronicle/akamai_eaa: 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 creds_file_path: '/path/to/ingestion-authentication-file.json' customer_id: '<CUSTOMER_ID>' endpoint: chronicle.googleapis.com log_type: 'AKAMAI_EAA' raw_log_field: body ingestion_labels: source: akamai_eaa service: pipelines: logs/akamai_eaa: receivers: - tcplog exporters: - chronicle/akamai_eaa
Substitua:
/path/to/ingestion-authentication-file.json: o caminho completo para o arquivo de chave JSON da conta de serviço (opção 1).- Linux:
/opt/observiq-otel-collector/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
- 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. <CUSTOMER_ID>: o ID de cliente do Google SecOps.0.0.0.0:5140: o endereço IP e a porta para o Bindplane detectar. Ajuste conforme necessário para seu ambiente.
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/akamai_eaa: compression: gzip creds_file_path: '/path/to/ingestion-authentication-file.json' customer_id: '<CUSTOMER_ID>' endpoint: malachiteingestion-pa.googleapis.com log_type: 'AKAMAI_EAA' raw_log_field: body ingestion_labels: source: akamai_eaa
Reinicie o agente do BindPlane para aplicar as mudanças:
Para reiniciar o agente do BindPlane no Linux:
Execute este comando:
sudo systemctl restart observiq-otel-collectorVerifique se o serviço está em execução:
sudo systemctl status observiq-otel-collectorVerifique se há erros nos registros:
sudo journalctl -u observiq-otel-collector -f
Para reiniciar o agente do BindPlane no Windows:
Escolha uma das seguintes opções:
- Prompt de comando ou PowerShell como administrador:
net stop observiq-otel-collector && net start observiq-otel-collector- Console de serviços:
- Pressione
Win+R, digiteservices.msce pressione Enter. - Localize o coletor do OpenTelemetry da observIQ.
- Clique com o botão direito do mouse e selecione Reiniciar.
- Pressione
Verifique se o serviço está em execução:
sc query observiq-otel-collectorVerifique se há erros nos registros:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
Criar credenciais de API da Akamai
O Akamai EAA usa dois tipos de credenciais de API, dependendo do tipo de feed. Crie as credenciais que correspondem aos feeds que você quer coletar.
Criar credenciais da API legada do EAA (para feeds de acesso e de administrador)
- Faça login no Akamai Control Center.
- Selecione Enterprise Center no menu de navegação principal à esquerda.
- Acesse Configurações gerais > Configurações.
- Selecione a guia Chaves de API.
- Clique em Gerar nova chave de API no canto superior direito.
- Insira um nome e uma descrição para a chave de API.
Na tela de confirmação, copie a Chave e o Secret.
Criar credenciais da API OPEN da Akamai (para feeds de integridade do conector, inventário de dispositivos e integridade do diretório)
- Faça login no Akamai Control Center.
- Acesse Administrador da conta > Identidade e acesso.
- Selecione a guia Usuários da API.
- Clique em Criar cliente de API.
- Na seção Selecionar APIs, pesquise Enterprise Application Access e defina o nível de acesso como READ-WRITE.
- Conclua as configurações restantes e clique em Criar cliente de API.
Clique em Fazer download para baixar as credenciais no formato
.edgercou em Copiar para copiá-las para um arquivo.edgerc.
Configurar o arquivo de credenciais .edgerc
Crie o arquivo de credenciais
.edgercno sistema em que o ULS será executado:touch ~/.edgercAbra o arquivo em um editor de texto:
nano ~/.edgercAdicione suas credenciais da API Akamai no seguinte formato:
[default] ; EAA Legacy API credentials (for access and admin feeds) eaa_api_host = manage.akamai-access.com eaa_api_key = <EAA_API_KEY> eaa_api_secret = <EAA_API_SECRET> ; Akamai OPEN API credentials (for conhealth, devinv, dirhealth feeds) host = <OPEN_API_HOST> client_token = <CLIENT_TOKEN> client_secret = <CLIENT_SECRET> access_token = <ACCESS_TOKEN>Proteja o arquivo de credenciais:
chmod 600 ~/.edgerc
Substitua:
<EAA_API_KEY>: a chave de API legada do EAA (por exemplo,XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX).<EAA_API_SECRET>: a chave secreta da API legada do EAA.<OPEN_API_HOST>: o nome do host da API aberta da Akamai (por exemplo,akaa-xxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxx.luna.akamaiapis.net).<CLIENT_TOKEN>: o token de cliente da API OPEN da Akamai (por exemplo,akab-xxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxx).<CLIENT_SECRET>: a chave secreta do cliente da API OPEN da Akamai.<ACCESS_TOKEN>: seu token de acesso da API aberta da Akamai (por exemplo,akab-xxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxx).
Instalar o Akamai Unified Log Streamer
O Unified Log Streamer (ULS) extrai registros do Akamai EAA pelas APIs da Akamai e os transmite para o agente do BindPlane usando TCP. O ULS é um aplicativo Python que requer o Python 3.9 ou posterior.
Instalação do Linux (Python)
Clone o repositório do ULS:
git clone https://github.com/akamai/uls.git cd ulsInstale os requisitos do Python para ULS:
pip3 install -r bin/requirements.txtInstale a dependência da CLI do EAA:
git clone --depth 1 --single-branch https://github.com/akamai/cli-eaa.git ext/cli-eaa pip3 install -r ext/cli-eaa/requirements.txtVerifique a instalação:
python3 bin/uls.py --help
Instalação do Docker
Extraia a imagem Docker oficial do ULS:
docker pull akamai/uls:latest
Configurar o ULS para transmitir registros do EAA para o Bindplane
Execução de linha de comando (teste)
Execute o ULS com saída TCP para transmitir registros ao agente do Bindplane:
python3 bin/uls.py --input eaa \ --feed access \ --output tcp \ --host <BINDPLANE_HOST> \ --port 5140 \ --edgerc ~/.edgerc \ --section default
Substitua:
<BINDPLANE_HOST>: o endereço IP ou o nome do host do servidor que executa o agente do BindPlane.5140: a porta configurada no receptortcplogdo Bindplane.Para transmitir vários tipos de feed, execute instâncias separadas do ULS:
# Access logs python3 bin/uls.py --input eaa --feed access --output tcp --host <BINDPLANE_HOST> --port 5140 --edgerc ~/.edgerc --section default # Admin audit logs python3 bin/uls.py --input eaa --feed admin --output tcp --host <BINDPLANE_HOST> --port 5140 --edgerc ~/.edgerc --section default # Connector health python3 bin/uls.py --input eaa --feed conhealth --output tcp --host <BINDPLANE_HOST> --port 5140 --edgerc ~/.edgerc --section default
Serviço Systemd (produção)
Para implantações de produção, configure o ULS como um serviço systemd.
Crie um arquivo de configuração do ULS:
sudo mkdir -p /etc/uls sudo nano /etc/uls/eaa-access-tcp.confAdicione a seguinte configuração:
ULS_INPUT=eaa ULS_FEED=access ULS_OUTPUT=tcp ULS_HOST=<BINDPLANE_HOST> ULS_PORT=5140 ULS_EDGERC=/root/.edgerc ULS_SECTION=defaultCrie um arquivo de serviço systemd:
sudo nano /etc/systemd/system/uls-eaa-access.serviceAdicione o seguinte conteúdo:
[Unit] Description=Unified Log Streamer - EAA Access Logs to Bindplane After=network.target [Service] Type=simple EnvironmentFile=/etc/uls/eaa-access-tcp.conf ExecStart=/usr/bin/python3 /opt/uls/bin/uls.py --input ${ULS_INPUT} --feed ${ULS_FEED} --output ${ULS_OUTPUT} --host ${ULS_HOST} --port ${ULS_PORT} --edgerc ${ULS_EDGERC} --section ${ULS_SECTION} Restart=always RestartSec=10 User=root [Install] WantedBy=multi-user.targetAtive e inicie o serviço:
sudo systemctl daemon-reload sudo systemctl enable uls-eaa-access.service sudo systemctl start uls-eaa-access.serviceVerifique se o serviço está em execução:
sudo systemctl status uls-eaa-access.serviceConferir registros:
sudo journalctl -u uls-eaa-access.service -f
Repita as etapas de 1 a 7 para cada tipo de feed adicional (admin, conhealth) criando arquivos de configuração e de serviço separados com nomes diferentes (por exemplo, uls-eaa-admin.service, uls-eaa-conhealth.service).
Implantação do Docker Compose
Crie um arquivo
docker-compose.yml:version: '3.8' services: uls-eaa-access: image: akamai/uls:latest container_name: uls-eaa-access restart: unless-stopped environment: - ULS_INPUT=eaa - ULS_FEED=access - ULS_OUTPUT=tcp - ULS_HOST=<BINDPLANE_HOST> - ULS_PORT=5140 volumes: - ~/.edgerc:/root/.edgerc:ro uls-eaa-admin: image: akamai/uls:latest container_name: uls-eaa-admin restart: unless-stopped environment: - ULS_INPUT=eaa - ULS_FEED=admin - ULS_OUTPUT=tcp - ULS_HOST=<BINDPLANE_HOST> - ULS_PORT=5140 volumes: - ~/.edgerc:/root/.edgerc:ro uls-eaa-conhealth: image: akamai/uls:latest container_name: uls-eaa-conhealth restart: unless-stopped environment: - ULS_INPUT=eaa - ULS_FEED=conhealth - ULS_OUTPUT=tcp - ULS_HOST=<BINDPLANE_HOST> - ULS_PORT=5140 volumes: - ~/.edgerc:/root/.edgerc:ro
Substitua <BINDPLANE_HOST> pelo endereço IP ou nome do host do servidor do agente do BindPlane.
Inicie os contêineres:
docker compose up -dConferir registros:
docker compose logs -f
Tabela de mapeamento de UDM
| Campo de registro | mapeamento de UDM | Lógica |
|---|---|---|
app |
target.application |
O valor após os dois pontos no campo app. |
apphost |
target.hostname |
Mapeado diretamente. |
browser |
network.http.user_agent |
Mapeado diretamente. |
bytes_in |
network.recieved_bytes |
Mapeado diretamente. |
bytes_out |
network.sent_bytes |
Mapeado diretamente. |
cc |
principal.location.country_or_region |
Mapeado diretamente. |
client_id |
additional.fields.key: "ID do cliente", additional.fields.value.string_value: client_id |
Mapeado condicionalmente se client_id estiver presente. |
clientip |
principal.ip |
Mapeado diretamente. |
cloud_zone |
principal.cloud.availability_zone |
Mapeado diretamente. |
connector_resp_time |
security_result.detection_fields.key: "Tempo de resposta do conector", security_result.detection_fields.value: connector_resp_time |
Mapeado condicionalmente se connector_resp_time não estiver vazio ou "-". |
content_type |
additional.fields.key: "Tipo de conteúdo", additional.fields.value.string_value: content_type |
Mapeado condicionalmente se content_type estiver presente. |
datetime |
metadata.event_timestamp |
Analisado do campo datetime usando o formato RFC 3339. |
deny_reason |
security_result.summary |
Mapeado diretamente. |
device_type |
principal.platform, principal.platform_version |
Mapeado para WINDOWS, LINUX ou MAC com base na correspondência de regex. O valor bruto é mapeado para principal.platform_version. |
di |
metadata.ingestion_labels.key: "di", metadata.ingestion_labels.value: di |
Mapeado diretamente como um rótulo de ingestão. |
error_code |
additional.fields.key: "Código do erro", additional.fields.value.string_value: error_code |
Mapeado condicionalmente se error_code estiver presente. |
event |
metadata.description |
Mapeado diretamente. |
geo_city |
principal.location.city |
Mapeado diretamente. |
geo_country |
principal.location.country_or_region |
Mapeado diretamente. |
geo_state |
principal.location.state |
Mapeado diretamente. |
groups |
principal.user.group_identifiers |
Mapeado diretamente. |
http_method |
network.http.method |
Mapeado diretamente. |
http_ver |
network.application_protocol, network.application_protocol_version |
Analisado usando o grok para extrair o protocolo e a versão. |
idpinfo |
additional.fields.key: "Informações do IDP", additional.fields.value.string_value: idpinfo |
Mapeado condicionalmente se idpinfo estiver presente. |
internal_host |
additional.fields.key: "Host interno", additional.fields.value.string_value: internal_host |
Mapeado condicionalmente se internal_host estiver presente. |
metadata.log_type |
metadata.log_type |
Fixado no código como "AKAMAI_EAA". |
metadata.product_name |
metadata.product_name |
Fixado no código como "AKAMAI_EAA". |
metadata.vendor_name |
metadata.vendor_name |
Fixado no código como "AKAMAI_EAA". |
metadata.event_type |
metadata.event_type |
Determinado pela lógica: USER_UNCATEGORIZED se uid estiver presente, NETWORK_HTTP se principal.ip e target estiverem definidos ou GENERIC_EVENT caso contrário. |
origin_host |
additional.fields.key: "Host de origem", additional.fields.value.string_value: origin_host |
Mapeado condicionalmente se origin_host estiver presente. |
origin_resp_time |
security_result.detection_fields.key: "Tempo de resposta da origem", security_result.detection_fields.value: origin_resp_time |
Mapeado condicionalmente se origin_resp_time não estiver vazio ou "-". |
os |
principal.platform |
Mapeado para WINDOWS, MAC ou LINUX com base na correspondência de regex. |
port |
target.port |
O valor após os dois pontos no campo app. |
ral |
metadata.description |
Valores concatenados da matriz ral, separados por vírgulas. |
referer |
network.http.referral_url |
Mapeado diretamente. |
resource |
principal.resource.attribute.labels.key: "Recurso", principal.resource.attribute.labels.value: resource |
Mapeado condicionalmente se resource estiver presente. |
resource_type |
principal.resource.attribute.labels.key: "Tipo de recurso", principal.resource.attribute.labels.value: resource_type |
Mapeado condicionalmente se resource_type estiver presente. |
rscd |
metadata.ingestion_labels.key: "rscd", metadata.ingestion_labels.value: rscd |
Mapeado diretamente como um rótulo de ingestão. |
session_id |
network.session_id |
Mapeado diretamente. |
session_info |
additional.fields.key: "Informações da sessão", additional.fields.value.string_value: session_info |
Mapeado condicionalmente se session_info estiver presente. |
state |
principal.location.state |
Mapeado diretamente. |
status_code |
network.http.response_code |
Mapeado diretamente. |
total_resp_time |
security_result.detection_fields.key: "Tempo total de resposta", security_result.detection_fields.value: total_resp_time |
Mapeado condicionalmente se total_resp_time não estiver vazio ou "-". |
ts |
metadata.event_timestamp |
Analisado do campo ts como milissegundos ou segundos UNIX, se presente. Caso contrário, do campo datetime. |
uid |
principal.user.userid |
Mapeado diretamente. |
uip |
principal.ip |
Mapeado diretamente. |
url_path |
target.url |
Mapeado diretamente. |
user_agent |
network.http.user_agent, network.http.parsed_user_agent |
Mapeado e analisado diretamente em um campo parsed_user_agent estruturado. |
username |
principal.user.email_addresses ou principal.user.userid |
Mapeado para email_addresses se parecer um e-mail. Caso contrário, para userid. |
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.