자동화 →

서비스 계정Service Account

서비스 계정(Service Account)은 사람 대신 일하는 로봇 직원의 사원증 같은 것 — 프로그램이 구글 드라이브 같은 서비스에 사람 로그인 없이 접근하도록 만든 전용 계정이에요.

회사에 로봇 직원을 들이면 그 로봇에게도 사원증을 발급해야 문을 열고 서류를 가져올 수 있어요. 서비스 계정이 바로 프로그램용 사원증이에요. 사람이 비밀번호로 로그인하는 대신, 프로그램은 서비스 계정의 키 파일(JSON)로 신분을 증명하고 허락받은 폴더나 기능에만 접근해요. 사람 계정과 달리 이메일 주소처럼 생긴 고유 주소를 가져요.

강의에서는 클라우드 환경에서 돌아가는 작업이 결과물을 구글 드라이브에 저장하게 할 때 써요. 구글 클라우드 콘솔에서 서비스 계정을 만들고 JSON 키를 내려받아 클라우드 환경 변수에 넣어요. 그다음 드라이브의 Output 폴더를 서비스 계정의 이메일 주소에 '편집자'로 공유해요. 이렇게 하면 내가 로그인하지 않아도 프로그램이 그 폴더에 파일을 올릴 수 있어요.

초보가 가장 많이 놓치는 단계가 폴더 공유예요. 서비스 계정은 내 드라이브를 자동으로 볼 수 없어서, 쓰려는 폴더를 그 계정 이메일에 직접 공유해야 해요. JSON 키 파일은 비밀번호와 같아서 깃허브에 올리거나 채팅에 붙이면 안 돼요. 환경 변수나 비밀 저장소에만 넣고, 필요한 폴더·권한만 주는 최소 권한 원칙을 지키세요. 사용자 본인으로 로그인해 동작하는 OAuth와는 목적이 달라요. 키를 여러 개 만들었다면 쓰지 않는 키는 바로 지워 관리 대상을 줄이세요.

💡 대표 예시

  • 드라이브 저장 — Output 폴더를 서비스 계정 이메일에 편집자로 공유한다
  • 키 발급 — 구글 클라우드 콘솔에서 서비스 계정을 만들고 JSON 키를 받는다
  • 클라우드 환경 — JSON 키 내용을 환경 변수에 넣어 프로그램이 읽게 한다
  • 권한 최소화 — 서비스 계정에는 결과물 폴더 하나만 공유한다
  • 키 유출 의심 — 기존 키를 삭제하고 새 JSON 키로 교체한다

🔗 관련 용어

환경변수

환경변수는 금고 열쇠를 별도 서랍에 보관하는 것 — 비밀번호·API 키 같은 민감 정보를 코드 안에 직접 쓰지 않고 별도 파일에 분리해서 관리하는 방식.

구글 클라우드 콘솔

구글 클라우드 콘솔(Google Cloud Console)은 구글 서비스용 관리사무소 같은 것 — 프로젝트를 만들고 유튜브·드라이브·지도 API를 켜고 로그인용 키를 발급받는 구글의 관리 화면이에요.

구글 드라이브 API

구글 드라이브 API(Google Drive API)는 드라이브 창고에 프로그램 전용 출입문을 다는 것 같은 것 — 사람이 직접 클릭하지 않아도 프로그램이 구글 드라이브에 파일을 올리고 내려받고 정리하게 해 주는 연결 통로예요.

JSON

JSON (JavaScript Object Notation)은 칸이 정해진 주문서 양식 같은 것 — "이름": "값" 짝으로 데이터를 정리해 프로그램끼리 주고받는 글자 형식이에요.

최소 권한 원칙

최소 권한 원칙(Principle of Least Privilege)은 아르바이트생에게 필요한 열쇠만 주는 것 같은 것 — 사람이나 AI 에이전트에게 일에 꼭 필요한 만큼의 권한만 주는 보안 원칙이에요.

시크릿(비밀키)

시크릿(Secrets)은 은행 금고에 맡겨 둔 열쇠 같은 것 — API 키·토큰·비밀번호처럼 노출되면 안 되는 값을 코드 밖의 안전한 보관소에 따로 저장해 두고 프로그램이 실행될 때만 꺼내 쓰게 하는 방식이에요.

이 개념, 직접 적용해볼까요?

반복 작업을 에이전트에 맡기는 법, 강의에서 내 사업에 맞게 처음부터 배워보세요.