🔐 구글 Maps API 키 보안을 위한 Referrer 제한 설정법

Google Maps API를 사용하는 프로젝트를 하다 보면,
API Key 하나로 지도도 띄우고, GeoJSON도 로딩하고, 다양한 기능을 활용할 수 있어요.

하지만!
이 API Key는 기본적으로 아무 웹사이트에서나 사용할 수 있기 때문에
아무런 제한 없이 방치하면 다른 사람이 내 API 키를 마음대로 가져다 쓸 수도 있습니다.
그 결과는? 👉 과금 폭탄 😱

그래서 꼭 필요한 게 바로 리퍼러(Referrer) 제한 설정이에요.

---

🧠 리퍼러(Referrer) 제한이란?

내 API 키를 사용할 수 있는 웹사이트(출처, 도메인)를 지정하는 보안 설정

즉, “이 키는 오직 내사이트.com에서만 쓸 수 있어!” 라고 구글에 알려주는 보안 설정이에요.

예를 들어 이렇게 설정하면:

도메인	사용 가능 여부
http://localhost:3000	✅ 사용 가능 (개발용)
https://myapp.com	✅ 사용 가능 (배포용)
https://badguy.com	❌ 차단됨

---

✅ 왜 꼭 설정해야 할까?

• 내 API 키가 외부에 유출되더라도, 지정된 도메인이 아니면 사용 불가
• 의도치 않은 API 사용으로 Google Cloud 비용이 폭증하는 걸 방지
• 회사나 팀 프로젝트에서도 기본 보안 습관으로 강력 추천

---

⚙️ 리퍼러 제한 설정 방법

1. Google Cloud Console 접속
2. API 및 서비스 > 사용자 인증 정보 메뉴 클릭
3. 사용 중인 API 키 선택
4. "애플리케이션 제한사항"에서 👉 웹사이트(HTTP 리퍼러) 선택
5. 허용할 도메인 입력

// 로컬 개발 환경
http://localhost:3000/*

// 배포 환경
https://yourdomain.com/*

// 서브도메인까지 허용할 경우
https://*.yourdomain.com/*

6. 💾 저장 버튼 클릭!

---

📸 설정 화면 예시

API 키 상세 설정 화면

위처럼 "웹사이트" 항목이 선택되어 있어야 합니다.

---

🧪 설정 후 확인

• 잘못된 도메인에서 키를 쓰면 콘솔에 아래 오류가 떠요:

RefererNotAllowedMapError

• 반대로, 설정한 도메인에서는 문제 없이 지도가 잘 뜨면 OK!

---

✅ 요약

항목	설명
목적	내 Google Maps API 키를 정해진 웹사이트에서만 사용하도록 제한
이점	보안 강화, 무단 사용 방지, 예상치 못한 요금 폭탄 방지
추천 대상	모든 웹 기반 Google Maps API 사용자

---

지금 구글 지도 프로젝트를 시작하려고 한다면,
API 키 발급 후 리퍼러 제한부터 꼭 설정해두세요.
작은 습관 하나가 큰 사고를 막아줍니다 🔒