Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Envoi et réception de messages AS2

Cette section décrit les processus d'envoi et de réception de messages AS2. Il fournit également des détails sur les noms de fichiers et les emplacements associés aux messages AS2.

Le tableau suivant répertorie les algorithmes de chiffrement disponibles pour les messages AS2 et indique quand vous pouvez les utiliser.

Traitement des messages AS2

Le processus entrant est défini comme un message ou un fichier en cours de transfert vers votre AWS Transfer Family serveur. La séquence des messages entrants est la suivante :

Envoi et réception de messages AS2 via HTTPS

Cette section décrit comment configurer un serveur Transfer Family qui utilise le protocole AS2 pour envoyer et recevoir des messages via HTTPS.

Envoyer des messages AS2 via HTTPS

Pour envoyer des messages AS2 via HTTPS, créez un connecteur contenant les informations suivantes :

Recevoir des messages AS2 via HTTPS

AWS Transfer Family Les serveurs AS2 ne fournissent actuellement que le transport HTTP via le port 5080. Vous pouvez toutefois mettre fin au protocole TLS sur un équilibreur de charge réseau ou d'application situé devant le point de terminaison VPC de votre serveur Transfer Family en utilisant le port et le certificat de votre choix. Avec cette approche, vous pouvez faire en sorte que les messages AS2 entrants utilisent le protocole HTTPS.

Conditions préalables

Vous pouvez configurer un équilibrage de charge réseau (NLB) ou un équilibreur de charge d'application (ALB). Le tableau suivant répertorie les avantages et les inconvénients de chaque approche.

Le tableau ci-dessous présente les différences de fonctionnalités entre l'utilisation d'un NLB et d'un ALB pour terminer le protocole TLS.

Configure NLB

Cette procédure décrit comment configurer un équilibreur de charge réseau (NLB) connecté à Internet dans votre VPC.

Pour créer un équilibreur de charge réseau et définir le point de terminaison VPC du serveur comme cible de l'équilibreur de charge

1. Ouvrez la console Amazon Elastic Compute Cloud à l'adresse https://console.aws.amazon.com/ec2/.

2. Dans le volet de navigation, choisissez Load Balancers, puis choisissez Create load balancer.

3. Sous Network Load Balancer, choisissez Créer.

4. Dans la section Configuration de base, entrez les informations suivantes :

   • Dans le champ Nom, entrez un nom descriptif pour l'équilibreur de charge.

   • Pour Scheme, choisissez Internet-facing.

   • Pour le type d'adresse IP, choisissez IPv4.

5. Dans la section Cartographie du réseau, entrez les informations suivantes :

   • Pour VPC, choisissez le cloud privé virtuel (VPC) que vous avez créé.

   • Sous Mappages, choisissez les zones de disponibilité associées aux sous-réseaux publics disponibles dans le même VPC que celui que vous utilisez avec les points de terminaison de votre serveur.

   • Pour l'adresse IPv4 de chaque sous-réseau, choisissez l'une des adresses IP Elastic que vous avez allouées.

6. Dans la section Auditeurs et routage, entrez les informations suivantes :

   • Pour Protocole, choisissez TLS.

   • Pour Port, entrez 5080.

   • Pour Action par défaut, choisissez Créer un groupe cible. Pour plus de détails sur la création d'un nouveau groupe cible, consultezPour créer un groupe cible.

   Après avoir créé un groupe cible, entrez son nom dans le champ Action par défaut.

7. Dans la section Paramètres de l'écouteur sécurisé, choisissez votre certificat dans la zone SSL/TLS Certificat par défaut.

8. Choisissez Créer un équilibreur de charge pour créer votre NLB.

9. (Facultatif, mais recommandé) Activez les journaux d'accès pour que l'équilibreur de charge réseau conserve une piste d'audit complète, comme décrit dans Journaux d'accès de votre équilibreur de charge réseau.

   Nous recommandons cette étape car la connexion TLS est interrompue au niveau du NLB. Par conséquent, l'adresse IP source qui apparaît dans vos groupes de CloudWatch journaux Transfer Family AS2 est l'adresse IP privée de la NLB, au lieu de l'adresse IP externe de votre partenaire commercial.

Configure ALB

Cette procédure décrit comment configurer un équilibreur de charge d'application (ALB) dans votre VPC.

Pour créer un équilibreur de charge d'application et définir le point de terminaison VPC du serveur comme cible de l'équilibreur de charge

1. Ouvrez la console Amazon Elastic Compute Cloud à l'adresse https://console.aws.amazon.com/ec2/.

2. Dans le volet de navigation, choisissez Load Balancers, puis choisissez Create load balancer.

3. Sous Application Load Balancer, choisissez Create (Créer).

4. Dans la console ALB, créez un nouvel écouteur HTTP sur le port 443 (HTTPS).

5. (Facultatif) Si vous souhaitez configurer l'authentification mutuelle (mTLS), configurez les paramètres de sécurité et un magasin de confiance.

   1. Joignez votre SSL/TLS certificat à l'auditeur.

   2. Sous Gestion des certificats clients, sélectionnez Authentification mutuelle (mTLS).

   3. Choisissez Verify with Trust Store.

   4. Dans Paramètres mTLS avancés, choisissez ou créez un trust store en téléchargeant vos certificats CA.

6. Créez un nouveau groupe cible et ajoutez les adresses IP privées des points de terminaison de vos serveurs Transfer Family AS2 en tant que cibles sur le port 5080. Pour plus de détails sur la création d'un nouveau groupe cible, consultezPour créer un groupe cible.

7. Configurez les contrôles de santé pour que le groupe cible utilise le protocole HTTP sur le port 5080.

8. Créez une nouvelle règle pour transférer le trafic HTTPS de l'auditeur vers le groupe cible.

9. Configurez l'écouteur pour qu'il utilise votre SSL/TLS certificat.

Une fois que vous avez configuré l'équilibreur de charge, les clients communiquent avec celui-ci via l'écouteur de port personnalisé. L'équilibreur de charge communique ensuite avec le serveur via le port 5080.

Tester l'accès au serveur à partir d'une adresse IP Elastic

Connectez-vous au serveur via le port personnalisé à l'aide d'une adresse IP Elastic ou du nom DNS du Network Load Balancer.

Transférer des fichiers à l'aide d'un connecteur AS2

Les connecteurs AS2 établissent une relation entre les partenaires commerciaux pour les transferts de messages AS2 depuis un serveur de la famille de transferts vers une destination externe appartenant au partenaire.

Vous pouvez utiliser Transfer Family pour envoyer des messages AS2 en faisant référence à l'ID du connecteur et aux chemins d'accès aux fichiers, comme illustré dans la commande start-file-transfer AWS Command Line Interface (AWS CLI) suivante :

aws transfer start-file-transfer --connector-id c-1234567890abcdef0 \
--send-file-paths "/amzn-s3-demo-source-bucket/myfile1.txt" "/amzn-s3-demo-source-bucket/myfile2.txt"

Pour obtenir les informations relatives à vos connecteurs, exécutez la commande suivante :

aws transfer list-connectors

La list-connectors commande renvoie les ID de connecteur, les URL et les noms de ressources Amazon (ARN) pour vos connecteurs.

Pour renvoyer les propriétés d'un connecteur particulier, exécutez la commande suivante avec l'ID que vous souhaitez utiliser :

aws transfer describe-connector --connector-id your-connector-id

La describe-connector commande renvoie toutes les propriétés du connecteur, notamment son URL, ses rôles, ses profils, ses notifications de disposition des messages (mDNS), ses balises et ses mesures de surveillance.

Vous pouvez vérifier que le partenaire a bien reçu les fichiers en consultant les fichiers JSON et MDN. Ces fichiers sont nommés conformément aux conventions décrites dansNoms et emplacements des fichiers. Si vous avez configuré un rôle de journalisation lors de la création du connecteur, vous pouvez également consulter vos CloudWatch journaux pour connaître l'état des messages AS2.

Pour afficher les détails du connecteur AS2, reportez-vous Afficher les détails du connecteur AS2 à. Pour plus d'informations sur la création de connecteurs AS2, consultezConfiguration des connecteurs AS2.

Le traitement AS2 prend en charge de nombreux protocoles RFC 4130, en mettant l'accent sur les cas d'utilisation courants et l'intégration avec les implémentations de serveurs existantes AS2-enabled . Pour plus de détails sur les configurations prises en charge, consultezConfigurations AS2.

Noms et emplacements des fichiers

Cette section décrit les conventions de dénomination des fichiers pour les transferts AS2.

Pour les transferts de fichiers entrants, notez les points suivants :

Pour les transferts sortants, la dénomination est similaire, à la différence qu'il n'y a pas de fichier de messages entrants et que l'ID de transfert du message transféré est ajouté au nom du fichier. L'ID de transfert est renvoyé par l'opération d'StartFileTransferAPI (ou lorsqu'un autre processus ou script appelle cette opération).

Vous pouvez également consulter les CloudWatch journaux pour consulter les détails de vos transferts, y compris ceux qui ont échoué.

Codes d’état

Le tableau suivant répertorie tous les codes d'état qui peuvent être enregistrés dans les CloudWatch journaux lorsque vous ou votre partenaire envoyez un message AS2. Les différentes étapes de traitement des messages s'appliquent à différents types de messages et sont destinées à la surveillance uniquement. Les états COMPLETED et FAILED représentent l'étape finale du traitement et sont visibles dans les fichiers JSON.

Exemples de fichiers JSON

Cette section répertorie des exemples de fichiers JSON pour les transferts entrants et sortants, y compris des exemples de fichiers pour les transferts réussis et les transferts échoués.

Exemple de fichier sortant transféré avec succès :

{
  "requester-content-type": "application/octet-stream",
  "message-subject": "File xyzTest from MyCompany_OID to partner YourCompany",
  "requester-file-name": "TestOutboundSyncMdn-9lmCr79hV.dat",
  "as2-from": "MyCompany_OID",
  "connector-id": "c-c21c63ceaaf34d99b",
  "status-code": "COMPLETED",
  "disposition": "automatic-action/MDN-sent-automatically; processed",
  "transfer-size": 3198,
  "mdn-message-id": "OPENAS2-11072022063009+0000-df865189-1450-435b-9b8d-d8bc0cee97fd@PartnerA_OID_MyCompany_OID",
  "mdn-subject": "Message be18db8-7361-42ff-8ab6-49ec1e435f34@c9c705f0baaaabaa has been accepted",
  "as2-to": "PartnerA_OID",
  "transfer-id": "dedf4601-4e90-4043-b16b-579af35e0d83",
  "file-path": "/amzn-s3-demo-bucket/as2testcell0000/openAs2/TestOutboundSyncMdn-9lmCr79hV.dat",
  "as2-message-id": "fbe18db8-7361-42ff-8ab6-49ec1e435f34@c9c705f0baaaabaa",
  "timestamp": "2022-07-11T06:30:10.791274Z"
}

Exemple de fichier sortant transféré sans succès :

{
  "failure-code": "HTTP_ERROR_RESPONSE_FROM_PARTNER",
  "status-code": "FAILED",
  "requester-content-type": "application/octet-stream",
  "subject": "Test run from Id da86e74d6e57464aae1a55b8596bad0a to partner 9f8474d7714e476e8a46ce8c93a48c6c",
  "transfer-size": 3198,
  "requester-file-name": "openAs2TestOutboundWrongAs2Ids-necco-3VYn5n8wE.dat",
  "as2-message-id": "9a9cc9ab-7893-4cb6-992a-5ed8b90775ff@718de4cec1374598",
  "failure-message": "http://Test123456789.us-east-1.elb.amazonaws.com:10080 returned status 500 for message with ID 9a9cc9ab-7893-4cb6-992a-5ed8b90775ff@718de4cec1374598",
  "transfer-id": "07bd3e07-a652-4cc6-9412-73ffdb97ab92",
  "connector-id": "c-056e15cc851f4b2e9",
  "file-path": "/amzn-s3-demo-bucket-4c1tq6ohjt9y/as2IntegCell0002/openAs2/openAs2TestOutboundWrongAs2Ids-necco-3VYn5n8wE.dat",
  "timestamp": "2022-07-11T21:17:24.802378Z"
}

Exemple de fichier entrant transféré avec succès :

{
  "requester-content-type": "application/EDI-X12",
  "subject": "File openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.dat sent from MyCompany to PartnerA",
  "client-ip": "10.0.109.105",
  "requester-file-name": "openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.dat",
  "as2-from": "MyCompany_OID",
  "status-code": "COMPLETED",
  "disposition": "automatic-action/MDN-sent-automatically; processed",
  "transfer-size": 1050,
  "mdn-subject": "Message Disposition Notification",
  "as2-message-id": "OPENAS2-11072022233606+0000-5dab0452-0ca1-4f9b-b622-fba84effff3c@MyCompany_OID_PartnerA_OID",
  "as2-to": "PartnerA_OID",
  "agreement-id": "a-f5c5cbea5f7741988",
  "file-path": "processed/openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.OPENAS2-11072022233606+0000-5dab0452-0ca1-4f9b-b622-fba84effff3c@MyCompany_OID_PartnerA_OID.dat",
  "server-id": "s-5f7422b04c2447ef9",
  "timestamp": "2022-07-11T23:36:36.105030Z"
}

Exemple de fichier entrant transféré sans succès :

{
  "failure-code": "INVALID_REQUEST",
  "status-code": "FAILED",
  "subject": "Sending a request from InboundHttpClientTests",
  "client-ip": "10.0.117.27",
  "as2-message-id": "testFailedLogs-TestRunConfig-Default-inbound-direct-integ-0c97ee55-af56-4988-b7b4-a3e0576f8f9c@necco",
  "as2-to": "0beff6af56c548f28b0e78841dce44f9",
  "failure-message": "Unsupported date format: 2022/123/456T",
  "agreement-id": "a-0ceec8ca0a3348d6a",
  "as2-from": "ab91a398aed0422d9dd1362710213880",
  "file-path": "failed/01187f15-523c-43ac-9fd6-51b5ad2b08f3.testFailedLogs-TestRunConfig-Default-inbound-direct-integ-0c97ee55-af56-4988-b7b4-a3e0576f8f9c@necco",
  "server-id": "s-0582af12e44540b9b",
  "timestamp": "2022-07-11T06:30:03.662939Z"
}