ForgeRock OpenAM 로그 수집

다음에서 지원:

이 문서에서는 Bindplane을 사용하여 ForgeRock OpenAM 로그를 Google Security Operations에 수집하는 방법을 설명합니다. 파서는 CSV, Syslog + KV 또는 JSON 형식의 로그에서 필드를 추출하고 정규화하여 통합 데이터 모델 (UDM)에 매핑합니다. 로그인/로그아웃, 액세스 결과, 일반 로그를 비롯한 다양한 OpenAM 이벤트 유형을 처리하여 사용자, 그룹, 네트워크 정보로 데이터를 보강하는 동시에 다양한 로그 형식과 이벤트 유형에 대한 특정 변환을 실행합니다. 파서는 JSON 파싱을 우선시한 다음 Syslog+KV로 대체하고 마지막으로 CSV로 대체하여 지원되지 않는 형식의 로그를 삭제합니다.

시작하기 전에

다음 기본 요건이 충족되었는지 확인합니다.

  • Google SecOps 인스턴스
  • Windows 2016 이상 또는 systemd가 설치된 Linux 호스트
  • 프록시 뒤에서 실행하는 경우 방화벽 포트가 열려 있음
  • Forgerock OpenAM에 대한 액세스 권한 관리 (예: amAdmin)

Google SecOps 수집 인증 파일 가져오기

  1. Google SecOps 콘솔에 로그인합니다.
  2. SIEM 설정 > 수집 에이전트로 이동합니다.
  3. 수집 인증 파일을 다운로드합니다. Bindplane이 설치될 시스템에 파일을 안전하게 저장합니다.

Google SecOps 고객 ID 가져오기

  1. Google SecOps 콘솔에 로그인합니다.
  2. SIEM 설정 > 프로필로 이동합니다.
  3. 조직 세부정보 섹션에서 고객 ID를 복사하여 저장합니다.

Bindplane 에이전트 설치

다음 안내에 따라 Windows 또는 Linux 운영체제에 Bindplane 에이전트를 설치합니다.

Windows 설치

  1. 명령 프롬프트 또는 PowerShell을 관리자로 엽니다.

  2. 다음 명령어를 실행합니다.

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

Linux 설치

  1. 루트 또는 sudo 권한으로 터미널을 엽니다.

  2. 다음 명령어를 실행합니다.

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh

추가 설치 리소스

추가 설치 옵션은 설치 가이드를 참고하세요.

Syslog를 수집하여 Google SecOps로 전송하도록 Bindplane 에이전트 구성

  1. 구성 파일에 액세스합니다.
    • config.yaml 파일을 찾습니다. 일반적으로 Linux에서는 /etc/bindplane-agent/ 디렉터리에 있고 Windows에서는 설치 디렉터리에 있습니다.
    • 텍스트 편집기 (예: nano, vi, 메모장)를 사용하여 파일을 엽니다.

  2. 다음과 같이 config.yaml 파일을 수정합니다.

    receivers:
    udplog:
        # Replace the port and IP address as required
        listen_address: "0.0.0.0:514"

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
        # Add optional ingestion labels for better organization
        ingestion_labels:
            log_type: 'OPENAM'
            raw_log_field: body

service:
    pipelines:
        logs/source0__chronicle_w_labels-0:
            receivers:
                - udplog
            exporters:
                - chronicle/chronicle_w_labels

  3. 인프라에 필요한 대로 포트와 IP 주소를 바꿉니다.

  4. <customer_id>를 실제 고객 ID로 바꿉니다.

  5. Google SecOps 수집 인증 파일 가져오기 섹션에서 인증 파일이 저장된 경로로 /path/to/ingestion-authentication-file.json를 업데이트합니다.

Bindplane 에이전트를 다시 시작하여 변경사항 적용

  • Linux에서 Bindplane 에이전트를 다시 시작하려면 다음 명령어를 실행합니다.

    sudo systemctl restart bindplane-agent

  • Windows에서 Bindplane 에이전트를 다시 시작하려면 서비스 콘솔을 사용하거나 다음 명령어를 입력하면 됩니다.

    net stop BindPlaneAgent && net start BindPlaneAgent

Forgerock OpenAM에서 감사 로깅 구성

  1. AM 콘솔에 로그인합니다.
  2. 구성 > 전역 서비스 > 감사 로깅으로 이동합니다.
  3. 감사 로깅을 활성화하여 감사 로깅 기능을 시작합니다.
  4. 필드 허용 목록 필터 및 필드 차단 목록 필터 목록에 감사 이벤트 로그에 포함 (허용 목록)하거나 제외 (차단 목록)할 값을 입력합니다.
  5. 저장을 클릭합니다.

Forgerock OpenAM용 Syslog 핸들러 구성

  1. amAdmin과 같은 관리자로 AM 콘솔에 로그인합니다.
  2. 전역 구성에서 이벤트 핸들러를 만들려면 구성 > 전역 서비스 > 감사 로깅으로 이동합니다.
  3. 영역에서 이벤트 핸들러를 만들려면 영역 > 영역 이름 > 서비스 > 감사 로깅으로 이동합니다.
  4. 보조 구성 추가 > Syslog를 클릭합니다.
  5. 다음 구성 세부정보를 제공합니다.
    • 이름: 이벤트 핸들러의 이름을 입력합니다 (예: Google SecOps Syslog Event Handler).
    • 서버 호스트 이름: Bindplane 에이전트 IP 주소를 입력합니다.
    • 서버 포트: Bindplane 에이전트 포트 번호를 입력합니다 (예: UDP의 경우 514).
    • 전송 프로토콜: UDP를 선택합니다.
    • 연결 시간 제한: 연결 시간(초)을 입력합니다(예: 120).
    • 선택사항: 버퍼링 옵션을 사용 설정합니다.
  6. 만들기를 클릭합니다.
  7. syslog 감사 이벤트 핸들러가 생성되면 여러 구성 탭이 표시됩니다.
  8. 일반 핸들러 구성 탭에서 사용 설정됨을 선택하여 이벤트 핸들러를 활성화합니다(사용 중지된 경우).
  9. 감사 로그의 주제를 선택합니다.
    • 액세스
    • 활동
    • 인증
    • 구성
  10. 저장을 클릭합니다.
  11. Syslog Configuration(Syslog 구성) 탭에서 다음 구성 세부정보를 제공합니다.
    • 서버 호스트 이름: Bindplane 에이전트 IP 주소를 입력합니다.
    • 서버 포트: Bindplane 에이전트 포트 번호를 입력합니다.
    • 연결 시간 제한: 연결 시간(초)을 입력합니다(예: 120).
    • 전송 프로토콜: UDP를 선택합니다.
    • Facility(기능): Local0을 선택합니다.
    • 모든 주제는 심각도를 INFORMATIONAL로 설정합니다.
  12. 저장을 클릭합니다.

  13. 버퍼링 탭에서 버퍼링 사용 설정을 선택하여 활성화합니다.

  14. 저장을 클릭합니다.

UDM 매핑 테이블

로그 필드 UDM 매핑 논리
client.ip principal.ip 요청하는 클라이언트의 IP 주소입니다.
client.ip principal.asset.ip 요청을 하는 클라이언트 애셋의 IP 주소입니다.
client.port principal.port 요청을 실행하는 클라이언트가 사용하는 포트입니다.
entries[0].info.authLevel principal.resource.resource_subtype 이벤트와 연결된 인증 수준입니다. 'authLevel:'이(가) 앞에 붙습니다.
entries[0].info.displayName security_result.description 인증 트리의 노드에 대한 설명 이름입니다.
entries[0].info.ipAddress principal.asset.ip 이벤트의 주체와 연결된 IP 주소입니다.
entries[0].info.ipAddress principal.ip 이벤트의 주체와 연결된 IP 주소입니다.
entries[0].info.nodeId principal.resource.id 인증 트리의 노드 고유 식별자입니다. 'nodeId:'가 앞에 붙습니다.
entries[0].info.nodeOutcome principal.resource.attribute.labels.value 인증 트리의 노드 결과입니다.
entries[0].info.nodeType principal.resource.type 인증 트리의 노드 유형입니다. 'nodeType:'이 앞에 붙습니다.
entries[0].info.treeName principal.resource.name 인증 트리의 이름입니다. 'treeName:'이 접두사로 붙습니다.
eventName metadata.product_event_type OpenAM 로그의 원시 이벤트 이름입니다.
http.request.headers.host[0] target.asset.hostname host 헤더에서 추출한 타겟 서버의 호스트 이름입니다.
http.request.headers.host[0] target.hostname host 헤더에서 추출한 타겟 서버의 호스트 이름입니다.
http.request.headers.user-agent[0] network.http.user_agent HTTP 요청의 사용자 에이전트입니다.
http.request.method network.http.method 요청에 사용된 HTTP 메서드입니다.
http.request.path target.url HTTP 요청 URL의 경로입니다.
info.failureReason security_result.summary 인증 실패 이유입니다. 'SSO'로 하드코딩됩니다. eventName 및 기타 필드를 기반으로 하는 논리에 따라 결정됩니다. GENERIC_EVENT, USER_LOGIN, USER_LOGOUT, NETWORK_HTTP, STATUS_UPDATE일 수 있습니다. 'OPENAM'으로 하드코딩됨 'OpenAM'으로 하드코딩됩니다. 'ForgeRock'으로 하드코딩됩니다.
principal target.user.userid userId, principal 또는 runAs 필드에서 추출된 이벤트에 관련된 사용자 ID입니다.
result security_result.action_details 이벤트의 결과입니다 (예: 'SUCCESSFUL', 'FAILED')을 반환합니다.
response.detail.reason security_result.summary 액세스 결과 이벤트의 실패 이유입니다.
response.status security_result.action_details 액세스 결과 이벤트의 응답 상태입니다.
runAs target.user.userid userId, principal 또는 runAs 필드에서 추출된 이벤트에 관련된 사용자 ID입니다.
security_result.action security_result.action 보안 이벤트의 결과로 취해진 조치입니다 (예: 'ALLOW', 'BLOCK').
server.ip target.asset.ip 타겟 서버의 IP 주소입니다.
server.ip target.ip 타겟 서버의 IP 주소입니다.
server.port target.port 타겟 서버의 포트입니다.
timestamp metadata.event_timestamp 이벤트의 타임스탬프입니다.
trackingIds metadata.product_log_id 이벤트와 연결된 추적 ID입니다.
transactionId metadata.product_deployment_id 이벤트와 연결된 거래 ID입니다.
userId target.user.userid userId, principal 또는 runAs 필드에서 추출된 이벤트에 관련된 사용자 ID입니다.
userId target.user.group_identifiers 사용자와 연결된 그룹 식별자입니다.
am_group target.user.group_identifiers 사용자와 연결된 그룹 식별자입니다.
am_user target.user.email_addresses am_user 필드에 있는 경우 사용자의 이메일 주소입니다.
loginID[0] target.user.userid 이벤트에 사용된 로그인 ID입니다.
loginID[0] target.user.email_addresses loginID 필드에 있는 경우 로그인에 사용된 이메일 주소입니다.
hostip intermediary.hostname 중개 기기의 호스트 이름입니다.
hostip intermediary.ip 중개 기기의 IP 주소입니다.
src_ip principal.asset.ip 소스 IP 주소입니다.
src_ip principal.ip 소스 IP 주소입니다.
desc metadata.description 이벤트에 대한 설명입니다.
payload metadata.description 이벤트의 페이로드입니다.

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가로부터 답변을 받으세요.