[SaaS uniquement]{class="badge positive" title="S’applique uniquement aux projets Adobe Commerce as a Cloud Service et Adobe Commerce Optimizer (infrastructure SaaS gérée par Adobe)."}

Vues de catalogue privé

Par défaut, une vue de catalogue est publique. Limitez l’accès à une vue de catalogue afin que seules les requêtes disposant d’un jeton signé valide puissent récupérer ses données.

Une vue de catalogue devient privée de deux manières :

La protection du catalogue s’applique uniquement à la vue de catalogue sélectionnée. Cela ne modifie pas les politiques ou les calques de la vue. Elle limite l’affichage à un seul catalogue des prix. Voir Restriction du catalogue des prix sur les affichages de catalogue privé.

Comprendre le périmètre de protection

La protection du catalogue s’applique uniquement à la vue du catalogue dans laquelle elle est activée. Il protège les demandes de catalogue et de recherche, mais ne modifie pas les politiques ou les calques de la vue, protège d’autres vues de catalogue ou sécurise les opérations de panier, de passage en caisse ou de commande.

Le serveur principal de commerce connecté doit appliquer indépendamment l’éligibilité d’achat.

Restriction du catalogue des prix pour les vues de catalogue privé

Une vue de catalogue privée ne peut référencer qu’un seul catalogue des prix. Cela diffère d’une vue de catalogue public, qui peut utiliser plusieurs tarifs.

Lorsque Catalog Protection est activé, le sélecteur de catalogue dans le formulaire de vue du catalogue passe d’une commande à sélection multiple à une commande à sélection unique (bouton radio).

Dans chaque cas, Adobe Commerce Optimizer affiche le message de validation suivant : A protected catalog view can use only one price book. Select 'Single price book only' to continue.

Les vues de catalogue public ne sont pas affectées par cette restriction et peuvent continuer à faire référence à plusieurs catalogues de prix.

Vues de catalogue privé automatiques pour les catalogues partagés B2B

Pour les déploiements intégrés avec Adobe Commerce Optimizer Connector for B2B pour prendre en charge les catalogues partagés, l’extension crée et configure automatiquement les vues de catalogue privé, en fonction de la configuration de catalogue partagé dans Adobe Commerce. Cette configuration inclut la vue de catalogue, la politique, une clé d’accès restreint initiale et une référence au catalogue. Avec cette configuration, vous gérez les clés d’accès restreint à partir de la page Commerce Admin Clés d’accès restreint (Système > Transfert de données). Pour plus d’informations, consultez Modifications du catalogue partagé B2B dans le guide d’intégration Adobe Commerce Optimizer Connector.

Si vous n’utilisez pas de catalogues partagés B2B, par exemple pour protéger une vue de catalogue pour un portail partenaire ou un aperçu de version préliminaire, suivez les instructions de la section Protection d’une vue de catalogue pour en configurer une manuellement.

Protection d’une vue de catalogue

Avant de commencer, créez une clé d’accès restreint à partir de la clé publique générée par votre application cliente.

Vérifier que l’accès est appliqué

Pour confirmer qu’une vue de catalogue privé rejette les requêtes non autorisées, appelez son point d’entrée 🔗 avec ou sans jeton signé, à l’aide des en-têtes suivants :

Une requête sans jeton valide renvoie une erreur GraphQL au lieu des données de catalogue, par exemple :

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

Une requête portant un jeton signé par une clé attribuée non expirée renvoie les données du catalogue comme prévu. Pour plus d’informations sur la signature d’un jeton JWT et l’appel de l’API de marchandisage, consultez la documentation destinée aux développeurs.

Gestion des clés d’accès restreintes

Si Catalog Protection est activé et que toutes les clés affectées expirent, la vue de catalogue devient inaccessible. Les vitrines qui reposent sur cette vue de catalogue ne peuvent pas servir de données à partir de celle-ci. Attribuez une nouvelle clé non expirée pour restaurer l’accès. Pour obtenir des instructions, voir Rotation des clés.

Plus comme ceci