Vistas del catálogo privado
De manera predeterminada, la vista de catálogo es pública. Restrinja el acceso a una vista de catálogo para que solo las solicitudes con un token firmado válido puedan recuperar sus datos.
Una vista de catálogo se vuelve privada de una de las dos maneras siguientes:
-
[Private Beta]{class="badge yellow" title="Requiere la extensión B2B del conector de Adobe Commerce Optimizer, que actualmente se encuentra en versión beta privada."} De forma automática, para los catálogos compartidos B2B: para las implementaciones de Commerce que usan la integración de Adobe Commerce Optimizer Connector con la extensión B2B, las vistas de catálogo privado se crean y configuran automáticamente, según la configuración de catálogo compartido en Adobe Commerce. Consulte Vistas automáticas de catálogo privado para catálogos compartidos B2B.
-
Manualmente, para cualquier vista de catálogo: para restringir el acceso a una vista de catálogo que de otra manera sería pública, incluida una vista de catálogo B2C, siga los pasos de Proteger una vista de catálogo. Consulte Casos de uso de claves de acceso restringido para ver ejemplos, como portales de socios y vistas previas al lanzamiento.
La protección del catálogo solo se aplica a la vista de catálogo seleccionada. No cambia las políticas ni las capas de la vista. Restringe la vista a un único libro de precios; consulte Restricción del libro de precios en vistas de catálogo privado.
Comprender el límite de protección
La protección del catálogo solo se aplica a la vista de catálogo en la que está activada. Protege las solicitudes de catálogo y de búsqueda, pero no cambia las directivas ni las capas de la vista, protege otras vistas de catálogo ni protege el carro de compras, las operaciones de cierre de compra o de pedido.
El backend de comercio conectado debe aplicar de forma independiente la idoneidad de la compra.
Restricción de libro de precios en vistas de catálogo privado
Una vista de catálogo privado sólo puede hacer referencia a un libro de precios. Esto difiere de una vista de catálogo público, que puede utilizar varios libros de precios.
Cuando se habilita Catalog Protection, el selector de libro de precios del formulario de vista de catálogo cambia de un control de selección múltiple a un control de selección única (botón de opción).
- Si activa Catalog Protection en una vista de catálogo que tiene varios libros de precios asignados, no podrá guardar la vista hasta que elimine todos los libros de precios excepto uno.
- Si anteriormente ha guardado una vista de catálogo privado con varias asignaciones de libro de precios antes de que existiera esta restricción, la configuración de la vista de catálogo no cambia automáticamente. Sin embargo, la próxima vez que edite la vista, deberá eliminar todos los libros de precios excepto uno para poder guardar las actualizaciones.
En cada uno de estos casos, Adobe Commerce Optimizer muestra el siguiente mensaje de validación: A protected catalog view can use only one price book. Select 'Single price book only' to continue.
Las vistas de catálogo público no se ven afectadas por esta restricción y pueden seguir haciendo referencia a varios libros de precios.
Vistas automáticas de catálogos privados para catálogos compartidos B2B
[Private Beta]{class="badge yellow" title="Requiere la extensión B2B del conector de Adobe Commerce Optimizer, que actualmente se encuentra en versión beta privada."}
Para implementaciones integradas con Adobe Commerce Optimizer Connector for B2B que admitan catálogos compartidos, la extensión crea y configura vistas de catálogo privado automáticamente, según la configuración de catálogo compartido en Adobe Commerce. Esta configuración incluye la vista de catálogo, la directiva, una clave de acceso inicial restringida y una referencia del libro de precios. Con esta configuración, administra las claves de acceso restringido desde la página Administrador de Commerce Claves de acceso restringido (Sistema > Transferencia de datos). Para obtener más información, consulte Cambios en el catálogo compartido B2B en la Adobe Commerce Optimizer ConnectorGuía de integración.
Si no usa catálogos compartidos B2B, por ejemplo, para proteger una vista del catálogo para un portal de socio o una vista previa al lanzamiento, use las instrucciones de Proteger una vista del catálogo para configurar una manualmente.
Proteger una vista de catálogo
Antes de empezar, cree una clave de acceso restringido a partir de la clave pública que genere su aplicación cliente.
-
En el formulario de creación o edición de la vista de catálogo, cambie Catalog Protection a Enabled.
-
En Restricted Access Keys, seleccione hasta tres claves de acceso restringido para asignarlas a esta vista de catálogo.
-
Haga clic en Save catalog view.
La vista de catálogo está ahora protegida. Solo las solicitudes que llevan un token firmado válido de una clave asignada pueden recuperar sus datos.
note NOTE Espere hasta cinco minutos para que los cambios de configuración de Protección de catálogos entren en vigor.
Verificar que el acceso sea obligatorio
Para confirmar que una vista de catálogo privado rechaza solicitudes no autorizadas, llame a su extremo GraphQL con y sin un token firmado, utilizando estos encabezados:
AC-View-IDAC-Price-Book-IDAC-Catalog-View-Access-TokenUna solicitud sin un token válido devuelve un error de GraphQL en lugar de datos de catálogo, por ejemplo:
{
"errors": [
{
"message": "Access key validation failed: Missing token",
"extensions": { "x-commerce-exception": "access-key-invalid" }
}
]
}
Una solicitud que lleva un token firmado por una clave asignada no caducada devuelve los datos del catálogo según lo esperado. Para obtener más información sobre cómo firmar un JWT y llamar a la API de comercialización, consulta la documentación para desarrolladores.
Administrar claves de acceso restringido
Si Catalog Protection está habilitado y todas las claves asignadas caducan, no se podrá obtener acceso a la vista de catálogo. Las tiendas que dependen de esta vista de catálogo no pueden servir datos de ella. Asigne una clave nueva que no haya caducado para restaurar el acceso. Para obtener instrucciones, vea Rotar claves.
Más parecido a esto
- Vistas de catálogo: aprenda cómo las vistas de catálogo organizan el catálogo de productos según la estructura empresarial, las directivas y los precios.
- Claves de acceso restringido: cree, asigne y gire las claves utilizadas para firmar tokens para la protección del catálogo.