Google SecOps와 Akeyless 통합

이 문서에서는 Akeyless를 Google Security Operations와 통합하는 방법을 설명합니다.

사용 사례

Akeyless 통합은 Google SecOps 기능을 사용하여 다음 사용 사례를 지원합니다.

  • 통합 사용자 인증 정보 동기화: Akeyless에 저장된 보안 비밀을 사용하여 Google SecOps 통합 인스턴스, 커넥터, 작업 전반에서 사용자 인증 정보와 민감한 매개변수를 자동으로 업데이트합니다.

  • 플레이북에서 보안 비밀 가져오기: 플레이북 실행 중에 필요에 따라 Akeyless에서 정적 보안 비밀 또는 특정 보안 비밀 버전을 가져와 외부 서비스로 인증합니다.

  • 사용자 인증 정보 순환 자동화: 매개변수를 latest 보안 비밀 버전에 매핑하여 순환된 API 키, 토큰, 비밀번호를 Akeyless에서 Google SecOps 통합, 커넥터, 작업으로 전파하여 만료된 사용자 인증 정보로 인한 중단을 방지합니다.

  • 버전 고정으로 사용자 인증 정보 업데이트 제어: Akeyless에서 통합, 커넥터 또는 작업 매개변수를 특정 보안 비밀 버전에 고정하여 사용자 인증 정보 변경사항을 검증하거나 필요에 따라 이전 버전으로 롤백합니다.

  • 워크플로에서 하드 코딩된 보안 비밀 삭제: 플레이북 입력 또는 맞춤 스크립트에 직접 삽입하는 대신 Akeyless에 민감한 사용자 인증 정보를 중앙 집중화하여 SOC 워크플로 전반에서 사용자 인증 정보 노출을 줄입니다.

시작하기 전에

Google SecOps 플랫폼에서 통합을 구성하기 전에 다음이 있는지 확인하세요.

  • API 키 사용자 인증 정보: 인증을 위한 Akeyless 액세스 ID 및 액세스 키입니다.

    자세한 내용은 Akeyless API 키 인증을 참조하세요.

  • 액세스 권한: Google SecOps가 검색하는 보안 비밀에 대해 인증 방법에 부여된 읽기 권한입니다.

    자세한 내용은 키리스 역할 기반 액세스 제어 (RBAC)를 참고하세요.

  • 네트워크 연결: Google SecOps 인스턴스 또는 원격 에이전트에서 Akeyless API Gateway URL로의 네트워크 액세스

통합 매개변수

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

매개변수 설명
API Gateway URL

(선택사항)

Akeyless API Gateway의 URL입니다.

기본값은 https://api.akeyless.io입니다.
Access ID

필수 항목입니다.

Akeyless API 키 인증 방법의 액세스 ID입니다.
Access Key

필수 항목입니다.

Akeyless 액세스 ID와 연결된 액세스 키입니다.
Verify SSL

필수 항목입니다.

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

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

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

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

작업

작업에 대한 자세한 내용은 내 Workdesk에서 대기 중인 작업에 응답 및 직접 조치 실행을 참고하세요.

보안 비밀 값 가져오기

보안 비밀 값 가져오기 작업을 사용하여 플레이북에서 사용할 Akeyless의 보안 비밀 값을 가져옵니다.

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

작업 입력

보안 비밀 값 가져오기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Secret Name

필수 항목입니다.

Akeyless에서 검색할 보안 비밀의 이름 또는 경로입니다.

최신 버전을 가져오려면 SECRET_NAME 또는 SECRET_NAME:latest를 입력합니다.

특정 버전을 검색하려면 SECRET_NAME:VERSION_NUMBER를 입력합니다. 여기서 VERSION_NUMBER은 양의 정수입니다 (예: /prod/api-key:2).

작업 출력

보안 비밀 값 가져오기 작업은 다음 출력을 제공합니다.

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

다음 예시에서는 보안 비밀 값 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
  "secret_name": "/secops/integrations/example-api-key",
  "version": "latest",
  "secret_value": "EXAMPLE_SECRET_VALUE"
}
출력 메시지

케이스 월에서 보안 비밀 값 가져오기 작업은 다음 출력 메시지를 제공합니다.

출력 메시지 메시지 설명
Successfully retrieved secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. 작업이 완료되었습니다.
Failed to retrieve secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. Reason: ERROR_REASON

작업이 실패했습니다.

Akeyless에 보안 비밀 경로와 버전이 있고 인증 사용자 인증 정보에 보안 비밀에 대한 읽기 액세스 권한이 있는지 확인합니다.
Error executing action 'Get Secret Value'. Reason: Invalid credential mapping format for value 'SECRET_NAME'. Expected format: 'secret_name' or 'secret_name:version' (where version is a positive integer or 'latest').

작업이 실패했습니다.

Secret Name 매개변수의 형식을 확인합니다.
스크립트 결과

다음 표에는 보안 비밀 값 가져오기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

핑

Ping 작업을 사용하여 Akeyless 서버에 대한 연결을 테스트합니다.

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

작업 입력

없음

작업 출력

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

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

케이스 월에서 핑 작업은 다음과 같은 출력 메시지를 제공합니다.

출력 메시지 메시지 설명
Successfully connected to the Akeyless server with the provided connection parameters! 작업이 완료되었습니다.
Failed to connect to the Akeyless server! Reason: ERROR_REASON

작업이 실패했습니다.

API Gateway URL, Access ID, Access Key, SSL 설정을 확인합니다.
스크립트 결과

다음 표에는 핑 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
is_success true 또는 false

작업

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

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

통합 사용자 인증 정보 동기화 작업을 사용하여 Akeyless에 저장된 보안 비밀을 구성된 Google SecOps 통합 인스턴스, 커넥터, 작업과 자동으로 동기화합니다.

작업 매개변수

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

매개변수 설명
API Gateway URL

(선택사항)

Akeyless API Gateway의 URL입니다.

기본값은 https://api.akeyless.io입니다.
Access ID

필수 항목입니다.

Akeyless API 키 인증 방법의 액세스 ID입니다.
Access Key

필수 항목입니다.

Akeyless 액세스 ID와 연결된 액세스 키입니다.
Verify SSL

필수 항목입니다.

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

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

필수 항목입니다.

타겟 통합 인스턴스, 커넥터, 작업이 구성된 Google SecOps 환경입니다.

기본값은 Default Environment입니다.
Credential Mapping

필수 항목입니다.

타겟 통합 인스턴스, 커넥터, 작업을 매개변수 값이 포함된 Akeyless 보안 비밀에 매핑하는 JSON 또는 YAML 딕셔너리입니다.

integration_instances, connectors 또는 jobs 키 아래에 매핑된 매개변수를 하나 이상 포함합니다.

예시는 Credential Mapping 예시를 참조하세요.

기본값은 {"integration_instances": {"Integration_Instance_Name": {"Parameter_Name": "Secret_Name"}}}입니다.

예시 Credential Mapping

다음 예시에서는 Credential Mapping 매개변수에서 통합 인스턴스, 커넥터, 작업의 매개변수를 매핑하는 방법을 보여줍니다.

{
  "integration_instances": {
    "VirusTotal_Prod": {
      "API Key": "/secops/prod/virustotal-api-key"
    },
    "Jira_Instance_1": {
      "API Token": "/secops/prod/jira-api-token:2"
    }
  },
  "connectors": {
    "CrowdStrike Falcon Alerts Connector": {
      "Client Secret": "/secops/prod/crowdstrike-client-secret:latest"
    }
  },
  "jobs": {
    "ServiceNow Sync Closed Cases": {
      "Password": "/secops/prod/servicenow-password:1"
    }
  }
}

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