본문으로 건너뛰기

타일: 외부 임베드 (`externalEmbed`)

필드값
타일 식별자externalEmbed
대시보드 레이블External embed / Einbettung
카테고리basic
크기embedded

외부 임베드 타일은 게시된 웹 앱에 예약 도구 또는 기타 서드파티 페이지를 직접 표시합니다. 설치된 iOS 및 Android 앱에서는 동일한 제한된 iframe을 Capacitor WebView 안에서 렌더링합니다.

허용되는 입력​

대시보드에서는 다음 중 하나를 입력할 수 있습니다.

  • 공개 HTTPS URL
  • 하나의 인용된 src 속성이 포함된 iframe 하나의 마크업

정규화된 iframe URL만 저장됩니다. Scoutello는 제공업체가 전달한 너비, 높이, 스타일, 권한, sandbox 설정, 이벤트 핸들러, 스크립트 및 주변의 모든 마크업을 무시합니다. HTTP 주소, 인증 정보, 사용자 지정 포트, IP 주소, 로컬/내부 호스트, Scoutello가 제어하는 호스트 및 형식이 잘못된 iframe 코드는 거부됩니다. Scoutello는 제출된 URL을 가져오거나, 확인하거나, 스크린샷을 생성하거나, 그 밖의 방식으로 탐색하지 않습니다.

대시보드에는 로컬 구성 미리보기가 표시되며, 의도적으로 제공업체에 연결하지 않습니다. 실제 결과는 게시된 웹 앱에서 테스트하세요.

로딩, 개인정보 보호 및 권한​

iframe은 자동으로 로드되며 표시 영역에 가까워지면 지연 로드됩니다. 따라서 방문자가 타일과 상호작용하기 전에 서드파티 제공업체에 연결될 수 있습니다. 방문자가 클릭해야 로드되도록 하거나 동의 관리 기능을 제공하는 기본 흐름은 없습니다.

저장하기 전에 조직은 제공업체를 신뢰할 수 있으며 필요한 개인정보 보호 고지 또는 동의 처리가 완료되었음을 확인해야 합니다. 이 확인은 콘텐츠 작성 시의 결정을 기록하는 것이며, 방문자의 동의를 의미하지 않습니다.

모바일 및 데스크톱 높이는 240~1,600픽셀로 설정할 수 있습니다. 기본값은 모바일 640픽셀, 데스크톱 720픽셀입니다. 결제 및 전체 화면 브라우저 기능은 선택 사항이며 기본적으로 비활성화되어 있습니다. 카메라, 마이크, 위치 정보, 클립보드, 다운로드 및 최상위 탐색 권한은 절대 부여되지 않습니다.

런타임에서는 코드로 관리되는 sandbox 및 referrer-policy 설정을 사용합니다. 고객이 제공한 sandbox 또는 권한 토큰은 렌더링된 iframe에 전달되지 않습니다. 브라우저 sandbox의 동작 방식은 WHATWG iframe 사양을 참조하세요.

프레이밍 제한​

제공업체는 Content Security Policy frame-ancestors 지시문 또는 X-Frame-Options 헤더를 사용하여 임베드를 금지할 수 있습니다. 브라우저는 교차 출처 프레이밍 실패에 대한 신뢰할 수 있는 세부 정보를 제공하지 않으므로, Scoutello는 대시보드에서 호환성을 확인하거나 제공업체의 거부와 비어 있는 제공업체 페이지를 항상 구분할 수 없습니다.

저장된 구성이 유효하지 않게 되면 게스트 환경에는 안전한 현지화 오류 상태가 표시되며, 가능한 경우 외부에서 열기 대체 옵션이 제공됩니다.

스크립트가 필요한 제공업체​

임의의 제공업체 스크립트는 Scoutello 페이지에서 실행할 수 없습니다. 스크립트만 제출하면 차단되며 제공업체 통합 요청 옵션이 표시됩니다. 요청에는 제공업체 이름, 공개 문서 URL, 사용 목적 및 스크립트 샘플이 포함됩니다. 제출하기 전에 비밀 정보, 비공개 인증 정보 및 개인정보를 삭제하세요.

스크립트 샘플은 일반 텍스트 형식의 지원 요청 내용으로만 저장되며 렌더링되거나 실행되지 않습니다. 승인을 받아도 해당 스니펫이 활성화되지는 않습니다. 대신 검토를 거친 제공업체 어댑터를 제품 작업으로 생성합니다. 이 어댑터는 쿠키를 사용하지 않고 별도로 등록 가능한 출처의 sandbox 문서에서 호스팅되며, 제공업체별 Content Security Policy와 출처 확인 메시징을 사용합니다. 이는 OWASP 서드파티 JavaScript 지침을 따릅니다.

지원 체크리스트​

  • 주소가 공개 HTTPS이며 대상 제공업체에 속하는지 확인합니다.
  • 제공업체가 게시된 출처에서 iframe 임베드를 허용하는지 확인합니다.
  • 제공업체 문서에서 요구하는 경우에만 결제 또는 전체 화면을 활성화합니다.
  • 게시하기 전에 개인정보 보호 고지 및 동의 동작을 검토합니다.
  • 스크립트만 사용하는 위젯에는 제공업체 통합 요청을 사용하고, 비밀 정보는 절대 붙여넣지 않습니다.