Coletar registros do SecureLink

Compatível com:

Este documento explica como ingerir registros do SecureLink no Google Security Operations usando o Google Cloud Storage V2.

O SecureLink (agora Imprivata Privileged Remote Access) é uma plataforma de acesso remoto de terceiros baseada na nuvem para gerenciamento seguro de acesso privilegiado e de fornecedores. A API REST do SecureLink oferece acesso programático a registros de sessão, eventos de autenticação e registros de auditoria administrativa.

Antes de começar

Verifique se você tem os pré-requisitos a seguir:

  • Uma instância do Google SecOps
  • Um projeto do GCP com a API Storage ativada
  • Permissões para criar e gerenciar intervalos do GCS
  • Permissões para gerenciar políticas do IAM em buckets do GCS
  • Permissões para criar serviços do Cloud Run, tópicos do Pub/Sub e jobs do Cloud Scheduler
  • Acesso privilegiado ao portal de administração do SecureLink com permissões de administrador
  • Uma chave de API do SecureLink com acesso de leitura ao registro de auditoria

Criar um bucket do Google Cloud Storage

  1. Acesse o Console do Google Cloud.
  2. Selecione um projeto ou crie um novo.
  3. No menu de navegação, acesse Cloud Storage > Buckets.
  4. Clique em Criar bucket.

  5. Informe os seguintes detalhes de configuração:

    Configuração Valor
    Nomeie seu bucket Insira um nome exclusivo globalmente, por exemplo, securelink-logs.
    Tipo de local Escolha de acordo com suas necessidades (região, birregional, multirregional)
    Local Selecione o local (por exemplo, us-central1).
    Classe de armazenamento Padrão (recomendado para registros acessados com frequência)
    Controle de acesso Uniforme (recomendado)
    Ferramentas de proteção Opcional: ativar o controle de versões de objetos ou a política de retenção

  6. Clique em Criar.

Gerar chave de API

  1. Faça login no portal de administração do SecureLink.
  2. Acesse Administração > Chaves de API ou Administração > Integrações > API.
  3. Clique em Gerar chave de API.
  4. Insira um nome para a chave de API (por exemplo, Google SecOps Integration).
  5. Selecione as permissões necessárias:
    • Leitura de registros de auditoria: acesso a registros de sessão e autenticação
    • Leitura da sessão: acesso aos dados da sessão de acesso remoto.
  6. Clique em Gerar.

  7. Copie e salve os seguintes detalhes em um local seguro:

    • Chave de API: o valor da chave de API gerada
    • ID da organização: o ID da sua organização do SecureLink (visível no URL do portal de administração ou na página "Configurações")

Determinar o URL base da API

O URL base da API SecureLink:

Ambiente URL base da API
Produção https://api.securelink.com/v1

Testar o acesso à API

  • Teste suas credenciais antes de prosseguir com a integração:

    # Replace with your actual credentials
SECURELINK_API_KEY="your-api-key"
SECURELINK_ORG_ID="your-org-id"

# Test API access - list recent audit logs
curl -s -X GET "https://api.securelink.com/v1/audit-logs?limit=1" \
  -H "Authorization: Bearer ${SECURELINK_API_KEY}" \
  -H "X-Organization-Id: ${SECURELINK_ORG_ID}" \
  -H "Accept: application/json"

Criar uma conta de serviço para a função do Cloud Run

A função do Cloud Run precisa de uma conta de serviço com permissões para gravar no bucket do GCS e ser invocada pelo Pub/Sub.

Criar conta de serviço

  1. No Console do GCP, acesse IAM e administrador > Contas de serviço.
  2. Clique em Criar conta de serviço.
  3. Informe os seguintes detalhes de configuração:
    • Nome da conta de serviço: insira securelink-logs-collector-sa
    • Descrição da conta de serviço: digite Service account for Cloud Run function to collect SecureLink logs
  4. Clique em Criar e continuar.
  5. Na seção Conceder acesso a essa conta de serviço ao projeto, adicione os seguintes papéis:
    1. Clique em Selecionar papel.
    2. Pesquise e selecione Administrador de objetos do Storage.
    3. Clique em + Adicionar outro papel.
    4. Pesquise e selecione Invocador do Cloud Run.
    5. Clique em + Adicionar outro papel.
    6. Pesquise e selecione Invocador do Cloud Functions.
  6. Clique em Continuar.
  7. Clique em Concluído.

Esses papéis são necessários para:

  • Administrador de objetos do Storage: grava registros no bucket do GCS e gerencia arquivos de estado.
  • Invocador do Cloud Run: permite que o Pub/Sub invoque a função.
  • Invocador do Cloud Functions: permite a invocação de funções

Conceder permissões do IAM no bucket do GCS

Conceda permissões de gravação à conta de serviço no bucket do GCS:

  1. Acesse Cloud Storage > Buckets.
  2. Clique no nome do bucket (por exemplo, securelink-logs).
  3. Acesse a guia Permissões.
  4. Clique em Conceder acesso.
  5. Informe os seguintes detalhes de configuração:
    • Adicionar principais: insira o e-mail da conta de serviço (por exemplo, securelink-logs-collector-sa@PROJECT_ID.iam.gserviceaccount.com).
    • Atribuir papéis: selecione Administrador de objetos do Storage.
  6. Clique em Salvar.

Criar tópico Pub/Sub

Crie um tópico do Pub/Sub em que o Cloud Scheduler vai publicar e a função do Cloud Run vai se inscrever.

  1. No Console do GCP, acesse Pub/Sub > Tópicos.
  2. Selecione Criar tópico.
  3. Informe os seguintes detalhes de configuração:
    • ID do tópico: insira securelink-logs-trigger
    • Não mude as outras configurações.
  4. Clique em Criar.

Criar uma função do Cloud Run para coletar registros

A função do Cloud Run será acionada por mensagens do Pub/Sub do Cloud Scheduler para buscar registros da API REST SecureLink e gravá-los no GCS.

  1. No console do GCP, acesse o Cloud Run.
  2. Clique em Criar serviço.
  3. Selecione Função (use um editor in-line para criar uma função).

  4. Na seção Configurar, forneça os seguintes detalhes de configuração:

    Configuração Valor
    Nome do serviço securelink-logs-collector
    Região Selecione a região que corresponde ao seu bucket do GCS (por exemplo, us-central1).
    Ambiente de execução Selecione Python 3.12 ou uma versão mais recente.

  5. Na seção Acionador (opcional):

    1. Clique em + Adicionar gatilho.
    2. Selecione Cloud Pub/Sub.
    3. Em Selecionar um tópico do Cloud Pub/Sub, escolha o tópico securelink-logs-trigger.
    4. Clique em Salvar.

  6. Na seção Autenticação:

    1. Selecione Exigir autenticação.
    2. Confira o Identity and Access Management (IAM).

  7. Role a tela para baixo e expanda Contêineres, rede, segurança.

  8. Acesse a guia Segurança:

    • Conta de serviço: selecione a conta de serviço securelink-logs-collector-sa.

  9. Acesse a guia Contêineres:

    1. Clique em Variáveis e secrets.
    2. Clique em + Adicionar variável para cada variável de ambiente:
    Nome da variável Valor de exemplo Descrição
    GCS_BUCKET securelink-logs Nome do bucket do GCS
    GCS_PREFIX securelink Prefixo para arquivos de registro
    STATE_KEY securelink/state.json Caminho do arquivo de estado
    SECURELINK_API_KEY your-api-key Chave de API do SecureLink
    SECURELINK_ORG_ID your-org-id ID da organização do SecureLink
    SECURELINK_API_BASE https://api.securelink.com/v1 URL base da API SecureLink
    MAX_RECORDS 5000 Máximo de registros por execução
    PAGE_SIZE 1000 Registros por página
    LOOKBACK_HOURS 24 Período de lookback inicial

  10. Na seção Variáveis e secrets, role a tela para baixo até Solicitações:

    • Tempo limite da solicitação: insira 600 segundos (10 minutos)

  11. Acesse a guia Configurações:

    • Na seção Recursos:
      • Memória: selecione 512 MiB ou mais.
      • CPU: selecione 1

  12. Na seção Escalonamento de revisão:

    • Número mínimo de instâncias: insira 0
    • Número máximo de instâncias: insira 100 ou ajuste com base na carga esperada.

  13. Clique em Criar.

  14. Aguarde a criação do serviço (1 a 2 minutos).

  15. Depois que o serviço for criado, o editor de código inline será aberto automaticamente.

Adicionar código da função

  1. Insira main no campo Ponto de entrada.

  2. No editor de código em linha, crie dois arquivos:

    • Primeiro arquivo main.py::

      import functions_framework
from google.cloud import storage
import json
import os
import urllib3
from datetime import datetime, timezone, timedelta
import time

# Initialize HTTP client with timeouts
http = urllib3.PoolManager(
  timeout=urllib3.Timeout(connect=5.0, read=30.0),
  retries=False,
)

# Initialize Storage client
storage_client = storage.Client()

# Environment variables
GCS_BUCKET = os.environ.get('GCS_BUCKET')
GCS_PREFIX = os.environ.get('GCS_PREFIX', 'securelink')
STATE_KEY = os.environ.get('STATE_KEY', 'securelink/state.json')
SECURELINK_API_KEY = os.environ.get('SECURELINK_API_KEY')
SECURELINK_ORG_ID = os.environ.get('SECURELINK_ORG_ID')
SECURELINK_API_BASE = os.environ.get('SECURELINK_API_BASE', 'https://api.securelink.com/v1')
MAX_RECORDS = int(os.environ.get('MAX_RECORDS', '5000'))
PAGE_SIZE = int(os.environ.get('PAGE_SIZE', '1000'))
LOOKBACK_HOURS = int(os.environ.get('LOOKBACK_HOURS', '24'))

def parse_datetime(value: str) -> datetime:
  """Parse ISO datetime string to datetime object."""
  if value.endswith("Z"):
    value = value[:-1] + "+00:00"
  return datetime.fromisoformat(value)

@functions_framework.cloud_event
def main(cloud_event):
  """
  Cloud Run function triggered by Pub/Sub to fetch SecureLink
  audit and session logs and write to GCS.

  Args:
    cloud_event: CloudEvent object containing Pub/Sub message
  """

  if not all([GCS_BUCKET, SECURELINK_API_KEY, SECURELINK_ORG_ID]):
    print('Error: Missing required environment variables')
    return

  try:
    bucket = storage_client.bucket(GCS_BUCKET)

    # Load state
    state = load_state(bucket, STATE_KEY)

    # Determine time window
    now = datetime.now(timezone.utc)
    last_time = None

    if isinstance(state, dict) and state.get("last_event_time"):
      try:
        last_time = parse_datetime(state["last_event_time"])
        # Overlap by 2 minutes to catch any delayed events
        last_time = last_time - timedelta(minutes=2)
      except Exception as e:
        print(f"Warning: Could not parse last_event_time: {e}")

    if last_time is None:
      last_time = now - timedelta(hours=LOOKBACK_HOURS)

    print(f"Fetching logs from {last_time.isoformat()} to {now.isoformat()}")

    # Fetch logs from multiple endpoints
    all_records = []
    newest_event_time = None

    for endpoint_type in ['audit-logs', 'sessions']:
      records, newest_time = fetch_logs(
        endpoint_type=endpoint_type,
        start_time=last_time,
        end_time=now,
        page_size=PAGE_SIZE,
        max_records=MAX_RECORDS,
      )
      all_records.extend(records)
      if newest_time:
        if newest_event_time is None or parse_datetime(newest_time) > parse_datetime(newest_event_time):
          newest_event_time = newest_time

    if not all_records:
      print("No new log records found.")
      save_state(bucket, STATE_KEY, now.isoformat())
      return

    # Write to GCS as NDJSON
    timestamp = now.strftime('%Y%m%d_%H%M%S')
    object_key = f"{GCS_PREFIX}/logs_{timestamp}.ndjson"
    blob = bucket.blob(object_key)

    ndjson = '\n'.join([json.dumps(record, ensure_ascii=False) for record in all_records]) + '\n'
    blob.upload_from_string(ndjson, content_type='application/x-ndjson')

    print(f"Wrote {len(all_records)} records to gs://{GCS_BUCKET}/{object_key}")

    # Update state with newest event time
    if newest_event_time:
      save_state(bucket, STATE_KEY, newest_event_time)
    else:
      save_state(bucket, STATE_KEY, now.isoformat())

    print(f"Successfully processed {len(all_records)} records")

  except Exception as e:
    print(f'Error processing logs: {str(e)}')
    raise

def load_state(bucket, key):
  """Load state from GCS."""
  try:
    blob = bucket.blob(key)
    if blob.exists():
      state_data = blob.download_as_text()
      return json.loads(state_data)
  except Exception as e:
    print(f"Warning: Could not load state: {e}")

  return {}

def save_state(bucket, key, last_event_time_iso: str):
  """Save the last event timestamp to GCS state file."""
  try:
    state = {'last_event_time': last_event_time_iso}
    blob = bucket.blob(key)
    blob.upload_from_string(
      json.dumps(state, indent=2),
      content_type='application/json'
    )
    print(f"Saved state: last_event_time={last_event_time_iso}")
  except Exception as e:
    print(f"Warning: Could not save state: {e}")

def fetch_logs(endpoint_type: str, start_time: datetime, end_time: datetime, page_size: int, max_records: int):
  """
  Fetch logs from SecureLink REST API
  with cursor-based pagination and rate limiting.

  Args:
    endpoint_type: API endpoint type (audit-logs, sessions)
    start_time: Start time for log query
    end_time: End time for log query
    page_size: Number of records per page
    max_records: Maximum total records to fetch

  Returns:
    Tuple of (records list, newest_event_time ISO string)
  """
  api_base = SECURELINK_API_BASE.rstrip('/')
  endpoint = f"{api_base}/{endpoint_type}"

  headers = {
    'Authorization': f'Bearer {SECURELINK_API_KEY}',
    'X-Organization-Id': SECURELINK_ORG_ID,
    'Accept': 'application/json',
    'User-Agent': 'GoogleSecOps-SecureLinkCollector/1.0'
  }

  records = []
  newest_time = None
  page_num = 0
  backoff = 1.0
  cursor = None

  start_iso = start_time.strftime('%Y-%m-%dT%H:%M:%SZ')
  end_iso = end_time.strftime('%Y-%m-%dT%H:%M:%SZ')

  while True:
    page_num += 1

    if len(records) >= max_records:
      print(f"Reached max_records limit ({max_records}) for {endpoint_type}")
      break

    url = f"{endpoint}?startDate={start_iso}&endDate={end_iso}&limit={min(page_size, max_records - len(records))}"
    if cursor:
      url += f"&cursor={cursor}"

    try:
      response = http.request('GET', url, headers=headers)

      # Handle rate limiting with exponential backoff
      if response.status == 429:
        retry_after = int(response.headers.get('Retry-After', str(int(backoff))))
        print(f"Rate limited (429). Retrying after {retry_after}s...")
        time.sleep(retry_after)
        backoff = min(backoff * 2, 30.0)
        continue

      backoff = 1.0

      if response.status != 200:
        print(f"HTTP Error: {response.status}")
        response_text = response.data.decode('utf-8')
        print(f"Response body: {response_text}")
        return records, newest_time

      data = json.loads(response.data.decode('utf-8'))

      page_results = data.get('data', data.get('results', data.get('items', [])))

      if not page_results:
        print(f"No more results (empty page) for {endpoint_type}")
        break

      print(f"{endpoint_type} page {page_num}: Retrieved {len(page_results)} events")

      # Add endpoint type for identification
      for event in page_results:
        event['_securelink_log_type'] = endpoint_type

      records.extend(page_results)

      # Track newest event time
      for event in page_results:
        try:
          event_ts = event.get('timestamp') or event.get('createdAt') or event.get('startTime')
          if event_ts:
            event_time = str(event_ts)
            if newest_time is None or parse_datetime(event_time) > parse_datetime(newest_time):
              newest_time = event_time
        except Exception as e:
          print(f"Warning: Could not parse event time: {e}")

      # Check for next cursor
      cursor = data.get('cursor') or data.get('nextCursor') or data.get('next_cursor')
      if not cursor:
        if len(page_results) < page_size:
          print(f"No more pages for {endpoint_type} (last page not full)")
        else:
          print(f"No more pages for {endpoint_type} (no cursor)")
        break

    except Exception as e:
      print(f"Error fetching {endpoint_type} logs: {e}")
      return records, newest_time

  print(f"Retrieved {len(records)} total {endpoint_type} records from {page_num} pages")
  return records, newest_time

    • Segundo arquivo requirements.txt::

      functions-framework==3.*
google-cloud-storage==2.*
urllib3>=2.0.0

  3. Clique em Implantar para salvar e implantar a função.

  4. Aguarde a conclusão da implantação (2 a 3 minutos).

Criar o job do Cloud Scheduler

O Cloud Scheduler vai publicar mensagens no tópico do Pub/Sub em intervalos regulares, acionando a função do Cloud Run.

  1. No Console do GCP, acesse o Cloud Scheduler.
  2. Clique em Criar job.

  3. Informe os seguintes detalhes de configuração:

    Configuração Valor
    Nome securelink-logs-collector-hourly
    Região Selecione a mesma região da função do Cloud Run
    Frequência 0 * * * * (a cada hora, na hora)
    Fuso horário Selecione o fuso horário (UTC recomendado)
    Tipo de destino Pub/Sub
    Tópico Selecione o tópico securelink-logs-trigger.
    Corpo da mensagem {} (objeto JSON vazio)

  4. Clique em Criar.

Opções de frequência de programação

Escolha a frequência com base no volume de registros e nos requisitos de latência:

Frequência Expressão Cron Caso de uso
A cada 5 minutos */5 * * * * Alto volume e baixa latência
A cada 15 minutos */15 * * * * Volume médio
A cada hora 0 * * * * Padrão (recomendado)
A cada 6 horas 0 */6 * * * Baixo volume, processamento em lote
Diariamente 0 0 * * * Coleta de dados históricos

Testar a integração

  1. No console do Cloud Scheduler, encontre seu job.
  2. Clique em Forçar execução para acionar o job manualmente.
  3. Aguarde alguns segundos.
  4. Acesse Cloud Run > Serviços.
  5. Clique em securelink-logs-collector.
  6. Clique na guia Registros.

  7. Verifique se a função foi executada com sucesso. Procure:

    Fetching logs from YYYY-MM-DDTHH:MM:SS+00:00 to YYYY-MM-DDTHH:MM:SS+00:00
audit-logs page 1: Retrieved X events
sessions page 1: Retrieved X events
Wrote X records to gs://securelink-logs/securelink/logs_YYYYMMDD_HHMMSS.ndjson
Successfully processed X records

  8. Acesse Cloud Storage > Buckets.

  9. Clique no nome do bucket (securelink-logs).

  10. Navegue até a pasta securelink/.

  11. Verifique se um novo arquivo .ndjson foi criado com o carimbo de data/hora atual.

Se você encontrar erros nos registros:

  • HTTP 401: verifique a chave de API e o ID da organização nas variáveis de ambiente
  • HTTP 403: verifique se a chave de API tem as permissões necessárias no portal de administração do SecureLink.
  • HTTP 429: limitação de taxa. A função vai tentar de novo automaticamente com espera.
  • Variáveis de ambiente ausentes: verifique se todas as variáveis necessárias estão definidas.
  1. Acesse Configurações do SIEM > Feeds.
  2. Clique em Adicionar novo feed.
  3. Clique em Configurar um único feed.
  4. No campo Nome do feed, insira um nome para o feed (por exemplo, SecureLink Logs).
  5. Selecione Google Cloud Storage V2 como o Tipo de origem.
  6. Selecione SecureLink como o Tipo de registro.

  7. Clique em Receber conta de serviço. Um e-mail exclusivo da conta de serviço será exibido, por exemplo:

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com

  8. Copie o endereço de e-mail.

  9. Clique em Próxima.

  10. Especifique valores para os seguintes parâmetros de entrada:

    • URL do bucket de armazenamento: insira o URI do bucket do GCS com o caminho do prefixo:

      gs://securelink-logs/securelink/
      • Substitua:
        • securelink-logs: o nome do bucket do GCS.
        • securelink: prefixo/caminho da pasta opcional onde os registros são armazenados (deixe em branco para a raiz).

    • Opção de exclusão da fonte: selecione a opção de exclusão de acordo com sua preferência:

      • Nunca: nunca exclui arquivos após as transferências (recomendado para testes).
      • Excluir arquivos transferidos: exclui os arquivos após a transferência bem-sucedida.

      • Excluir arquivos transferidos e diretórios vazios: exclui arquivos e diretórios vazios após a transferência bem-sucedida.

    • Idade máxima do arquivo: inclui arquivos modificados nos últimos dias. O padrão é 180 dias.

    • Namespace do recurso: o namespace do recurso

    • Rótulos de ingestão: o rótulo a ser aplicado aos eventos deste feed

  11. Clique em Próxima.

  12. Revise a nova configuração do feed na tela Finalizar e clique em Enviar.

Conceder permissões do IAM à conta de serviço do Google SecOps

A conta de serviço do Google SecOps precisa do papel Leitor de objetos do Storage no seu bucket do GCS.

  1. Acesse Cloud Storage > Buckets.
  2. Clique no nome do bucket.
  3. Acesse a guia Permissões.
  4. Clique em Conceder acesso.
  5. Informe os seguintes detalhes de configuração:
    • Adicionar principais: cole o e-mail da conta de serviço do Google SecOps.
    • Atribuir papéis: selecione Leitor de objetos do Storage.
  6. Clique em Salvar.

Tabela de mapeamento do UDM

Campo de registro Mapeamento do UDM Lógica
additional_classification additional.fields Dados importantes de eventos específicos do fornecedor que não podem ser representados adequadamente nas seções formais do modelo UDM
mecanismo extensions.auth.mechanism Mecanismo de autenticação
extensions.auth.type Tipo de autenticação
msg, inner_message, desc metadata.description A descrição do evento
metadata.event_type Tipo de evento (por exemplo, USER_LOGIN, NETWORK_CONNECTION)
resource_name, _application_protocol network.application_protocol Protocolo de aplicativo (por exemplo, HTTP, FTP)
método network.http.method Método HTTP (por exemplo, GET, POST)
network.ip_protocol Protocolo IP (por exemplo, TCP, UDP)
sessionId network.session_id ID da sessão
principal_host principal.hostname Nome do host de origem
login_ip, src_ip, inner_ip, principal_host principal.ip Endereço IP de origem da conexão.
principal_port principal.port Número da porta de origem
process_id principal.process.pid ID do processo
principal_uri principal.url URL associado ao principal.
nome de usuário, chave principal.user.email_addresses Endereços de e-mail associados ao usuário
username, key, user_id principal.user.userid ID do usuário
security_action security_result.action Ação realizada (por exemplo, ALLOW, BLOCK)
categoria security_result.category Categoria do resultado de segurança
action, description security_result.description Descrição do resultado de segurança
prioridade security_result.priority Prioridade do resultado de segurança
método security_result.severity Gravidade do resultado de segurança
prioridade security_result.severity_details Detalhes da gravidade
reason security_result.summary Resumo do resultado de segurança
application, product_event_type target.application Nome do aplicativo
pwd target.file.full_path Caminho completo do arquivo
target_host target.hostname Nome do host de destino
dst_ip, target_host target.ip Endereço IP de destino
target_port target.port Número da porta de destino
comando target.process.command_line Linha de comando do processo
target.resource.type Tipo de recurso
url target.url URL associado ao destino
nome de usuário, chave target.user.email_addresses Endereços de e-mail associados ao usuário de destino
nome target.user.user_display_name Nome de exibição do usuário
username, key, user_id target.user.userid ID do usuário de destino
metadata.product_name Nome do produto
metadata.vendor_name Nome do fornecedor/empresa

Registro de alterações

Ver o registro de alterações deste analisador

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