사용자 지정 웹훅을 이용한 IP 지리적 위치 조회 서비스 - n8n 워크플로우

개발자 및 통합자: 외부 애플리케이션에서 IP 정보를 빠르게 조회할 서버리스 방식이 필요한 분.
시스템 관리자: 액세스 로그를 분석하며 사용자 IP에 대한 지리적 맥락이 필요한 분.
n8n 사용자: n8n 웹훅 트리거와 HTTP 요청(HTTP Request) n8n 노드를 함께 사용하는 실용적인 예제를 찾고 있는 분.
자동화 전문가: 실시간 지리 데이터가 필요한 고급 n8n 워크플로우 프로세스를 구축하는 분.

이 강력한 n8n 워크플로우는 IP-API.com과 같은 모든 외부 공개 API 서비스를 경량의 내부 마이크로서비스로 변환하여 사용자 지정 URL을 통해 액세스할 수 있도록 하는 방법을 보여줍니다. 내장된 n8n 웹훅 트리거를 활용하면 IP 주소를 (POST 요청을 통해) 보내고 포괄적인 지리 정보를 즉시 수신할 수 있습니다.

이 특정 n8n 워크플로우는 외부 API를 직접 호출할 수 없는 시스템에 IP 조회 기능을 통합하거나 n8n 인프라 내에서 API 사용을 중앙 집중화하는 데 매우 유용합니다. 트리거링과 응답 반환이라는 이러한 유형의 n8n 노드 조합을 마스터하는 것은 n8n 템플릿을 사용하여 강력하고 확장 가능한 자동화를 구축하는 기본 사항입니다.

이 자동화는 n8n 트리거로 시작하여 구조화된 응답으로 마무리되는 직접적인 API 프록시 서비스로 작동합니다.

1. 웹훅 활성화 (n8n 트리거): Receive IP Webhook n8n 노드는 /ip-lookup 경로로 들어오는 POST 요청을 수신하도록 구성됩니다. 이 노드는 'ip' 속성을 포함하는 JSON 본문(예: {"ip": "203.0.113.45"})을 예상합니다.


2. API 호출: 트리거가 활성화되면 Get IP Geolocation n8n 노드가 IP-API.com으로 HTTP GET 요청을 실행합니다. 중요하게도 URL은 n8n 표현식을 사용하여 동적으로 구성됩니다. 이 표현식은 웹훅 본문에서 수신된 IP 주소를 API 엔드포인트에 삽입합니다.


3. 데이터 수신: IP-API는 국가, 지역, 도시, 위도/경도, ISP, 조직 등 상세한 데이터를 포함하는 JSON 페이로드를 반환합니다.


4. 응답: Respond with Geolocation Data n8n 노드는 이전 n8n 노드에서 가져온 전체 JSON 출력을 받아 웹훅을 호출한 클라이언트에 즉시 다시 전송합니다. 이로써 n8n 워크플로우의 전체 실행이 완료됩니다.

1. 가져오기(Import): 제공된 전체 n8n 워크플로우 JSON을 복사하여 '새로 만들기(New)' -> 'JSON에서 가져오기(Import from JSON)' 옵션을 사용하여 n8n 인스턴스에 직접 붙여넣습니다.


2. 웹훅 구성: Receive IP Webhook n8n 노드는 미리 구성되어 있습니다. n8n 워크플로우를 저장한 후 '활성화(Activate)'를 클릭하세요. n8n이 이 웹훅에 대한 프로덕션 URL(예: https://your.n8n.instance/webhook/ip-lookup)을 제공합니다. 이것이 바로 새로 생성된 조회용 API 엔드포인트입니다.


3. 자격 증명 불필요: Get IP Geolocation n8n 노드는 공개 서비스인 IP-API를 호출하며, 기본 조회의 경우 일반적으로 API 키가 필요하지 않습니다. 이 특정 n8n 템플릿에는 자격 증명 설정이 필요하지 않습니다.

Receive IP Webhook (n8n 트리거):
기능: 이 n8n 워크플로우의 시작점(n8n 트리거)이자 외부 API 엔드포인트 역할을 합니다.
주요 구성: HTTP 메서드는 POST로 설정, 응답 모드는 '응답 노드(Response Node)'로 설정, 경로는 /ip-lookup으로 설정됩니다. 조회를 원하는 IP를 담은 JSON 본문을 기다립니다.
Get IP Geolocation (HTTP 요청 n8n 노드):
기능: IP-API.com으로 외부 API 호출을 실행합니다.
주요 구성: URL은 동적입니다: http://ip-api.com/json/{{ $json.body.ip }}. 이 표현식은 웹훅 트리거로 전달된 IP 속성을 검색하여 API 요청 URL을 구성합니다.
Respond with Geolocation Data (웹훅에 응답 n8n 노드):
기능: 호출한 클라이언트에게 검색된 데이터를 다시 전송하여 루프를 닫습니다.
* 주요 구성: '모든 수신 항목(All Incoming Items)'으로 응답하도록 설정되어, HTTP 요청 n8n 노드에서 수신한 전체 JSON 구조를 HTTP 응답으로 그대로 전달합니다.