워크로드 아이덴티티 제휴로 원격 에이전트 인증

다음에서 지원:

이 문서에서는 워크로드 아이덴티티 제휴(WIF)를 사용하여 Google SecOps 원격 에이전트에 키 없는 인증을 구성하는 방법을 설명합니다. 워크로드 아이덴티티 제휴를 사용하면 원격 에이전트 호스트 환경에서 장기 서비스 계정 JSON 키 파일을 다운로드, 관리, 저장할 필요가 없습니다.

워크로드 아이덴티티 제휴를 사용하면 외부 클라우드 제공업체, 온프레미스 인프라, Kubernetes 클러스터 또는 CI/CD 파이프라인에서 실행되는 원격 에이전트가 외부 ID 공급업체에서 파생된 단기 제휴 Google Cloud 액세스 토큰을 사용합니다.

시작하기 전에

워크로드 아이덴티티 제휴를 구성하기 전에 다음 기본 요건을 확인하세요.

  • 최소 원격 에이전트 버전 2.6.2 이상
  • 워크로드 아이덴티티 제휴를 구성하는 사용자는 워크로드 아이덴티티 풀(roles/iam.workloadIdentityPoolAdmin) 및 서비스 계정(roles/iam.serviceAccountAdmin)을 만들고 관리하는 데 필요한 IAM 권한을 Google Cloud 에 가지고 있어야 합니다.
  • Google Cloud 에서 Chronicle SOAR 원격 에이전트 역할(roles/chronicle.soarRemoteAgent)로 생성된 전용 서비스 계정. 서비스 계정을 만드는 단계는 서비스 계정 만들기를 참조하세요.
  • 외부 ID 공급업체(AWS, Azure, Active Directory/ADFS, Kubernetes, CI/CD 파이프라인, X.509 CA 또는 커스텀 OIDC/SAML 공급업체)에 대한 액세스 권한
  • 방화벽은 원격 에이전트 호스트에서 sts.googleapis.com, iamcredentials.googleapis.com, Chronicle API 위치 엔드포인트(ONE_PLATFORM_URL_DOMAIN에 구성된 REGION-chronicle.googleapis.com)로의 아웃바운드 HTTPS(TCP 포트 443) 트래픽을 허용해야 합니다. 전체 허용 목록 및 Private Service Connect 세부정보는 네트워크 및 Private Service Connect 요구사항 및 네트워크 및 방화벽 요구사항을 참조하세요.

1단계: 워크로드 아이덴티티 풀 및 공급업체 만들기

Google Cloud에서 워크로드 아이덴티티 풀은 외부 ID를 관리하고 워크로드 아이덴티티 제공업체는 외부 IdP와 Google Cloud간의 연결 매개변수를 정의합니다.

  1. Google Cloud 콘솔에서 워크로드 아이덴티티 풀 페이지로 이동합니다. 워크로드 아이덴티티 풀로 이동
  2. 풀 만들기를 클릭합니다.
  3. 풀의 이름과 설명을 입력합니다(예: soar-remote-agent-pool).
  4. 계속을 클릭합니다.
  5. 풀에 공급업체 추가 섹션에서 공급업체 유형을 선택하고 공급업체 가이드에서 공급업체 연결 세부정보(예: AWS 계정 ID 또는 OIDC 발급기관 및 대상)를 입력합니다.
  6. 속성 매핑 구성 섹션에서 공급업체 가이드에 지정된 대로 외부 토큰(예: google.subject=assertion.sub)의 클레임을 Google Cloud IAM 속성에 매핑합니다.
  7. 저장을 클릭합니다.

2단계: 서비스 계정 가장 권한 부여

워크로드 아이덴티티 풀의 외부 ID가 원격 에이전트 서비스 계정을 가장하도록 허용합니다.

  1. Google Cloud 콘솔에서 서비스 계정 페이지로 이동합니다.
  2. 원격 에이전트 서비스 계정을 선택합니다.
  3. 액세스 권한이 있는 주 구성원 탭을 클릭합니다.
  4. 액세스 권한 부여를 클릭합니다.
  5. 새 주 구성원 필드에 워크로드 아이덴티티 풀에 해당하는 주 구성원 식별자를 입력합니다.
    principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/*
  6. 역할 선택 목록에서 워크로드 아이덴티티 사용자(roles/iam.workloadIdentityUser)를 선택합니다.
  7. 저장을 클릭합니다.

3단계: 외부 계정 사용자 인증 정보(agent-key.json) 다운로드 또는 생성

원격 에이전트 호스트 머신에서 다음 옵션 중 하나를 사용하여 agent-key.json라는 외부 계정 사용자 인증 정보 구성 파일을 가져옵니다.

옵션 A: Google Cloud 콘솔에서 다운로드(권장)

  1. Google Cloud 콘솔에서 워크로드 아이덴티티 풀 페이지로 이동합니다.
  2. 워크로드 아이덴티티 풀을 선택하고 액세스 권한 부여를 클릭합니다.
  3. 액세스 권한 부여 패널에서 서비스 계정 가장을 사용하여 액세스 권한 부여를 선택합니다.
  4. 서비스 계정 선택 목록에서 원격 에이전트 서비스 계정을 선택합니다.
  5. 주 구성원(서비스 계정에 액세스할 수 있는 ID) 선택 섹션에서 서비스 계정에 액세스할 수 있는 ID를 지정합니다(예: 속성 이름 및 값 선택).
  6. 저장을 클릭합니다.
  7. 애플리케이션 구성 창에서 다음을 수행합니다.
    • 워크로드 아이덴티티 제공업체를 선택합니다.
    • OIDC ID 토큰 경로 필드에 외부 토큰이 마운트되거나 저장된 정확한 경로를 입력합니다(Kubernetes 프로젝션 토큰의 경우 포드 매니페스트에 정의된 mountPath + path(예: /var/run/secrets/tokens/gcp-kms-token)와 일치해야 함).
    • 형식 유형을 텍스트(원시 JWT 문자열)로 설정합니다. 표준 토큰 파일에는 JSON을 선택하지 마세요.
    • 구성 다운로드를 클릭하고 파일을 agent-key.json로 저장합니다(또는 다운로드한 파일의 이름을 agent-key.json로 변경).
  8. agent-key.json 파일을 원격 에이전트 호스트 머신으로 전송합니다.

옵션 B: gcloud CLI를 사용하여 생성

gcloud iam workload-identity-pools create-cred-config 명령어를 실행하여 사용자 인증 정보 구성 파일을 생성합니다.

gcloud iam workload-identity-pools create-cred-config \
    projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID \
    --service-account=SERVICE_ACCOUNT_EMAIL \
    --output-file=agent-key.json \
    --credential-source-file=/var/run/secrets/tokens/gcp-kms-token

샘플 구성 파일 참조

참고로 생성된 agent-key.json 파일에는 다음과 유사한 구조가 포함됩니다.

{
  "type": "external_account",
  "audience": "//iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID",
  "subject_token_type": "urn:ietf:params:oauth:token-type:jwt",
  "token_url": "https://sts.googleapis.com/v1/token",
  "credential_source": {
    "file": "/var/run/secrets/tokens/gcp-kms-token"
  },
  "service_account_impersonation_url": "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT_EMAIL:generateAccessToken"
}

4단계: Google SecOps에서 서비스 계정 매핑

원격 에이전트를 배포하기 전에 Google SecOps 내에서 서비스 계정 이메일 주소를 승인합니다.

  1. 설정 > 액세스 관리 > 그룹 매핑으로 이동합니다.
  2. 추가 추가를 클릭합니다.
  3. 역할 추가 대화상자의 IAM 역할/IdP 그룹 필드에 전체 서비스 계정 이메일 주소를 입력합니다.
  4. 원격 에이전트가 관리할 적절한 환경을 선택합니다.
  5. 추가를 클릭합니다.

5단계: 원격 에이전트 인증 배포 또는 업데이트

Podman

Podman에서 원격 에이전트 인증을 구성하려면 다음 단계를 따르세요.

  1. 실행 중인 Podman 컨테이너를 나열합니다.
    podman ps
  2. 에이전트의 컨테이너 ID를 입력합니다.
    CONTAINER_ID
  3. 다음 명령어를 사용하여 사용자 인증 정보 구성 파일을 컨테이너의 전용 경로에 복사합니다.

    podman cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
  4. 다음 명령어를 사용하여 컨테이너에서 사용자 인증 정보 구성 파일의 소유자를 변경합니다.

    podman exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
  5. 다음 명령어를 실행하여 변경사항을 적용합니다.
    podman restart CONTAINER_ID

Docker

Docker에서 원격 에이전트 인증을 구성하려면 다음 단계를 따르세요.

  1. 실행 중인 Docker 컨테이너를 나열합니다.
    docker ps
  2. 에이전트의 컨테이너 ID를 입력합니다.
    CONTAINER_ID
  3. 다음 명령어를 사용하여 사용자 인증 정보 구성 파일을 컨테이너의 전용 경로에 복사합니다.

    docker cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
  4. 다음 명령어를 사용하여 컨테이너에서 사용자 인증 정보 구성 파일의 소유자를 변경합니다.

    docker exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
  5. 다음 명령어를 실행하여 변경사항을 적용합니다.
    docker restart CONTAINER_ID

설치 프로그램

CentOS/RHEL에서 원격 에이전트 인증을 구성하려면 다음 단계를 따르세요.

  1. 사용자 인증 정보 구성 파일을 예상 경로로 이동합니다.

    mv PATH_TO_AGENT_KEY/agent-key.json /opt/SiemplifyAgent/agent-key.json
  2. 다음 명령어를 사용하여 사용자 인증 정보 구성 파일의 소유자를 변경합니다.

    chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
  3. 다음 명령어를 실행하여 에이전트 서비스를 다시 시작합니다.
    supervisorctl restart siemplify_agent

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