Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

PingIDM (이전 명칭: ForgeRock OpenIDM) 로그 수집

파서 버전: 4.0

다음에서 지원:

Google SecOps SIEM

이 문서에서는 Google Cloud Storage V2를 사용하여 PingIDM (이전 명칭: ForgeRock OpenIDM) 로그를 Google Security Operations로 수집하는 방법을 설명합니다.

PingIDM은 사용자 프로비저닝, 동기화, 비밀번호 관리, 액세스 거버넌스를 제공하는 ID 관리 플랫폼입니다. ID 수명 주기 이벤트, 인증 시도, 조정 작업, 구성 변경사항을 REST를 통해 액세스할 수 있는 감사 로그에 기록합니다.

시작하기 전에

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

Google SecOps 인스턴스입니다.
Cloud Storage API가 사용 설정된 GCP 프로젝트
GCS 버킷 및 IAM 정책을 만들고 관리할 수 있는 권한
Cloud Run 서비스, Pub/Sub 주제, Cloud Scheduler 작업을 만들 수 있는 권한
관리자 인증 정보가 있는 ForgeRock OpenIDM 또는 PingIDM 인스턴스에 대한 권한 액세스

Google Cloud Storage 버킷 만들기

Google Cloud 콘솔로 이동합니다.
프로젝트를 선택하거나 새 프로젝트를 만듭니다.
탐색 메뉴에서 Cloud Storage > 버킷으로 이동합니다.
버킷 만들기를 클릭합니다.

다음 구성 세부정보를 제공합니다.

설정	값
버킷 이름 지정	전역적으로 고유한 이름 (예: `forgerock-openidm-audit-logs`)을 입력합니다.
위치 유형	필요에 따라 선택 (리전, 이중 리전, 멀티 리전)
위치	위치를 선택합니다 (예: `us-central1`).
스토리지 클래스	Standard (자주 액세스하는 로그에 권장)
액세스 제어	균일 (권장)
보호 조치	선택사항: 객체 버전 관리 또는 보관 정책 사용 설정

만들기를 클릭합니다.

ForgeRock OpenIDM 사용자 인증 정보 수집

ForgeRock OpenIDM 기본 URL 가져오기

ForgeRock OpenIDM 또는 PingIDM 인스턴스에 로그인합니다.
브라우저 주소 표시줄에서 기본 URL을 확인합니다.
- 형식: https://openidm.example.com
- /admin와 같은 후행 슬래시나 경로를 포함하지 마세요.

관리 사용자 인증 정보 가져오기

ForgeRock OpenIDM 인스턴스의 관리 사용자 인증 정보를 가져옵니다.
필요한 사항은 다음과 같습니다.
- 사용자 이름: 관리 사용자 이름 (예: openidm-admin)
- 비밀번호: 관리 비밀번호

권한 확인

ForgeRock OpenIDM에 로그인합니다.
구성 > 시스템 환경설정 > 감사로 이동합니다.
감사 구성과 주제가 표시되면 필요한 권한이 있는 것입니다.
이 옵션이 표시되지 않으면 관리자에게 문의하여 감사 읽기 권한을 부여받으세요.

API 액세스 테스트

통합을 진행하기 전에 사용자 인증 정보를 테스트합니다.

# Replace with your actual credentials
OPENIDM_BASE_URL="[https://openidm.example.com](https://openidm.example.com)"
OPENIDM_USERNAME="openidm-admin"
OPENIDM_PASSWORD="your-admin-password"

# Test API access to authentication audit topic
curl -v \
    -H "X-OpenIDM-Username: ${OPENIDM_USERNAME}" \
    -H "X-OpenIDM-Password: ${OPENIDM_PASSWORD}" \
    -H "Accept-API-Version: resource=1.0" \
    -H "Accept: application/json" \
    "${OPENIDM_BASE_URL}/openidm/audit/authentication?_queryFilter=true&_pageSize=1"

예상 응답: 감사 이벤트가 포함된 JSON과 함께 HTTP 200

Cloud Run 함수의 서비스 계정 만들기

Cloud Run 함수에는 GCS 버킷에 쓸 수 있고 Pub/Sub에 의해 호출될 수 있는 권한이 있는 서비스 계정이 필요합니다.

서비스 계정 만들기

GCP 콘솔에서 IAM 및 관리자 > 서비스 계정으로 이동합니다.
서비스 계정 만들기를 클릭합니다.
다음 구성 세부정보를 제공합니다.
- 서비스 계정 이름: forgerock-openidm-collector-sa
- 서비스 계정 설명: Service account for Cloud Run function to collect ForgeRock OpenIDM logs
만들고 계속하기를 클릭합니다.
이 서비스 계정에 프로젝트에 대한 액세스 권한 부여 섹션에서 다음 역할을 추가합니다.
1. 스토리지 객체 관리자: GCS 버킷에 로그를 쓰고 상태 파일을 관리합니다.
2. Cloud Run 호출자: Pub/Sub가 함수를 호출할 수 있도록 합니다.
3. Cloud Functions 호출자: 함수 호출을 허용합니다.
계속을 클릭한 다음 완료를 클릭합니다.

GCS 버킷에 대한 IAM 권한 부여

Cloud Storage > 버킷으로 이동합니다.
버킷 이름 (예: forgerock-openidm-audit-logs)을 클릭합니다.
권한 탭으로 이동합니다.
액세스 권한 부여를 클릭합니다.
다음 구성 세부정보를 제공합니다.
- 주 구성원 추가: 서비스 계정 이메일 (예: forgerock-openidm-collector-sa@PROJECT_ID.iam.gserviceaccount.com)을 입력합니다.
- 역할 할당: 스토리지 객체 관리자를 선택합니다.
저장을 클릭합니다.

Pub/Sub 주제 만들기

GCP 콘솔에서 Pub/Sub > 주제로 이동합니다.
주제 만들기를 클릭합니다.
다음 구성 세부정보를 제공합니다.
- Topic ID: forgerock-openidm-trigger
- 다른 설정은 기본값으로 둡니다.
만들기를 클릭합니다.

로그를 수집하는 Cloud Run 함수 만들기

GCP 콘솔에서 Cloud Run으로 이동합니다.
서비스 만들기를 클릭합니다.
함수를 선택합니다 (인라인 편집기를 사용하여 함수 만들기).
구성 섹션에서 다음 구성 세부정보를 입력합니다.

설정 값

서비스 이름 forgerock-openidm-collector

리전 GCS 버킷과 일치하는 리전을 선택합니다 (예: us-central1).

런타임 Python 3.12 이상 선택
트리거 섹션에서 다음을 수행합니다.
1. + 트리거 추가를 클릭합니다.
2. Cloud Pub/Sub을 선택합니다.
3. Cloud Pub/Sub 주제 선택에서 forgerock-openidm-trigger를 선택합니다.
4. 저장을 클릭합니다.
인증 섹션에서 다음을 구성합니다.
1. 인증 필요를 선택합니다.
2. ID 및 액세스 관리 (IAM)를 확인합니다.
아래로 스크롤하고 컨테이너, 네트워킹, 보안을 펼칩니다.
보안 탭으로 이동합니다.
- 서비스 계정: forgerock-openidm-collector-sa를 선택합니다.

설정	값
서비스 이름	`forgerock-openidm-collector`
리전	GCS 버킷과 일치하는 리전을 선택합니다 (예: `us-central1`).
런타임	Python 3.12 이상 선택

컨테이너 탭으로 이동합니다.

변수 및 보안 비밀을 클릭합니다.
각 환경 변수에 대해 + 변수 추가를 클릭합니다.

변수 이름	예시 값	설명
`GCS_BUCKET`	`forgerock-openidm-audit-logs`	GCS 버킷 이름
`GCS_PREFIX`	`openidm`	로그 파일의 접두사
`STATE_KEY`	`openidm/state.json`	상태 파일 경로
`OPENIDM_BASE_URL`	`https://openidm.example.com`	OpenIDM 기준 URL
`OPENIDM_USERNAME`	`openidm-admin`	OpenIDM 관리자 사용자 이름
`OPENIDM_PASSWORD`	`your-admin-password`	OpenIDM 관리자 비밀번호
`AUDIT_TOPICS`	`access,activity,authentication,config,sync`	쉼표로 구분된 주제
`PAGE_SIZE`	`100`	페이지당 레코드 수
`MAX_PAGES`	`50`	주제당 최대 페이지 수

요청 섹션에서 다음을 확인합니다.
- 요청 제한 시간: 600초
설정 탭으로 이동합니다.
- 리소스: 512MiB 메모리, 1 CPU
만들기를 클릭합니다. 서비스가 생성되면 인라인 코드 편집기가 열립니다.

함수 코드 추가

진입점 필드에 main을 입력합니다.

편집기에서 두 파일을 만듭니다.

main.py:

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

# 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', 'openidm')
STATE_KEY = os.environ.get('STATE_KEY', 'openidm/state.json')
OPENIDM_BASE_URL = os.environ.get('OPENIDM_BASE_URL')
OPENIDM_USERNAME = os.environ.get('OPENIDM_USERNAME')
OPENIDM_PASSWORD = os.environ.get('OPENIDM_PASSWORD')
AUDIT_TOPICS = os.environ.get('AUDIT_TOPICS', 'access,activity,authentication,config,sync').split(',')
PAGE_SIZE = int(os.environ.get('PAGE_SIZE', '100'))
MAX_PAGES = int(os.environ.get('MAX_PAGES', '50'))

@functions_framework.cloud_event
def main(cloud_event):
    """
    Cloud Run function triggered by Pub/Sub to fetch ForgeRock OpenIDM logs and write to GCS.
    """
    if not all([GCS_BUCKET, OPENIDM_BASE_URL, OPENIDM_USERNAME, OPENIDM_PASSWORD]):
        print('Error: Missing required environment variables')
        return

    try:
        bucket = storage_client.bucket(GCS_BUCKET)
        state = load_state(bucket, STATE_KEY)

        all_events = []
        for topic in AUDIT_TOPICS:
            topic = topic.strip()
            print(f"Fetching audit logs for topic: {topic}")
            events = fetch_audit_logs(topic, state.get(topic, {}))
            all_events.extend(events)

            if events:
                latest_timestamp = max(e.get('timestamp', '') for e in events)
                state[topic] = {
                    'last_timestamp': latest_timestamp,
                    'last_run': datetime.now(timezone.utc).isoformat(),
                    'events_count': len(events)
                }

        if all_events:
            write_to_gcs(bucket, all_events)
            save_state(bucket, STATE_KEY, state)
            print(f"Successfully processed {len(all_events)} audit events")
        else:
            print("No new audit events to process")

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

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

def save_state(bucket, key, state):
    try:
        blob = bucket.blob(key)
        blob.upload_from_string(json.dumps(state, indent=2), content_type='application/json')
    except Exception as e:
        print(f"Warning: Could not save state: {e}")

def fetch_audit_logs(topic, topic_state):
    base_url = OPENIDM_BASE_URL.rstrip('/')
    all_events = []
    last_timestamp = topic_state.get('last_timestamp')
    query_filter = 'true' if not last_timestamp else f'timestamp gt "{last_timestamp}"'
    page_offset = 0
    page_count = 0

    while page_count < MAX_PAGES:
        try:
            url = f"{base_url}/openidm/audit/{topic}"
            params = {
                '_queryFilter': query_filter,
                '_pageSize': str(PAGE_SIZE),
                '_pagedResultsOffset': str(page_offset),
                '_sortKeys': 'timestamp'
            }

            headers = {
                'X-OpenIDM-Username': OPENIDM_USERNAME,
                'X-OpenIDM-Password': OPENIDM_PASSWORD,
                'Accept-API-Version': 'resource=1.0',
                'Accept': 'application/json'
            }

            response = http.request('GET', url, fields=params, headers=headers)
            if response.status != 200:
                print(f"API error for topic {topic}: {response.status}")
                break

            data = json.loads(response.data.decode('utf-8'))
            events = data.get('result', [])
            if not events:
                break

            all_events.extend(events)
            page_offset += PAGE_SIZE
            page_count += 1
            if len(events) < PAGE_SIZE:
                break
        except Exception as e:
            print(f"Error for topic {topic}: {str(e)}")
            break
    return all_events

def write_to_gcs(bucket, events):
    timestamp = datetime.now(timezone.utc).strftime('%Y%m%d_%H%M%S')
    filename = f"{GCS_PREFIX}/openidm_audit_{timestamp}.json"
    ndjson_content = '\n'.join([json.dumps(event) for event in events])
    bucket.blob(filename).upload_from_string(ndjson_content, content_type='application/x-ndjson')

requirements.txt:

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

배포를 클릭합니다. 배포하는 데 2~3분이 걸립니다.

Cloud Scheduler 작업 만들기

GCP Console에서 Cloud Scheduler로 이동합니다.
작업 만들기를 클릭합니다.

다음 구성 세부정보를 제공합니다.

설정	값
이름	`forgerock-openidm-collector-hourly`
리전	Cloud Run 함수와 동일한 리전 선택
주파수	`0 * * * *` (매시간)
시간대	시간대 선택 (UTC 권장)
타겟 유형	Pub/Sub
주제	`forgerock-openidm-trigger`
메일 본문	`{}`

만들기를 클릭합니다.

일정 빈도 옵션

빈도	크론 표현식	사용 사례
5분마다	`/5 * * *`	대용량, 저지연
1시간마다	`0 * * * *`	표준 (권장)
매일	`0 0 * * *`	일괄 수집

통합 테스트

Cloud Scheduler에서 작업의 강제 실행을 클릭합니다.
Cloud Run 로그에서 실행을 확인합니다. Successfully processed X audit events을 찾습니다.
openidm/ 폴더 아래의 Cloud Storage 버킷에 새 json 파일이 있는지 확인합니다.

Google SecOps 서비스 계정 가져오기

Google SecOps에서 피드 구성

SIEM 설정 > 피드로 이동합니다.
새 피드 추가 > 단일 피드 구성을 클릭합니다.
피드 이름: ForgeRock OpenIDM Audit Logs
소스 유형: Google Cloud Storage V2
로그 유형: FORGEROCK_OPENIDM
서비스 계정 가져오기를 클릭하고 제공된 이메일 (예: chronicle-12345...)을 복사합니다.
다음을 클릭합니다.
스토리지 버킷 URL: gs://forgerock-openidm-audit-logs/openidm/.
소스 삭제 옵션: 원하는 대로 선택합니다 (예: 안 함).
다음을 클릭하고 검토한 후 제출을 클릭합니다.

IAM 권한 부여

Cloud Storage > 버킷으로 이동합니다.
버킷을 선택하고 권한 탭을 클릭합니다.
액세스 권한 부여를 클릭합니다.
주 구성원 추가: Google SecOps 서비스 계정 이메일을 붙여넣습니다.
역할 할당: 스토리지 객체 뷰어를 선택합니다.
저장을 클릭합니다.

UDM 매핑 테이블

로그 필드	UDM 매핑	로직
`fluenttag_label`, `topic_label`, `context_roles_label`	`additional.fields`	컨텍스트의 키-값 쌍입니다.
`Via`	`intermediary.hostname`	프록시/중개자의 호스트 이름입니다.
`x_forwarded_ip`, `caller.callerIps`	`intermediary.ip`	중개자의 IP입니다.
`timestamp`	`metadata.event_timestamp`	이벤트 타임스탬프입니다.
`transactionId`	`metadata.product_deployment_id`	고유한 거래 ID입니다.
`eventName`	`metadata.product_event_type`	ForgeRock의 이벤트 이름입니다.
`_id`	`metadata.product_log_id`	고유 로그 식별자입니다.
`request_method`	`network.http.method`	사용된 HTTP 메서드입니다.
`response.statusCode`	`network.http.response_code`	HTTP 상태 코드
`user_agent`	`network.http.user_agent`	전체 사용자 에이전트 문자열입니다.
`client.ip`, `context.ipAddress`	`principal.ip`	작업 수행자의 소스 IP입니다.
`userId`, `principalData.0`	`principal.user.userid`	행위자 사용자의 ID입니다.
`security_action`	`security_result.action`	보안 결정이 내려졌습니다.
`level`	`security_result.severity`	매핑된 심각도 수준입니다.
`server.ip`	`target.ip`	타겟 시스템의 IP입니다.
`http.request.path`	`target.url`	타겟 URL/경로입니다.
해당 사항 없음	`metadata.product_name`	ForgeRock OpenIDM으로 설정합니다.
해당 사항 없음	`metadata.vendor_name`	ForgeRock으로 설정합니다.
`elapsed_time" and "X-Content-Type-Options`	`additional.fields`	변경 로그에서 매핑됨
`trackingIds.0`	`metadata.product_log_id`	변경 로그에서 매핑됨
`context.userRolesProperty", "context.authenticationId", and "context.authenticationIdProperty`	`principal.user.attribute.roles`	변경 로그에서 매핑됨
`context.component", "context.moduleId", and "context.queryId`	`principal.resource.attribute.labels`	변경 로그에서 매핑됨
`context.roles", "_normalized.fieldNames", and "_eventId`	`additional.fields`	변경 로그에서 매핑됨

변경 로그

이 파서의 변경 로그 보기

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