여행 API 인증과 보안: 테넌트 데이터는 어디서 새는가

파트너 여행사의 개발자가 화요일 오후에 연동을 테스트하고 있습니다. 예약 목록 엔드포인트가 쿼리 스트링으로 agencyId를 받는 것을 보고, 호기심에 114를 115로 바꿔 봅니다. 응답에는 다른 회사의 예약이 담겨 있습니다. 승객 이름, PNR, 그리고 그 여행사가 마진을 붙이기 전에 지불한 넷 요금까지요. 아무도 공격하지 않았습니다. API가 클라이언트의 말을 그대로 믿었을 뿐입니다. 이 오후 한 번이 여행 API 인증과 보안의 거의 전부이며, 이 주제가 로그인 화면이 흔히 받는 것보다 더 많은 주의를 받아야 하는 이유입니다.
멀티테넌트 여행 API가 새는 경로는 예측 가능한 몇 가지로 한정됩니다. 하나씩 이름을 붙여 볼 만합니다. 각각에는 출시 후보다 출시 전에 훨씬 싸게 해결되는 설계상의 답이 있기 때문입니다.
테넌트는 파라미터가 아니다
서두의 실수는 검사가 빠졌다는 것이 아닙니다. 호출자에게 누구냐고 묻고 그 대답을 믿는 설계 자체입니다. 단일 고객 시스템이라면 그저 어수선한 정도입니다. 하지만 수십 개의 여행사, 하위 대리점, 화이트라벨 사이트가 하나의 데이터베이스를 공유하는 플랫폼에서는, 키를 쥐게 될 모든 연동 개발자의 정직함에 보안 모델 전체가 기대게 됩니다.
이 버그 계열 전체를 없애는 원칙은 이것입니다. 테넌트는 자격 증명에서 오며, 요청에서 오지 않는다. 키나 토큰이 검증되면 서버는 그것이 어느 테넌트에 속하는지, 그 테넌트 안의 어느 사무소인지, 호출자가 어떤 역할을 가졌는지 확정합니다. 이후 모든 쿼리는 그 범위 안에서 실행됩니다. 요청 본문에 여행사 ID가 정당한 이유로 들어올 수는 있습니다. 예를 들어 콘솔리데이터가 하위 대리점 대신 예약을 생성하는 경우입니다. 그러나 서버는 그 ID를 자격 증명이 이미 정해 둔 범위와 대조할 뿐, 어떤 필드가 요청한다고 해서 범위를 넓히지 않습니다.
실무에서는 세 가지가 서버 쪽에 있습니다.
- 핸들러마다가 아니라 데이터 계층에서 범위 지정. 테넌트 소유 테이블에 대한 모든 쿼리에 자동으로 걸리는 필터가 있으면,
where절을 잊은 개발자는 남의 데이터가 아니라 빈 결과를 받습니다. 핸들러별 검사는 누군가 급하게 엔드포인트를 추가하는 첫 순간 무너집니다. - 경로의 모든 ID에 대한 객체 수준 검사.
GET /bookings/98231은 예약 98231이 호출자의 범위에 속하는지 확인해야 합니다. 순차 ID에서는 이것이 여행 API의 가장 흔한 구멍입니다. 예약 번호와 PNR 참조는 추측하기 쉽기 때문입니다. - "당신 것이 아님"과 "존재하지 않음"에 같은 응답. 다른 테넌트의 예약에는 404를 돌려주세요. 403은 그 레코드가 실제로 있음을 확인해 주는데, 그것만으로도 경쟁사가 갖고 싶어 할 정보입니다.
예외 경로에도 같은 규율이 필요합니다. 대부분의 플랫폼에는 테넌트를 가로질러 읽는 운영자 뷰가 필요합니다. 지원팀, 재무, 플랫폼 소유자 같은 경우입니다. 이를 코드로 부여되고 사용할 때마다 기록되는 별도의 역할로 만드세요. 인증된 호출자라면 누구나 설정할 수 있는 쿼리 플래그가 되어서는 안 됩니다. 클라이언트 연동이 이러한 경계 주변에서 어떻게 동작해야 하는지는 요청 측을 다룬 항공권 예약 API 연동 글을 참고하세요.
공급사 자격 증명은 절대 브라우저에 닿지 않는다
여행 플랫폼은 두 종류의 비밀을 갖고 있습니다. 첫째는 여러분의 것, 즉 파트너에게 발급하는 키입니다. 둘째는 공급사와의 관계에 속한 것으로, GDS 오피스 자격 증명, NDC 어그리게이터 토큰, 베드뱅크 API 키가 있으며 흔히 회사명과 IATA 번호가 적힌 계약에 묶여 있습니다. 이것으로 보낸 모든 요청은 공급사 입장에서 여러분이 보낸 요청입니다.
이 자격 증명의 안전한 장소는 단 하나, 호출자를 대신해 공급사와 통신하는 서버 프로세스입니다. 싱글 페이지 앱의 JavaScript 번들, 모바일 앱 바이너리, "검색 페이지용일 뿐"이라며 브라우저에 내려보내는 설정 파일, 공급사 호출이 실패했을 때 돌려주는 오류 메시지 어디에도 있어서는 안 됩니다. 이 모든 곳이 어딘가에서 유출의 원인이 된 적이 있습니다. 네트워크 탭은 누구나 열 수 있고, 앱 바이너리는 원하는 사람이면 누구나 풀어 볼 수 있습니다.
결과는 청구서보다 나쁩니다. 공급사 키가 유출되면 낯선 사람이 여러분 계정으로 검색하고, 때로는 예약까지 할 수 있습니다. 공급사가 여러분을 평가하는 룩투북 비율이 소진되고, 최악의 경우 여러분의 크레딧으로 발권됩니다. 공급사는 그 트래픽을 여러분의 것과 구별하지 못합니다. 흔한 결과는 여러분이 아님을 증명하는 동안 계정이 정지되는 것이며, 한 항공사나 한 베드뱅크를 주로 파는 여행사에게는 그 기간 내내 가게 문을 닫는 것과 같습니다.
여기서 작은 원칙 두 가지가 따라옵니다. 요청이 어느 공급사 계정을 거칠지는 클라이언트가 고르지 않으며, 서버가 테넌트 설정에서 고릅니다. 그리고 공급사의 오류 본문은 API 밖으로 나가기 전에 변환합니다. 공급사의 원본 오류가 요청 헤더를 그대로 되돌려 주는 경우가 있기 때문입니다.
유출된 넷 요금의 실제 비용
개발자는 데이터 유출의 순위를 데이터가 얼마나 개인적이냐로 매기는 경향이 있습니다. 여행 유통에서 상업적으로 가장 위험한 필드는 흔히 가격입니다. 넷 요금은 공개하지 않는다는 조건으로 공급사가 여러분에게 약속한 금액이고, 판매가와의 차이가 여러분과 하위 대리점의 마진입니다. 아래 표는 대략적인 순위입니다. 여러분의 사업에서는 행의 비중을 다르게 볼 수 있으며, 그 의견 차이는 사고가 난 뒤가 아니라 사고 전에 팀과 나눌 가치가 있습니다.
| 무엇이 새는가 | 보통 누가 발견하는가 | 여러분이 치르는 비용 |
|---|---|---|
| B2C 검색 응답 속 넷 요금 (JSON에 숨어 있고 화면에는 안 보임) | 스크레이핑하는 경쟁사, 호기심 많은 고객 | 가격 동일성에 대한 공급사의 항의, 공시 가격을 낸 이유를 묻는 고객 |
| 다른 하위 대리점의 마진이나 넷 가격 | 서로 비교해 보는 하위 대리점 | 네트워크 전체에서 가격 협상이 다시 열림, 더 좋은 조건을 받은 대리점이 화제가 됨 |
| 클라이언트 번들 속 공급사 자격 증명 | 들여다보는 누구나 | 여러분 계정의 트래픽과 예약, 조사 중 정지 가능성 |
| 열거 가능한 예약 또는 PNR ID | 스크레이퍼, 때로는 기자 | 승객 데이터 노출, 상업적 손실을 훨씬 넘는 규제상의 무게 |
| 다른 여행사의 신용 한도와 잔액 | 파트너, 경쟁사 | 네트워크에서 가장 약한 계정이 빼가기의 표적이 됨 |
팀들이 놓치는 것은 첫 번째 행입니다. 화면은 올바르게 보이기 때문입니다. 페이지에는 판매가가 표시되지만, 그것을 채운 응답에는 프런트엔드가 "필요할지도 모른다"는 이유로 넷 요금과 마진이 별도 필드로 실려 있습니다. 응답은 서버에서 대상별로 만드세요. B2C 호출자는 판매가만 받아야 하고, 누군가 뺄셈을 할 수 있게 하는 어떤 것도 받아서는 안 됩니다. 하위 대리점에 넷 요금을 배포하는 방법 글은 바로 그 차이가 콘솔리데이터가 파는 상품인 이유를 설명합니다.
다운타임 없는 자격 증명 로테이션
모든 자격 증명은 언젠가 교체해야 합니다. 개발자가 파트너 여행사를 떠나고, 키가 공개 저장소에서 발견되고, 공급사가 자기 일정대로 키를 회전합니다. 로테이션이 "바꾸면 파트너가 재배포할 때까지 전부 깨진다"는 뜻이라면 아무도 로테이션하지 않고, 키는 수년간 살아남습니다.
첫날부터 겹침을 고려해 설계하세요. 파트너마다 활성 키를 동시에 두 개 가질 수 있습니다. 새 키를 만들고, 배포하고, 트래픽이 넘어가는 것을 지켜본 뒤에야 옛 키를 폐기합니다. 이것이 동작하려면 플랫폼에 화려하지 않은 부품 몇 가지가 필요합니다.
- 눈에 보이는 키 식별자. 비밀 옆에 저장된 접두사나 ID로, 로그와 지원 티켓이 비밀 자체를 보지 않고도 어떤 키가 호출했는지 말할 수 있게 합니다.
- 해시로 저장된 비밀. 생성 시 한 번만 보여 주고 다시는 보여 주지 않습니다. 지원팀이 파트너의 키를 읽을 수 있다면, 지원 도구를 침해한 사람도 읽을 수 있습니다.
- 키별 마지막 사용 시각. 파트너가 옛 키가 조용해졌는지 확인한 뒤 폐기할 수 있도록 합니다.
- 인증 앞단의 모든 캐시를 포함해 즉시 효력이 생기는 폐기.
공급사 자격 증명도 반대 방향으로 같은 겹침이 필요합니다. 빌드에 박아 넣지 말고, 실행 중인 서비스가 다시 읽는 시크릿 저장소나 암호화된 설정에 보관하세요. 그러면 전환은 배포가 아니라 설정 변경이 됩니다. 장기 키 위에 단기 액세스 토큰을 얹는 것도 도움이 됩니다. 토큰이 새더라도 대부분 사람이 사라진 것을 알아채기 전에 만료됩니다.
로테이션은 로깅이 값을 하는 지점이기도 합니다. 비밀이나 승객 결제 데이터는 기록하지 않으면서 어떤 키와 어떤 테넌트가 각 호출을 했는지 기록하면, "우리 쪽이었나?"라는 질문에 일주일이 아니라 한 시간 안에 답할 수 있습니다.
파트너에게 키를 건네기 전에
짧은 목록입니다. 긴 버전은 이 글의 나머지이기 때문입니다.
- 요청 안의 무언가가 키의 테넌트를 바꿀 수 있습니까? 그래서는 안 됩니다.
- ID를 받는 모든 엔드포인트가 소유권을 확인하고, 실패하면 404로 답합니까?
- 공급사 자격 증명이나 그로부터 파생된 필드가 브라우저에서 접근 가능합니까?
- B2C 응답 어딘가에 숨은 필드를 포함해 넷 가격이나 마진이 들어 있습니까?
- 파트너가 여러분에게 전화하지 않고 로테이션할 수 있고, 여러분이 파트너에게 전화하지 않고 폐기할 수 있습니까?
우리 API 접근은 이렇게 처리합니다
이 블로그를 운영하는 플랫폼은 항공과 호텔 API를 제공합니다. 플랫폼의 모든 테넌트는 이미 자체 관리자 패널, 자체 예약, 역할 기반 직원 권한으로 운영되며, 공급사 콘텐츠는 일대일 계약이 아니라 공급사 그룹을 통해 테넌트에 도달합니다. API 접근은 셀프 서비스 키가 아니라 대화로 시작합니다. 위에서 말한 이유도 일부 있습니다. 자격 증명이 생기기 전에 누가 어느 시장을 위해 연동하는지 알고 싶기 때문입니다. 여행 API 페이지에서 제공되는 내용과 그 대화를 시작하는 방법을 확인할 수 있습니다.