API 키가 서너 개일 때는 메모장 하나만 열어둬도 별문제가 없습니다. 저도 처음에는 그 정도로 충분하다고 생각했거든요.
그런데 날씨, 지도, 공공데이터, 검색 서비스 같은 걸 이것저것 붙이다 보니, 키 이름을 정하는 것보다 더 골치 아픈 일이 생겼습니다.
"대체 이번 작업에는 어떤 인증키가 들어가야 하지?" 하고 원본 목록에서 다시 찾는 일입니다.
모아놓은 API 키가 30개, 50개로 늘어났는데 막상 만드는 날씨 앱에는 그중 5개만 필요하다면, 결국 또 일일이 눈으로 찾아 복사해야 합니다. 그래서 제가 직접 쓰려고 만든 API Key Name Studio 도구도 기능 개편을 거쳤습니다.
현재 v40.9에서는 여러 TXT 파일에서 키를 한꺼번에 불러와 이름을 깔끔히 정리한 다음, 이번 프로젝트에서 실제 쓸 인증키만 체크해 TXT 하나로 쏙 묶어내는 방식으로 개선했습니다.
이 도구가 해주는 일은 크게 세 가지입니다
도구를 처음 구상할 때 가장 고민했던 건 이름 규칙이었습니다. 한글 API 이름을 영어 로마자로 길게 늘려 놓으면 나중에 코드를 볼 때 도무지 구분이 안 가더군요.
예를 들어 한국토지주택공사는 LH, 한국관광공사는 KTO, 한국천문연구원은 KASI처럼 통용되는 기관 약칭을 앞줄에 붙입니다. 뒤따르는 기능명도 한눈에 알아보기 쉬운 영어 단어로 줄여줍니다.
한글 API 이름을 읽어 기관 약칭과 대표 기능 위주로 변환합니다. KEY_NAME 칸을 비워두어도 자동으로 깔끔하게 정돈됩니다.
한글 이름, KEY_NAME, 기관명으로 검색할 수 있고, 유사한 API는 그룹으로 모아봅니다. 기존에 써오던 키 이름은 직접 수정해 유지해도 됩니다.
전체 목록을 매번 복사할 필요 없이 이번 작업에 들어갈 항목만 체크한 뒤 별도의 TXT 파일로 바로 내보냅니다.
원하는 인증키만 골라 TXT 하나로 모으기
v40.9 업데이트에서 손이 제일 많이 갔던 부분도 프로젝트별 선택 내보내기입니다.
예를 들어 보관 중인 API 키가 수십 개라 해도, 이번에 새로 만드는 앱에 필요한 키가 4개뿐이라면 그 4개에만 체크 표시를 합니다. 그러고 나서 선택 키 TXT 저장 버튼을 누르면 딱 필요한 내용만 담긴 TXT 파일이 만들어집니다.
만들어진 TXT 내부에는 복잡한 구조를 넣지 않았습니다. 한 줄에 하나씩 KEY_NAME=실제인증키 형식으로 단순하게 작성됩니다.
이렇게 모아두면 다른 프로젝트로 환경 변수를 옮길 때도 어떤 키를 넣어줘야 할지 헤맬 이유가 없습니다.
여러 인증키를 환경 변수에 한꺼번에 등록할 때도 이 방식이 훨씬 간편합니다. 파일 하나로 정리되어 있으니 작업 기준으로 삼기 딱 좋거든요.
WEATHER_API_KEY=실제인증키값 MAP_API_KEY=실제인증키값 AIR_QUALITY_KEY=실제인증키값 SEARCH_SERVICE_KEY=실제인증키값
Cloudflare Workers나 Pages 서비스를 이용 중이시라면 Wrangler의 일괄 등록 명령어(secret bulk)와 바로 연동해 쓸 수 있습니다. 제가 이 기능을 만든 주요 목적 중 하나이기도 합니다.
Workers 기준으로는 프로젝트용 TXT를 뽑아낸 다음 터미널에서 명령어 한 줄만 입력하면 환경 변수가 한꺼번에 등록됩니다.
npx wrangler secret bulk selected-keys.txt --name WORKER_NAME
Pages 프로젝트 역시 마찬가지 방식으로 손쉽게 처리할 수 있습니다.
npx wrangler pages secret bulk selected-keys.txt --project-name PAGES_PROJECT_NAME
Cloudflare를 안 쓰시더라도 아무 상관없습니다. 평범한 TXT 파일이라서 개발 팀원에게 전달하거나 새 프로젝트 환경을 구축할 때 묶음 문서로 쓰기 무척 편합니다.
사용 방법은 4단계로 단순합니다
따로 프로그램을 컴퓨터에 깔 필요가 없습니다. 다운로드한 HTML 파일 하나를 브라우저로 열면 바로 작동합니다.
기존에 쓰던 TXT 파일이 여러 개 있다면 한 번에 드래그해 넣으면 되고, 새로 얻은 API라면 수동 입력창에 한글 이름과 키값을 바로 작성하셔도 됩니다.
새로고침해도 작업 내용이 남아있습니다
도구를 만들면서 걱정했던 부분 중 하나가 실수로 새로고침을 누르는 상황이었습니다. 키를 20개쯤 정리했는데 탭을 잘못 건드려 날아가 버리면 다시 시작하기 막막해지니까요.
v40.9 버전은 현재 브라우저 탭의 sessionStorage에 작업 내용을 저장합니다. 덕분에 작업 중 새로고침을 하더라도 한글 이름, 변수명, 실제 키와 체크 상태까지 그대로 살아있습니다.
물론 브라우저 탭을 아예 닫으면 이 세션 기록도 말끔히 지워집니다. 소중한 인증키가 저장소에 오랫동안 남아있지 않도록 안전하게 설계했습니다.
탭을 실수로 새로고침해도 입력해둔 실제 키와 선택한 상태가 그대로 복원됩니다. 외부 서버로 데이터가 나가지 않습니다.
작업이 끝나면 TXT나 JSON 백업 파일로 내 컴퓨터에 안전하게 내려받아 보관하세요. 인증키가 포함된 파일은 공개된 곳에 올리지 않는 것이 원칙입니다.
API Key Name Studio v40.9 다운로드
별도 설치 없는 단일 HTML 도구 파일입니다.
PC 브라우저에서 바로 열어 안전하게 활용해보세요.
글을 마무리하며
API Key Name Studio는 거창한 비밀번호 관리 프로그램을 노리고 만든 게 아닙니다. 여러 서비스를 붙이다 보니 자꾸 헷갈렸던 이름 구분과 프로젝트별 키 묶음 작업을 조금이나마 쉽게 해보려고 만든 소소한 도구입니다.
한글 API 이름을 입력해 KEY_NAME을 정돈하고, 필요한 항목만 골라 단일 TXT 파일로 뽑아내는 과정만으로도 작업 시간이 꽤 단축되더군요.
매번 원본 메모장을 켜고 눈으로 인증키를 찾아 복사하셨던 분들이라면, 필요한 키만 묶어 넘기는 이 방식이 꽤 유용하게 느껴지실 겁니다.
이용안내 · 저작권 · 오류신고
힐링편의점은 생활정보, 웹도구, 계산기와 미니게임 등 일상에 도움이 되는 정보 및 편의 콘텐츠를 제공합니다. 게시물의 내용과 웹도구의 계산 결과는 참고용으로 이용해 주세요.
건강, 법률, 세무, 재정, 정부정책 등 중요한 판단이 필요한 정보는 관련 기관의 공식 자료나 해당 분야 전문가를 통해 다시 확인하시기 바랍니다. 미니게임과 테스트 결과는 오락 및 일반적인 두뇌 활동을 위한 것으로, 개인의 능력이나 건강 상태를 측정하거나 진단하는 자료가 아닙니다.
본 사이트가 직접 제작하고 권리를 보유한 콘텐츠, 디자인, 문구, 이미지와 웹도구 소스코드의 무단 복제, 재배포 및 상업적 이용을 금합니다. 내용을 인용하거나 공유할 경우 출처와 원문 링크를 함께 표시해 주세요.
외부 자료나 제3자 콘텐츠가 포함된 경우에는 해당 출처와 권리자의 이용 조건이 우선 적용됩니다.
© 2026 Healing Mart · 힐링편의점. All rights reserved.
웹도구나 미니게임이 정상적으로 작동하지 않거나 게시물에서 잘못된 정보를 발견하셨다면 아래 오류 신고 페이지로 알려주세요. 게임 또는 도구 이름, 사용 기기, 브라우저와 오류 내용을 함께 남겨주시면 문제를 확인하는 데 도움이 됩니다.
신고 내용에는 비밀번호, 주민등록번호, 전화번호 등 불필요한 개인정보나 민감한 정보를 작성하지 마세요.
