워크로드 아이덴티티 제휴로 원격 에이전트 인증
이 문서에서는 워크로드 아이덴티티 제휴(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간의 연결 매개변수를 정의합니다.
- Google Cloud 콘솔에서 워크로드 아이덴티티 풀 페이지로 이동합니다. 워크로드 아이덴티티 풀로 이동
- 풀 만들기를 클릭합니다.
- 풀의 이름과 설명을 입력합니다(예:
soar-remote-agent-pool). - 계속을 클릭합니다.
- 풀에 공급업체 추가 섹션에서 공급업체 유형을 선택하고 공급업체 가이드에서 공급업체 연결 세부정보(예: AWS 계정 ID 또는 OIDC 발급기관 및 대상)를 입력합니다.
- 속성 매핑 구성 섹션에서 공급업체 가이드에 지정된 대로 외부 토큰(예:
google.subject=assertion.sub)의 클레임을 Google Cloud IAM 속성에 매핑합니다. - 저장을 클릭합니다.
2단계: 서비스 계정 가장 권한 부여
워크로드 아이덴티티 풀의 외부 ID가 원격 에이전트 서비스 계정을 가장하도록 허용합니다.
- Google Cloud 콘솔에서 서비스 계정 페이지로 이동합니다.
- 원격 에이전트 서비스 계정을 선택합니다.
- 액세스 권한이 있는 주 구성원 탭을 클릭합니다.
- 액세스 권한 부여를 클릭합니다.
- 새 주 구성원 필드에 워크로드 아이덴티티 풀에 해당하는 주 구성원 식별자를 입력합니다.
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/*
- 역할 선택 목록에서 워크로드 아이덴티티 사용자(
roles/iam.workloadIdentityUser)를 선택합니다. - 저장을 클릭합니다.
3단계: 외부 계정 사용자 인증 정보(agent-key.json) 다운로드 또는 생성
원격 에이전트 호스트 머신에서 다음 옵션 중 하나를 사용하여 agent-key.json라는 외부 계정 사용자 인증 정보 구성 파일을 가져옵니다.
옵션 A: Google Cloud 콘솔에서 다운로드(권장)
- Google Cloud 콘솔에서 워크로드 아이덴티티 풀 페이지로 이동합니다.
- 워크로드 아이덴티티 풀을 선택하고 액세스 권한 부여를 클릭합니다.
- 액세스 권한 부여 패널에서 서비스 계정 가장을 사용하여 액세스 권한 부여를 선택합니다.
- 서비스 계정 선택 목록에서 원격 에이전트 서비스 계정을 선택합니다.
- 주 구성원(서비스 계정에 액세스할 수 있는 ID) 선택 섹션에서 서비스 계정에 액세스할 수 있는 ID를 지정합니다(예: 속성 이름 및 값 선택).
- 저장을 클릭합니다.
- 애플리케이션 구성 창에서 다음을 수행합니다.
- 워크로드 아이덴티티 제공업체를 선택합니다.
- OIDC ID 토큰 경로 필드에 외부 토큰이 마운트되거나 저장된 정확한 경로를 입력합니다(Kubernetes 프로젝션 토큰의 경우 포드 매니페스트에 정의된
mountPath+path(예:/var/run/secrets/tokens/gcp-kms-token)와 일치해야 함). - 형식 유형을 텍스트(원시 JWT 문자열)로 설정합니다. 표준 토큰 파일에는 JSON을 선택하지 마세요.
- 구성 다운로드를 클릭하고 파일을
agent-key.json로 저장합니다(또는 다운로드한 파일의 이름을agent-key.json로 변경).
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 내에서 서비스 계정 이메일 주소를 승인합니다.
- 설정 > 액세스 관리 > 그룹 매핑으로 이동합니다.
- 추가 추가를 클릭합니다.
- 역할 추가 대화상자의 IAM 역할/IdP 그룹 필드에 전체 서비스 계정 이메일 주소를 입력합니다.
- 원격 에이전트가 관리할 적절한 환경을 선택합니다.
- 추가를 클릭합니다.
5단계: 원격 에이전트 인증 배포 또는 업데이트
Podman
Podman에서 원격 에이전트 인증을 구성하려면 다음 단계를 따르세요.
-
실행 중인 Podman 컨테이너를 나열합니다.
podman ps -
에이전트의 컨테이너 ID를 입력합니다.
CONTAINER_ID
-
다음 명령어를 사용하여 사용자 인증 정보 구성 파일을 컨테이너의 전용 경로에 복사합니다.
podman cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
-
다음 명령어를 사용하여 컨테이너에서 사용자 인증 정보 구성 파일의 소유자를 변경합니다.
podman exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
다음 명령어를 실행하여 변경사항을 적용합니다.
podman restart CONTAINER_ID
Docker
Docker에서 원격 에이전트 인증을 구성하려면 다음 단계를 따르세요.
-
실행 중인 Docker 컨테이너를 나열합니다.
docker ps -
에이전트의 컨테이너 ID를 입력합니다.
CONTAINER_ID
-
다음 명령어를 사용하여 사용자 인증 정보 구성 파일을 컨테이너의 전용 경로에 복사합니다.
docker cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
-
다음 명령어를 사용하여 컨테이너에서 사용자 인증 정보 구성 파일의 소유자를 변경합니다.
docker exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
다음 명령어를 실행하여 변경사항을 적용합니다.
docker restart CONTAINER_ID
설치 프로그램
CentOS/RHEL에서 원격 에이전트 인증을 구성하려면 다음 단계를 따르세요.
-
사용자 인증 정보 구성 파일을 예상 경로로 이동합니다.
mv PATH_TO_AGENT_KEY/agent-key.json /opt/SiemplifyAgent/agent-key.json
-
다음 명령어를 사용하여 사용자 인증 정보 구성 파일의 소유자를 변경합니다.
chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
다음 명령어를 실행하여 에이전트 서비스를 다시 시작합니다.
supervisorctl restart siemplify_agent
관련 문서
도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.