드론 탐지 시스템 연동: API와 데이터 체크리스트

드론 탐지 시스템을 보안 플랫폼에 연동하기 전 API, 이벤트, 시각, 좌표, 접근 보안, 연결 장애와 인수 시험 항목을 확인하세요.

드론 탐지 시스템을 보안 플랫폼에 연동하기 전 API, 이벤트, 시각, 좌표, 접근 보안, 연결 장애와 인수 시험 항목을 확인하세요. 드론 탐지 시스템을 보안 플랫폼에 연결하려면 네트워크 접속이나 지도 표시 이상의 준비가 필요합니다. 운용자는 이벤트의 출처, 변화 과정과 후속 절차를 이해해야 합니다. 따라서 요구서에는 데이터와 처리 책임을 명확히 적어야 합니다. 이 체크리스트는 [대드론 시스템 안내](/ko/counter-uas-system) 및 [다중 센서 융합 가이드](/ko/articles/counter-uas-multi-sensor-fusion-explained)를 보완하며, 특정 제품 사이의 호환성을 전제로 하지 않습니다. 1. 운용자의 업무 흐름 정의하기 누가 경보를 받고, 상황을 확인하고, 접수를 표시하고, 상급자에게 전달하고, 종료할지 정하세요. 탐지 정보와 대응 행위의 권한은 구분해야 합니다. 탐지만으로 의도를 판단할 수 없다는 점은 [FAA 안내](https://www.faa.gov/airports/new_entrants/uas_detection_mitigation_response)에서도 확인할 수 있습니다. 플랫폼이 받을 정보가 경보, 연속 관측, 트랙, 영상 중 무엇인지 명시하세요. 단계별 책임자와 센서 자체 화면에서 수행할 작업도 정하세요. 통합 화면이 있다고 전체 업무 절차까지 완성되는 것은 아닙니다. 2. 버전이 명시된 인터페이스 문서 받기 API·펌웨어 버전, 인증 방식, 요청·응답 예시, 오류와 시험 환경을 요청하세요. [OpenAPI](https://spec.openapis.org/oas/v3.1.1.html)는 HTTP API를 기술하는 표준 형식을 제공하지만, 사용 자체가 제품 호환성을 보장하지는 않습니다. 이벤트 스트림이나 SDK도 동등한 문서가 필요합니다. 전송 방식, 구독, 시간 제한, 전달 보장, 사용량 제한과 라이선스를 확인하세요. ‘API 제공’이라는 설명만으로 연동 개발량을 산정하기는 어렵습니다. 3. 최소 이벤트 스키마 합의하기 다음 표는 계약에서 합의할 항목의 예시이며 범용 API 규격이 아닙니다. 필수, 선택, 알 수 없음, 해당 없음 상태를 구분하세요. 데이터 그룹 합의할 내용 식별자 센서·이벤트·트랙 ID와 유지 규칙 시각 관측·수신·갱신 시각 위치 지점 종류, 좌표, 단위와 제공 가능한 불확실성 분류 대상 유형, 분류 방법과 신뢰도 값의 의미 생명 주기 생성·갱신·소실·종료 증빙 영상·관측·로그의 참조 정보 장비 상태 연결 상태, 가용성, 센서 오류 좌표가 없을 때 0으로 바꾸지 마세요. 원본 관측과 융합 트랙 사이의 참조를 보존해야 나중에 이벤트를 재구성할 수 있습니다. 서로 다른 정보를 단순한 ‘드론 탐지’ 상태 하나로 축약하지 않도록 하세요. 4. 시각과 좌표 기준 맞추기 명확한 시간 형식을 정하세요. [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339.html)는 시간대 오프셋을 포함한 표현을 정의하지만 시계 동기화를 수행하지는 않습니다. 동기화 방식, 허용 오차와 오래된 데이터 처리 기준은 따로 합의하세요. 지연 시간의 시작점과 종료점도 정해야 합니다. 메시지 도착과 운용자의 접수는 서로 다른 측정입니다. 좌표계, 단위와 고도 기준을 문서화하세요. 기체, 조종 장치, 이륙 지점, 수신기 위치를 구분해야 합니다. 방위만 있는 데이터를 근거 없이 지점 좌표로 바꾸면 안 됩니다. 5. 영상·메타데이터·제어 기능 분리하기 영상이 보인다고 이벤트 수신이나 카메라 제어까지 호환되는 것은 아닙니다. 기능별 지원 여부, 버전과 ID 매핑을 확인하세요. [ONVIF Profile M](https://www.onvif.org/profiles/profile-m/)은 분석 메타데이터와 이벤트를 다루며 모든 드론 관련 필드를 인증하지는 않습니다. 실제 플랫폼 버전에서 필요한 필드를 시험하세요. 특정 탐지 장비나 VMS가 미확인 인터페이스 기능을 지원한다고 가정하지 마세요. 6. 접근 보안과 연결 장애 대비하기 IT 담당자와 인증, 암호화, 권한, 자격 증명 교체, 감사 기록, 보존 기간을 검토하세요. 외부 서비스 의존성과 인터넷이 없을 때의 동작도 정의하세요. 연결 끊김은 관측이 없는 상태와 구분되어야 합니다. 임시 저장, 재전송, 중복 제거와 순서가 바뀐 메시지 처리 방식을 정하세요. 저장 한계와 데이터 유실 알림도 문서에 포함하세요. 7. 인수 전 전체 연결 경로 시험하기 센서, 어댑터, 플랫폼 버전을 기록하세요. 기대 결과와 통과 기준을 미리 정하고 최소한 다음을 시험하세요. 플랫폼에서 이벤트 생성·갱신·종료가 이어지는지 확인. 미확인 대상과 좌표 누락을 임의 값 없이 표시하는지 확인. 연결 중단·복구 시 중복과 지연 메시지를 처리하는지 확인. 권한 없는 계…