Configuration des nœuds HTTPRequest et HTTPAsyncRequest pour utiliser SSL ( HTTPS )

Configurez les nœuds HTTPRequest ou HTTPAsyncRequest pour communiquer avec d'autres applications qui utilisent HTTP via SSL.

Avant de commencer

Configuration d'une infrastructure à clés publiques (PKI) au niveau du noeud d'intégration: Configuration d'une infrastructure à clés publiques

La sécurité de ce scénario est gérée par le JRE installé sur votre machine. Pour plus d'informations, consultez les rubriques suivantes :

A propos de cette tâche

Cette rubrique décrit les étapes à suivre lors de la configuration d'un noeud HTTPRequest sur un système Windows . Les étapes que vous devez suivre sur d'autres systèmes d'exploitation sont presque identiques.

Pour permettre à un nœud HTTPRequest de communiquer via HTTP sur SSL, une application serveur HTTPS est nécessaire. Les informations fournies dans cette rubrique expliquent comment utiliser le nœud HTTPInput avec l'application serveur SSL, mais ces instructions s'appliquent également si vous utilisez une autre application serveur. Vous spécifiez le champ d'alias de clé d'authentification du client SSL approprié (Alias de clé) sur le nœud HTTPRequest ou le nœud HTTPAsyncRequest lorsque le magasin de clés du serveur contient plusieurs certificats pour le serveur.

Effectuez les sous-tâches suivantes:

Création d'un flux de messages pour effectuer des demandes à l'adresse HTTPS

A propos de cette tâche

Le flux de messages suivant permet de créer un flux de messages générique destiné à convertir un message « IBM MQ » en une requête « HTTP » :

Procédure

Créez un flux de messages avec les noeuds MQInput->HTTPRequest->Compute->MQOutput.
Dans le nœud MQInput, définissez le nom de la file d'attente sur « HTTPS.IN1 » et créez la file d'attente « IBM MQ ».
Sur le nœud MQOutput, définissez le nom de la file d'attente sur « HTTPS.OUT1 » et créez la file d'attente « IBM MQ ».
Sur le nœud HTTPRequest, définissez le service web URL pour qu'il pointe vers le serveur HTTP à appeler. Pour appeler le noeud HTTPInput , utilisez https://localhost:7083/testHTTPS.
Facultatif : dans l'onglet Propriétés des paramètres d' SSL, sélectionnez « Activer la vérification de la liste de révocation des certificats ».
Pour plus d'informations sur la vérification de la liste de révocation de certificat (CRL), voir Utilisation des listes de révocation de certificat.
Dans l'onglet Propriétés avancées du noeud HTTPRequest , définissez la propriété Response message location in tree sur OutputRoot.Objet BLOB.

Sur le noeud Compute , ajoutez le code ESQL suivant:

CREATE COMPUTE MODULE test_https_Compute
    CREATE FUNCTION Main() RETURNS BOOLEAN
    BEGIN
        -- CALL CopyMessageHeaders();
        CALL CopyEntireMessage();
        set OutputRoot.HTTPResponseHeader = null;
        RETURN TRUE;
    END;

    CREATE PROCEDURE CopyMessageHeaders() BEGIN
        DECLARE I INTEGER;
        DECLARE J INTEGER;
        SET I = 1;
        SET J = CARDINALITY(InputRoot.*[]);
        WHILE I < J DO
            SET OutputRoot.*[I] = InputRoot.*[I];
            SET I = I + 1;
        END WHILE;
    END;

    CREATE PROCEDURE CopyEntireMessage() BEGIN
        SET OutputRoot = InputRoot;
    END;
END MODULE;

Etape suivante

Le flux de messages est maintenant prêt à être déployé sur le noeud d'intégration et testé.

Test de votre exemple

A propos de cette tâche

Pour vérifier que l'exemple fonctionne, procédez comme suit:

Procédure

Suivez les instructions fournies dans la section « Configuration des nœuds HTTPInput et HTTPReply pour utiliser SSL » ( HTTPS ), y compris la mise à l'essai de l'exemple.
Déployez le flux de messages HTTPRequest .
Envoyez un message à la file d'attente IBM MQ HTTPS.IN1.
Si l'opération aboutit, un message s'affiche dans la file d'attente en sortie. Si le processus échoue, une erreur apparaît dans le journal des erreurs local (qui est le journal des événements sous Windows).