Compart lance DocBridge® Communication Suite
Lancement sur le marché de DocBridge® Communication Suite : De nouvelles normes en matière de flexibilité et de technologie dans la gestion de la communication avec les clients.
PlusLe mappage des URI – une fonctionnalité souvent sous-estimée
Le mappage des URI (URI Mapping) est une fonctionnalité essentielle mais souvent mal comprise de DocBridge® Communication Suite (DBCS). Ce guide vise à clarifier son objectif, sa mise en œuvre et les avantages pratiques qu'il offre, en particulier en ce qui concerne la portabilité des ressources et la sécurité.
Si vous déployez DBCS à l'aide d'un Helm-Chart pour Kubernetes, Docker Compose ou le programme d'installation de DBCS, la bonne nouvelle est que vous pouvez généralement vous fier aux paramètres par défaut de ces méthodes de déploiement. Le programme d'installation configure automatiquement le mappage des URI, ce qui rend les modifications manuelles généralement inutiles. Cependant, il est toujours utile de comprendre les mécanismes et les avantages sous-jacents, d'où ce guide.
Pourquoi le mappage des URI ?
L'objectif principal du mappage URI dans DBCS est d'assurer la portabilité des modèles et des ressources dans différents environnements - développement, test et production - sans nécessiter de modifications manuelles. En règle générale, les modèles font référence à d'autres ressources telles que les images, les feuilles de style et les polices de caractères par le biais d'URL. Ces références doivent pouvoir être adaptées à différents scénarios de déploiement.
Comment fonctionne le mappage d'URI
Lors de la conception de modèles par glisser-déposer, les ressources telles que les polices, les images ou les éléments de texte sont référencées via des schémas spéciaux, par exemple resdir:// ou fonts://. Ces schémas inhabituels servent de caractères de remplacement. . Ces protocoles inhabituels jouent le rôle de caractères génériques. Au moment de l'exécution, ces espaces réservés se résolvent dynamiquement en chemins ou noms d'hôtes réels, spécifiques à l'environnement, ce qui permet de maintenir la portabilité des ressources.
Par exemple, un caractère générique d'URL tel que
resdir://resource-directory/staticse résoudra en une URL complète basée sur l'environnement spécifique, comme par exemple :
http://localhost:8080/resource-directory/staticDeux éléments essentiels du mappage des URI
Le mappage des URI dans les DBCS comporte deux éléments principaux :
1. Résolution des caractères génériques des URI :
Définis dans le profil, les caractères génériques URI tels que resdir:// sont mappés en URL valides spécifiques au moment de l'exécution. Dans les environnements locaux, une configuration manuelle est nécessaire, alors que les déploiements Kubernetes utilisant les Helm-Charts automatisent ce processus.
2. Header Value Mapping:
Ce composant est crucial pour la sécurité, car il garantit que les demandes de ressources (comme celles hébergées dans Resource Director ou Repository Manager) sont authentifiées et autorisées. Au lieu d'attribuer des autorisations générales au service DocBridge® Gear, DBCS transmet le jeton OAuth de la demande initiale aux demandes de ressources ultérieures. Cela garantit un contrôle d'accès granulaire conforme à vos configurations de sécurité.
Mise en œuvre pratique
La configuration de mappage URI standard (cpurires.pro), incluse dans le DBCS-Helm-Chart, offre des fonctions prêtes à l'emploi pour les déploiements typiques. Elle gère automatiquement aussi bien la résolution des substituts d'URI que l'affectation des en-têtes de jetons OAuth.
Le jeton OAuth est associé à l'en-tête d'autorisation, ce qui garantit que les ressources sont récupérées en toute sécurité et en respectant tous les contrôles d'accès configurés. Ainsi, les ressources telles que les modèles, les images et les feuilles de style nécessaires à la production ou à la prévisualisation sont récupérées en toute sécurité à l'aide des informations d'identification de l'utilisateur à l'origine de la demande.
Avantages de la mise en correspondance des URI :
- Portabilité des ressources : Les modèles et les ressources passent en toute transparence d'un environnement à l'autre
- Sécurité renforcée : L'extraction des ressources par jeton OAuth s'aligne sur les contrôles d'accès existants
- Réduction de l'effort manuel : La résolution automatisée des espaces réservés et l'accès sécurisé minimisent la configuration et la maintenance manuelles
Déploiement recommandé
Pour de meilleurs résultats, utilisez les Helm-Charts ou le programme d'installation de DBCS pour déployer dans des environnements Kubernetes, en tirant parti de la configuration du profil cpurires.pro fourni sans modification.
Le mappage d'URI, bien qu'il semble complexe au départ, simplifie considérablement la gestion des ressources dans plusieurs environnements de déploiement, garantissant ainsi la cohérence, la sécurité et la facilité d'utilisation de DBCS.
Pour de plus amples informations ou des configurations personnalisées, veuillez contacter l'équipe de support produit de DBCS.
