Premiers pas avec les cibles Application Integration et Apigee proxy Integration

Ce tutoriel explique comment utiliser l'assistant de proxy Apigee pour créer un proxy avec une cible d'intégration. Le proxy utilise une référence de déclencheur d'API d'une intégration existante pour lancer la séquence d'étapes dans l'intégration.

Les étapes ci-dessous décrivent comment configurer le proxy de cible d'intégration pour exécuter une intégration réussie lorsque le proxy est appelé.

Avant de commencer

Confirmez vos identifiants de connexion Apigee et les détails de votre organisation. Ces informations sont requises pour accéder à la fonctionnalité Application Integration et à l'assistant de proxy de l'UI Apigee.
Créez et publiez une intégration avec un déclencheur d'API et au moins une tâche.
- Si vous n'avez pas encore créé d'intégration utilisant un déclencheur d'API, suivez les étapes décrites dans la section Récupérer la charge utile de l'API et envoyer un e-mail.
- Notez le nom de l'intégration que vous créez ou l'intégration existante que vous souhaitez utiliser, car vous en aurez besoin ultérieurement.
Créez un compte de service Google dans le projet Google Cloud où votre organisation Apigee a été créée, puis procédez comme suit :
- Attribuez le rôle Demandeur Application Integration (roles/integrations.applicationIntegrationInvokerRole) au compte de service. Pour en savoir plus sur les rôles prédéfinis pour Application Integration, consultez la page Rôles IAM prédéfinis.
- Autorisez votre compte utilisateur (compte principal) à associer des comptes de service à des ressources grâce à l'autorisation iam.serviceAccounts.actAs. Pour en savoir plus sur les autorisations des comptes de service, consultez la page Rôles pour l'authentification du compte de service.
Vous devez fournir ce compte de service lorsque vous déployez le proxy d'API.
Si vous souhaitez utiliser Application Integration sans aucune limite, vous pouvez payer pour les intégrations. Application Integration est disponible en tant que service complémentaire pour votre abonnement. Si vous avez déjà acheté les droits Application Integration et que vous souhaitez activer ces droits pour votre projet Google Cloud ou votre organisation Apigee, contactez l'assistance Apigee. Toutefois, si vous souhaitez acheter les droits Application Integration, contactez le service commercial d'Apigee. Une fois Application Integration activé, procédez comme suit :
1. Activez les API suivantes :
  - API Apigee (apigee.googleapis.com)
  - API Application Integration (integrations.googleapis.com)
  - API Secret Manager (secretmanager.googleapis.com)
  - API Connectors (connectors.googleapis.com)
  Pour en savoir plus sur l'activation des API, consultez la page Activer des services.
2. Activez les modules complémentaires Integration et Connectors pour votre organisation Apigee.
  - Si vous créez une organisation à utiliser pour l'intégration, exécutez la commande suivante :
```
curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" -d '{"name":"${ORG_ID}", "analyticsRegion":"us-west1", "authorized_network":"${NETWORK_ID}", "runtimeType":"CLOUD", "runtimeDatabaseEncryptionKeyName":"${ENCRYPTION_KEY_NAME}", "addonsConfig": {"integrationConfig": {"enabled": true}, "connectorsPlatformConfig":{"enabled":true}}}' "https://apigee.googleapis.com/v1/organizations?parent=projects/${PROJECT_ID}"
```
  - Si vous utilisez une organisation existante, exécutez la commande suivante :
```
curl -H "Authorization: Bearer $TOKEN" -H "content-type:application/json" "https://apigee.googleapis.com/v1/organizations/${ORG_ID}:setAddons" -XPOST -d '{"addonsConfig":{"integrationConfig":{"enabled":true},"connectorsPlatformConfig":{"enabled":true}}}'
```
3. Vérifiez si les modules complémentaires sont bien activés à l'aide de la commande suivante :
```
curl -H "Authorization: Bearer $TOKEN"  -H "content-type:application/json" "https://apigee.googleapis.com/v1/organizations/${ORG_ID}"
```
  La commande doit afficher un message semblable à celui-ci :
```
{
  "name": "Test....",
  "createdAt": "1615483867669",
  "lastModifiedAt": "1615483873468",
  …...
  "addonsConfig": {
    "integrationConfig": {
      "enabled": true,
    "connectorsPlatformConfig": {
      "enabled": true
    }
  }
  }
```
  Remarque:
  - Lorsque vous exécutez une commande de module complémentaire, celle-ci écrase tous les modules complémentaires existants. Par conséquent, si vous disposez de modules complémentaires existants, incluez-les dans la commande complémentaire.
  - La désactivation d'un module complémentaire supprime toutes les configurations du module complémentaire (fonctionnalité). Par exemple, si vous désactivez le module complémentaire "Intégrations", toutes les intégrations sont supprimées.
4. Attribuez les rôles IAM suivants à votre compte de service par défaut (service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com) :
  - Demandeur Application Integration (roles/integrations.applicationIntegrationInvokerRole)
  Pour en savoir plus sur l'attribution de rôles ou d'autorisations supplémentaires à un compte de service, consultez la page Accorder, modifier et révoquer des accès.

Créer un proxy de cible Application Integration

Pour créer un proxy de cible d'intégration dans l'UI Apigee, procédez comme suit :

Accédez à l'interface utilisateur d'Apigee et connectez-vous.
Sélectionnez votre organisation dans le menu déroulant en haut à gauche de l'UI.
Dans la vue principale, cliquez sur Proxys d'API.
Vous pouvez également sélectionner Développer > Proxys d'API dans le menu de navigation de gauche.
Dans la liste déroulante Environnement, sélectionnez l'environnement dans lequel vous souhaitez créer un proxy d'API.
Cliquez sur Créer.
Sélectionnez Cible d'intégration dans la liste des types de proxys.
L'assistant de création de proxy démarre.
Sur la page de configuration Détails du proxy, fournissez les informations suivantes :
- Nom : Entrez un nom pour le proxy.
  Les noms de proxy peuvent contenir des caractères alphanumériques, des tirets et des traits de soulignement.
- Chemin de base : il est renseigné automatiquement en fonction du nom du proxy.
  Le chemin de base fait partie de l'URL utilisée pour envoyer des requêtes à votre API. Apigee utilise l'URL pour mettre en correspondance et acheminer les requêtes entrantes vers le proxy d'API approprié.
- Description (Facultatif) : saisissez une brève description du proxy.
  Par exemple, Proxy test for Application Integration.
- Région d'intégration : sélectionnez la région de l'intégration dans la liste déroulante.
- Cible d'intégration : sélectionnez le nom de la cible d'intégration dans la liste déroulante. Notez que la liste des cibles d'intégration est renseignée en fonction de la région d'intégration sélectionnée.
- Déclencheur : sélectionnez le déclencheur d'API associé à l'intégration dans la liste déroulante.
- Endpoint type (Type de point de terminaison) : sélectionnez Sync (Synchroniser).
Cliquez sur Suivant.
Sur la page de configuration Règles courantes, conservez les valeurs par défaut et cliquez sur Suivant.
Dans la page Récapitulatif, cliquez sur Créer.
Un proxy de cible d'intégration a bien été créé.

Déployez le proxy :

Pour déployer le proxy nouvellement créé, procédez comme suit :

Dans l'UI d'Apigee, sélectionnez Développer > Proxys d'API.
L'UI affiche la liste des proxys d'API et leur état de déploiement.
Dans la liste déroulante Environment (Environnement), sélectionnez l'environnement dans lequel vous souhaitez déployer le proxy d'API.
Cliquez sur le proxy récemment créé que vous souhaitez déployer. L'UI affiche la page Présentation par défaut.
Pour déployer vos modifications, cliquez d'abord sur Déployer pour afficher la boîte de dialogue Déployer.
Saisissez ce qui suit :
- Révision : numéro de révision du proxy que vous souhaitez déployer.
- Environnement : environnement dans lequel vous souhaitez déployer le proxy.
- Compte de service : compte de service créé pour le proxy.
Cliquez sur Déployer.

L'interface utilisateur lance le processus de déploiement de la révision sélectionnée. Le déploiement complet du proxy peut prendre jusqu'à une minute.

Une fois le proxy déployé, la colonne État de la section Déploiements affiche une icône verte indiquant que la révision 1 du proxy est déployée.

Remarque : Il n'y a pas d'élément Authentication explicite dans la définition de la règle Définir la requête d'intégration du proxy. Apigee ajoute automatiquement un jeton d'authentification à la requête.

Pour que la règle Définir la requête d'intégration s'authentifie correctement, vous devez déployer votre cible d'intégration avec un compte de service disposant des rôles IAM requis pour exécuter une intégration. Pour en savoir plus sur le déploiement d'un proxy d'API, consultez la section Déployer sur Apigee.

Tester le proxy de cible d'intégration

Exécutez la commande suivante à partir de la fenêtre de terminal pour appeler le proxy et déclencher l'intégration :

curl -v https://YOUR_ENV_GROUP_HOSTNAME/PROXY_NAME

où YOUR_ENV_GROUP_HOSTNAME est le nom d'hôte d'un groupe d'environnements contenant l'environnement dans lequel votre proxy est déployé.

Exemple :

curl -v https://my-org-prod.hybrid.e2e.apigeeks.net/my-proxy

Pour vérifier que l'intégration a bien été déclenché en appelant le proxy, procédez comme suit :

Ouvrez l'interface utilisateur Apigee.
Cliquez sur Développer > Intégrations.
Recherchez ou sélectionnez le nom de l'intégration créée lors des étapes ci-dessus, puis cliquez sur le nom de l'intégration.
Cliquez sur Logs (Journaux).
Vérifiez qu'un journal d'exécution existe pour l'intégration déclenchée. Pour afficher les détails du journal, cliquez sur la ligne pour développer les détails d'exécution.

Mettre à jour la charge utile de la requête de proxy (facultatif)

Pour mettre à jour la charge utile de la requête de proxy, procédez comme suit:

Dans l'UI Apigee, sélectionnez Développer > Proxys d'API dans le menu de navigation de gauche.
Cliquez sur le proxy récemment créé.
Par défaut, l'UI affiche l'onglet Présentation de ce proxy dans l'éditeur de proxy.
Cliquez sur l'onglet Développer :
Dans le volet Navigateur, sélectionnez Définir la requête d'intégration sous l'en-tête Règles.
Annulez la mise en commentaire du bloc <Parameters>, puis saisissez les détails de vos paramètres.
Pour spécifier des paramètres individuels, utilisez l'élément <Parameter>. Pour spécifier des tableaux de paramètres, utilisez l'élément <ParameterArray>.

Remarque : Le bloc Parameters n'est commenté dans ce tutoriel que pour des raisons de simplicité. Application Integration accepte un certain nombre de paramètres pouvant être transmis dans le cadre de la règle Définir la requête d'intégration. Pour en savoir plus et obtenir des exemples, consultez la page Règle SetIntegrationRequest.
Cliquez sur Enregistrer.

Étape suivante

Explorez la mise en page du concepteur d'intégrations et comprenez les différents concepts d'intégration décrits dans la page Tous les concepts.