Styxis
Company
Knowledge

Pydantic MISSING union 직렬화: 부모 타입 밖 필드의 노출 검사

공개할 필드 집합은 런타임 객체가 가진 정보와 별개로 검증해야 이용자가 제공한 정보의 노출 범위를 지킬 수 있다.

Pydantic MISSING union 직렬화: 부모 타입 밖 필드의 노출 검사

응답 타입을 부모로 선언했다는 사실만으로 자식의 모든 속성이 공개 범위에서 제외되는지 단정할 수는 없다. 결측을 표현하는 타입 조합이 직렬화 경로를 바꾼다면 출력 경로를 직접 확인해야 한다. 정상 부모 필드가 있다는 검사와 추가 필드가 없다는 검사는 목적이 다르다. [1, 2, 3]

공개 원문이 보여 준 범위

기반 클래스와 컨테이너 양쪽에 MISSING union이 있을 때 선언된 부모 타입 대신 자식 필드까지 직렬화된다는 보고다. 원문은 MISSING을 한쪽에서 제거하거나 None으로 바꾼 대조를 제시한다. [1]

입력과 출력에서 확인할 관계

응답에 허용할 경로를 먼저 선언한다. 자식에만 있는 경로가 나타나면 전달을 멈추고 직렬화 방식과 결측 정책을 함께 검토한다. response_path, declared_public, emitted를 비교해야 정상 부모 필드가 있다는 이유로 추가 노출을 승인하지 않는다. 허용 범위는 객체가 가진 모든 속성이 아니라 공개 계약에서 가져온다. [1, 3]

승인 기준과 실패 사례

설명용 응답에서 허용한 경로는 parent_field뿐이다. 그 집합 밖으로 내보낸 경로 수가 0이면 공개 범위 조건을 충족한다. child_field까지 출력해 집합 밖 경로 수가 1이 되면 실패다. 실제 속성이 존재한다는 사실은 공개 권한을 뜻하지 않으며, 검증기는 부모·자식 타입을 다시 구성하는 대신 준비된 경로 목록의 위반을 찾는다. [1, 3]

Truthound를 연결하는 검사 경계

Truthound Core 3.3.2의 NotInSetValidator로 준비한 출력 경로 목록에 공개 금지 경로가 포함됐는지 검사할 수 있다. 허용 밖 경로 전체를 찾으려면 명시 allowlist와 출력 집합을 먼저 대사한다. 이 도구가 응답 모델을 다시 직렬화하거나 공개 정책을 결정하지는 않는다. [1, 2, 3]

다른 선택이 필요한 조건

필드 차단이 전체 개인정보 보호를 인증하지 않으며 None 대체는 생략과 null의 API 의미를 바꿀 수 있다. 응답 전용 모델로 명시적으로 투영하고 원래 객체와 직렬화 객체를 분리한다. 해당 엔드포인트가 자식 필드까지 공개하도록 계약된 경우 그 경로는 허용 밖이 아니다. [1, 3]

적용 조건

response_path, declared_public, emitted 표를 원시 입력과 승인 기준에서 각각 준비하고 행 식별자를 유지한다.

대안

응답 전용 모델로 명시적으로 투영하고 원래 객체와 직렬화 객체를 분리한다.

한계

  • 필드 차단이 전체 개인정보 보호를 인증하지 않으며 None 대체는 생략과 null의 API 의미를 바꿀 수 있다.

근거

사건 확인일
대상 확인일
수정일