로그 필드	UDM 매핑	로직
	extensions.auth.mechanism	사용된 인증 메커니즘입니다.
	extensions.auth.type	인증 유형입니다.
합계	metadata.description	이벤트에 대한 설명입니다.
	metadata.event_type	이벤트 유형입니다.
event_type, cat	metadata.product_event_type	제품별 이벤트 유형입니다.
product_version	metadata.product_version	제품 버전입니다.
터미널	principal.hostname	주 구성원과 연결된 호스트 이름입니다.
name	principal.user.user_display_name	사용자의 표시 이름입니다.
usrName	principal.user.userid	사용자 ID입니다.
	security_result.action	보안 시스템에서 취한 조치입니다.
	security_result.category	보안 결과의 카테고리입니다.
클래스	security_result.category_details	보안 결과 카테고리에 관한 추가 세부정보입니다.
reason	security_result.severity	보안 결과의 심각도 수준입니다.
reason	security_result.severity_details	자세한 심각도 정보입니다.
logstr	security_result.summary	보안 결과 요약입니다.
job_id	target.application	타겟팅되는 애플리케이션입니다.
job_group	target.group.group_display_name	그룹의 표시 이름입니다.
	target.namespace	타겟의 네임스페이스입니다.
dsn	target.resource.name	리소스 이름입니다.
vol	target.resource.parent	상위 리소스입니다.
res, dsn	target.resource.product_object_id	제품별 객체 식별자입니다.
	target.resource.resource_type	리소스 유형
name	target.user.user_display_name	타겟 사용자의 표시 이름입니다.
usrName	target.user.userid	대상 사용자의 사용자 ID입니다.
product_name	metadata.product_name	이벤트를 생성하는 제품의 이름입니다.
vendor_name	metadata.vendor_name	공급업체 이름입니다.

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

CA ACF2 로그 수집

파서 버전: 2.0

다음에서 지원:

Google SecOps SIEM

이 문서에서는 Bindplane 에이전트를 사용하여 CA ACF2 로그를 Google Security Operations로 수집하는 방법을 설명합니다.

z/OS용 Broadcom ACF2 (Access Control Facility 2)는 IBM z/OS 시스템에 대한 액세스 제어, 인증, 감사를 제공하는 메인프레임 보안 제품입니다. ACF2는 인증 시도, 데이터 세트 액세스 위반, 리소스 액세스 이벤트, TSO 명령어 로깅, 데이터베이스 수정 등 보안 이벤트를 IBM System Management Facility (SMF) 레코드 (기본 유형 230)에 로깅합니다. 이러한 SMF 레코드는 BMC AMI Defender for z/OS와 같은 서드 파티 에이전트를 사용하여 Chronicle로 전달해야 합니다.

시작하기 전에

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

Google SecOps 인스턴스
Windows Server 2016 이상 또는 systemd가 설치된 Linux 호스트
Bindplane 에이전트와 BMC AMI Defender for z/OS 에이전트 간의 네트워크 연결
프록시 뒤에서 실행하는 경우 Bindplane 에이전트 요구사항에 따라 방화벽 포트가 열려 있는지 확인합니다.
ACF2가 활성화된 z/OS LPAR에 BMC AMI Defender for z/OS가 설치되어 실행 중임
amihlq.CZAGENT.PARM 데이터 세트에서 BMC AMI Defender 매개변수 파일을 수정할 수 있는 액세스 권한
z/OS에서 CZAGENT 시작 태스크를 시작하거나 수정할 수 있는 권한

Bindplane 에이전트의 Google SecOps 사용자 인증 정보 가져오기

Google SecOps에 Bindplane 에이전트를 인증하려면 다음 방법 중 하나를 선택합니다.

새 배포: Chronicle API를 사용합니다 (옵션 1).
기존 배포: 2027년 7월 20일에 수집 API가 지원 중단될 때까지 수집 인증 파일 (옵션 2)을 계속 사용합니다.

옵션 1: Chronicle API의 서비스 계정 만들기 (권장)

Google Cloud 콘솔에 로그인하고 Google SecOps 인스턴스에 연결된 Google Cloud 프로젝트를 선택합니다.
IAM 및 관리자 > 서비스 계정으로 이동합니다.
서비스 계정 만들기를 클릭합니다.
다음 구성 세부정보를 제공합니다.
- 서비스 계정 이름: 계정 이름을 입력합니다 (예: bindplane-ingest).
- 서비스 계정 설명: 설명 (예: Bindplane agent log ingestion)을 입력합니다.
만들고 계속하기를 클릭합니다.
이 서비스 계정에 프로젝트에 대한 액세스 권한 부여 섹션에서 역할 선택을 클릭하고 Chronicle 편집자를 선택합니다.
계속을 클릭한 다음 완료를 클릭합니다.
만든 서비스 계정을 클릭한 다음 키 탭으로 이동합니다.
키 추가 > 새 키 만들기를 클릭합니다.
JSON을 선택하고 만들기를 클릭합니다. 키 파일이 컴퓨터에 다운로드됩니다.
키 파일을 Bindplane 수집기 디렉터리 (Linux의 경우 /opt/observiq-otel-collector/ingestion-auth.json, Windows의 경우 C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json)에 ingestion-auth.json로 저장하거나 config.yaml의 creds_file_path를 업데이트하여 저장한 경로와 일치시킵니다.
IAM 및 관리자 > 설정으로 이동하여 프로젝트 번호를 복사합니다. 내보내기 도구 구성에 필요합니다.

옵션 2: 데이터 수집 인증 파일 다운로드 (기존)

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

Google SecOps 고객 ID 가져오기

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

참고: Bindplane 에이전트 내보내기를 구성하려면 customer 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
```
3. 설치가 완료될 때까지 기다립니다.
4. 다음을 실행하여 설치를 확인합니다.
```
sc query observiq-otel-collector
```
  서비스가 RUNNING으로 표시됩니다.
Linux 설치
1. 루트 또는 sudo 권한으로 터미널을 엽니다.
2. 다음 명령어를 실행합니다.
```
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
```
3. 설치가 완료될 때까지 기다립니다.
4. 다음을 실행하여 설치를 확인합니다.
```
sudo systemctl status observiq-otel-collector
```
  서비스가 active (running)으로 표시됩니다.

추가 설치 리소스

추가 설치 옵션 및 문제 해결은 Bindplane 에이전트 설치 가이드를 참고하세요.

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

구성 파일 찾기

Linux:

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

Windows:

notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"

구성 파일 설정

config.yaml의 전체 콘텐츠를 다음 구성으로 바꿉니다.

receivers:
  udplog:
    listen_address: "0.0.0.0:514"

exporters:
  chronicle/acf2_logs:
    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: '/opt/observiq-otel-collector/ingestion-auth.json'
    customer_id: 'YOUR_CUSTOMER_ID'
    endpoint: chronicle.googleapis.com
    log_type: CA_ACF2
    raw_log_field: body
    ingestion_labels:
      env: production
      source: acf2

service:
  pipelines:
    logs/acf2_to_chronicle:
      receivers:
        - udplog
      exporters:
        - chronicle/acf2_logs

다음 자리표시자를 바꿉니다.
- 수신자 구성:
  - listen_address: UDP 포트 514의 모든 인터페이스에서 리슨하도록 0.0.0.0:514로 설정합니다.
    - 루트가 아닌 사용자로 실행되는 Linux 시스템의 경우 포트 1514 이상을 사용하세요.
    - 이 포트를 BMC AMI Defender 서버 문 구성과 일치시킵니다.
- 내보내기 도구 구성:
  - creds_file_path: 서비스 계정 JSON 키 파일의 전체 경로 (옵션 1):
    - Linux: /opt/observiq-otel-collector/ingestion-auth.json
    - Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
  - customer_id: YOUR_CUSTOMER_ID을 customer ID로 바꿉니다. 자세한 내용은 Google SecOps 고객 ID 가져오기를 참조하세요.
  - location: <LOCATION>을 Google SecOps 인스턴스의 리전으로 바꿉니다 (예: us, europe 또는 asia-southeast1). 내보내기 도구는 이 값으로 chronicle.googleapis.com에 프리픽스를 추가합니다. 전체 목록은 리전 엔드포인트를 참고하세요.
  - project: <PROJECT_NUMBER>을 IAM 및 관리자 > 설정의 프로젝트 번호로 바꿉니다.
  - endpoint: chronicle.googleapis.com로 설정된 상태를 유지합니다.
  - log_type: CA_ACF2 (ACF2 로그의 Chronicle 수집 라벨)로 설정합니다.
  - ingestion_labels: 로그를 분류하기 위한 선택적 라벨 (필요에 따라 맞춤설정)

기존 수집 API 내보내기 도구

옵션 2의 데이터 수집 인증 파일을 사용하는 경우 exporters 블록을 다음으로 바꿉니다. creds_file_path을 수집 인증 파일의 경로로 설정하고 인스턴스가 미국 외부에 있는 경우 malachiteingestion-pa.googleapis.com을 리전 엔드포인트 (예: europe-malachiteingestion-pa.googleapis.com)로 바꿉니다.

exporters:
  chronicle/acf2_logs:
    compression: gzip
    creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
    customer_id: 'YOUR_CUSTOMER_ID'
    endpoint: malachiteingestion-pa.googleapis.com
    log_type: CA_ACF2
    raw_log_field: body
    ingestion_labels:
      env: production
      source: acf2

구성 파일 저장

수정 후 파일을 저장합니다.

Linux: Ctrl+O, Enter, Ctrl+X를 차례로 누릅니다.
Windows: 파일 > 저장을 클릭합니다.

변경사항을 적용하려면 Bindplane 에이전트를 다시 시작하세요.

Linux에서 Bindplane 에이전트를 다시 시작하려면 다음 안내를 따르세요.
1. 다음 명령어를 실행합니다.
```
sudo systemctl restart observiq-otel-collector
```
2. 서비스가 실행 중인지 확인합니다.
```
sudo systemctl status observiq-otel-collector
```
3. 로그에서 오류를 확인합니다.
```
sudo journalctl -u observiq-otel-collector -f
```
Windows에서 Bindplane 에이전트를 다시 시작하려면 다음 안내를 따르세요.
1. 다음 옵션 중 하나를 선택합니다.
  - 관리자 권한으로 명령 프롬프트 또는 PowerShell:
```
net stop observiq-otel-collector && net start observiq-otel-collector
```
  - 서비스 콘솔:
    1. Win+R를 누르고 services.msc를 입력한 다음 Enter 키를 누릅니다.
    2. observIQ OpenTelemetry Collector를 찾습니다.
    3. 마우스 오른쪽 버튼으로 클릭하고 다시 시작을 선택합니다.
2. 서비스가 실행 중인지 확인합니다.
```
sc query observiq-otel-collector
```
3. 로그에서 오류를 확인합니다.
```
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
```

ACF2 SMF 레코드를 전달하도록 BMC AMI Defender for z/OS 구성

$$$SERVR parameter member

Sign in to the z/OS system using TSO/ISPF or a 3270 emulator.
Navigate to the BMC AMI Defender parameter library:
1. Enter ISPF at the TSO READY prompt.
2. Select option 2 (Edit).
3. In the ISPF Library field, enter the data set name: amihlq.CZAGENT.PARM (replace amihlq with your installation high-level qualifier).
4. Press Enter.
Edit the $$$SERVR 구성원을 수정합니다.

$$$SERVR member.

Press Enter.

Locate the SERVER statement section (approximately line 40-60).

Uncomment one of the SERVER statements by removing the leading semicolon (;).

Configure the SERVER statement with the Bindplane agent IP address and port:

SERVER bindplane-host-ip:514 TRANS(UDP) MAXMSG(2000)

Replace bindplane-host-ip with the IP address of the Bindplane agent host (for example, 192.168.1.100).

If using a non-standard port (for example, 1514), specify: bindplane-host-ip:1514.

TRANS(UDP) specifies UDP transport protocol (recommended for syslog).

MAXMSG(2000) sets the maximum message length to 2000 bytes (ACF2 records may require larger sizes).

Verify the OPTIONS statement for syslog format:

Scroll up to locate the OPTIONS statements (approximately line 10-30).

Ensure one of the following OPTIONS statements is uncommented based on your preferred format:

OPTIONS IF(RFC 3164) SIEM(RFC 3164) TIMESTAMP INSTNAME(SIEM.Agent)

RFC 3164: Standard syslog format (recommended for Chronicle)

CEF: Common Event Format (alternative)

LEEF: Log Event Extended Format (alternative)

JSON: JSON format (alternative)

Save the changes:

Press F3 to exit the editor.

Type SAVE when prompted.

Press Enter.

Edit the $$$CONFG 매개변수 구성원 옆에 E를 입력하여 ACF2 SMF 레코드 수집을 사용 설정

amihlq.CZAGENT.PARM 데이터 세트 구성원 목록에서 $$$CONFG member:

Type E next to the $$$CONFG 구성원을 수정합니다.

Enter를 누릅니다.

ACF2 SMF 레코드 선택 스위치를 찾습니다 (ACF2 또는 SMF 230 검색).

ACF2의 SELECT 문 주석 처리를 삭제합니다.

SELECT IF(ACF2) SMF(ACF2)

이렇게 하면 ACF2 SMF 레코드 (기본 유형 230)를 수집할 수 있습니다.

사이트에서 ACF2에 다른 SMF 레코드 유형을 사용하는 경우 TSO에서 ACF SHOW SYSTEMS 명령어를 사용하여 유형을 확인합니다.

변경사항을 저장합니다.

F3을 눌러 편집기를 종료합니다.

메시지가 표시되면 SAVE를 입력합니다.

Enter를 누릅니다.

SMF ACF2 문 매개변수 구성원 만들기 또는 수정

amihlq.CZAGENT.PARM 데이터 세트 구성원 목록에서 $$$ACF2 or SMFACF2 exists.

If the member does not exist, create it:

Type C (Create) on the command line.

Enter the member name: $$$ACF2.라는 구성원이 있는지 확인합니다.
Enter를 누릅니다.
구성원을 수정하고 다음 SMF ACF2 문을 추가합니다.
SMF ACF2(230) FACILITY(SECURITY4) SEVERITY(INFORMATIONAL) ACF2(230): ACF2의 SMF 레코드 유형을 지정합니다 (기본값은 230임. ACF SHOW SYSTEMS로 확인). FACILITY(SECURITY4): syslog 기능을 보안 (4)으로 설정합니다. SEVERITY(INFORMATIONAL): 기본 심각도를 정보로 설정합니다. 잘못된 비밀번호 또는 권한 위반은 심각도 ERROR로 자동 전송됩니다. 리소스 위반은 심각도 ERROR로 자동 전송됩니다.
원하는 경우 특정 ACF2 하위유형 및 심각도를 구성합니다. SMF ACF2(230) + FACILITY(SECURITY4) + SEVERITY(INFORMATIONAL) + SUBTYPES(P SEV(ERROR)) + SUBTYPES(V SEV(ERROR)) + SUBTYPES(D SEV(ERROR)) 하위 유형 P: 잘못된 비밀번호 또는 권한 이벤트 (심각도: 오류) 하위 유형 V: 리소스 위반 (심각도: 오류) 하위 유형 D: 데이터 세트 액세스 위반 (오류 심각도) 변경사항을 저장합니다. F3을 눌러 편집기를 종료합니다. 메시지가 표시되면 SAVE를 입력합니다. Enter를 누릅니다. BMC AMI Defender 파라미터 파일 새로고침 ISPF를 종료하고 TSO READY 프롬프트로 돌아갑니다. MODIFY 명령어를 실행하여 파라미터 파일을 새로고침합니다. F CZAGENT,PARMS 다른 경우 CZAGENT을 BMC AMI Defender 시작 작업 이름으로 바꿉니다. 이 명령어는 에이전트를 중지하지 않고 파라미터 파일을 새로고침합니다. CZAPRINT 출력을 확인하여 구성을 확인합니다. ISPF에서 옵션 3.4 (DSLIST)를 선택합니다. 데이터 세트 이름 패턴 (CZAGENT.CZAPRINT 또는 사이트별 이름 지정 규칙)을 입력합니다. Enter를 누릅니다. 최신 CZAPRINT 데이터 세트 옆에 B (찾아보기)를 입력합니다. Enter를 누릅니다. 시스템로그 서버에 성공적으로 연결되었음을 나타내는 메시지를 검색합니다. CZA0070I Connected to server bindplane-host-ip:514 CZA0100I SMF ACF2 statement processed CZAGENT 시작 태스크가 실행 중이 아니면 시작합니다. S CZAGENT ACF2 로그 전달 확인 테스트 ACF2 보안 관련 활동을 생성합니다. TSO에서 액세스 권한이 없는 데이터 세트에 액세스하려고 시도합니다. 잘못된 비밀번호로 로그인을 시도합니다 (테스트 계정 사용). ACF2에서 로깅하는 TSO 명령어를 실행합니다. Bindplane 에이전트 로그를 확인하여 ACF2 syslog 메시지를 수신했는지 확인합니다. Linux: sudo journalctl -u observiq-otel-collector -f | grep ACF2 Windows: type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log" | findstr ACF2 Google SecOps 콘솔에 로그인하여 ACF2 로그가 수집되고 있는지 확인합니다. 검색 > UDM 검색으로 이동합니다. 다음 쿼리를 입력합니다. metadata.log_type = "CA_ACF2" ACF2 보안 이벤트가 검색 결과에 표시되는지 확인합니다. UDM 매핑 테이블 로그 필드 UDM 매핑 로직 extensions.auth.mechanism 사용된 인증 메커니즘입니다. extensions.auth.type 인증 유형입니다. 합계 metadata.description 이벤트에 대한 설명입니다. metadata.event_type 이벤트 유형입니다. event_type, cat metadata.product_event_type 제품별 이벤트 유형입니다. product_version metadata.product_version 제품 버전입니다. 터미널 principal.hostname 주 구성원과 연결된 호스트 이름입니다. name principal.user.user_display_name 사용자의 표시 이름입니다. usrName principal.user.userid 사용자 ID입니다. security_result.action 보안 시스템에서 취한 조치입니다. security_result.category 보안 결과의 카테고리입니다. 클래스 security_result.category_details 보안 결과 카테고리에 관한 추가 세부정보입니다. reason security_result.severity 보안 결과의 심각도 수준입니다. reason security_result.severity_details 자세한 심각도 정보입니다. logstr security_result.summary 보안 결과 요약입니다. job_id target.application 타겟팅되는 애플리케이션입니다. job_group target.group.group_display_name 그룹의 표시 이름입니다. target.namespace 타겟의 네임스페이스입니다. dsn target.resource.name 리소스 이름입니다. vol target.resource.parent 상위 리소스입니다. res, dsn target.resource.product_object_id 제품별 객체 식별자입니다. target.resource.resource_type 리소스 유형 name target.user.user_display_name 타겟 사용자의 표시 이름입니다. usrName target.user.userid 대상 사용자의 사용자 ID입니다. product_name metadata.product_name 이벤트를 생성하는 제품의 이름입니다. vendor_name metadata.vendor_name 공급업체 이름입니다. 변경 로그 이 파서의 변경 로그 보기 도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.