Connecteur Microsoft Exchange

Le connecteur Microsoft Exchange vous permet d'effectuer des opérations d'insertion, de suppression, de mise à jour et de lecture sur les tables des schémas Exchange Web Services (EWS) et Microsoft Graph.

Versions compatibles

Ce connecteur est compatible avec Exchange Online.

Avant de commencer

Avant d'utiliser le connecteur Microsoft Exchange, effectuez les tâches suivantes:

  • Dans votre projet Google Cloud :
    • Vérifiez que la connectivité réseau est configurée. Pour en savoir plus sur les modèles réseau, consultez la section Connectivité réseau.
    • Attribuez le rôle IAM roles/connectors.admin à l'utilisateur qui configure le connecteur.
    • Attribuez les rôles IAM suivants au compte de service que vous souhaitez utiliser pour le connecteur :
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Un compte de service est un compte Google spécial destiné à représenter un utilisateur non humain qui doit s'authentifier et obtenir les autorisations permettant d'accéder aux données des API Google. Si vous ne possédez pas de compte de service, vous devez en créer un. Pour plus d'informations, consultez la section Créer un compte de service.

    • Activez les services suivants :
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Pour savoir comment activer des services, consultez la page Activer des services.

    Si ces services ou autorisations n'ont pas encore été activés pour votre projet, vous êtes invité à les activer lors de la configuration du connecteur.

Configurer le connecteur

Une connexion est spécifique à une source de données. Cela signifie que si vous disposez de nombreuses sources de données, vous devez créer une connexion distincte pour chacune d'elles. Pour créer une connexion, procédez comme suit:

  1. Dans la console Cloud, accédez à la page Integration Connectors > Connections (Connecteurs d'intégration > Connexions), puis sélectionnez ou créez un projet Google Cloud.

    Accéder à la page "Connexions"

  2. Cliquez sur + CRÉER pour ouvrir la page Créer une connexion.
  3. Dans la section Emplacement, choisissez l'emplacement de la connexion.
    1. Région : sélectionnez un emplacement dans la liste déroulante.

      Pour obtenir la liste de toutes les régions disponibles, consultez la page Emplacements.

    2. Cliquez sur NEXT (Suivant).
  4. Dans la section Détails de connexion, procédez comme suit :
    1. Connecteur: sélectionnez Microsoft Exchange dans la liste déroulante des connecteurs disponibles.
    2. Version du connecteur : sélectionnez la version du connecteur dans la liste déroulante des versions disponibles.
    3. Dans le champ Nom de connexion, saisissez un nom pour l'instance de connexion.

      Les noms de connexion doivent répondre aux critères suivants :

      • Les noms de connexion peuvent contenir des lettres, des chiffres ou des traits d'union.
      • Les lettres doivent être en minuscules.
      • Les noms de connexion doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
      • Les noms de connexion ne peuvent pas dépasser 49 caractères.
    4. Saisissez éventuellement une Description pour l'instance de connexion.
    5. Vous pouvez également activer Cloud Logging, puis sélectionner un niveau de journalisation. Par défaut, le niveau de journalisation est défini sur Error.
    6. Compte de service : sélectionnez un compte de service disposant des rôles requis.
    7. Vous pouvez également configurer les paramètres du nœud de connexion :

      • Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
      • Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.

      Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter plus de transactions pour une connexion, plus de nœuds sont nécessaires. À l'inverse, moins de nœuds sont nécessaires pour traiter moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez la section Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour une meilleure disponibilité) et le nombre maximal sur 50.

    8. Locataire Azure: locataire Microsoft Online à partir duquel les données sont accessibles. Si vous ne spécifiez pas de locataire, le locataire par défaut est utilisé.
    9. Schéma: sélectionnez le schéma EWS ou MSGraph. Le schéma par défaut est EWS.
    10. Vous pouvez également désactiver le filtrage côté serveur en sélectionnant Désactiver le filtrage côté serveur.
    11. Cliquez sur SUIVANT.
  5. Dans la section Destinations, sélectionnez "Adresse hôte" comme type de destination, puis spécifiez l'adresse du serveur Exchange auquel le connecteur se connecte, par exemple https://outlook.office365.com/EWS/Exchange.asmx.
  6. Cliquez sur SUIVANT.
  7. Dans la section Authentification, saisissez les informations d'authentification. Pour comprendre comment configurer ces types d'authentification, consultez la section Configurer l'authentification.

  8. Cliquez sur Next (Suivant).
  9. Vérifiez vos informations de connexion et d'authentification.
  10. Cliquez sur Créer.

Configurer l'authentification

Saisissez les informations en fonction de l'authentification par nom d'utilisateur et mot de passe.

  • Nom d'utilisateur: nom d'utilisateur du connecteur.
  • Mot de passe : Secret de Secret Manager contenant le mot de passe associé au connecteur.

Saisissez les informations en fonction de l'authentification OAuth 2.0 – Code d'autorisation.

  • ID client : ID client utilisé pour demander des jetons d'accès.
  • Champ d'application: liste des champs d'application souhaités, séparés par une virgule.
  • Code secret du client : code secret du client utilisé pour demander des jetons d'accès.
  • URL d'autorisation: URL d'autorisation générée lors de la création du client.

Étapes supplémentaires après la création de la connexion

Si vous avez sélectionné OAuth 2.0 - Authorization code pour l'authentification, vous devez effectuer les étapes supplémentaires suivantes après avoir créé la connexion:

  1. Sur la page Connexions, recherchez la connexion que vous venez de créer.

    Notez que l'état du nouveau connecteur est Autorisation requise.

  2. Cliquez sur Autorisation requise.

    Le volet Modifier l'autorisation s'affiche.

  3. Copiez la valeur de l'URI de redirection dans votre application externe.
  4. Vérifiez les informations d'autorisation.
  5. Cliquez sur Autoriser.

    Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.

Effectuer une nouvelle autorisation au code d'autorisation

Si vous utilisez le type d'authentification Authorization code et que vous avez modifié la configuration de votre application Azure Synapse, vous devez autoriser à nouveau votre connexion Azure Synapse. Pour réautoriser une connexion, procédez comme suit:

  1. Cliquez sur la connexion requise sur la page Connexions.

    La page des détails de la connexion s'ouvre.

  2. Cliquez sur Modifier pour modifier les détails de la connexion.
  3. Vérifiez les informations OAuth 2.0 – Code d'autorisation dans la section Authentification.

    Si nécessaire, apportez les modifications nécessaires.

  4. Cliquez sur Enregistrer. Vous êtes redirigé vers la page d'informations sur la connexion.
  5. Cliquez sur Modifier l'autorisation dans la section Authentification. Le volet Authorize (Autoriser) s'affiche.
  6. Cliquez sur Autoriser.

    Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.

Limites du système

Le connecteur Microsoft Exchange peut traiter quatre transactions par seconde et par nœud, et limite les transactions au-delà de cette limite. Par défaut, les connecteurs d'intégration allouent deux nœuds (pour une meilleure disponibilité) à une connexion.

Pour en savoir plus sur les limites applicables à Integration Connectors, consultez la section Limites.

Utiliser la connexion Microsoft Exchange dans une intégration

Une fois la connexion créée, elle devient disponible à la fois dans Apigee Integration et Application Integration. Vous pouvez utiliser la connexion dans une intégration via la tâche "Connecteurs".

  • Pour découvrir comment créer et utiliser la tâche Connecteurs dans Apigee Integration, consultez la section Tâche Connecteurs.
  • Pour savoir comment créer et utiliser la tâche Connecteurs dans Application Integration, consultez la section Tâche Connecteurs.

Actions

Le connecteur Microsoft Exchange fournit des actions telles que MoveItem et SendItem. Pour savoir comment configurer les actions, consultez la section Exemples d'actions.

Exemples d'actions

Cette section explique comment effectuer certaines actions dans ce connecteur.

Exemple : MoveItem

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action MoveItem, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
     {
  "ItemId":"The unique ItemId of the item to be sent"
  "ItemChangekey":"The unique ItemChangeKey of the item to be sent"
  "FolderDisplayName":"The display name of the new folder"
  }

Exemples d'opérations d'entité

Exemple : Lister tous les éléments envoyés

Cet exemple liste tous les enregistrements de l'entité SentItems.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "SentItems" dans la liste Entity.
  3. Sélectionnez l'opération LIST, puis cliquez sur OK.

Exemple : Obtenir un enregistrement spécifique de l'entité "Sentitems"

Cet exemple récupère un enregistrement dont l'ID est "568ea947-e03d-ef11-8409-7c1e5217e912" à partir de l'entité SentItems.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez SentItems dans la liste Entity.
  3. Sélectionnez l'opération GET, puis cliquez sur OK.
  4. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur entityId, puis saisissez 568ea947-e03d-ef11-8409-7c1e5217e912 dans le champ Default Value (Valeur par défaut).

    Ici, Id est la valeur de clé primaire de l'entité SentItems.

  5. Cliquez sur OK.

Obtenir de l'aide auprès de la communauté Google Cloud

Vous pouvez publier vos questions et discuter de ce connecteur sur les forums Cloud de la communauté Google Cloud.

Étape suivante