주요 변경 사항
이번 주에는 request 반환 결과에 영향을 주는 두 가지 변경 사항이 적용되었습니다. UTF-8을 사용하지 않는 사이트의 response body가 깨져서 반환되던 문제가 해결되었으며, validate 설정으로 허용된 200 외의 response가 마침내 실패 대신 성공으로 집계됩니다. 또한 고객 API의 보안 취약점 몇 가지를 패치했습니다.
새로운 기능
Single에서 비 UTF-8 페이지의 텍스트가 정상 반환됨
불가리아어 포럼, 중국 이커머스, 일본 뉴스 또는 windows-1251, GBK, Big5, Shift_JIS를 사용하는 사이트에 Single을 호출할 때 이전에는 response body가 깨진 바이트로 반환되었습니다. 기본 HTTP 계층에 UTF-8 디코더가 하드코딩되어 있어 키릴 문자 페이지가 промоции 형태로 수신되었고, 클라이언트 측에서 원본을 복구할 방법이 없었습니다.
이 문제는 request 계층에서 수정되었습니다. 이제 Single은 Content-Type header, <meta charset>, <meta http-equiv> 순으로 소스 charset을 감지하여 body가 JSON envelope에 도달하기 전에 UTF-8로 트랜스코딩합니다. UTF-8이나 ASCII 페이지는 그대로 전달됩니다. 이미지나 PDF 같은 바이너리 콘텐츠는 디코딩되지 않습니다. 원본 바이트가 필요한 경우 returnBuffer: true를 통해 기존처럼 원본 버퍼를 그대로 받을 수 있습니다.
기본 적용됩니다. 별도의 플래그 설정은 필요하지 않습니다. 기존에 잘 작동하던 페이지는 그대로 작동하며, 깨진 텍스트를 반환하던 페이지는 이제 읽을 수 있는 텍스트로 반환됩니다. 브라우저 사용자는 Chromium이 charset을 자체적으로 디코딩하므로 이 점을 고려할 필요가 없습니다.
성공 여부 분류에 validate 규칙 적용
request에 validate를 설정하면(예: validate.status.accept = [200, 403]), request 엔진은 규칙을 준수하여 오류 없이 response를 처리했습니다. 그러나 업스트림의 결과 분류 시스템이 이 규칙을 무시하고 200이 아닌 모든 결과를 application_fail로 분류했습니다. 이에 따라 두 가지 결과가 발생했습니다. 허용된 403이 Dashboard에서 실패로 표시되었고, 성공 건에 대해서만 과금되므로 정상 전달된 해당 response는 과금되지 않았습니다.
이제 분류 시스템이 validate의 선언을 준수합니다. validate가 지정된 request는 상태 코드와 관계없이 엔진이 오류 없이 처리한 경우 모두 성공으로 처리됩니다. validate가 없는 request는 이전과 동일하게 200일 때만 성공으로 처리되므로 기존 동작 방식은 그대로 유지됩니다.
이 수정 사항은 향후 요청부터 적용됩니다. 기존 내역 데이터는 저장된 결과를 유지하며, 새로운 request만 정상적으로 분류됩니다. 따라서 유효하다고 판단한 response에 대해 App Fail가 표시되었던 현상은 이러한 이유 때문이었습니다.
고객 API 보안 강화
고객 API 전반에 걸쳐 보안 점검 0단계를 배포했습니다.
- CORS가 이제
https://foura.ai로 제한됩니다. 이전 설정은 credentials를 전송하면서 모든 origin을 반영하는 구조였으며, 이는 전형적인 CSRF 취약점 형태였습니다. 동일 출처 브라우저 호출과 서버 측 API 호출에는 영향을 주지 않습니다. - Activity 타임라인 뒤의 메트릭 라우트에서 쿼리로 직접 전달되던 임의의
outcome필터 입력을 허용 목록에 등록된 알려진 outcome 값으로만 제한했습니다. 일반 계정에서는 악용할 수 없으나 선제적으로 차단했습니다.
두 작업 모두 기존 API 계약을 변경하지 않습니다. 일반적인 사용 중에는 차이를 체감하기 어렵습니다. 하지만 문제가 발견되기 전에 선제적으로 수정했다는 점은 충분히 언급할 가치가 있습니다.
대시보드 요약과 일치하도록 Activity 라벨 통일
간단한 변경 사항입니다. Dashboard의 Activity 테이블에는 Application_fail 같은 원시 결과 문자열이 표시되었지만, Overview의 칩, 도넛 차트, 타임라인에는 직관적인 라벨(App Fail)과 함께 결과별 색상 코드가 적용되었습니다. 동일한 데이터를 두 가지 방식으로 보여주던 구조였습니다. 이제 둘 다 동일한 라벨 및 색상 맵을 참조하도록 동기화되어, 어느 위치에서 확인하든 행의 상태가 동일하게 표시됩니다.
수치 지표
이번 주에는 새로운 지연 시간이나 성공률 수치가 없습니다. 이번 작업의 대부분은 "속도 개선"보다 "정상 동작 보장"이 올바른 지표인 정확성 및 보안 관련 작업이었습니다. 다음 주 다이제스트에는 현재 진행 중인 몇 가지 작업의 처리량 데이터가 포함될 예정입니다.