Coletar registros do Akamai Enterprise Application Access

Versão do analisador: 3.0

Compatível com:

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 systemd para 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.
  1. Faça login no console doGoogle Cloud e selecione o projeto do Google Cloud vinculado à sua instância do Google SecOps.
  2. Acesse IAM e administrador > Contas de serviço.
  3. Clique em Criar conta de serviço.
  4. 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).
  5. Clique em Criar e continuar.
  6. Na seção Conceder a essa conta de serviço acesso ao projeto, clique em Selecionar um papel e escolha Editor do Chronicle.
  7. Clique em Continuar e depois em Concluído.
  8. Clique na conta de serviço que você criou e acesse a guia Chaves.
  9. Clique em Adicionar chave > Criar nova chave.
  10. Selecione JSON e clique em Criar. O download do arquivo de chave é feito no seu computador.
  11. Salve o arquivo de chave como ingestion-auth.json no diretório do coletor do BindPlane (/opt/observiq-otel-collector/ingestion-auth.json no Linux ou C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json no Windows) ou atualize creds_file_path em config.yaml para corresponder ao caminho em que você o salvou.
  12. 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)

  1. Faça login no console do Google SecOps.
  2. Acesse Configurações > Gerenciamento de dados > Agentes de coleta. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Agentes de coleta.
  3. Faça o download do arquivo de autenticação de ingestão.
  4. Salve o arquivo com segurança no sistema em que o agente do Bindplane será instalado.

Receber o ID de cliente do Google SecOps

  1. Faça login no console do Google SecOps.
  2. Acesse Configurações > Administração > Perfil. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Perfil.
  3. 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

  1. Abra o Prompt de comando ou o PowerShell como administrador.
  2. Execute este comando:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    

Instalação do Linux

  1. Abra um terminal com privilégios de raiz ou sudo.
  2. 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

  1. Abra o arquivo de configuração do agente do Bindplane em um editor de texto:

    Linux:

    sudo nano /opt/observiq-otel-collector/config.yaml
    

    Windows:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    
  2. Edite o arquivo config.yaml da 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
  • Substitua <LOCATION> pela região da sua instância do Google SecOps (por exemplo, us, europe ou asia-southeast1). O exportador prefixa chronicle.googleapis.com com 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 exporters pelo seguinte. Defina creds_file_path como o caminho para o arquivo de autenticação de ingestão e, se a instância estiver fora dos EUA, substitua malachiteingestion-pa.googleapis.com pelo 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:

  1. Execute este comando:

    sudo systemctl restart observiq-otel-collector
    
  2. Verifique se o serviço está em execução:

    sudo systemctl status observiq-otel-collector
    
  3. Verifique se há erros nos registros:

    sudo journalctl -u observiq-otel-collector -f
    

Para reiniciar o agente do BindPlane no Windows:

  1. 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:
      1. Pressione Win+R, digite services.msc e pressione Enter.
      2. Localize o coletor do OpenTelemetry da observIQ.
      3. Clique com o botão direito do mouse e selecione Reiniciar.
  2. Verifique se o serviço está em execução:

    sc query observiq-otel-collector
    
  3. Verifique 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)

  1. Faça login no Akamai Control Center.
  2. Selecione Enterprise Center no menu de navegação principal à esquerda.
  3. Acesse Configurações gerais > Configurações.
  4. Selecione a guia Chaves de API.
  5. Clique em Gerar nova chave de API no canto superior direito.
  6. Insira um nome e uma descrição para a chave de API.
  7. 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)

  1. Faça login no Akamai Control Center.
  2. Acesse Administrador da conta > Identidade e acesso.
  3. Selecione a guia Usuários da API.
  4. Clique em Criar cliente de API.
  5. Na seção Selecionar APIs, pesquise Enterprise Application Access e defina o nível de acesso como READ-WRITE.
  6. Conclua as configurações restantes e clique em Criar cliente de API.
  7. Clique em Fazer download para baixar as credenciais no formato .edgerc ou em Copiar para copiá-las para um arquivo .edgerc.

Configurar o arquivo de credenciais .edgerc

  1. Crie o arquivo de credenciais .edgerc no sistema em que o ULS será executado:

    touch ~/.edgerc
    
  2. Abra o arquivo em um editor de texto:

    nano ~/.edgerc
    
  3. Adicione 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>
    
  4. 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)

  1. Clone o repositório do ULS:

    git clone https://github.com/akamai/uls.git
    cd uls
    
  2. Instale os requisitos do Python para ULS:

    pip3 install -r bin/requirements.txt
    
  3. Instale 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.txt
    
  4. Verifique a instalação:

    python3 bin/uls.py --help
    

Instalação do Docker

  1. 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 receptor tcplog do 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.

  1. Crie um arquivo de configuração do ULS:

    sudo mkdir -p /etc/uls
    sudo nano /etc/uls/eaa-access-tcp.conf
    
  2. Adicione 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=default
    
  3. Crie um arquivo de serviço systemd:

    sudo nano /etc/systemd/system/uls-eaa-access.service
    
  4. Adicione 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.target
    
  5. Ative e inicie o serviço:

    sudo systemctl daemon-reload
    sudo systemctl enable uls-eaa-access.service
    sudo systemctl start uls-eaa-access.service
    
  6. Verifique se o serviço está em execução:

    sudo systemctl status uls-eaa-access.service
    
  7. Conferir 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

  1. 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.

  1. Inicie os contêineres:

    docker compose up -d
    
  2. Conferir 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.