Spécification d'un serveur REST

A propos de cette tâche

Les services externes doivent fournir des informations de connexion et d'authentification pour appeler un service sur l'hôte. Les informations de connexion, ainsi que les valeurs par défaut des informations d'authentification de base, sont définies dans un serveur. Les configurations de serveur peuvent être partagées par plusieurs services externes dans une automatisation métierou un kit d'outils. Un serveur vous permet de conserver les informations de connexion en un seul endroit de sorte que vous ne devez les mettre à jour qu'une seule fois en cas de modification. Si l'API change, mais le serveur est identique, vous pouvez redécouvrir le service sans modifier le serveur.

Lorsque vous détectez un service REST, vous pouvez choisir d'utiliser un serveur REST existant ou en créer un nouveau. Les propriétés d'hôte, de port et de serveur sécurisé sont ajoutées automatiquement si la définition Swagger les précise.

Pour modifier un serveur REST existant, procédez comme suit :

1. Sélectionnez l'onglet Serveurs dans l'éditeur Paramètres Process App . L'éditeur Paramètres de l'application de processus s'affiche lorsque vous ouvrez pour la première fois une application de processus nouvellement créée dans Business Automation Studio.
2. Sélectionnez le serveur que vous souhaitez modifier. Vous pouvez changer les propriétés de liaison.
   • Nom du serveur.
   • Description du serveur.
   • Les paramètres Par défaut sont utilisés si rien n'est précisé pour les autres environnements. Vous pouvez avoir plusieurs types d'environnement, qui sont ajoutés en cliquant sur +. Les autres types d'environnement que vous pouvez ajouter sont les suivants :
     • Développement : environnement dans lequel vous développez vos services. Il s'agit de Business Automation Studio ou d'un serveur de flux de travaux dont le type d'environnement est défini sur Développement.
     • Test : environnement dans lequel vous testez vos services.
     • Transfert : environnement dans lequel vous déployez vos services pour le test de préproduction.
     • Production : environnement dans lequel vos services sont déployés pour être utilisés par votre organisation.
   • Nom d'hôte : Nom d'hôte du serveur qui héberge le service REST. Définissez une adresse IP ou un nom d'hôte et un domaine. Par exemple : myHost.labwide.ibm.com.
   • Port: numéro de port du serveur.
   • Serveur sécurisé : cette case à cocher indique si vous voulez sécuriser le serveur, c'est-à-dire utiliser le protocole HTTPS (Hypertext Transfer Protocol Secure). Si vous sélectionnez le protocole HTTPS, assurez-vous que vous disposez du certificat de sécurité exigé par le service REST et que vous indiquez le numéro de port correct pour le serveur sécurisé.
   • Configuration SSL : Vérifiez le certificat de serveur pour le service REST que vous souhaitez appeler. Si le service externe utilise l'authentification OAuth, vérifiez le certificat du serveur pour le fournisseur OAuth.
     • Si le certificat serveur est signé par une autorité de certification publique, vous pouvez utiliser la configuration SSL préconfigurée nommée PublicInternetSSLSettings.
     • Si le certificat serveur n'est pas signé par une des autorités de certification publiques incluses dans la configuration SSL prédéfinie :
       • Un administrateur doit créer une nouvelle configuration SSL pour ce service et importer le certificat serveur dans un nouveau magasin de clés de confiance. Voir Operating cloud environments.
   • Authentification : valeurs par défaut de la méthode d'authentification de base utilisée pour appeler le service REST. Ces paramètres prennent effet lorsque aucun paramètre d'authentification de base n'est configuré dans l'onglet Liaison du service externe. Vous pouvez utiliser l'une des options suivantes :

     Aucun

     Aucune donnée d'identification n'est nécessaire.

     De base - nom d'utilisateur et mot de passe

     Authentification en utilisant le nom d'utilisateur et le mot de passe spécifiés.

     De base - données d'identification d'appel

     Authentification en utilisant l'alias d'authentification J2C qui détient le nom d'utilisateur et mot de passe.

   • Délai d'attente de demande et de réponse : durée avant la fin du délai d'attente de connexion au serveur.

     Délai d'expiration de la requête

     Durée, exprimée en millisecondes, pendant laquelle le client tente d'établir une connexion avant de subir un dépassement de délai d'attente. La valeur par défaut est 30000. Si vous choisissez Aucun , le client tente indéfiniment d'établir une connexion.

     Dépassement du délai de réponse

     Durée, exprimée en millisecondes, pendant laquelle le client attend une réponse avant de subir un dépassement de délai d'attente. La valeur par défaut est 60000. Si vous choisissez Aucun , le client attend indéfiniment.