열쇠 갈아 끼우기
직원이 나가거나 키가 샜을 때 쓰던 키를 새것으로 바꾸는 절차예요. 순서를 미리 알아 두면 사고가 난 날에도 당황하지 않아요.
쉽게 말하면
가게 도어락 번호를 바꾸는 일이에요. 번호를 바꾸는 손동작은 1분이면 끝나요. 어려운 건 그 번호를 아는 사람이 사장님만이 아니라는 점이에요. 아침 담당 알바, 재고 넣어 주는 거래처, 청소 업체가 다 그 번호로 들어와요. 번호만 덜컥 바꾸면 다음 날 아침에 아무도 못 들어와요. 키를 갈아 끼우는 일도 똑같아요. 새 키를 만드는 것보다, 옛 키를 쓰던 곳을 빠짐없이 찾는 것이 이 작업의 전부예요.
여기서 말하는 키는 API 키예요. 결제사, 문자 발송, 지도, AI 서비스처럼 다른 회사 기능을 붙일 때 받아 둔 출입증이에요.
지운 그 순간부터 결제와 문자 발송이 멈춰요. 손님은 오류 화면을 보고, 사장님은 어디에 새 키를 넣어야 하는지를 그 급한 와중에 찾게 돼요.
손님 쪽에서는 아무 일도 안 일어나요. 옛 키가 아직 어딘가에서 쓰이고 있으면 폐기 전에 그 사실이 드러나요.
갈아 끼워야 하는 날
전부 같은 급하기가 아니에요. 오늘 안에 끝내야 하는 것과 이번 달 안에만 하면 되는 것이 섞여 있어요. 왼쪽에서 내 상황을 찾으세요.
| 이런 일이 있었어요 | 언제까지 | 왜 그 속도인가 |
|---|---|---|
| 키를 단체 대화방이나 메일로 보냈어요 | 오늘 안에 | 지운 메시지도 상대 기기와 백업에는 남아요. 보낸 순간 이미 내 손을 떠났어요 |
| 청구서에 안 쓴 사용량이 찍혔어요 | 지금 즉시 | 새는 동안에도 요금은 계속 붙어요. 원인 조사보다 폐기가 먼저예요 |
| 키를 알던 직원이나 외주가 일을 마쳤어요 | 일이 끝난 그 주 안에 | 나쁜 마음이 아니어도 그 사람 노트북이 분실되면 내 키가 같이 사라진 셈이에요 |
| 코드나 캡처에 키가 그대로 들어갔어요 | 오늘 안에 | 공개된 키는 사람이 아니라 자동 프로그램이 찾아내요. 발견까지 오래 걸리지 않아요 |
| 아무 일도 없었어요 | 반년에서 1년에 한 번 | 언제 샜는지 모르는 키가 몇 년째 살아 있는 상태를 끊는 청소예요 |
| 쓰던 서비스를 해지했어요 | 해지하는 날 같이 | 안 쓰는 키가 살아 있으면 아무도 안 보는 문이 열려 있는 것과 같아요 |
마지막 줄이 제일 자주 빠져요
쓰다 만 서비스의 키가 계정에 남아 있는 경우가 많아요. 새는 걸 알아챌 사람이 아무도 없다는 점에서 이게 가장 조용한 위험이에요. 정리하는 날에 안 쓰는 키부터 지우면 절반이 끝나요.
먼저 세는 것: 이 키가 사는 자리
절차를 시작하기 전에 종이 한 장을 채워야 해요. 이 키를 어디어디에 넣어 뒀는가. 이 목록이 없으면 갈아 끼우기가 아니라 서비스 중단이 돼요.
| 키가 들어가 있을 만한 자리 | 확인하는 법 | 빠뜨리면 생기는 일 |
|---|---|---|
| 운영 중인 서비스의 환경변수 | 설정 화면에서 키 이름 목록을 눈으로 확인해요 | 진짜 손님 쪽 기능이 멈춰요. 가장 먼저 티가 나는 자리예요 |
| 연습 환경 | 운영과 같은 이름의 칸이 있는지 봐요 | 손님은 멀쩡한데 점검할 때만 실패해요. 원인을 엉뚱한 데서 찾게 돼요 |
| 정해진 시간에 도는 자동 작업 | 매일 아침 보내는 알림이나 월말 집계가 있는지 떠올려요 | 그날은 조용하고 다음 달 첫 주에 터져요. 가장 늦게 드러나는 종류예요 |
| 외주나 직원의 개인 컴퓨터 | 받은 사람이 있으면 그 사람에게 직접 물어요 | 내 쪽은 다 바꿨는데 옛 키가 계속 쓰여요. 폐기 시점에 알게 돼요 |
| 다른 회사 관리자 화면에 넣어 둔 칸 | 결제사나 배송사 설정에 내 키를 등록한 적이 있는지 봐요 | 통보가 안 들어와요. 주문은 들어왔는데 알림만 안 오는 상태가 돼요 |
직접 해보기
무엇을 붙여 뒀는지부터 열어 보세요
연결 센터에서 지금 내 서비스에 어떤 것이 붙어 있는지 볼 수 있어요. 오늘 아무것도 바꾸지 않아도 돼요. 연결 하나당 키가 어디에 들어가 있는지 한 줄씩 적어 두는 것만으로 이 문서의 절반이 끝나요.
연결 센터 열기겹치는 시간을 만드는 순서
핵심은 하나예요. 새것을 먼저 만들고, 옛것은 마지막에 지운다. 두 키가 함께 살아 있는 며칠이 사고를 막는 안전망이에요.
- 1새 키를 발급받아요. 이 순간에는 아무것도 안 바뀌어요. 옛 키도 그대로 살아 있어요.
- 2새 키에 쓸 수 있는 범위를 좁혀요. 읽기만 되게 하거나 필요한 기능만 켜요. 딱 필요한 만큼만이 여기서 값을 해요.
- 3앞에서 만든 목록의 자리를 하나씩 새 키로 바꿔요. 한 번에 다 하지 말고 한 자리씩 하고 화면을 눌러 봐요.
- 4옛 키의 사용 기록을 며칠 지켜봐요. 여기서 0이 안 되면 아직 못 찾은 자리가 있다는 뜻이에요.
- 5사용 기록이 조용해지면 옛 키를 폐기해요. 이 단계를 안 하면 앞의 네 걸음이 전부 의미가 없어져요.
- 6바꾼 날짜를 적어 둬요. 다음 정기 교체와 사고 조사 때 이 한 줄이 기준선이 돼요.
순서가 뒤집히면 성격이 달라져요
옛 키를 먼저 지우면 그건 교체가 아니라 영업 중단 뒤 복구예요. 급한 마음에 발급 화면에서 삭제부터 누르는 실수가 가장 흔해요. 딱 한 경우에만 옛것을 먼저 죽여요. 지금 새고 있는 게 확실할 때예요.
확인해 보세요
외주 개발자가 일을 마쳤어요. 그 사람이 알던 키를 정리하려고 해요. 첫 순서는?
만들었다고 옛것이 죽지 않아요
이 작업에서 가장 많이 나오는 오해예요. 새 키를 발급받으면 옛 키가 자동으로 무효가 될 거라고 생각하는 거예요. 대부분의 서비스는 둘 다 살려 둬요. 겹치는 시간을 쓰라고 일부러 그렇게 만든 거예요.
장면 1 · 정리를 마쳤다고 생각한 다음 달
“지난달에 새 키로 다 바꿨는데, 옛 키 사용량이 계속 찍혀요.”
바꾸기는 했는데 폐기를 안 한 상태예요. 여기서 값이 나가는 건 놀라는 게 아니라 그 사용 기록이에요. 옛 키가 어디서 쓰이고 있는지 알려 주는 유일한 단서니까요. 기록에 남은 시간대와 내 자동 작업 시간표를 맞춰 보면 못 찾은 자리가 나와요.
장면 2 · 외주 업체가 작업 전에 말했다
“키는 제 쪽 설정 파일에 넣어 두고 쓸게요. 끝나면 지우겠습니다.”
지우겠다는 약속은 확인할 방법이 없어요. 이 자리에서 할 말은 하나예요. "일이 끝나면 제가 그 키를 폐기하고 새로 발급할게요." 이러면 상대의 성의와 무관하게 정리가 끝나요. 더 좋은 방법은 처음부터 그 작업 전용 키를 따로 발급해 주는 거예요. 권한과 역할을 나눠 두면 폐기 범위도 그만큼 좁아져요.
사람을 의심하는 절차가 아니에요
교체는 상대를 못 믿어서 하는 일이 아니에요. 누구의 실수여도 피해가 그 사람 손에서 끝나게 만드는 장치예요. 그래서 일이 끝나면 자동으로 도는 순서로 만들어 두는 게 좋아요. 그때그때 판단하면 껄끄러워서 미루게 돼요.
자주 묻는 것
- Q. 키를 바꾸면 손님이 로그아웃되거나 데이터가 사라지나요?
- 아니에요. 여기서 바꾸는 건 내 서비스와 다른 회사 사이의 출입증이에요. 손님 계정이나 저장된 기록과는 다른 층이에요. 다만 소셜 로그인처럼 손님 로그인 경로에 쓰이는 키라면 잠깐 로그인 실패가 날 수 있어서, 그런 건 손님이 적은 시간에 바꿔요.
- Q. 얼마나 자주 바꿔야 정답인가요?
- 사고가 없다면 반년에서 1년에 한 번이 무난해요. 다만 날짜보다 사건이 기준이에요. 사람이 나가거나 키가 노출된 날에는 주기와 상관없이 바로 해요.
- Q. 바꾸는 동안 서비스가 멈추나요?
- 겹치는 시간을 만들면 안 멈춰요. 두 키가 다 살아 있는 상태에서 자리를 하나씩 옮기니까요. 멈추는 경우는 옛 키를 먼저 지웠을 때예요.
- Q. 키를 어디에 넣었는지 기억이 안 나요. 어떻게 찾나요?
- 옛 키의 사용 기록이 지도예요. 언제 어느 시간대에 쓰였는지 보고 그 시간에 도는 기능을 찾아요. 그래서 옛 키를 성급히 지우면 안 돼요. 지우는 순간 그 단서도 같이 사라져요.
- Q. 직원마다 키를 따로 주는 게 나은가요?
- 가능하면 그게 나아요. 사람마다 계정과 키가 따로면 나가는 사람 것만 끊으면 끝나요. 하나를 돌려쓰면 한 명이 나갈 때마다 전체를 갈아 끼워야 해요.
- Q. 바꾼 기록은 어디에 남겨 두나요?
- 발급 화면에도 남지만 내 쪽에도 한 줄 적어 두세요. 언제 무엇을 왜 바꿨는지면 충분해요. 나중에 이상한 사용량이 보일 때 누가 무엇을 했나 기록과 함께 보면 범위를 빨리 좁힐 수 있어요.
하나 더
새 키로 전부 바꿨는데 옛 키 사용 기록이 매일 새벽 3시에만 찍혀요. 무엇을 의심할까요?
직접 해보기
만드는 중이라면 이 문장을 그대로 보내세요
직접 만드는 중이면 이렇게 말하면 돼요. "키를 코드에 직접 적지 말고 환경변수로 읽게 해 주세요. 그리고 그 키를 쓰는 자리를 목록으로 알려 주세요." 앞 문장은 사고를 줄이고, 뒤 문장이 나중에 갈아 끼울 때 쓰는 지도가 돼요.
스튜디오에서 적어 보기더 깊이 (안 읽어도 괜찮아요)
비유가 어디까지 맞고 어디부터 다른가 · 도어락 번호는 사람이 외워서 누르지만 키는 프로그램이 자동으로 써요. 그래서 다른 점이 하나 생겨요. 도어락은 못 들어오는 사람이 문 앞에서 바로 항의하지만, 키는 못 들어가도 아무도 말을 안 해요. 조용히 실패한 뒤 며칠 있다가 "알림이 안 와요"로 나타나요. 바꾼 뒤 며칠을 지켜보는 단계가 필요한 이유가 이거예요.
두 개를 늘 살려 두는 방식 · 규모가 있는 곳은 아예 키를 항상 두 개 유지해요. 한쪽을 쓰는 동안 다른 쪽을 갈아 끼우고, 다음 교체 때 역할을 맞바꿔요. 그러면 교체가 특별한 행사가 아니라 평소 동작이 돼요. 1인 가게에서 여기까지 갈 필요는 없지만, 결제와 정산에 쓰는 키 하나만큼은 이 방식이 값을 해요.
폐기와 잠그기는 다른 버튼이에요 · 서비스에 따라 키를 즉시 삭제하는 것 말고 일시적으로 막는 기능이 있어요. 지금 새는지 확실하지 않을 때는 막기를 먼저 눌러요. 잘못 짚었으면 되돌릴 수 있으니까요. 확실히 샌 키는 막기가 아니라 삭제예요. 되살릴 여지를 남기면 안 되니까요.
이 절차가 [[incident-response|사고 대응]]과 만나는 지점 · 키가 샌 게 확실한 날에는 이 문서의 순서가 뒤집혀요. 옛 키를 먼저 죽이고, 그다음에 새 키를 만들고, 자리를 채워요. 몇 분에서 몇십 분 서비스가 멈추지만 그게 맞는 선택이에요. 새는 동안 나가는 요금과 열려 있는 문이 그 정지 시간보다 비싸니까요.
이것만 기억하세요
- ·새 키를 먼저 만들고 옛 키는 마지막에 지워요. 순서가 뒤집히면 영업 중단이 돼요
- ·새 키를 만들어도 옛 키는 안 죽어요. 폐기는 따로 눌러야 하는 별개의 단계예요
- ·시작 전에 이 키가 들어가 있는 자리를 목록으로 세요. 자동 작업과 연습 환경을 자주 빠뜨려요
- ·사람이 나가거나 키가 노출된 날은 주기와 상관없이 그 주 안에 바꿔요
- ·옛 키의 사용 기록이 못 찾은 자리를 알려 주는 지도예요. 조용해진 뒤에 지워요