스프링 - NICE 본인인증 API connection timed out 해결

스프링 - NICE 본인인증 API connection timed out 해결

 

작성 일자 : 2025년 03월 23일

---

 

floating wavy membrane illustrated by Dalle3

 

 

발생 오류

 

NICE 본인인증 API를 호출하는 중, AWS ECS Production 환경에서 connection timed out 오류가 발생했습니다.

2025-03-18T14:52:36.194Z ERROR 1 --- [xxxx] [nio-8080-exec-3] c.g.l.d.u.s.AdultVerificationService     : Failed to initialize adult verification
org.springframework.web.client.ResourceAccessException: I/O error on POST request for "https://svc.niceapi.co.kr:22001/digital/niceid/api/v1.0/common/crypto/token": Connection timed out
    at org.springframework.web.client.RestTemplate.createResourceAccessException(RestTemplate.java:915) ~[spring-web-6.1.13.jar!/:6.1.13]
    at org.springframework.web.client.RestTemplate.doExecute(RestTemplate.java:895) ~[spring-web-6.1.13.jar!/:6.1.13]
    at org.springframework.web.client.RestTemplate.execute(RestTemplate.java:790) ~[spring-web-6.1.13.jar!/:6.1.13]
    at org.springframework.web.client.RestTemplate.postForEntity(RestTemplate.java:538) ~[spring-web-6.1.13.jar!/:6.1.13]

 

---

 

 

Cloud Architecture

 

필자는 AWS ECS(EC2 based)를 사용하여 Spring Boot 애플리케이션을 배포하고 있습니다.

 

---

 

간략한 구조

CloudFlare DNS -> AWS ALB -> ECS Service -> Spring Boot Application

 

---

 

네트워크 Outbound Traffic

Spring Boot Application -> NAT Instance -> NICE API

 

---

 

 

해결 방법

 

NICE API는 일반적인 443 포트가 아닌 22001 포트를 사용하고 있습니다.

 

이로 인해 NAT 인스턴스에서 22001 포트로 나가는 트래픽을 허용해주어야 합니다.

 

---

 

1. NAT 인스턴스 보안 그룹 수정(Outbound Traffic)

 

NAT 인스턴스의 보안 그룹을 수정하여 22001 포트로 나가는 트래픽을 허용해줍니다.

• IP version: IPv4
• Type: Custom TCP
• Protocol: TCP
• Port Range: 22001
• Destination: 0.0.0.0/0

 

---

 

2. NAT 인스턴스 보안 그룹 수정(Inbound Traffic)

 

ECS Task subnet에서 NAT 인스턴스로 들어오는 Ephermal Port 트래픽을 허용해줍니다.

• IP version: IPv4
• Type: Custom TCP
• Protocol: TCP
• Port Range: 1024-65535
• Source: ECS Task Subnet CIDR(각 서브넷 마다 rule 설정)