비공개 카탈로그 보기
기본적으로 카탈로그 보기는 공개 보기입니다. 유효한 서명 토큰이 있는 요청만 해당 데이터를 검색할 수 있도록 카탈로그 보기에 대한 액세스를 제한합니다.
카탈로그 보기는 다음 두 가지 방법 중 하나로 비공개가 됩니다.
-
[Private Beta]{class="badge yellow" title="현재 비공개 베타에 있는 Adobe Commerce Optimizer 커넥터 B2B 확장이 필요합니다."} B2B 공유 카탈로그에 대해 자동으로—B2B 확장과 Adobe Commerce Optimizer Connector 통합을 사용하는 Commerce 배포의 경우 Adobe Commerce의 공유 카탈로그 구성에 따라 개인 카탈로그 보기가 자동으로 만들어지고 구성됩니다. B2B 공유 카탈로그에 대한 자동 비공개 카탈로그 보기를 참조하세요.
-
모든 카탈로그 보기에 대해 수동으로—B2C 카탈로그 보기를 포함하여 공개되는 카탈로그 보기에 대한 액세스를 제한하려면 카탈로그 보기 보호의 단계를 따르십시오. 파트너 포털 및 시험판 미리 보기와 같은 예는 제한된 액세스 키 사용 사례를 참조하십시오.
카탈로그 보호는 선택한 카탈로그 보기에만 적용됩니다. 보기의 정책 또는 계층은 변경되지 않습니다. 단일 가격 장부로 보기를 제한합니다. 개인 카탈로그 보기에 대한 가격 장부 제한을 참조하세요.
보호 경계 이해
카탈로그 보호는 활성화된 카탈로그 보기에만 적용됩니다. 이 기능은 카탈로그 및 검색 요청을 보호하지만 보기의 정책이나 계층을 변경하거나 다른 카탈로그 보기를 보호하거나 장바구니, 체크아웃 또는 주문 작업을 보호하지 않습니다.
연결된 상거래 백엔드는 독립적으로 구매 자격을 적용해야 합니다.
개인 카탈로그 보기에 대한 가격 책자 제한
비공개 카탈로그 보기는 하나의 가격 장부만 참조할 수 있습니다. 이는 여러 가격 장부를 사용할 수 있는 공개 카탈로그 보기와는 다릅니다.
Catalog Protection을(를) 사용하도록 설정하면 카탈로그 보기 양식의 가격 장부 선택기가 다중 선택 컨트롤에서 단일 선택(라디오 단추) 컨트롤로 전환됩니다.
- 가격 장부가 여러 개 할당된 카탈로그 보기에서 Catalog Protection을(를) 사용하도록 설정하면 가격 장부를 하나만 제외한 모든 항목을 제거할 때까지 보기를 저장할 수 없습니다.
- 이 제한이 존재하기 전에 가격 장부 지정을 여러 개 사용하여 개인 카탈로그 뷰를 이전에 저장한 경우 카탈로그 뷰 구성이 자동으로 변경되지 않습니다. 그러나 다음에 보기를 편집할 때는 업데이트를 저장하기 전에 하나의 가격 장부를 제외한 모든 가격 장부를 제거해야 합니다.
이러한 각 경우에 Adobe Commerce Optimizer은(는) 다음 유효성 검사 메시지를 표시합니다. A protected catalog view can use only one price book. Select 'Single price book only' to continue.
공개 카탈로그 보기는 이 제한의 영향을 받지 않으며 여러 가격 장부를 계속 참조할 수 있습니다.
B2B 공유 카탈로그에 대한 자동 비공개 카탈로그 보기
[Private Beta]{class="badge yellow" title="현재 비공개 베타에 있는 Adobe Commerce Optimizer 커넥터 B2B 확장이 필요합니다."}
공유 카탈로그를 지원하기 위해 Adobe Commerce Optimizer Connector for B2B과(와) 통합된 배포의 경우, 확장 기능은 Adobe Commerce의 공유 카탈로그 구성에 따라 개인 카탈로그 보기를 자동으로 만들고 구성합니다. 이 구성에는 카탈로그 보기, 정책, 초기 제한 액세스 키 및 가격 장부 참조가 포함됩니다. 이 구성을 통해 Commerce 관리 제한된 액세스 키 페이지(시스템 > 데이터 전송)에서 제한된 액세스 키를 관리합니다. 자세한 내용은 Adobe Commerce Optimizer Connector통합 안내서의 B2B 공유 카탈로그 변경 내용을 참조하세요.
B2B 공유 카탈로그를 사용하지 않는 경우(예: 파트너 포털 또는 프리릴리스 미리 보기에 대한 카탈로그 보기를 보호하려면 카탈로그 보기 보호의 지침을 사용하여 수동으로 구성해야 합니다.
카탈로그 보기 보호
시작하기 전에 클라이언트 응용 프로그램에서 생성한 공개 키에서 제한된 액세스 키를 만듭니다.
-
카탈로그 보기 만들기 또는 편집 양식에서 Catalog Protection을(를) Enabled(으)로 전환합니다.
-
Restricted Access Keys에서 이 카탈로그 보기에 할당할 최대 3개의 제한된 액세스 키를 선택하십시오.
{width="70%" modal="regular"}
-
Save catalog view을(를) 클릭합니다.
이제 카탈로그 보기가 보호됩니다. 할당된 키에서 유효한 서명된 토큰을 전달하는 요청만 해당 데이터를 검색할 수 있습니다.
note NOTE 카탈로그 보호 구성 변경 사항이 적용되는 데 최대 5분이 소요됩니다.
액세스가 적용되었는지 확인
비공개 카탈로그 보기가 권한 없는 요청을 거부하는지 확인하려면 다음 헤더를 사용하여 서명된 토큰을 사용하거나 사용하지 않고 해당 GraphQL 끝점을 호출합니다.
AC-View-IDAC-Price-Book-IDAC-Catalog-View-Access-Token유효한 토큰이 없는 요청은 카탈로그 데이터 대신 GraphQL 오류를 반환합니다. 예:
{
"errors": [
{
"message": "Access key validation failed: Missing token",
"extensions": { "x-commerce-exception": "access-key-invalid" }
}
]
}
만료되지 않은 할당된 키로 서명된 토큰을 전달하는 요청은 카탈로그 데이터를 예상대로 반환합니다. JWT에 서명하고 머천다이징 API를 호출하는 방법에 대한 자세한 내용은 개발자 설명서를 참조하십시오.
제한된 액세스 키 관리
Catalog Protection을(를) 사용하도록 설정하고 할당된 모든 키가 만료되면 카탈로그 보기에 액세스할 수 없게 됩니다. 이 카탈로그 보기에 의존하는 상점 영역은 데이터를 제공할 수 없습니다. 액세스 권한을 복원하려면 만료되지 않은 새 키를 할당하십시오. 자세한 내용은 키 회전을 참조하세요.