스토어 크롤링
Web Bot Auth를 사용하여 공개 Shopify 온라인 스토어에 액세스하도록 자체 크롤러, 스크립트 또는 도구를 안전하게 승인할 수 있습니다. Web Bot Auth는 Shopify 관리자에서 생성되는 HTTP 메시지 서명에 의존합니다. 권한이 있는 출처에서 보낸 요청인지 확인할 수 있도록 각 요청의 HTTP 헤더에 서명을 포함해야 합니다.
접근성 및 SEO 감사, 자동화된 테스트, 데이터 분석 및 유사한 사용 사례를 위해 온라인 스토어에 액세스하는 자동화된 자사 또는 타사 도구와 함께 서명을 사용할 수 있습니다. 서명이 없어도 검색 엔진 및 대규모 언어 모델(LLM)에서 스토어를 색인화할 수 있습니다.
서명 기능
서명에는 다음과 같은 기능이 있습니다.
- 보안 인증: 크롤러에 대해 암호화된 보안 서명을 생성할 수 있습니다.
- 만료 제어: 특정 기간이 지나면 서명이 만료되도록 설정할 수 있습니다. 최대 기간은 3개월입니다.
- 중앙 집중식 관리: 모든 서명을 한 곳에서 관리하고 볼 수 있습니다.
- 사용자 지정 이름 지정: 각 서명에 식별할 수 있는 사용자 지정 이름을 지정할 수 있습니다.
- 도메인 범위 지정: 각 서명은 Shopify 스토어에 연결되어 있어야 하는 특정 도메인에 사용됩니다.
서명 생성 시 고려 사항
서명을 생성하고 사용하기 전에 다음 고려 사항을 검토하세요.
- 서명을 사용한 스토어 크롤링은 온라인 스토어프론트를 분석하기 위한 용도로만 사용됩니다. 추가적인 체크아웃 보안 계층으로 인해 서명은 Shopify 체크아웃에 대한 액세스 권한을 부여하지 않습니다.
- 서명에 명확하고 설명적인 이름을 사용하세요.
- 서명은 자동으로 만료되며 갱신할 수 없습니다. 서명이 만료되면 새 서명을 생성하고 도구를 업데이트하세요.
- 각 서명은 하나의 도메인에 사용되므로 서명을 사용할 연결된 도메인을 지정해야 합니다. Shopify에 연결된 도메인만 선택할 수 있습니다.
서명 생성
Shopify 관리자에서 직접 서명을 생성하고 관리할 수 있습니다.
Shopify 관리자에서 **온라인 스토어** > **기본 설정**으로 이동합니다.
**크롤러 액세스** 섹션에서 **서명 생성**을 클릭합니다.
**이름** 필드에 서명을 설명하는 이름을 입력합니다.
**도메인** 필드에서 이 서명을 사용할 도메인을 선택합니다.
**유효 기간** 섹션에서 서명의 만료 기간을 선택합니다.
**생성**을 클릭합니다.
선택 사항: 새로 생성된 **Signature-Input** 및 **Signature** 값을 복사하려면 각 값 옆의 **복사**를 클릭합니다.
서명이 만료되면 더 이상 유효하지 않습니다. 만료된 서명은 갱신할 수 없지만 새 서명을 생성할 수는 있습니다.
요청에 서명 추가
서명을 복사한 다음 요청의 HTTP 헤더에 추가할 수 있습니다. 각 서명은 포함해야 하는 3개의 HTTP 헤더로 구성됩니다.
| 헤더 이름 | 헤더 값 |
|---|---|
| Signature-Input | 서명 입력 값을 추가합니다. |
| 서명 | 서명 값을 추가합니다. |
| Signature-Agent | Signature-Agent 값은 에이전트의 유효한 URI를 포함하는 문자열입니다. 이 값에는 `"https://shopify.com"`(따옴표 포함)을 사용하십시오. |
사용자 지정 헤더 추가에 대한 지침은 다음 설명서를 참조하십시오.
서명 보기
Shopify 관리자에서 기존 서명에 대한 다음 정보를 볼 수 있습니다.
- 서명 이름
- 연결된 도메인
- **Signature-Input** 및 **Signature** 값의 첫 몇 글자
- **Signature-Agent** 값
- 서명 만료 날짜 및 상태
Shopify 관리자에서 **온라인 스토어** > **기본 설정**으로 이동합니다.
크롤러 액세스 섹션에서 서명에 대한 정보를 검토하십시오.
서명 문제 해결
서명 문제를 선택하고 문제 해결 단계를 따르십시오.
인증 문제 해결
크롤러에서 속도 제한 오류가 발생하는 경우 서명이 유효하지 않은 것입니다. 다음 정보를 확인하십시오.
- HTTP 헤더에 올바른 서명 형식을 사용하고 있는지 확인합니다.
- 모든 요청과 함께 Signature-Input, Signature, Signature-Agent 헤더가 전송되는지 확인합니다.
- 서명이 만료되지 않았는지 확인합니다. Shopify 관리자에서 만료 날짜를 검토하십시오.
- 서명과 연결된 도메인을 크롤링합니다.
분실된 서명 복구
서명을 분실한 경우 다음 단계를 완료하여 복구할 수 있습니다.
- Shopify 관리자에서 온라인 스토어 > 기본 설정으로 이동합니다.
- 크롤러 액세스 섹션의 목록에서 서명을 찾습니다.
- 복사를 클릭하여 Signature-Input, Signature 및 Signature-Agent 값을 클립보드에 복사하십시오.
서명 만료 날짜 변경
생성한 후에는 서명의 만료 날짜를 변경할 수 없습니다. 다른 만료 날짜를 설정하려면 원하는 만료 날짜로 새 서명을 생성한 다음 새 서명을 사용하도록 서비스를 업데이트하십시오.
이전 서명은 여전히 유효하며 원래 만료 날짜까지 계속 작동합니다.