GCP 무료 크레딧으로 Vertex AI 쓰다가 조직 정책에 막혔을 때

Owner 권한인데도 서비스 계정 API 키 생성이 안 된다면? 조직 정책 충돌이 원인입니다.

문제 상황 — 왜 Owner인데 막히는가
원인 진단 — 조직 소속 확인
해결 Step 1 — 조직 정책 관리자 권한 부여
해결 Step 2 — 문제 정책 비활성화
해결 Step 3 — API 키 재생성 및 검증
여전히 막힌다면 — ADC 우회법

1. 문제 상황

GCP 무료 크레딧($300)으로 Vertex AI에서 Claude API를 호출하려고 서비스 계정 키를 생성하려 했는데, 프로젝트 Owner임에도 아래 에러가 뜹니다.

에러: iam.managed.disableServiceAccountApiKeyCreation 제약 조건에 의해 API 키 생성이 차단되었습니다.

직관적으로 말이 안 되는 상황이죠. Owner인데 왜 못 만드는 걸까요?

2. 원인 — GCP 권한 계층 구조

GCP의 권한 계층은 아래처럼 생겼습니다. 조직 정책은 IAM 역할(Owner 포함)보다 상위 레이어에 있습니다.

최상위

조직 정책
(Org Policy)

›

중간

폴더 / 프로젝트
정책

›

하위

IAM 역할
(Owner 등)

즉, 집주인(Owner)이라도 건물 관리 규정(Org Policy)에서 “방 구조 변경 금지”를 걸어두면 마음대로 못 바꿉니다.

핵심 진단: 콘솔 상단 프로젝트 드롭다운에서 프로젝트 옆에 조직 이름이 표시되나요? “조직 없음”이 아닌 특정 조직 이름이 뜬다면 그 조직의 정책이 적용된 것입니다.

3. 해결 방법

해당 조직의 관리자가 본인이라면 직접 정책을 풀 수 있습니다.

Step 1

조직 정책 관리자 권한 부여

GCP 콘솔 → IAM 및 관리자 → IAM
상단 범위를 프로젝트 → 조직으로 전환
본인 계정 옆 수정(연필) 아이콘 클릭
조직 정책 관리자 (Organization Policy Administrator) 역할 추가
저장

Step 2

문제 정책 비활성화

IAM 및 관리자 → 조직 정책으로 이동
검색창에 disableServiceAccountApiKeyCreation 입력
해당 정책 클릭 → [관리] 버튼
“재정의 후 미적용 (Not enforced)” 으로 변경 → 저장

Step 3

서비스 계정 API 키 재생성 및 검증

IAM 및 관리자 → 서비스 계정으로 이동
대상 서비스 계정 클릭 → 키 탭
[키 추가] → JSON 형식으로 다운로드

4. 정책 수정 권한도 없다면 — ADC 우회법

조직 관리자가 본인이 아닌 경우(교육기관 제공 계정 등), API 키 방식 자체를 우회할 수 있습니다.

원리: Service Account API Key를 생성하지 않고, 현재 로그인된 사용자 인증 정보(ADC)를 SDK가 자동으로 읽어가게 하는 방식입니다.

terminal

gcloud auth application-default login
gcloud config set project YOUR_PROJECT_ID

python

import anthropic
import google.auth
import google.auth.transport.requests

credentials, project = google.auth.default()
credentials.refresh(google.auth.transport.requests.Request())

client = anthropic.AnthropicVertex(
    project_id=project,
    region="us-east5"
)

message = client.messages.create(
    model="claude-opus-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}]
)

5. 그래도 할당량 0 에러가 뜬다면

정책 문제를 해결했는데도 “할당량 소진” 에러가 뜨는 경우가 있습니다. 신규 유료 계정은 Claude 등 파트너 모델의 초기 할당량이 0으로 설정되어 있기 때문입니다.

해결: GCP 콘솔 → IAM 및 관리자 → 할당량 및 시스템 한도 → Claude 관련 항목 검색 → 값이 0이면 [할당량 수정 요청]으로 최솟값(예: 1~5 RPM) 신청

요약: Owner 권한인데 막힌다 → 조직 소속 확인 → 조직 정책 관리자 권한 부여 → 정책 비활성화 → 키 재생성. 조직 수정 권한이 없다면 ADC 방식으로 우회.