구글 클라우드, IAM 헬퍼 에이전트 스킬 공개: 바뀐 점과 지금 할 일

구글 클라우드 IAM 헬퍼 에이전트 스킬은 코딩 에이전트가 권한 오류 진단, 최소 권한 정책 작성, 변경 영향 시뮬레이션, 임시 권한 요청을 직접 호출하게 해 주는 스킬 4종이다. 구글 클라우드가 2026년 10월 27일 블로그로 공개했고, 진단과 시뮬레이션은 자동으로 실행되지만 접근 정책 변경은 사람 확인에서 멈춘다.

IAM 헬퍼 에이전트 스킬, 누가 다시 정해야 하나

에이전트에게 배포를 맡겼다면 권한을 누가 어디까지 열어 줄지 다시 정해야 한다. 회사 출입증에 비유하면, 신입이 문 앞에서 막힐 때마다 아무 문이나 열리는 만능 출입증을 받으면 보안이 무너지고, 반대로 매번 총무팀에 줄을 서면 일이 멈춘다. 이번 스킬은 문이 왜 안 열리는지 알려 주고 임시 출입증 신청까지 대신하되, 출입 규칙을 바꾸는 최종 도장은 사람에게 남긴다. 구글 클라우드도 같은 방식으로 진단과 정책 변경을 분리해 설계했다. 다만 이것은 구조를 설명하는 비유이고, 실제 위험 등급 기준은 아래에서 보듯 아직 공개된 내용이 없다.

무엇이 바뀌었나: 스킬 4종과 읽기 전용 MCP 도구

구글 클라우드는 공식 블로그에서 에이전트가 자율적으로 인프라를 만들고 배포하면서 권한 문제가 더 자주, 더 빨리 터진다고 설명했다. 수동으로 권한 오류를 풀면 개발자와 관리자가 지치고, 지름길로 가면 에이전트가 과도한 권한을 받아 최소 권한 원칙이 깨진다는 것이다. 그 해법이 IAM 헬퍼이며, 열린 Agent Skills 표준으로 패키징돼 Gemini CLI, Gemini Cloud Assist, ADK, Claude Code, Cursor에서 쓸 수 있다고 한다.

IAM 헬퍼 스킬 4종이 하는 일

스킬 이름	하는 일
iam-helper-for-policy-management	JSON, YAML, Terraform 형식의 접근 요구사항으로 IAM v1 허용 규칙과 v2 거부 규칙을 만들고 검증한다. allUsers 공개 접근과 roles/owner, roles/editor 같은 넓은 기본 역할은 적용 전에 막는다.
iam-helper-for-troubleshooting	403 PERMISSION_DENIED 오류에서 빠진 권한이나 막는 규칙을 찾는다. 개발자용 흐름은 스스로 풀 수 있는지 보거나 관리자에게 보낼 요청서를 만들고, 관리자용 흐름은 조직·폴더·프로젝트로 상속되는 규칙을 추적한다.
iam-helper-for-policy-simulator	계획, 시뮬레이션, 분석, 적용 4단계로 정책 변경을 검증한다. 최근 90일 접근 로그로 기존 트래픽이 끊기지 않는지 먼저 본다. 구글 Policy Simulator 문서도 최근 90일 접근 시도를 현재 정책과 제안 정책으로 다시 평가한다고 설명한다.
iam-helper-for-privileged-access-management	Privileged Access Manager(PAM)로 임시 권한 요청, 승인, 자동 회수를 처리한다. 상승된 접근은 감사 기록이 남고 시간이 정해져 있다.

스킬이 직접 쓰는 도구는 구글 관리형 MCP 서버의 IAM MCP 도구다. 구글은 이 도구가 Policy Troubleshooter, Policy Analyzer, Policy Simulator, IAM v1·v2 API에 연결된 읽기 전용 함수라고 밝혔다. 팀이 API 래퍼를 직접 만들 필요가 없고, 에이전트가 도구를 찾아 호출하면 긴 정책 문서를 프롬프트에서 직접 해석하지 않아도 된다는 설명이다.

내 경우도 해당되나: 에이전트에게 구글 클라우드 일을 맡기는 경우

구글은 두 가지 사용 장면을 들었다. 첫째는 개발자의 코딩 에이전트가 배포 중 403 오류를 만났을 때, 티켓을 올리고 기다리는 대신 진단 스킬로 빠진 Pub/Sub 권한을 찾고 PAM 스킬로 1시간짜리 임시 권한을 요청하는 흐름이다. 둘째는 인프라 에이전트가 배포 파이프라인에서 권한에 막히면 빌드를 실패시키지 않고 최소 권한 정책 초안을 만들고, 시뮬레이터로 90일 로그 기준 영향을 확인한 뒤 관리자에게 승인을 요청하는 흐름이다.

반대로 에이전트를 쓰지 않고 콘솔에서 직접 권한을 관리하는 팀은 당장 달라지는 것이 없다. 이미 쓰는 IAM 기능 위에 에이전트용 연결 계층이 더해진 것이어서, 기존 역할과 정책이 자동으로 바뀌지는 않는다. 다른 구글 클라우드 MCP 도구를 에이전트에 연결할 때도 같은 원칙(사람 승인, 좁은 권한, 감사 로그)을 먼저 확인해 둘 만하다.

지금 할 일: 설치 전에 권한 범위부터 정한다

스킬이 무엇인지 낯설다면 클로드 스킬이란? SKILL.md로 만드는 법을 먼저 읽어도 된다. 구글 클라우드 Agent Skills 카탈로그의 skills/cloud/ 폴더에 4개 스킬이 올라와 있고, 카탈로그 안내에 따르면 npx skills add google/skills로 설치한다. 실행하면 설치할 스킬, 대상 에이전트, 설치 범위(프로젝트 또는 전체)를 고르는 화면이 나온다.

1. 에이전트가 쓰는 서비스 계정에 주는 역할을 먼저 점검한다. 권한이 넓은 에이전트 계정이 다른 자원으로 번지는 경로는 AI 에이전트의 IAM 횡적 이동 확인법에서 볼 수 있다. 스킬이 사람 확인을 요청하더라도, 에이전트 계정이 IAM 정책을 직접 수정할 수 있는 역할을 갖고 있으면 스킬을 거치지 않는 경로가 남기 때문이다.
2. 처음에는 진단 스킬(iam-helper-for-troubleshooting)과 읽기 전용 도구만 설치해 403 오류가 났을 때 원인을 제대로 짚는지 본다.
3. 정책 변경 스킬은 시뮬레이터와 함께 시험용 프로젝트에서 켜고, 변경 전 사람에게 확인을 요청하는지 본다.
4. PAM 스킬은 임시 권한을 승인하는 사람과 유효 시간을 정한 뒤 쓴다.

성공 여부는 세 가지로 확인한다. 에이전트가 403 오류의 원인을 정확한 권한이나 규칙 이름으로 답하는지, 정책 변경 요청이 승인 대기에서 멈추는지, 임시 권한이 정해진 시간 뒤 사라지는지를 본다. PAM 이벤트는 Cloud Audit Logs에 기록되므로 요청·승인·회수 기록이 남았는지도 함께 본다.

앞으로 확인할 점

블로그는 프리뷰인지 정식 출시인지, 요금이 붙는지를 밝히지 않았다. 스킬별로 지원하는 도구와 MCP 서버 주소도 글에 나오지 않으므로 도입 전에 IAM 공식 문서에서 확인해야 한다. 접근 정책 변경을 사람 확인에 맡기는 기준은 사용자가 바꿀 수 있는 위험 등급에 따른다고만 설명돼 있어, 어떤 변경이 어느 등급에 들어가는지는 직접 시험해 정해야 한다. 에이전트 개발 환경이 처음이라면 구글 ADK 사용법에서 스킬을 붙일 개발 키트부터 살펴볼 수 있다.

자주 묻는 질문

IAM 헬퍼 스킬은 클로드 코드에서도 쓸 수 있나?

구글은 공식 블로그에서 Gemini CLI, Gemini Cloud Assist, ADK, Claude Code, Cursor에서 쓸 수 있다고 밝혔다. 설치할 때 대상 에이전트를 고른다.

에이전트가 권한을 마음대로 바꿀 수 있나?

구글 블로그에 따르면 진단과 시뮬레이션은 자동으로 실행되지만 접근 정책 변경은 위험 등급에 따라 사람 확인에서 멈춘다. MCP 도구 자체는 읽기 전용이다.

403 오류만 풀면 되는데 전부 설치해야 하나?

구글 카탈로그 안내에 따르면 설치할 때 스킬을 전체 또는 개별로 고를 수 있다. 403 오류의 원인만 찾으려면 진단 스킬만 설치하면 된다.