설치 방법

도메인 등록부터 설치 확인까지 네 단계입니다. 순서를 지키면 설치 여부를 화면에서 바로 확인할 수 있습니다.

1. 1

   운영 도메인 등록

   내 사이트 · 사이트 등록 에서 사이트 이름과 운영 도메인을 넣습니다. 프로토콜과 경로는 자동으로 정리되므로 www.example.kr 처럼 호스트만 적어도 됩니다.

   등록하면 사이트 전용 공개키가 만들어지고, apex 주소와 www 주소가 허용 Origin에 자동 등록됩니다.

2. 2

   허용 Origin 확인

   사이트 상세의 허용 Origin 탭에서 실제 접속 주소가 모두 들어 있는지 확인합니다. 설정 API는 여기 등록된 Origin과 정확히 일치하는 요청에만 응답합니다.

   • https:// 와 http://, www 유무, 포트는 각각 다른 Origin입니다.
   • 경로·쿼리·와일드카드는 쓸 수 없습니다.
   • 스테이징 주소에서도 확인하려면 그 주소를 한 줄 더 추가합니다.
3. 3

   설치 코드 삽입

   사이트 상세의 설치 코드 탭에서 코드를 복사해 모든 페이지가 공유하는 레이아웃의 </body> 바로 앞에 넣습니다.

   공개키는 브라우저에 노출해도 되는 사이트 식별자입니다. 비밀키가 아니며, 다른 사이트에서의 사용은 허용 Origin 검사로 막습니다.

   <script defer
     src="https://cdn.webaccessibility.kr/widget/v1/loader.js"
     data-site-key="pub_사이트별_공개키"></script>

4. 4

   운영 시작과 설치 확인

   사이트 상세 개요 탭에서 운영을 시작합니다. 설정 대기·중지 상태에서는 설정 API가 응답하지 않아 위젯이 표시되지 않습니다.

   운영을 시작한 뒤 사이트를 열면 위젯이 설정을 실제로 불러간 시각이 기록되고, 설치 상태가 설치 확인됨 으로 바뀝니다. 값이 바뀌지 않으면 코드가 페이지에 들어가지 않았거나 Origin이 다른 경우입니다.

위 코드의 data-site-key 값은 사이트마다 다릅니다. 예시를 그대로 쓰지 말고 반드시 사이트 상세 화면에서 복사해 주세요.