SOAR 권한을 IAM으로 마이그레이션

다음에서 지원:

Google SecOps SOAR

이 문서는 액세스 제어를 위해 기존 SOAR 권한 그룹에서 Google Cloud Identity and Access Management (IAM)로 환경을 이전해야 하는 Google Security Operations 통합 고객과 SOAR 독립형 사용자를 모두 안내합니다. 이 절차에 대한 동영상 둘러보기는 SOAR IAM 마이그레이션 동영상을 참고하세요.

참고: 이전 도구를 사용하면 기존 SOAR 설정 권한에 대한 새 맞춤 IAM 바인딩을 제안할 수 있습니다. 자세한 내용은 기능 RBAC를 참고하세요.

Google Cloud 콘솔 확인 프로세스는 다음 주요 단계를 실행하여 SOAR 권한에서Google Cloud IAM으로의 전환을 자동화합니다.

• 맞춤 권한 그룹 및 사용자 할당을 비롯한 기존 권한 구성을 읽습니다.
• 기존 권한 그룹을 복제하는 맞춤 IAM 역할을 생성합니다.
• 모든 액세스 권한이 유지되도록 기존 사용자 및 그룹을 새로 생성된 IAM 역할에 매핑합니다.
• 사용자와 그룹을 할당된 역할에 바인딩하는 IAM 정책을 만듭니다.

시작하기 전에

마이그레이션을 시작하기 전에 다음 요구사항을 충족하는지 확인하세요.

• Google SecOps 통합 고객인 경우 Cloud IAM을 사용하여 플랫폼의 SIEM 측 역할과 권한을 관리해야 합니다. 자세한 내용은 기존 RBAC를 기능 RBAC로 이전하기를 참고하세요.

• Google Cloud 콘솔과 SOAR에서 동일한 ID (이메일 또는 계정)를 사용해야 합니다.

• IdP 그룹 매핑: 인증에 직원 ID 제휴를 사용하는 경우 그룹 매핑 페이지에서 모든 사용자가 ID 공급업체 (IdP) 그룹에 매핑되어 있는지 확인하세요. IdP 그룹 매핑에 대한 정보는 플랫폼에서 사용자 매핑을 참고하세요. 마이그레이션 도구는 이러한 매핑을 사용하여 사용자 메일 또는 그룹을 IAM 보안 주체에 바인드하는 스크립트를 만듭니다.

• 이메일 그룹 매핑 인증에 Cloud ID를 사용하는 경우 그룹 매핑 페이지에서 모든 사용자가 이메일 그룹에 매핑되어 있는지 확인하세요. 이메일 매핑에 관한 정보는 Cloud ID를 사용하여 플랫폼에서 사용자 매핑을 참고하세요. 마이그레이션 도구는 이러한 매핑을 사용하여 사용자 메일 또는 그룹을 IAM 보안 주체에 바인드하는 스크립트를 만듭니다.

• 선택사항: SOAR API 키입니다. 그룹 매핑 페이지에서 현재 사용자를 매핑할 SOAR 권한이 없는 경우 SOAR 관리자에게 SOAR API 키를 제공해 달라고 요청하고 이를 사용하여 스크립트를 생성하면 됩니다.

SOAR 관리자는 다음 절차의 단계를 실행해야 합니다.

1. Google SecOps 플랫폼에서 SOAR 설정 > 고급 > 권한 그룹 (API 키)으로 이동합니다.
2. 설정 모듈과 설정 아래의 옵션이 모두 선택되어 있는지 확인하면서 권한 그룹을 만듭니다.
3. SOAR 설정 > 고급 > API 키로 이동합니다.
4. 만든 권한 그룹을 선택하여 새 API 키를 추가합니다.
5. 생성된 API 키를 복사합니다.

• 권한: 필요한 권한이 있는지 확인합니다.

  • Chronicle API 관리자
  • Chronicle 서비스 관리자
  • Chronicle SOAR 관리자

경고: IAM을 사용 설정하면 모든 Chronicle 사전 정의된 역할이 SOAR 권한과 함께 활성화됩니다. 이제 Chronicle API 관리자에는 SOAR 관리자 권한이 포함됩니다. Chronicle 사전 정의된 역할에 할당된 보안 주체 (사용자 / 그룹)에게 SOAR 권한을 부여하지 않거나 권한을 제한하려면 SOAR 권한이 명시적으로 제외된 커스텀 역할을 할당하는 것이 좋습니다.

마이그레이션 후 해결되지 않은 문제가 있는 경우 IAM 사용 중지를 클릭하여 권한 그룹에서 IAM 역할로의 마이그레이션을 되돌립니다. 새로 생성된 IAM 역할과 바인딩은 삭제되지 않습니다.

각 역할에 필요한 권한의 전체 목록은 필요한 IAM 권한을 참고하세요.

SOAR 권한을 이전하는 방법에는 두 가지가 있습니다.

• Google Cloud CLI 사용
• Terraform 사용

Google Cloud CLI를 사용하여 SOAR 권한 마이그레이션

SOAR 권한을 Google Cloud IAM으로 이전하려면 다음 단계를 따르세요.

1. Google Cloud 콘솔에서 Google SecOps 관리 설정으로 이동합니다.
2. SOAR IAM 마이그레이션 탭을 클릭합니다.
3. 역할 바인딩 마이그레이션 섹션에서 Google Cloud CLI 명령어를 복사합니다. 새 조건을 지정하는 옵션이 표시되면 2를 선택합니다. 없음 .
4. Google Cloud 툴바에서 Cloud Shell 활성화를 클릭합니다.
5. 터미널 창에 Google Cloud CLI 명령어를 붙여넣고 Enter 키를 누릅니다.
6. 스크립트가 성공적으로 실행되었는지 확인합니다.
7. Google Cloud 콘솔로 돌아가 이 작업 완료 섹션에서 IAM 사용 설정을 클릭합니다.

Terraform을 사용하여 SOAR 권한 이전

Terraform을 사용하여 SOAR 권한을 Google Cloud IAM으로 이전하려면 다음 단계를 따르세요.

1. Google Cloud 콘솔에서 Google SecOps 관리 설정으로 이동합니다.
2. SOAR IAM 마이그레이션 탭을 클릭합니다.
3. 역할 바인딩 마이그레이션 섹션에서 Google Cloud CLI 명령어를 복사합니다.
4. Terraform 저장소로 이동하여 Google Cloud CLI 명령어를 해당 Terraform 명령어로 매핑합니다. 다음 표에서는 Google Cloud CLI의 커스텀 역할 생성 명령어와 Terraform 명령어를 매핑합니다.

gcloud 플래그	Terraform 인수	참고
ROLE_ID (위치)	role_id	Terraform에서는 projects/PROJECT_ID/roles/ 접두사를 포함하지 마세요. ID 문자열 (예: myCustomRole)만 사용합니다.
--project	project	커스텀 역할이 정의된 프로젝트의 ID입니다.
--title	title	역할에 대해 사람이 읽을 수 있는 제목입니다.
--description	description	역할의 목적과 권한에 대한 요약입니다.
--permissions	permissions	gcloud는 쉼표로 구분된 문자열을 허용합니다. Terraform에는 문자열 목록(["perm.a", "perm.b"])이 필요합니다.
--stage	stage	유효한 값: ALPHA, BETA, GA, DEPRECATED, DISABLED, EAP

참고: 명령줄의 각 --flag가 Terraform 리소스 블록 내의 해당 인수와 올바르게 페어링되어 있는지 확인하세요.

Terraform 예시에 대한 Google Cloud CLI 매핑

Google Cloud CLI 명령어:

gcloud iam roles create SOAR_Custom_managedUser_google.com --project="{customer project}" 
--title="SOAR Custom managedUser Role" 
--description="SOAR Custom role generated for IDP Mapping Group ManagedUser" 
--stage=GA 
--permissions=chronicle.cases.get

Terraform 명령어:

resource "google_project_iam_custom_role" "{terraform_name}" {
  role_id     = "SOAR_Custom_managedUser_google.com"
  title       = "SOAR Custom managedUser Role"
  project     = "{customer project}"
  stage       = "GA"
  permissions = [
    #This is an example!
    "chronicle.cases.get"
  ]
}

IAM 정책 바인딩 (역할 할당)

Google Cloud CLI projects add-iam-policy-binding을 사용하면 특정 구성원 (사용자, 서비스 계정 또는 그룹)에게 특정 역할을 부여합니다. 다음 표에서는 Google Cloud CLI 명령어와 Terraform 명령어를 매핑합니다. IAM 역할을 할당하기 위해 명령어를 매핑합니다.

gcloud 플래그	Terraform 인수	참고
PROJECT_ID (위치)	project	타겟 프로젝트의 ID입니다.
--member	member	주 구성원 ID (예: user:email, serviceAccount:email, group:email)입니다.
--role	role	역할 ID입니다. 맞춤 역할(projects/ID/roles/NAME)에는 전체 경로를 사용하고 표준 역할(roles/NAME)에는 닉네임을 사용합니다.

역할 할당 예시

Google Cloud CLI 명령어:

gcloud projects add-iam-policy-binding
 {customer project}
--member="user:[e-mail]" 
--role="projects/{customer project}/roles/SOAR_Custom_managedUser_google.com"

Terraform 명령어:

resource "google_project_iam_member" "{terraform_name}" {
  project = "{customer project}"
  role    = "projects/{customer project}/roles/SOAR_Custom_managedUser_google.com"
  member  = "user:[e-mail]"
}

참고: google_project_iam_binding (단수 'binding'은 Google Cloud CLI 명령어 이름과 일치)을 사용하면 코드에 나열되지 않은 다른 사용자가 해당 역할에서 삭제되므로 사용하지 않는 것이 좋습니다. 대신 google_project_iam_member를 사용하세요.

중요: 기존 SOAR API와의 하위 호환성을 위해 마이그레이션 후에도 그룹 매핑 페이지에 권한 그룹 열이 계속 표시됩니다. 이 과제를 삭제하지 마세요. 이 열은 2026년 11월 30일까지 고객에게 영향을 주지 않고 자동으로 삭제됩니다.

게시물 이전

IAM 권한을 사용하도록 전환한 후 API를 호출하는 데 사용하는 각 curl 명령어는 매핑된 서비스 계정 (IDP 매핑 그룹에 매핑됨) 또는 플랫폼에 한 번 이상 로그인한 사용자와 함께 전송해야 합니다.

FAQ

• 문제 및 권장사항에 관한 자세한 목록은 IAM 역할 이전 FAQ를 참고하세요.