API 키 공유와 유출 — 팀원·외주에 나누고 새면 끄는 순서

API 키는 비밀번호처럼 사람·프로젝트마다 따로 만들어 쓰고, 한 키를 단톡방이나 공유 문서로 돌리지 마세요. 키가 새어 나간 것 같으면 그 키를 바로 끄거나 새 키로 바꾼 뒤 사용 기록을 확인하세요. 저장소에서 커밋을 지우는 것만으로는 이미 새어 나간 키를 막을 수 없어요.

어느 회사 키든 답은 같아요. Anthropic 도움말도 쓸 사람은 자기 키를 받으라고 하고, Google 은 Gemini API 키를 비밀번호처럼 다루라고 해요.

키는 쓰는 사람과 쓰는 곳마다 하나씩 나눠요. 키 이름에 누가·어디에 쓰는지 적어 두면, 끌 때 어느 줄인지 바로 찾아요.

「키 만들기」로 하나씩 만든 키는 한도·기한 없이 시작해 지갑 잔액까지 써요. 만든 뒤 바로 그 줄의 「한도 수정」에서 월·하루 사용 한도와 「이 날까지 사용」을 넣어요. 같은 조건의 키가 여럿이면 「여러 개 발급」에서 처음부터 걸어요.

키 원문은 메신저 단체방·메일·공유 문서·스프레드시트·저장소·앱이나 웹 화면 코드에 적지 않아요. 받은 사람은 환경변수나 비밀 관리 도구에 넣고, 받은 메시지는 지워요.

원포트는 키 원문을 저장하지 않아서 잃어버린 키를 다시 보여 드릴 수 없어요. 잃어버리면 그 줄의 「새로 받기」로 새 키를 받아요.

「관리 키」(sk-som- 로 시작)는 AI 를 부르지 못하지만, 가진 사람이 이 지갑의 API 키를 모두 만들고 폐기할 수 있어요. 키를 관리하는 사람만 갖고 외주나 다른 팀에 건네지 않아요.

1. 1지갑 주인 계정으로 스쿨오더·오피스오더의 「AI API」 화면을 열고 「키 관리」로 가요.
2. 2「여러 개 발급」을 열어 이름 앞머리, 「만들 개수」, 키별 월 한도·하루 한도, 「이 날까지 사용」을 적고 「일괄 발급」을 눌러요.
3. 3「CSV 받기」로 이름과 키 원문이 든 파일을 받아 보관해요. 이름은 「앞머리 1」, 「앞머리 2」…처럼 번호로 붙으니 몇 번을 누구에게 줬는지 적어 둬요.
4. 4화면 안내 「CSV를 보관하고 각자에게 자기 키만 전달해주세요」대로, 한 사람에게 자기 키 한 줄만 따로 전해요. CSV 파일을 통째로 단톡방이나 공유 폴더에 올리지 않아요.
5. 5다 받았으면 「보관했어요」를 눌러요.

기한이 지난 키도 폐기하기 전까지 켜진 키 자리를 차지해요. 계약이 여러 번 끝나도 자리가 비지 않으면 이 정리부터 해요.

하루 한도는 쓴 양이 한도에 닿은 다음 호출부터 막아서, 마지막 한 번과 그때 함께 보낸 호출만큼은 넘을 수 있어요.

아래 조건을 발주서나 계약서 특약에 붙이고, 빈칸은 프로젝트에 맞게 채워요.

1. 1참여하는 사람마다 키를 하나씩 만들고, 이름은 「업체명-프로젝트명-이름」처럼 적어요.
2. 2「이 날까지 사용」에 계약 종료일을, 하루 사용 한도에 하루에 쓸 몫을 넣어요.
3. 3납품물(소스·설정 파일·문서)에서 키를 빼고, 키를 넣을 환경변수 이름만 남기게 해요.
4. 4계약이 끝나면 그 키를 「폐기」해요. 기한이 지나 닫힌 키는 「기한 지난 키 폐기」 → 「N개 폐기」로 한 번에 정리해요.

[API 키 사용 조건]
1. 이 일에만 쓰는 키를 참여하는 사람마다 하나씩 드려요. 키 이름은 「업체명-프로젝트명-이름」이에요.
2. 키에는 끝나는 날(____년 __월 __일)과 하루 사용량 상한(____)이 걸려 있어요. 더 필요하면 미리 담당자에게 알려 주세요.
3. 키는 환경변수나 비밀 관리 도구에만 두고, 소스 코드·저장소(공개·비공개)·앱/웹 화면 코드·메신저·메일·공유 문서에는 적지 않아요.
4. 키를 다른 사람이나 다른 프로젝트에 넘기지 않아요. 사람이 바뀌면 새 키를 요청해요.
5. 키가 새어 나갔거나 그렇게 의심되면 알게 된 뒤 __시간 안에 담당자(연락처 ____)에게 언제·어디에 보였는지 알려 주세요. 커밋이나 저장소를 지우는 것으로 알림을 대신하지 않아요.
6. 계약이 끝나는 날 발주처가 키를 폐기해요. 납품물에서는 키를 지우고, 키를 넣을 환경변수 이름만 문서로 남겨 주세요.
7. 이 키로 쓴 양은 발주처가 키마다 이번 달 합계로 확인해요.

공개 저장소·공개 웹페이지·앱 코드처럼 누구나 볼 수 있는 곳에 키가 보였거나, 쓰지 않았는데 키 줄의 「최근 사용」이 오늘로 바뀌고 「이번 달 사용」이 늘었다면 바로 꺼요. 서비스가 잠깐 멈춰도요. 그 키에 하루 사용 한도가 없으면 더 미루지 마세요.

노트북을 잃어버렸거나, 키를 가진 사람이 나갔거나, 새었는지 확실하지 않다면 새 키를 먼저 넣고 옛 키를 꺼요.

제공사 안내도 이 두 길을 나눠 적어요. Anthropic 은 유출이 의심되면 그 키를 바로 지우고 새 키를 만들라고 하고, Google 은 새 키를 앱에 넣어 확인하기 전엔 옛 키를 지우지 말라고 해요.

깃허브 문서는 코드에서 키를 지우거나, 새 커밋을 올리거나, 저장소를 지우고 다시 만들어도 이미 새어 나간 키의 악용은 막지 못한다고 적어요. 키를 내준 회사 쪽에서 그 키를 꺼야 끝나요.

깃허브는 공개 저장소에 올라간 키를 찾아 키를 낸 회사에 알려 주기도 해요. 다만 알림을 받은 뒤 키를 끌지는 그 회사가 정해요.

새어 나간 키가 언제부터 얼마나 쓰였는지는 아래 네 곳으로 좁혀요.