# FourA 다이제스트: 2026년 6월 12일 - 6월 19일

> URL: https://foura.ai/ko/blog/foura-digest-2026-06-19
> Updated: 2026-06-20
> Index: https://foura.ai/llms.txt

## 주요 변경 사항

이번 주에는 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`)과 함께 결과별 색상 코드가 적용되었습니다. 동일한 데이터를 두 가지 방식으로 보여주던 구조였습니다. 이제 둘 다 동일한 라벨 및 색상 맵을 참조하도록 동기화되어, 어느 위치에서 확인하든 행의 상태가 동일하게 표시됩니다.

## 수치 지표

이번 주에는 새로운 지연 시간이나 성공률 수치가 없습니다. 이번 작업의 대부분은 "속도 개선"보다 "정상 동작 보장"이 올바른 지표인 정확성 및 보안 관련 작업이었습니다. 다음 주 다이제스트에는 현재 진행 중인 몇 가지 작업의 처리량 데이터가 포함될 예정입니다.
