CyberArk PAM을 Google SecOps와 통합

이 문서에서는 CyberArk Privileged Access Manager를 Google Security Operations와 통합하는 방법을 안내합니다.

시작하기 전에

통합과 함께 작동하도록 CyberArk PAM을 구성하려면 통합을 위한 사용자를 만들고 해당 사용자에게 필요한 CyberArk PAM Vault에 액세스할 수 있는 권한을 제공해야 합니다.

사용자 생성

통합을 위한 사용자를 만들려면 다음 단계를 완료하세요.

  1. 관리자로 PrivateArk Client에 로그인합니다.
  2. 도구 > 관리 도구 > 사용자 및 그룹으로 이동합니다.
  3. 사용자 및 그룹 대화상자에서 사용자 위치를 선택하고 새로 만들기를 클릭한 후 사용자를 선택합니다.
  4. 신규 사용자 대화상자의 여러 탭에서 필요에 따라 정보를 입력합니다. 일반 및 인증 탭은 필수입니다.

사용자 만들기에 대한 자세한 내용은 Vault에 사용자 추가를 참조하세요.

생성된 사용자에게 권한 부여

새로 만든 사용자에게 Vault 액세스 권한을 추가하려면 다음 단계를 완료하세요.

  1. 관리자로 PrivateArk Client에 로그인합니다.
  2. 액세스 권한을 제공할 Vault를 선택하고 로그인합니다(더블클릭).
  3. 상단 메뉴에서 소유자를 클릭합니다.
  4. 신규 사용자를 추가하려면 추가를 클릭합니다.
  5. 대화상자에서 사용자를 선택합니다.
  6. 승인 대상 섹션에서 최소한 다음 권한을 선택합니다.
    • Monitor Safe
    • Retrieve files from Safe
    • Store files in Safe
    • Admisiter Safe
  7. 변경사항을 저장하려면 OK(확인)를 클릭합니다.
  8. 대화상자 창을 종료하려면 닫기를 클릭합니다.

선택사항: 클라이언트 인증서 구성

기존 클라이언트 인증서를 사용하거나 새 클라이언트 인증서를 만들어 CyberArk PAM 인스턴스와 Google SecOps SOAR 간의 보안 통신을 수행할 수 있습니다. 클라이언트 인증서를 구성하는 방법에 대한 자세한 내용은 중앙 사용자 인증 정보 제공업체 웹 서비스 구성을 참조하세요.

CyberArk PAM 및 Google SecOps 통합

통합에는 다음 매개변수가 필요합니다.

매개변수 설명
API Root 필수

API 기준 URL입니다.

https://IP_ADDRESS :PORT 형식으로 값을 제공합니다.

Username 필수

연결할 사용자 이름입니다.

Password 필수

연결할 비밀번호입니다.

Verify SSL 선택사항

선택하면 통합에서 CyberArk 서버 연결에 사용되는 SSL 인증서가 유효한지 확인합니다.

이 설정은 기본적으로 선택됩니다.

CA Certificate 필수

API 루트에 대한 보안 연결을 검증하는 데 사용할 CA 인증서입니다.

이 매개변수는 Base64로 인코딩된 문자열 형식의 CA 인증서를 허용합니다.

Client Certificate 선택사항

CyberArk PAM에 대해 구성된 경우 API 루트에 대한 연결을 설정하는 데 사용할 CyberArk 클라이언트 인증서를 지정합니다. 인증서를 PFX 파일 (PKCS #12 형식)로 제공합니다.

Client Certificate Passphrase 선택사항

클라이언트 인증서에 필요한 암호입니다.

Google SecOps에서 통합을 구성하는 방법에 대한 안내는 통합 구성을 참조하세요.

필요한 경우 이후 단계에서 변경할 수 있습니다. 통합 인스턴스를 구성한 후 플레이북에서 사용할 수 있습니다. 여러 인스턴스를 구성하고 지원하는 방법에 관한 자세한 내용은 다중 인스턴스 지원을 참고하세요.

작업

작업에 대한 자세한 내용은 Workdesk의 대기 중인 작업에 응답 및 케이스에서 수동 작업 실행을 참고하세요.

계정 비밀번호 값 가져오기

계정 비밀번호 값 가져오기 작업을 사용하여 CyberArk에서 계정 비밀번호 값을 가져옵니다.

이 작업을 통해 비밀번호와 SSH 키를 모두 가져올 수 있습니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

계정 비밀번호 값 가져오기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Account 필수

비밀번호 값을 가져올 계정 ID입니다.

참고: 계정 ID는 계정 나열 작업에서 가져올 수 있습니다.

Reason 필수

계정 비밀번호 값에 액세스하는 이유입니다.

기본값은 Google SecOps SOAR에서 자동으로 검색됩니다.

Ticketing System Name 선택사항

티켓 시스템의 이름입니다.

Ticket ID 선택사항

티켓 시스템 티켓 ID입니다.

Version 선택사항

검색할 계정 비밀번호 값 버전입니다.

작업 출력

계정 비밀번호 값 가져오기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시에서는 계정 비밀번호 값 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 설명합니다.

{
 "content": "PASSWORD_VALUE"
}
출력 메시지

계정 비밀번호 값 가져오기 작업은 다음 출력 메시지를 제공합니다.

출력 메시지 메시지 설명
Successfully fetched password value for account ID ACCOUNT_ID

Password value for account with ID ACCOUNT_ID and supplied version VERSION was not found in the CyberArk PAM.

작업이 완료되었습니다.
Error executing action "Get Account Password Value". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

다음 표에서는 계정 비밀번호 값 가져오기 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

스크립트 결과 이름 값
is_success True 또는 False

계정 나열

계정 나열 작업을 사용하여 제공된 기준에 따라 CyberArk PAM에서 사용 가능한 계정을 나열합니다.

이 작업은 Google SecOps SOAR 항목에서 실행되지 않습니다.

작업 입력

계정 나열 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Search Query 필수

사용할 검색어입니다.

Search operator 필수

제공된 검색어를 기반으로 검색을 실행하는 데 사용할 검색 연산자입니다.

가능한 값은 다음과 같습니다.
  • contains
  • startswith

기본값은 contains입니다.

Max Records To Return 필수

반환할 레코드 수입니다. 값을 제공하지 않으면 작업은 50개의 레코드를 반환합니다 (API 기본값).

Records Offset 필수

값을 반환하는 작업의 오프셋입니다.

Filter Query 필수

사용할 필터 쿼리입니다. safeName 또는 modificationTime 매개변수를 기반으로 필터링할 수 있습니다.

Saved Filter 필수

사용할 저장된 필터 쿼리입니다.

이 매개변수는 Filter Query 매개변수보다 우선 적용됩니다.

작업 출력

계정 나열 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 가능
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
케이스 월 테이블

케이스 월에서 계정 나열 작업은 다음 표를 제공합니다.

테이블 이름: 사용 가능한 PAM 계정

표 열:

  • ID
  • Safe Name
  • User Name(사용자 이름)
  • 보안 비밀 유형
JSON 결과

다음 예시에서는 계정 나열 작업을 사용할 때 수신되는 JSON 결과 출력을 설명합니다.

{
   "value": [
       {
           "categoryModificationTime": 1672051160,
           "platformId": "WinDomain",
           "safeName": "UserTestSafe",
           "id": "33_3",
           "name": "user@example.com",
           "address": "user@example.com",
           "userName": "user",
           "secretType": "password",
           "platformAccountProperties": {},
           "secretManagement": {
               "automaticManagementEnabled": true,
               "lastModifiedTime": 1672051160
           },
           "createdTime": 1672051160
       }
   ],
   "count": 1
}
출력 메시지

계정 나열 작업은 다음 출력 메시지를 제공합니다.

출력 메시지 메시지 설명

Successfully found accounts for the criteria provided in CyberArk PAM.

No accounts were found for the criteria provided in CyberArk PAM.

Both the Filter Query and Saved Filter parameters are provided, Saved Filter takes priority.

작업이 완료되었습니다.
Error executing action "List Accounts". Reason: ERROR_REASON

작업이 실패했습니다.

서버 연결, 입력 매개변수 또는 사용자 인증 정보를 확인하세요.

스크립트 결과

다음 표에서는 계정 나열 작업을 사용할 때 스크립트 결과 출력의 값을 설명합니다.

스크립트 결과 이름 값
is_success True 또는 False

핑

*핑 작업을 사용하여 CyberArk에 대한 연결을 테스트합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

통합 입력

없음

작업 출력

핑 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 불가
출력 메시지 사용 가능
스크립트 결과 사용 가능
출력 메시지

핑 작업은 다음 출력 메시지를 제공합니다.

출력 메시지 메시지 설명
Successfully connected to the CyberArk PAM installation with the provided connection parameters! 작업이 완료되었습니다.
Failed to connect to the CyberArk PAM installation! Error is ERROR_REASON

작업이 실패했습니다.

서버 연결, 입력 매개변수 또는 사용자 인증 정보를 확인하세요.

스크립트 결과

다음 표에서는 Ping 작업을 사용할 때 스크립트 결과 출력 값을 설명합니다.

스크립트 결과 이름 값
is_success True 또는 False

계정 비밀번호 변경

계정 비밀번호 변경 작업을 사용하여 CyberArk PAM에서 즉시 비밀번호 변경 작업을 큐에 추가합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

계정 비밀번호 변경 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Account ID 필수

즉시 비밀번호 변경 작업을 위해 대기열에 추가할 계정 ID의 쉼표로 구분된 목록입니다.

참고: 계정 나열 작업의 출력 매개변수에서 대상 계정 ID 문자열을 직접 가져올 수 있습니다.

작업 출력

계정 비밀번호 변경 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
JSON 결과 사용 가능
출력 메시지 사용 가능
스크립트 결과 사용 가능
JSON 결과

다음 예시에서는 계정 비밀번호 변경 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
  "successful_accounts": [
    "28_12"
  ],
  "failed_accounts": [
    {
      "account_id": "36_4",
      "error": "The account is not managed by the CPM"
    }
  ]
}
출력 메시지

계정 비밀번호 변경 작업은 다음 출력 메시지를 제공합니다.

출력 메시지 메시지 설명
Successfully queued immediate password change task for the following accounts: ACCOUNT_IDS 작업이 완료되었습니다.
Error executing action "Change Account Password". Reason: ERROR_REASON

작업이 실패했습니다.

서버 연결, 타겟 계정 ID 값 또는 관리 CPM 구성 설정을 확인하세요.

스크립트 결과

다음 표에서는 계정 비밀번호 변경 작업을 사용할 때 스크립트 결과 출력 값을 설명합니다.

스크립트 결과 이름 값
is_success True 또는 False

작업

작업에 대한 자세한 내용은 새 작업 구성 및 고급 예약을 참조하세요.

CyberArk PAM - 통합 사용자 인증 정보 동기화 작업

CyberArk PAM - 동기화 통합 사용자 인증 정보 작업을 사용하여 CyberArk PAM에서 계정 사용자 인증 정보와 보안 비밀을 자동으로 가져오고 통합 인스턴스, 커넥터, 예약된 작업의 구성을 동적으로 업데이트하여 Google SecOps SOAR에 동기화합니다.

작업 매개변수

CyberArk PAM - 통합 사용자 인증 정보 동기화 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
API Root

필수 입력란입니다.

CyberArk PAM의 기준 URL입니다.

값이 제공되지 않으면 작업은 통합 구성에 제공된 값을 참조합니다.

Username

필수 입력란입니다.

CyberArk PAM에 연결하는 데 사용되는 사용자 이름입니다.

값이 제공되지 않으면 작업은 통합 구성에 제공된 값을 참조합니다.

Password

필수 입력란입니다.

CyberArk PAM에 연결하는 데 사용되는 비밀번호입니다.

값이 제공되지 않으면 작업은 통합 구성에 제공된 값을 참조합니다.

Verify SSL

필수 입력란입니다.

선택하면 통합에서 CyberArk PAM 서버에 연결할 때 SSL 인증서를 검증합니다.

기본적으로 사용 설정됩니다.

CA Certificate

(선택사항)

API 루트에 대한 SSL 연결의 유효성을 검사하는 데 사용되는 Base64로 인코딩된 CA 인증서입니다.

Client Certificate

(선택사항)

상호 TLS 인증에 사용되는 Base64로 인코딩된 클라이언트 인증서입니다.

Client Certificate Passphrase

(선택사항)

클라이언트 인증서에 필요한 암호입니다 (암호화된 경우).

Environment Name

필수 입력란입니다.

통합 인스턴스, 커넥터, 작업을 조회하고 업데이트할 Google SecOps SOAR 환경의 이름입니다. 공유 환경의 경우 *을 제공합니다.

기본값은 Default Environment입니다.

Credential Mapping

필수 입력란입니다.

SOAR 통합 인스턴스, 커넥터, 작업을 CyberArk PAM 계정 경로에 매핑하는 JSON 또는 YAML 매핑 문자열입니다.

값은 accounts/<account_id> 또는 accounts/<account_id>/versions/<version_id> 형식을 사용해야 합니다.

기본값은 {"integration_instances": {"Integration_Instance_Name": {"Parameter_Name": "accounts/Account_ID"}}}입니다.

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