Configurer la validation de base des demandes dans API Gateway

Pour créer une AWS CloudFormation pile

1. Ouvrez la AWS CloudFormation console à l'adresse https://console.aws.amazon.com/cloudformation.

2. Choisissez Créer une pile, puis choisissez Avec de nouvelles ressources (standard).

3. Dans Spécifier le modèle, choisissez Charger un modèle de fichier.

4. Sélectionnez le modèle que vous avez téléchargé.

5. Choisissez Suivant.

6. Pour Nom de la pile, saisissez request-validation-tutorial-console, puis choisissez Suivant.

7. Pour Configurer les options de pile, choisissez Suivant.

8. Pour les fonctionnalités, reconnaissez que AWS CloudFormation vous pouvez créer IAM des ressources dans votre compte.

9. Sélectionnez Envoyer.

Pour sélectionner votre nouvelle création API

1. Sélectionnez la pile request-validation-tutorial-console nouvellement créée.

2. Sélectionnez Ressources.

3. Sous Identifiant physique, choisissez votreAPI. Ce lien vous dirigera vers la console API Gateway.

Pour créer un modèle

1. Un modèle est requis pour utiliser la validation des demandes sur le corps d'une demande entrante. Pour créer un modèle, dans le volet de navigation principal, choisissez Modèles.

2. Sélectionnez Create model.

3. Pour Name (Nom), saisissez PetStoreModel.

4. Pour Type de contenu, entrez application/json. Si aucun type de contenu correspondant n'est trouvé, la validation de demande n'est pas effectuée. Pour utiliser le même modèle quel que soit le type de contenu, saisissez $default.

5. Pour Description, saisissez My PetStore Model comme description du modèle.

6. Pour Schéma du modèle, collez le modèle suivant dans l’éditeur de code, puis choisissez Créer.

   {
     "type" : "object",
     "required" : [ "name", "price", "type" ],
     "properties" : {
       "id" : {
         "type" : "integer"
       },
       "type" : {
         "type" : "string",
         "enum" : [ "dog", "cat", "fish" ]
       },
       "name" : {
         "type" : "string"
       },
       "price" : {
         "type" : "number",
         "minimum" : 25.0,
         "maximum" : 500.0
       }
     }
   }

Pour configurer la validation de requête pour une méthode GET

1. Dans le volet de navigation principal, choisissez Resources, puis sélectionnez la GETméthode.

2. Dans l'onglet Demande de méthode, sous Paramètres de demande de méthode, choisissez Modifier.

3. Pour Validateur de requête, sélectionnez Valider les paramètres de chaîne de requête et les en-têtes.

4. Sous Paramètres de chaîne de URL requête, procédez comme suit :

   1. Sélectionnez Add query string (Ajouter une chaîne de requêtes).

   2. Pour Name (Nom), saisissez petType.

   3. Activez Obligatoire.

   4. Maintenez Mise en cache désactivée.

5. Choisissez Enregistrer.

6. Dans l’onglet Requête d’intégration, sous Paramètres de requête d’intégration, choisissez Modifier.

7. Sous Paramètres de chaîne de URL requête, procédez comme suit :

   1. Sélectionnez Add query string (Ajouter une chaîne de requêtes).

   2. Pour Name (Nom), saisissez petType.

   3. Pour Mappage à partir de, entrez method.request.querystring.petType. Cela mappe petType au type d'animal de compagnie.

      Pour plus d'informations sur le mappage des données, consultez le didacticiel sur le mappage des données.

   4. Maintenez Mise en cache désactivée.

8. Choisissez Enregistrer.

Pour tester la validation des requêtes pour la méthode GET

1. Choisissez l’onglet Test. Vous devrez peut-être choisir la flèche droite pour afficher l'onglet.

2. Pour Chaînes de requête, saisissez petType=dog, puis choisissez Tester.

3. Le test de méthode renverra 200 OK et une liste de chiens.

   Pour obtenir des informations sur la façon de transformer ces données de sortie, consultez le didacticiel sur le mappage des données.

4. Supprimez petType=dog et choisissez Tester.

5. Le test de méthode renverra une erreur 400 avec le message d’erreur suivant :

   {
     "message": "Missing required request parameters: [petType]"
   }

Pour configurer la validation de requête pour la méthode POST

1. Dans le volet de navigation principal, choisissez Resources, puis sélectionnez la POSTméthode.

2. Dans l'onglet Demande de méthode, sous Paramètres de demande de méthode, choisissez Modifier.

3. Pour Validateur de requête, sélectionnez Valider le corps.

4. Sous Corps de la requête, choisissez Ajouter un modèle.

5. Pour Type de contenu, entrezapplication/json, puis pour Modèle, sélectionnez PetStoreModel.

6. Choisissez Enregistrer.

Pour tester la validation de requête pour une méthode POST

1. Choisissez l’onglet Test. Vous devrez peut-être choisir la flèche droite pour afficher l'onglet.

2. Sous Corps de la requête, collez ce qui suit dans l’éditeur de code :

   {
     "id": 2,
     "name": "Bella",
     "type": "dog",
     "price": 400
   }

   Sélectionnez Tester).

3. Le test de méthode renverra 200 OK et un message de réussite.

4. Sous Corps de la requête, collez ce qui suit dans l’éditeur de code :

   {
     "id": 2,
     "name": "Bella",
     "type": "dog",
     "price": 4000
   }

   Sélectionnez Tester).

5. Le test de méthode renverra une erreur 400 avec le message d’erreur suivant :

   {
    "message": "Invalid request body"
   }

   Au bas des journaux de test, la raison pour laquelle le corps de la requête est non valide est renvoyée. Dans ce cas, le prix de l'animal de compagnie était supérieur au maximum spécifié dans le modèle.

Pour supprimer une AWS CloudFormation pile

1. Ouvrez la AWS CloudFormation console à l'adresse https://console.aws.amazon.com/cloudformation.

2. Sélectionnez votre AWS CloudFormation pile.

3. Choisissez Supprimer, puis confirmez votre choix.

Pour créer une AWS CloudFormation pile

Téléchargez et décompressez le modèle de création d'application pour AWS CloudFormation.

Pour effectuer le didacticiel suivant, vous avez besoin de l'AWS Command Line Interface (AWS CLI) version 2.

Pour les commandes longues, un caractère d’échappement (\) est utilisé pour les fractionner en plusieurs lignes.

1. Utilisez la commande suivante pour créer la AWS CloudFormation pile.

   aws cloudformation create-stack --stack-name request-validation-tutorial-cli --template-body file://request-validation-tutorial-cli.zip --capabilities CAPABILITY_NAMED_IAM 

2. AWS CloudFormation fournit les ressources spécifiées dans le modèle. La fin du provisionnement de vos ressources peut prendre quelques minutes. Utilisez la commande suivante pour voir l'état de votre AWS CloudFormation pile.

   aws cloudformation describe-stacks --stack-name request-validation-tutorial-cli

3. Lorsque le statut de votre AWS CloudFormation pile est définiStackStatus: "CREATE_COMPLETE", utilisez la commande suivante pour récupérer les valeurs de sortie pertinentes pour les étapes futures.

    aws cloudformation describe-stacks --stack-name request-validation-tutorial-cli --query "Stacks[*].Outputs[*].{OutputKey: OutputKey, OutputValue: OutputValue, Description: Description}"

   Les valeurs de sortie sont les suivantes :

   • ApiId, qui est l'identifiant duAPI. Pour ce didacticiel, l'APIidentifiant estabc123.

   • ResourceId, qui est l'ID de la ressource de validation dans laquelle les POST méthodes GET et sont exposées. Pour ce didacticiel, l'ID de ressource est efg456.

Pour créer les validateurs de demandes et importer un modèle

1. Un validateur est requis pour utiliser la validation des demandes avec l'interface  AWS CLI. Utilisez la commande suivante pour créer un validateur qui valide uniquement les paramètres de demande.

   aws apigateway create-request-validator --rest-api-id abc123 \
         --no-validate-request-body \
         --validate-request-parameters \
         --name params-only

   Notez l'ID du validateur params-only.

2. Utilisez la commande suivante pour créer un validateur qui valide uniquement le corps de la demande.

   aws apigateway create-request-validator --rest-api-id abc123 \
         --validate-request-body \
         --no-validate-request-parameters \
         --name body-only

   Notez l'ID du validateur body-only.

3. Un modèle est requis pour utiliser la validation des demandes sur le corps d'une demande entrante. Utilisez la commande suivante pour importer un modèle.

   aws apigateway create-model --rest-api-id abc123 --name PetStoreModel --description 'My PetStore Model' --content-type 'application/json' --schema '{"type": "object", "required" : [ "name", "price", "type" ], "properties" : { "id" : {"type" : "integer"},"type" : {"type" : "string", "enum" : [ "dog", "cat", "fish" ]},"name" : { "type" : "string"},"price" : {"type" : "number","minimum" : 25.0, "maximum" : 500.0}}}}' 

   Si aucun type de contenu correspondant n'est trouvé, la validation de demande n'est pas effectuée. Pour utiliser le même modèle quel que soit le type de contenu, spécifiez $default comme clé.

Pour créer les méthodes GET et POST

1. Utilisez la commande suivante pour ajouter la GET HTTP méthode à la /validate ressource. Cette commande crée la méthode GET, ajoute le validateur params-only et définit la chaîne de requête petType selon les besoins.

   aws apigateway put-method --rest-api-id abc123 \
          --resource-id efg456 \
          --http-method GET \
          --authorization-type "NONE" \
          --request-validator-id aaa111 \
          --request-parameters "method.request.querystring.petType=true"

   Utilisez la commande suivante pour ajouter la POST HTTP méthode à la /validate ressource. Cette commande crée la méthode POST, ajoute le validateur body-only et attache le modèle au validateur de corps uniquement.

   aws apigateway put-method --rest-api-id abc123 \
          --resource-id efg456 \
          --http-method POST \
          --authorization-type "NONE" \
          --request-validator-id bbb222 \
          --request-models 'application/json'=PetStoreModel

2. Utilisez la commande suivante pour configurer la réponse 200 OK de la méthode GET /validate.

   aws apigateway put-method-response --rest-api-id abc123  \
               --resource-id efg456 \
               --http-method GET \
               --status-code 200

   Utilisez la commande suivante pour configurer la réponse 200 OK de la méthode POST /validate.

   aws apigateway put-method-response --rest-api-id abc123  \
               --resource-id efg456 \
               --http-method POST \
               --status-code 200

3. Utilisez la commande suivante pour configurer un Integration avec un point de HTTP terminaison spécifié pour la GET /validation méthode.

   aws apigateway put-integration --rest-api-id abc123  \
               --resource-id efg456 \
               --http-method GET \
               --type HTTP \
               --integration-http-method GET \
               --request-parameters '{"integration.request.querystring.type" : "method.request.querystring.petType"}' \
               --uri 'http://petstore-demo-endpoint.execute-api.com/petstore/pets'

   Utilisez la commande suivante pour configurer un Integration avec un point de HTTP terminaison spécifié pour la POST /validation méthode.

   aws apigateway put-integration --rest-api-id abc123  \
                 --resource-id efg456 \
                 --http-method POST \
                 --type HTTP \
                 --integration-http-method GET \
                 --uri 'http://petstore-demo-endpoint.execute-api.com/petstore/pets'

4. Utilisez la commande suivante pour configurer une réponse d'intégration pour la méthode GET /validation.

   aws apigateway put-integration-response --rest-api-id abc123 \
                 --resource-id efg456\
                 --http-method GET \
                 --status-code 200 \
                 --selection-pattern ""

   Utilisez la commande suivante pour configurer une réponse d'intégration pour la méthode POST /validation.

   aws apigateway put-integration-response --rest-api-id abc123 \
               --resource-id efg456 \
               --http-method POST \
               --status-code 200 \
               --selection-pattern ""

Pour tester le API

1. Pour tester la méthode GET qui effectuera la validation des demandes pour les chaînes de requête, utilisez la commande suivante :

   aws apigateway test-invoke-method --rest-api-id abc123 \
               --resource-id efg456 \
               --http-method GET \
               --path-with-query-string '/validate?petType=dog'

   Le résultat sera 200 OK et une liste de chiens.

2. Utilisez la commande suivante pour tester sans inclure la chaîne de requête petType.

   aws apigateway test-invoke-method --rest-api-id abc123 \
               --resource-id efg456 \
               --http-method GET

   Le résultat sera une erreur 400.

3. Pour tester la méthode POST qui effectuera la validation des demandes pour le corps de la demande, utilisez la commande suivante :

    aws apigateway test-invoke-method --rest-api-id abc123 \
               --resource-id efg456 \
               --http-method POST \
               --body '{"id": 1, "name": "bella", "type": "dog", "price" : 400 }'

   Le résultat sera 200 OK et un message de réussite.

4. Utilisez la commande suivante pour tester en utilisant un corps non valide.

    aws apigateway test-invoke-method --rest-api-id abc123 \
                 --resource-id efg456 \
                 --http-method POST \
                 --body '{"id": 1, "name": "bella", "type": "dog", "price" : 1000 }'

   Le résultat sera une erreur 400, car le prix du chien est supérieur au prix maximum défini par le modèle.

Pour supprimer une AWS CloudFormation pile

• Utilisez la commande suivante pour supprimer vos AWS CloudFormation ressources.

  aws cloudformation delete-stack  --stack-name request-validation-tutorial-cli