.. _infra-partners: ########### Partenaires ########### .. index:: Partenaire .. _partner-def: Définition ========== Un partenaire représente une instance Waarp R66, une application ou personne qui intervient dans les flux, que ce soit comme émetteur de fichier, comme récepteur ou comme serveur de rebond. Les types de partenaires gérés par Waarp Manager actuellement sont : - les clients et serveurs Waarp R66; - les clients et serveurs Waarp Transfer; - les instances Waarp Gateway; - les instance Waarp Gateway FTP; - les clients et serveurs FTP, HTTP et SFTP. .. _partner-list: Liste des partenaires ===================== L'index de cette section affiche la liste des partenaires définis. .. figure:: ../../_static/img/waarp_instances.png :align: center Liste des partenaires Cette liste peut être triée, en cliquant sur les en-têtes de colonnes, et filtrée. En fonction des droits de l'utilisateur, les boutons en regard de chaque ligne permettent d'accéder aux écrans suivants : - :ref:`partner-details` - :ref:`partner-edit` - :ref:`partner-delete` - :ref:`partners-passwords` .. note:: Les partenaires définis par le biais d'un référentiel externe ne peuvent pas être édités par l'interface web. Ils doivent être édités via ce référentiel. .. _partner-details: Détails d'un partenaire ======================= L'écran de visualisation des détails d'un partenaire regroupe l'ensemble des informations disponibles pour le partenaire choisi. Les informations dépendent du type du partenaire. Les propriétés communes sont les suivantes : Site Le site auquel appartient le partenaire. Un partenaire peut n'être rattaché à aucun site. Application L'application à laquelle correspond le partenaire. L'application peut être laissée vide. Au cours de la frappes, des suggestions sont faites avec les applications déjà connues dans l'application. Une des suggestions peut être choisie, ou une nouvelle application peut être saisie. Elle sera alors créée à l'enregistrement. Environnement L'environnement auquel est rattaché le partenaire. Description Une description libre. Les propriétés spécifiques à chaque type sont listées ci-dessous. Selon les droits de l'utilisateur, la description du partenaire peut être édité et les mots de passe peuvent être regénérés. Détails d'un partenaire Waarp R66 --------------------------------- Les partenaires Waarp R66 ont les propriétés spécifiques suivantes : Rôle Client et/ou serveur Identifiant R66 C'est l'identifiant interne utilisé par Waarp R66 pour gérer ses transferts en clair Identifiant R66 TLS Même chose mais pour les transferts chiffrés Adresse IP ou nom d'hôte Adresse à laquelle un partenaire Waarp R66 Serveur peut être joint, ou depuis laquelle un partenaire R66 Client provient. Si un nom d'hôte est fourni, celui-ci doit pouvoir être résolu par DNS. Hôte Le nom du serveur sur lequel le partenaire se trouve .. figure:: ../../_static/img/waarp_partner_details_r66.png :align: center Détails d'un partenaire Waarp R66 Onglet interfaces Liste des les interfaces d'un Waarp R66. .. figure:: ../../_static/img/waarp_partner_details_local_servers_r66.png :align: center Détails de l'onglet interfaces L'onglet "interfaces" correspond aux interfaces de communication d'un Waarp R66. Il est possible de créer/supprimer autant d'interfaces que l'on souhaite mais un minimum d'une interface est requis. Les protocoles possible à ajouter sont : R66(TLS). Détails d'un partenaire Waarp Gateway FTP ----------------------------------------- Les paramètres d'un partenaire Waarp Gateway FTP sont les mêmes que les paramètres des partenaires Waarp, à la différence qu'une Gateway FTP est à la fois client *et* serveur. .. figure:: ../../_static/img/waarp_partner_details_gwftp.png :align: center Détails d'un partenaire Waarp Gateway FTP Onglet interfaces Liste des interfaces d'une Gateway FTP. .. figure:: ../../_static/img/waarp_partner_details_local_servers_gwftp.png :align: center Détails de l'onglet interfaces Détails d'un partenaire Waarp Transfer ----------------------------------------- Les paramètres d'un partenaire Waarp Transfer .. figure:: ../../_static/img/waarp_partner_details_transfer.png :align: center Détails d'un partenaire Waarp Transfer Les partenaires Waarp Transfer ont les propriétés spécifiques suivantes : Onglet utilisateurs L'onglet "utilisateurs" permet à un administrateur manager d'ajouter au partenaire en question un autre utilisateur manager. Ce qui créera également un utilisateur dans votre gateway avec le même nom d'utilisateur mais avec un mot de passe générer aléatoirement. Utilisateur REST et mot de passe REST L'utilisateur REST et son mot de passe pour récuperer l'historique de transfert. C'est cet utilisateur dit "système" que manager utilise internement pour effectuer toutes les requetes REST vers votre partenaire Transfer. Détails d'un partenaire FTP --------------------------- .. figure:: ../../_static/img/waarp_partner_details_ftp.png :align: center Détails d'un partenaire FTP Les partenaires FTP ont les propriétés spécifiques suivantes : Passerelle FTP La passerelle Waarp Gateway FTP auquel le partenaire FTP est rattaché Identifiant interne Identifiant interne utilisé par Waarp Manager Si le partenaire est un client, le compte dont les accès (Identifiants et mot de passe) sont définis est créé sur la Gateway FTP de rattachement. Un client FTP pourra se connecter à la Gateway pour effectuer des transferts. Si le partenaire est un serveur, les informations à renseigner doivent être fournis par l'administrateur du partenaire. Il s'agit d'un serveur auquel la Gateway peut se connecter pour envoyer un fichier. Onglet interfaces Liste des interfaces d'un FTP .. figure:: ../../_static/img/waarp_partner_details_local_servers_ftp.png :align: center Détails de l'onglet interfaces Détails d'un partenaire HTTP ---------------------------- Les partenaires HTTP ont les propriétés spécifiques suivantes : Passerelle HTTP liée Passerelle auquel le partenaire HTTP est relié. Il s'agira d'une Waarp Gateway, vous aurez donc le choix de choisir entre plusieurs Waarp Gateway si vous en avez plusieurs de définies. TLS si le client/serveur utilise HTTPS plutôt que HTTP. .. figure:: ../../_static/img/waarp_partner_details_http.png :align: center Détails d'un partenaire HTTP Onglet interfaces L'onglet "interfaces" correspond aux interfaces de communication d'un partenaire HTTP. Il est possible de créer/supprimer autant d'interfaces que l'on souhaite mais un minimum d'une interface HTTP est requis. Les protocoles possible à ajouter sont : HTTP. .. figure:: ../../_static/img/waarp_partner_details_local_servers_http.png :align: center Détails de l'onglet interfaces Détails d'un partenaire Waarp Gateway ------------------------------------- .. figure:: ../../_static/img/waarp_partner_details_gateway.png :align: center Détails d'un partenaire Waarp Gateway Les partenaires Waarp Gateway ont les propriétés spécifiques suivantes : Utilisateur REST et mot de passe REST L'utilisateur REST et son mot de passe pour récuperer l'historique de transfert. C'est cet utilisateur dit "système" que manager utilise internement pour effectuer toutes les requetes REST vers votre partenaire Gateway. Onglet utilisateurs Liste des utilisateurs d'une Waarp Gateway ajouté via Waarp Manager. L'onglet "utilisateurs" permet à un administrateur manager d'ajouter au partenaire en question un autre utilisateur manager. Ce qui créera également un utilisateur dans votre gateway avec le même nom d'utilisateur mais avec un mot de passe générer aléatoirement. .. figure:: ../../_static/img/waarp_partner_details_users_gateway.png :align: center Détails de l'onglet utilisateurs Onglet interfaces L'onglet "interfaces" correspond aux interfaces de communication d'une Waarp Gateway. Il est possible de créer autant d'interfaces que l'on souhaite. Ils seront créer via le déploiement de configuration un à un par protocole et par priorité. Les protocoles possible à ajouter sont : R66(TLS), SFTP, HTTP(s). .. figure:: ../../_static/img/waarp_partner_details_local_servers_gateway.png :align: center Détails de l'onglet interfaces .. note:: Dans l'onglet interfaces, la priorité la plus basse correspond a l'interface prioritaire. De plus, les interfaces sont triées par ordre de priorité. .. _partner-edit: Édition d'un partenaire ======================= L'écran d'édition d'un site permet d'éditer la plupart des informations d'un partenaire. Les propriétés éditables sont les mêmes que celles présentées ci-dessus. Édition d'un partenaire Waarp R66 --------------------------------- .. figure:: ../../_static/img/waarp_partner_edit_r66.png :align: center Détails d'un partenaire Waarp R66 .. figure:: ../../_static/img/waarp_partner_edit_local_servers_r66.png :align: center Détails l'onglet interfaces L'onglet "interfaces" correspond aux interfaces de communication d'un Waarp R66. Il est possible de créer/supprimer autant d'interfaces que l'on souhaite mais un minimum d'une interface R66(TLS) est requis. Les protocoles possible à ajouter sont : R66(TLS). Édition d'un partenaire Waarp Transfer -------------------------------------- .. figure:: ../../_static/img/waarp_partner_edit_transfer.png :align: center Détails d'un partenaire Waarp Transfer Onglet utilisateurs .. figure:: ../../_static/img/waarp_partner_edit_users_transfer.png :align: center Détails de l'onglet utilisateur Utilisateur REST et mot de passe REST .. figure:: ../../_static/img/waarp_partner_edit_local_servers_transfer.png :align: center Détails de l'onglet interfaces L'onglet "interfaces" correspond aux interfaces de communication d'un Waarp R66. Il est possible de créer/supprimer autant d'interfaces que l'on souhaite mais un minimum d'une interface R66(TLS) est requis. Les protocoles possible à ajouter sont : R66(TLS). Édition d'un partenaire Waarp Gateway FTP ----------------------------------------- .. figure:: ../../_static/img/waarp_partner_edit_gwftp.png :align: center Détails d'un partenaire Waarp Gateway FTP .. figure:: ../../_static/img/waarp_partner_edit_local_servers_gwftp.png :align: center Détails l'onglet interfaces L'onglet "interfaces" correspond aux interfaces de communication d'une Gateway FTP. Il est possible de créer/supprimer autant d'interfaces que l'on souhaite mais un minimum d'une interface R66(TLS) et FTP est requis. Les protocoles possible à ajouter sont : R66(TLS) et FTP. Édition d'un partenaire FTP --------------------------- .. figure:: ../../_static/img/waarp_partner_edit_ftp.png :align: center Détails d'un partenaire FTP .. figure:: ../../_static/img/waarp_partner_edit_local_servers_ftp.png :align: center Détails l'onglet interfaces L'onglet "interfaces" correspond aux interfaces de communication d'un partenaire FTP. Il est possible de créer/supprimer autant d'interfaces que l'on souhaite mais un minimum d'une interface FTP est requis. Les protocoles possible à ajouter sont : FTP. Édition d'un partenaire HTTP ---------------------------- .. figure:: ../../_static/img/waarp_partner_edit_http.png :align: center Détails d'un partenaire HTTP .. figure:: ../../_static/img/waarp_partner_edit_local_servers_http.png :align: center Détails l'onglet interfaces L'onglet "interfaces" correspond aux interfaces de communication d'un partenaire HTTP. Il est possible de créer/supprimer autant d'interfaces que l'on souhaite mais un minimum d'une interface HTTP est requis. Les protocoles possible à ajouter sont : HTTP. Édition d'un partenaire Waarp Gateway ------------------------------------- .. figure:: ../../_static/img/waarp_partner_edit_gateway.png :align: center Détails d'un partenaire Waarp Gateway .. figure:: ../../_static/img/waarp_partner_edit_users_gateway.png :align: center Détails de l'onglet utilisateurs L'onglet "utilisateurs" permet à un administrateur Waarp Manager d'ajouter à une Waarp Gateway un utilisateur Waarp Manager. Cet utilisateur aura un mot de passe généré aléatoirement. .. figure:: ../../_static/img/waarp_partner_edit_local_servers_gateway.png :align: center Détails l'onglet interfaces L'onglet "interfaces" correspond aux interfaces de communication d'une Waarp Gateway. Il est possible de créer autant d'interfaces que l'on souhaite. Ils seront créer via le déploiement de configuration un à un par protocole et par priorité. Les protocoles possible à ajouter sont : R66(TLS), SFTP, HTTP(s). Attention, une Waarp Gateway doit avoir au moins une interface R66(TLS) .. note:: Tous les panneaux représentants les interfaces de communication de chaque partenaires peuvent s'ouvrir et se fermer pour plus de visibilité. Ils ont également trois boutons : #. la flèche du haut qui augmente la priorité #. la flèche du bas qui diminue la priorité #. la croix qui supprime l'interface en ouvrant une fenêtre de confirmation .. _partners-passwords: Régénération des mots de passe ============================== Ce bouton permet de régénérer les mots de passe des partenaires, utilisés pour la communication de pair à pair. Ce mot de passe est au format : ``[identifiant de partenaire]_[timestamp]``. L’encryptage de ces mots de passe se base sur un algorithme DES. L’emplacement de la clé DES peut être paramétré dans le fichier de configuration de Waarp Manager sous le nom de variable « DesKey ». .. important:: Les nouveaux mots de passe ne seront effectifs qu’au redéploiement de la configuration. .. _partner-delete: Suppression d'un partenaire =========================== Il y a deux manières de supprimer un partenaire : - soit par la `liste des partenaires `_ : .. figure:: ../../_static/img/waarp_partner_delete_from_list_view.png :align: center Écran de suppression d'un partenaire depuis la liste des partenaires - soit par l'écran de visualisation des `détails du partenaire `_ : .. figure:: ../../_static/img/waarp_partner_delete_from_list_view.png :align: center Écran de suppression d'un partenaire depuis le détail d'un partenaire Si les droits de l'utilisateur le permettent, le bouton de suppression permet de supprimer le partenaire. .. warning:: Un partenaire peut être supprimé s'il n'apparaît pas dans un site ou dans un flux.