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

Exibições de catálogo privado

Por padrão, uma exibição de catálogo é pública. Restrinja o acesso a uma exibição de catálogo para que somente as solicitações com um token assinado válido possam recuperar seus dados.

Uma exibição de catálogo se torna privada de uma das duas formas a seguir:

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.

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.

Exibições automáticas de catálogo privado para catálogos compartilhados B2B

[Private Beta]{class="badge yellow" title="Requer a extensão B2B do Adobe Commerce Optimizer Connector, que atualmente está em beta privado."}

Para implantações integradas ao Adobe Commerce Optimizer Connector for B2B para oferecer suporte a catálogos compartilhados, a extensão cria e configura exibições de catálogo privado automaticamente, com base na configuração de catálogo compartilhado em Adobe Commerce. Essa configuração inclui a exibição do catálogo, a política, uma chave de acesso restrito inicial e uma referência de catálogo de preços. Com essa configuração, você gerencia chaves de acesso restrito da página Chaves de Acesso Restrito do Administrador do Commerce (Sistema > Transferência de Dados). Para obter detalhes, consulte Alterações no catálogo compartilhado B2B no Adobe Commerce Optimizer ConnectorGuia de Integração.

Se você não estiver usando catálogos compartilhados B2B, por exemplo, para proteger uma exibição de catálogo para um portal de parceiro ou pré-visualização de pré-lançamento, use as instruções em Proteger uma exibição de catálogo para configurar um manualmente.

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 do catálogo ficará inacessível. As vitrines 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