Les sections suivantes vous informent sur les protocoles utilisés dans un système DocuWare et sur les standards par lesquels les différents composants échangent des informations.
Protocoles
DocuWare utilise les protocoles TCP suivants pour la communication entre les différents composants logiciels.
HTTPS (transmission de données HTML ou binaires)
HTTP n'est pas chiffré par défaut. Pour communiquer de manière sécurisée via Internet, il est nécessaire de le chiffrer avec TLS/SSL (HTTPS). Pour cela, un certificat sur le serveur avec IIS (Internet Information Services) est requis.HTTPS avec REST (Representational State Transfer)
Le Platform Service de DocuWare en particulier est entièrement basé sur REST.
HTTPS avec SOAP (Simple Object Access Protocol)
SOAP permet le partage de messages basés sur le jeu d'informations XML (XML Information Set). Dans le système DocuWare, SOAP est utilisé par différents services frontend pour la communication avec les applications clientes.
Communication entre les couches des applications clientes, des services frontend et des services backend. Avec DocuWare 7.14, le serveur d'authentification est obsolète.
Communication client-serveur
La matrice vous indique quel serveur communique avec quelles applications clientes. Les protocoles utilisés sont indiqués entre parenthèses et les ports utilisés figurent sur une ligne séparée. Des ports standard sont utilisés pour toutes les applications clientes. La seule exception est DocuWare Administration (jusqu'à DocuWare 7.13 — à partir de la version 7.14, le Server Manager remplace DocuWare Administration).
Communication serveur-serveur
La matrice vous permet de voir quels serveurs communiquent entre eux, via quels protocoles, et à quelles bases de données ils accèdent. Si vous utilisez plusieurs machines serveur pour les services frontend et les services backend, assurez-vous que tous les ports de communication nécessaires sont disponibles pour les autres machines serveur.
Avec DocuWare 7.14, DocuWare Administration est obsolète et remplacé par le Server Manager.
DocuWare Server Messaging
La messagerie de serveur à serveur est basée sur le protocole RESP (Redis Serialization Protocol).
Le service DocuWare Server Messaging fonctionne via TCP, utilise le port 6379 par défaut et chiffre l'ensemble du trafic avec TLS 1.2.
Bien que chaque composant DocuWare puisse techniquement participer au Server Messaging, seuls les composants suivants l'utilisent actuellement :
DocuWare Platform
Settings Service
Background Process Service
Deux options sont disponibles pour le service RESP côté serveur :
Installation du rôle « DocuWare Server Messaging » sur une machine serveur : le composant de messagerie installé par ce rôle est basé sur l'implémentation Microsoft du protocole RESP appelée Garnet. L'implémentation Microsoft ne prend en charge qu'une seule instance du service.
Serveur RESP/Redis externe :
Fournissez votre propre cluster Redis ou utilisez votre cluster existant. L'utilisation ou la configuration de votre propre cluster Redis permet de contourner les limitations de l'implémentation Microsoft — par exemple, si vous souhaitez mettre en place une configuration à tolérance de pannes.
En savoir plus sur le protocole RESP et DocuWare Server Messaging :
Implémentation Microsoft du protocole RESP : Garnet
Communication serveur jusqu'à DocuWare version 7.12
Le bus de messages est la plateforme centrale d'échange de messages entre les serveurs web et la plupart des serveurs backend jusqu'à DocuWare version 7.12 incluse. Il utilise le protocole Microsoft Message Queuing (MSMQ).
DocuWare Server Messaging remplace la communication basée sur MSMQ, cette technologie n'étant plus prise en charge par Microsoft.
Le bus de messages est responsable du partage des modifications entre les composants serveur.
Le bus de messages suit le modèle publication-abonnement (publish-subscribe). Il implémente un modèle de type « fire-and-forget » qui, pour des raisons de rapidité, nécessite que le message soit remis directement sous peine d'être perdu. Un cas d'utilisation typique serait la notification de l'arrivée de nouveaux documents ou de la modification de paramètres.
Les messages sont toujours envoyés à tous les abonnés. Les abonnés décident s'ils souhaitent réutiliser les messages ou non.
Le bus de messages est géré dans la console de gestion au niveau du nœud « Message Queuing » et peut être installé plusieurs fois dans un même système DocuWare.
Le bus de messages est utilisé pour la communication entre les services frontend et une partie des services backend.
L'installation de DocuWare installe les fonctions Windows « Microsoft Message Queue » et « Multicast support ». Le multicast n'est pas pris en charge par tous les réseaux virtualisés, mais il est requis pour les installations multi-serveurs de DocuWare car les messages doivent être échangés entre les serveurs. La prise en charge du multicast n'est pas requise pour les installations sur un seul serveur.
Remarque : l'hébergement de systèmes DocuWare de test et de production dans le même VLAN/sous-réseau peut entraîner des problèmes importants, notamment avec Microsoft Message Queuing (MSMQ). MSMQ utilise une adresse IP dédiée (IP multicast), ce qui peut provoquer des conflits et des échecs de livraison de messages lorsque les deux systèmes sont actifs sur le même segment réseau. Pour éviter ces problèmes, il est recommandé de séparer les environnements DocuWare de test et de production en les plaçant sur des VLAN ou des sous-réseaux différents. Assurez-vous d'une isolation réseau appropriée pour garantir l'intégrité et le bon fonctionnement de vos systèmes DocuWare — si cette recommandation n'est pas suivie, votre installation entre dans un cas d'utilisation non pris en charge (détails dans la base de connaissances du support DocuWare).