Gerenciar chaves de acesso restrito 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."}
Se você usar Adobe Commerce catálogos compartilhados B2B com o Adobe Commerce Optimizer Connector B2B extension, a extensão automaticamente gerará e atribuirá a primeira chave de acesso restrito quando uma exibição de catálogo for criada. Use a página Restricted Access Keys no Administrador do Commerce para exibir essa chave e criar, atribuir ou excluir chaves adicionais.
Acessar a página access-the-page
No Administrador do Commerce, vá para System > Data Transfer > Restricted Access Keys.
Você pode atribuir uma chave à exibição de catálogo na grade Catálogo Compartilhado ou na grade Empresa. Consulte Atribuir chaves a uma exibição de catálogo compartilhado B2B.
Quando você precisar de mais do que a chave automática when-you-need-more-than-the-automatic-key
A chave automática gerada pelo Adobe Commerce Optimizer Connector B2B extension abrange a maioria dos catálogos compartilhados B2B sem exigir nenhuma ação sua. Gerencie você mesmo as chaves nestes casos:
- Girando uma chave — Crie uma nova chave, atribua-a à exibição de catálogo junto com a existente, confirme se está funcionando e exclua a chave antiga. A rotação automática ainda não está disponível.
- Falha ao vincular uma chave — Se o Status de Sincronização de Exibição de Catálogo mostrar um desvio relacionado à chave, tente salvar a atribuição de exibição de catálogo novamente para repetir o link com falha. Se a chave ainda falhar, execute Reconcile & Repair para recuperar a chave ou o status antes de criar uma substituição. Crie uma chave de substituição somente se a chave tiver expirado ou se a falha for irrecuperável de forma persistente.
- Localizar uma chave pública — Na página Chaves de Acesso Restrito, selecione View Public Key para exibir e copiar a chave pública de uma chave.
Uma visualização de catálogo pode ter até três chaves atribuídas de uma só vez. Durante a rotação de chaves, Adobe Commerce Optimizer aceita tokens assinados por qualquer chave atribuída não expirada; não há etapa manual para definir uma chave “ativa”.
Criar uma chave
Na página Restricted Access Keys, crie uma chave selecionando Create Key.
O Commerce gera um novo par de chaves e contém a chave privada. A tabela Chaves de acesso restrito é atualizada com uma nova entrada de chave que mostra a ID de chave exclusiva. Use este Key ID quando atribuir a chave a uma exibição de catálogo.
A chave pública não é registrada com Adobe Commerce Optimizer até que você atribua a chave a uma exibição de catálogo. Após o registro, a entrada da tabela Chave de acesso restrito é atualizada para mostrar a atribuição do catálogo e a data de expiração.
Atribuir chaves a uma exibição de catálogo projetada de catálogo compartilhado B2B assign-keys-to-a-shared-catalog-view
Atribuir ou cancelar atribuição de chaves da exibição de catálogo da conta da empresa ou da página de catálogo compartilhado, não da grade Restricted Access Keys principal.
Uma exibição de catálogo deve ter pelo menos uma chave e pode ter no máximo três.
- Se você tentar atribuir uma quarta chave, você receberá uma mensagem de erro quando tentar salvar o valor:
A Catalog View can have at most 3 access keys. - Se uma exibição de catálogo tiver apenas uma chave, essa chave não poderá ser excluída ou desatribuída.
Para atualizar a configuração da chave de visualização do catálogo, você pode acessá-la na página de conta da empresa ou na página de catálogo compartilhado.
-
No Administrador do Commerce, abra a página da empresa (Customers > Companies).
-
Na coluna Action da empresa, selecione Edit.
-
Para exibir a lista de exibições de catálogo projetadas do catálogo compartilhado atribuído à Empresa, expanda a seção Catalog Views.
A guia lista as exibições de catálogo projetadas no catálogo compartilhado, incluindo suas chaves atribuídas.
-
Na coluna Actions da exibição do catálogo a ser atualizada, selecione Edit Restricted Access Keys.
-
Para atribuir uma chave, selecione a lista suspensa Access Keys. Em seguida, selecione uma chave não atribuída pelo key ID, por exemplo
#42. Em seguida, clique em Done para atribuí-lo à exibição do catálogo.As chaves já atribuídas a uma exibição de catálogo diferente são rotuladas de acordo.
-
Para remover um token de acesso, remova-o do campo Access Tokens selecionando o controle
xno rótulo da chave. -
Para salvar e aplicar as atualizações de configuração, selecione Save.
-
No Administrador do Commerce, abra a página de catálogo compartilhado (Catalog > Shared catalogs).
-
Na coluna Action para o compartilhado, escolha General Settings no menu Select.
-
Para exibir a lista de exibições de catálogo projetadas no catálogo compartilhado, selecione Catalog Views no menu Shared Catalog Information.
A página Catalog Views lista a ID de exibição do catálogo, a exibição de armazenamento associada e a chave de acesso para cada exibição de catálogo.
-
Na coluna Actions da exibição do catálogo a ser atualizada, selecione Edit Restricted Access Keys.
-
Para atribuir uma chave, selecione a lista suspensa Access Keys. Em seguida, selecione uma chave não atribuída pelo título de chave padrão, por exemplo
#42. Em seguida, clique em Done para atribuí-lo à exibição do catálogo.As chaves já atribuídas a uma exibição de catálogo diferente são rotuladas de acordo.
-
Para remover um token de acesso, remova-o do campo Access Tokens selecionando o controle
xno rótulo da chave. -
Para salvar e aplicar as atualizações de configuração, selecione Save.
Gerenciar expiração e renovação de chave
Você pode configurar o tempo de vida padrão da chave para chaves de acesso restrito. O valor determina a data de expiração definida quando a extensão Adobe Commerce Optimizer Connector B2B gera a chave inicial, ou quando você cria uma nova chave manualmente.
A data de expiração é mostrada na coluna Expires At na página Restricted Access Keys.
Para alterar a duração, vá para Stores > Settings > Configuration > Services > ACO Restricted Access Keys. Na página Provisioning, atualize o campo Default Key Expiry (days). O tempo de vida padrão da chave do sistema é definido inicialmente por um período estendido (~100 anos). Certifique-se de atualizá-lo para um valor que corresponda às suas políticas de segurança.
Renovação da chave
Quando uma chave estiver dentro de 10 dias da expiração, a página Restricted Access Keys mostrará um ícone de aviso ao lado de sua entrada. Se você não renovar a chave antes de expirar, a exibição do catálogo ficará inacessível até que você atribua uma nova chave.
Você pode criar e atribuir uma nova chave a qualquer momento e remover a antiga depois de confirmar que a nova chave está funcionando.
Limitações conhecidas
A rotação de chaves automática ainda não está disponível.