개요

serial 지시어는 Web Serial API(navigator.serial)로 시리얼 포트를 통해 마이크로컨트롤러·산업 장비 등과 저수준 통신할 수 있는지를 제어합니다. 기본 허용 목록은 self이며, 매우 강력한 저수준 기기 접근 권한입니다.

자세히

`serial=(self)`는 자기 오리진, `serial=()`는 전면 차단, `serial=(self "https://iot.example.com")`는 지정 오리진에 위임합니다. iframe에는 `allow="serial"`가 필요합니다. 정책이 거부하면 navigator.serial.requestPort()가 반환하는 Promise는 NotAllowedError로 reject됩니다.

Web Serial은 navigator.serial.requestPort()로 사용자가 포트를 선택하는 프롬프트가 필수이며, 정책 허용은 그 전제일 뿐입니다. 임의 바이트를 주고받는 저수준 채널이라 임의 오리진에 열어주면 위험이 큽니다. 주로 크로미엄 계열에서만 지원되며 구형 Feature-Policy의 serial을 대체합니다.

문법

Permissions-Policy: serial=(self)

실무 참고

• Web Serial은 저수준 기기 통신이라 신뢰하는 최상위 오리진에만 허용하고 서드파티 프레임에는 serial=()로 차단하세요.
• 지원이 제한적(주로 Chromium)이므로 navigator.serial 존재 여부를 감지하세요.

관련 지시어