Connect를 통한 일괄 표준 검사

한눈에 보기

이 레시피는 여러 PDF를 한 번의 호출로 하나 이상의 명명된 정책에 대해 검사합니다. Connect 전송 계층을 통해 일괄 규정 준수 도구를 사용합니다. 이 도구는 Enterprise 등급입니다. class_exists() 프로브가 이를 발견하며, nextpdf/premium가 서버와 함께 설치된 경우에만 등록됩니다. 각 문서는 요청에 포함된 모든 정책에 대해 검사되며, 응답은 문서별 및 정책별로 통합된 보고서입니다.

단일 문서 검사와 마찬가지로, 정책별 “통과”는 도구가 구현한 규칙에 대한 도구 자체의 검사 결과이며 — 독립적인 적합성 인증이 아닙니다. 적합성 판정은 검증기가 내립니다.

설치

composer require nextpdf/server

tools/list 호출로 Enterprise 일괄 도구가 있는지 확인하십시오. /connect/tool-catalog/.을 참조하십시오.

개념 개요

표준은 각 문서에 대한 요구사항을 명시하고, 검사기는 각 문서를 그 요구사항에 비추어 평가합니다(PDF/A-4 §6.2.3). 적합성은 요구사항에 따라 판정되며, 생성자가 주장하는 것이 아닙니다(PDF/A-4 §6.7.3). 서명 관련 정책에서는 PAdES 기준선 수준이 서로 구별되며, B-LT/B-LTA 수준(검증 자료, 보관 타임스탬프)은 Enterprise 전용 기능입니다(ETSI EN 319 142-2 §5.5). 일괄 결과는 문서 집합 전체에 대해 동일하게 좁은 의미의 “구현된 규칙이 실패하지 않음” 의미론을 집계합니다.

API 표면

tools/list로 실행 중인 레지스트리의 도구 이름을 확인하십시오. 공식 카탈로그는 /connect/tool-catalog/.입니다. 이 레시피에서는 도구 개수를 다시 설명하지 않습니다.

코드 예제 — 빠른 시작

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "batch_compliance_check",
    "arguments": {
      "sources": ["/data/q1.pdf", "/data/q2.pdf"],
      "policies": ["pdfa-4"]
    }
  }
}

코드 예제 — 프로덕션

curl -sS -X POST https://connect.example.com/v1/tools/batch_compliance_check \
  -H 'Authorization: Bearer '"$NEXTPDF_CONNECT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"sources":["/data/q1.pdf","/data/q2.pdf"],"policies":["pdfa-4"]}' \
  -o /tmp/batch.json -w '%{http_code}' > /tmp/batch-status || {
    echo "transport failure invoking batch_compliance_check" >&2; exit 1; }

응답에는 일괄 ID, 집계된 pass/fail 개수, 정책별 결과와 실패 사유를 담은 문서별 checks 배열이 포함됩니다. 실패 항목을 필터링하고 수정한 뒤, 영향을 받은 문서만 다시 제출하십시오.

엣지 케이스 및 주의 사항

**빈 sources 또는 policies**는 잘못된 매개변수 오류입니다.
누락된 파일은 일괄 전체를 실패시키지 않고 결과별 오류로 표시됩니다. 각 결과에 오류 필드가 있는지 확인하십시오.
일괄 크기 한도 초과는 명시적인 오류입니다. 더 작은 일괄로 나누십시오.
알 수 없는 정책 ID는 인식된 식별자를 명시하는 알 수 없는 표준 오류입니다. B-LT/B-LTA를 참조하는 서명 정책은 해당 자료를 생성할 수 있는 Enterprise 배포에서만 의미가 있습니다.
도구 없음. nextpdf/premium가 없으면 Enterprise 일괄 도구가 등록되지 않으며, 호출은 알 수 없는 도구 오류로 실패합니다.

성능

프런트매터 예산은 문서상의 상한입니다. 이 도구는 문서를 서버 측에서 처리하며, 문서별 작업 메모리는 무시할 수 없는 수준입니다. 전역 타임아웃을 늘리기보다 일괄 크기를 호스트의 메모리에 맞추십시오.

보안 참고 사항

외부로 전송되는 로그 수준에서는 소스 경로나 전체 보고서를 기록하지 마십시오. 일괄 ID와 집계된 pass/fail 개수만 기록하십시오. 정책별 “통과”는 구현된 규칙 집합을 설명하는 것이며, 보안이나 법적 보증이 아닙니다.

적합성

주장	조항	reference_id
표준이 요구사항을 명시하며, 검사기가 각 문서를 평가합니다	PDF/A-4 §6.2.3
적합성은 요구사항에 따라 판정되며, 생성자가 주장하는 것이 아닙니다	PDF/A-4 §6.7.3
B-LT/B-LTA는 검증 자료를 추가하는, 서로 구별되는 Enterprise 전용 수준입니다	ETSI EN 319 142-2 §5.5

일괄 표준 검사를 지원한다는 것은 적합성 인증이 아닙니다. 적합성 판정은 독립적인 검증기가 문서별로 내립니다.

상용 컨텍스트

일괄 규정 준수 도구는 Enterprise 등급이며, nextpdf/premium가 서버와 함께 설치된 경우에만 등록됩니다.

Connect 세부 사항

전송 계층 가용성 (MCP / REST / gRPC)

이 도구는 공유 도구 실행기를 통해 MCP tools/call, REST 도구 엔드포인트, gRPC 서비스에서 동일하게 호출할 수 있습니다.

HITL 위험 등급

일괄 검사는 읽기 전용이며 기본적으로 approval_required가 아닙니다. 운영자 재정의는 위험 수준을 높이는 것만 가능합니다. 자세한 내용은 /connect/hitl-risk-tiers/를 참조하십시오.

확인 게이트 JSON 엔벨로프

운영자 재정의가 이를 approval_required로 높이지 않는 한, 도구는 게이트를 트리거하지 않습니다. 엔벨로프 및 일회용 토큰 계약은 /connect/hitl-risk-tiers/.에 있습니다.

함께 보기

/cookbook/connect/compliance-check/ — 단일 문서 표준 검사.
/cookbook/connect/ai-ready-certification/ — 더 광범위한 AI 준비성 검사.
/connect/tool-catalog/ — 등급별 도구 집합 계산.
/connect/hitl-risk-tiers/ — 위험 모델과 게이트.