[Somente SaaS]{class="badge positive" title="Aplica-se somente ao Adobe Commerce as a Cloud Service e Adobe Commerce Optimizer projetos (infraestrutura SaaS gerenciada pela Adobe)."}

Exibições de catálogo privado

Por padrão, uma exibição de catálogo é pública. Ative a proteção de catálogo em uma exibição de catálogo para restringir o acesso a solicitações que incluem um token assinado válido.

A proteção de catálogo se aplica somente à exibição de catálogo selecionada. Isso não altera as políticas ou camadas da exibição. Ela restringe a exibição a um único catálogo de preços — consulte Restrição de catálogo de preços em exibições de catálogo privado.

Consulte os Casos de uso da chave de acesso restrito para obter exemplos de quando proteger uma exibição de catálogo.

Entender o limite de proteção

A proteção de catálogo se aplica somente à exibição de catálogo em que está habilitada. Ela protege solicitações de catálogo e pesquisa, mas não altera as políticas ou camadas da exibição, protege outras exibições de catálogo ou protege o carrinho, a finalização ou as operações de pedido.

O back-end de comércio conectado deve impor independentemente a qualificação de compra.

Restrição de catálogo de preços em exibições de catálogo privado

Uma exibição de catálogo privado pode fazer referência a apenas um catálogo de preços. Isso é diferente de uma exibição de catálogo público, que pode usar vários catálogos de preços.

Quando Catalog Protection está habilitado, o seletor de catálogo de preços no formulário de exibição de catálogo alterna de um controle de seleção múltipla para um controle de seleção única (botão de opção).

Em cada um desses casos, Adobe Commerce Optimizer exibe a seguinte mensagem de validação: A protected catalog view can use only one price book. Select 'Single price book only' to continue.

As exibições de catálogo público não são afetadas por essa restrição e podem continuar fazendo referência a vários catálogos de preços.

Proteger uma exibição de catálogo

Antes de começar, crie uma chave de acesso restrito a partir da chave pública gerada pelo aplicativo cliente.

Verificar se o acesso é aplicado

Para confirmar se uma exibição de catálogo privado rejeita solicitações não autorizadas, chame seu endpoint do GraphQL com e sem um token assinado, usando estes cabeçalhos:

Uma solicitação sem um token válido retorna um erro de GraphQL em vez de dados de catálogo, por exemplo:

{
  "errors": [
    {
      "message": "Access key validation failed: Missing token",
      "extensions": { "x-commerce-exception": "access-key-invalid" }
    }
  ]
}

Uma solicitação que transporta um token assinado por uma chave atribuída e não expirada retorna os dados do catálogo conforme esperado. Para obter detalhes sobre como assinar um JWT e chamar a API de merchandising, consulte a documentação para desenvolvedores.

Gerenciar chaves de acesso restrito

Se Catalog Protection estiver habilitado e todas as chaves atribuídas expirarem, a exibição de catálogo ficará inacessível—as vitrines de loja que dependem dessa exibição de catálogo não podem fornecer dados a partir dela. Atribua uma chave nova e não expirada para restaurar o acesso. Para obter instruções, consulte Girar chaves.

Veja mais aqui