인증
사용자명·비밀번호 방식과 서버 IP 화이트리스트 방식이 있습니다. 둘 다 프록시 유저 단위로 설정하며, 프록시 유저는 계정당 100개까지 만들 수 있습니다.
게이트웨이는 연결마다 어느 계정에 과금할지, 어떤 종류의 IP를 내줄지 두 가지를 확인합니다. 둘 다 프록시 유저에 정해져 있습니다. 프록시 유저에는 이름, 비밀번호, 기본 네트워크가 있고, 필요하면 트래픽 한도와 비밀번호 없이 접속할 수 있는 IP 주소 목록을 추가로 설정할 수 있습니다.
사용자명과 비밀번호
기본 방식입니다. 일반적인 프록시 인증으로, 사용자명 자리에는 계정 식별자와 프록시 유저 이름을 이은 HANDLE-NAME(필요하면 타게팅 파라미터를 뒤에 붙인 형태)을, 비밀번호 자리에는 프록시 유저의 비밀번호를 넣어 보냅니다. HTTP와 HTTPS에서는 Proxy-Authorization: Basic 헤더를, SOCKS5에서는 RFC 1929의 사용자명/비밀번호 방식을 씁니다. 프록시 URL에 자격 증명을 넣어 두면 어떤 클라이언트 라이브러리든 이 과정을 알아서 처리합니다.
# 클라이언트가 user:pass를 base64로 인코딩해 Proxy-Authorization 헤더로 보냅니다
curl -x icn-01.gw.scalardata.ai:7777 \
-U "k7f3q2-acme-country-kr:PASSWORD" \
https://ipinfo.io/json비밀번호는 공백과 콜론을 뺀 출력 가능한 ASCII 문자 16~128자입니다. 대시보드는 비밀번호를 자동으로 생성하고 언제든 다시 생성할 수 있으며, API로는 직접 정한 비밀번호를 쓸 수 있습니다. 대시보드 로그인(이메일 링크나 Google 계정)으로는 게이트웨이에 접속할 수 없습니다. 게이트웨이는 프록시 유저 비밀번호와 화이트리스트에 등록된 IP만 받습니다.
IP 화이트리스트
고정 공인 IP를 쓰는 서버라면, 비밀번호를 서버마다 넣어 두는 대신 그 주소를 프록시 유저에 등록하세요. 화이트리스트에 있는 IP에서 온 연결은 그 주소가 등록된 프록시 유저에 한해 비밀번호 검사를 건너뜁니다. 자격 증명을 아예 보내지 않으면 게이트웨이는 그 프록시 유저의 기본 설정대로 요청을 라우팅하고, 타게팅이 필요하면 그 프록시 유저의 사용자명만 비밀번호 없이 보내면 됩니다. 다른 프록시 유저의 사용자명으로 보내면 평소처럼 그 유저의 비밀번호가 필요합니다.
# 화이트리스트에 등록된 서버에서: 비밀번호 없이, 사용자명은 타게팅 용도로만
curl -x icn-01.gw.scalardata.ai:7777 \
-U "k7f3q2-acme-country-kr:" \
https://ipinfo.io/json
# 화이트리스트 서버에서 자격 증명을 아예 보내지 않는 경우:
# IP가 등록된 프록시 유저로 인식되고, 그 유저의 기본 설정으로 라우팅됩니다
curl -x icn-01.gw.scalardata.ai:7777 https://ipinfo.io/json화이트리스트에는 IPv4·IPv6 단일 주소와 CIDR 범위를 넣을 수 있습니다. 범위는 IPv4 /24, IPv6 /64까지이고 계정당 최대 50개 항목을 등록할 수 있으며, 사설·예약 대역은 등록할 수 없습니다. 항목 하나는 프록시 유저 하나에 속합니다. 내 계정의 프록시 유저끼리는 범위가 겹쳐도 되며, 이때 연결은 가장 좁은 범위의 항목으로 인식됩니다(/24 안의 /32가 우선). 다른 계정이 등록한 주소는 추가할 수 없습니다. 목록은 대시보드의 IP 화이트리스트 화면이나 화이트리스트 엔드포인트에서 관리하며, 주소를 추가할 때 연결할 프록시 유저를 고릅니다.
공인 IP가 계속 바뀌는 가정용 인터넷이나 서버리스 함수 환경에서는 화이트리스트를 쓸 수 없습니다. 또 NAT 환경에서는 같은 공인 IP를 쓰는 모든 장비가 같은 프록시 유저로 인식됩니다.
프록시 유저 여러 개 쓰기
계정 하나에 프록시 유저를 100개까지 둘 수 있습니다. 각각 비밀번호, 기본 네트워크, 화이트리스트, 한도를 따로 설정하고 사용량도 프록시 유저별로 집계되므로, 비용을 나눠 보는 단위로도 쓸 수 있습니다. 흔한 구성은 다음과 같습니다.
acme-prod 주거용, 비밀번호 A, 월 예산만큼 한도 설정
acme-staging 주거용, 비밀번호 B, 소량 한도
acme-crawler 데이터센터, 비밀번호 C, 화이트리스트만 사용모든 프록시 유저는 계정의 잔액과 구독을 함께 씁니다. 그래서 acme-crawler 같은 데이터센터 프록시 유저는 계정에 데이터센터 구독이 있을 때만 트래픽을 보낼 수 있습니다. 프록시 유저에 건 한도는 네트워크와 관계없이 그 프록시 유저가 UTC 기준 한 달 동안 주고받을 수 있는 바이트를 제한할 뿐, 별도의 트래픽을 구매하는 것은 아닙니다. 프록시 유저는 대시보드나 API로 만듭니다.
비밀번호 교체
프록시 유저의 비밀번호는 대시보드나 API에서 바꿀 수 있습니다. 새 비밀번호는 이후 연결에 바로 적용되고, 이미 열린 연결은 그대로 유지됩니다. 열린 연결까지 끊으려면 프록시 유저를 비활성화하세요. 몇 초 안에 닫힙니다. 스티키 세션은 비밀번호가 아니라 프록시 유저와 세션 ID 기준으로 묶이기 때문에, 진행 중인 세션은 비밀번호를 바꿔도 IP가 유지됩니다.
비밀번호가 유출된 것 같다면 먼저 프록시 유저를 비활성화하세요. 열린 연결도 함께 닫힙니다. 그다음 비밀번호를 교체하고 다시 활성화한 뒤, 프록시 유저의 일별 사용량에서 예상 밖의 트래픽이 있었는지 확인하세요. 다음 두 가지만 지켜도 이런 상황을 크게 줄일 수 있습니다.
- 환경마다, 외부 협업사마다 프록시 유저를 따로 두세요. 그러면 유출된 것만 교체하면 됩니다.
- 프록시 URL이 로그에 남지 않게 하세요. HTTP 라이브러리 상당수가 오류가 나면 자격 증명이 포함된 전체 URL을 출력합니다. 장시간 실행되는 서버에는 환경 변수나 화이트리스트를 쓰는 편이 안전합니다.