위젯 키와 도메인

위젯 키란#

위젯 키는 사이트에 붙인 위젯이 어느 계정의 어느 에이전트인지 알려주는 값입니다. 설치 코드에 들어가는 긴 문자열이 이 키입니다.

위젯은 이 키 하나로 자기 소속을 판별합니다. 키를 바꾸면 위젯이 불러오는 페르소나와 지식도 함께 바뀝니다.

설치할 때 한 번 쓰고 잊는 값이 아닙니다. 사이트를 하나 더 열거나, 담당자가 바뀌거나, 키가 외부에 노출됐을 때 다시 꺼내 보게 됩니다.

키와 도메인이 묶이는 방식#

키는 도메인 단위로 발급됩니다. 위젯은 키를 발급받은 도메인에서만 뜨고, 다른 주소에 같은 키를 붙이면 동작하지 않습니다.

여기서 도메인은 주소가 정확히 같아야 한다는 뜻입니다. example.com으로 받은 키는 shop.example.com에서 쓸 수 없고 그 반대도 마찬가지입니다. 쇼핑몰과 브랜드 소개 사이트를 따로 운영한다면 각각 발급합니다.

같은 도메인으로 여러 번 발급할 수도 있습니다. 발급할 때마다 새 키가 하나씩 더 생기고 기존 키는 그대로 살아 있습니다. 테스트용과 운영용을 나누거나 외주 개발사에 별도 키를 전달할 때 이 방식을 씁니다.

열람 권한#

키 값은 계정 관리자에게만 표시됩니다. 관리자가 아닌 구성원에게는 어떤 도메인에 키가 몇 개 발급돼 있고 각각 활성 상태인지까지만 보이고, 키 자리에는 관리자에게만 표시된다는 안내가 대신 들어갑니다.

발급도 관리자 권한입니다. 설치는 개발 담당자가 맡더라도 발급은 관리자 계정에서 하고, 발급된 키를 전달하는 방식으로 진행합니다.

재발급하면#

키가 외부에 노출됐다면 재발급으로 차단합니다. 재발급은 새 키를 만들면서 이전 키를 그 자리에서 무효로 만듭니다.

새 키는 재발급 직후 화면에 한 번만 표시됩니다. 다시 열면 가려진 상태로만 보이므로 그 자리에서 복사합니다.

사이트에 붙여 둔 설치 코드의 키도 새 값으로 교체해야 합니다. 교체 전까지 그 사이트에서는 위젯이 뜨지 않습니다.

더 이상 쓰지 않는 키는 삭제할 수 있습니다. 삭제하면 키가 비활성으로 바뀌고, 이미 지웠거나 없는 키를 한 번 더 지워도 오류가 나지 않습니다.

위젯 코드를 받아오는 주소#

설치 코드의 첫 줄은 위젯 코드를 내려받는 주소입니다. 기본값을 그대로 두면 되지만, 별도 주소에서 받아야 하는 경우에는 직접 지정할 수 있습니다.

키마다 따로 지정하는 다른 값과 달리 이 주소는 계정의 활성 키 전체에 한꺼번에 적용됩니다. 한 사이트만 다른 주소를 쓰게 할 수는 없습니다.

다음 단계#

• 키를 발급하고 관리하는 화면은 위젯 설정을 참고하세요.
• 발급한 키를 사이트에 붙이는 방법은 위젯 설치를 참고하세요.
• 위젯이 사이트에 뜨지 않을 때는 위젯 미표시를 참고하세요.