Conetor do Microsoft Exchange

O conetor do Microsoft Exchange permite-lhe realizar operações de inserção, eliminação, atualização e leitura em tabelas no esquema dos Serviços Web do Exchange (EWS) e do Microsoft Graph.

Versões suportadas

Este conetor suporta o Exchange Online.

Antes de começar

Antes de usar o conector do Microsoft Exchange, conclua as seguintes tarefas:

  • No seu projeto do Google Cloud:
    • Certifique-se de que a conetividade de rede está configurada. Para obter informações sobre padrões de rede, consulte o artigo Conetividade de rede.
    • Conceda a função IAM roles/connectors.admin ao utilizador que está a configurar o conetor.
    • Conceda as seguintes funções de IAM à conta de serviço que quer usar para o conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Uma conta de serviço é um tipo especial de Conta Google destinada a representar um utilizador não humano que precisa de autenticação e autorização para aceder a dados nas APIs Google. Se não tiver uma conta de serviço, tem de criar uma. O conector e a conta de serviço têm de pertencer ao mesmo projeto. Para mais informações, consulte Criar uma conta de serviço.

    • Ative os seguintes serviços:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (API Connectors)

      Para saber como ativar serviços, consulte o artigo Ativar serviços.

    Se estes serviços ou autorizações não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando configurar o conector.

Configure o conetor

Uma associação é específica de uma origem de dados. Isto significa que, se tiver muitas origens de dados, tem de criar uma associação separada para cada origem de dados. Para criar uma associação, faça o seguinte:

  1. Na Cloud Console, aceda à página Integration Connectors > Ligações e, de seguida, selecione ou crie um projeto do Google Cloud.

    Aceda à página Ligações

  2. Clique em + CRIAR NOVO para abrir a página Criar associação.
  3. Na secção Localização, escolha a localização para a ligação.
    1. Região: selecione uma localização na lista pendente.

      Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.

    2. Clique em SEGUINTE.
  4. Na secção Detalhes da associação, conclua o seguinte:
    1. Conector: selecione Microsoft Exchange na lista pendente de conectores disponíveis.
    2. Versão do conetor: selecione a versão do conetor na lista pendente de versões disponíveis.
    3. No campo Nome da ligação, introduza um nome para a instância de ligação.

      Os nomes das associações têm de cumprir os seguintes critérios:

      • Os nomes das associações podem usar letras, números ou hífenes.
      • As letras têm de ser minúsculas.
      • Os nomes das associações têm de começar com uma letra e terminar com uma letra ou um número.
      • Os nomes das associações não podem exceder 49 carateres.
    4. Opcionalmente, introduza uma Descrição para a instância de associação.
    5. Opcionalmente, ative o Registo na nuvem e, em seguida, selecione um nível de registo. Por predefinição, o nível do registo está definido como Error.
    6. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
    7. Opcionalmente, configure as definições do nó de associação:

      • Número mínimo de nós: introduza o número mínimo de nós de ligação.
      • Número máximo de nós: introduza o número máximo de nós de ligação.

      Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.

    8. Inquilino do Azure: o inquilino do Microsoft Online a partir do qual os dados são acedidos. Se não especificar um inquilino, é usado o seu inquilino predefinido.
    9. Esquema: selecione o esquema EWS ou MSGraph. O esquema predefinido é EWS.
    10. Opcionalmente, pode desativar a filtragem do lado do servidor selecionando Desativar filtragem do lado do servidor.
    11. Clique em SEGUINTE.
  5. Na secção Destinos, selecione o tipo de destino como Endereço do anfitrião e especifique o endereço do servidor do Exchange ao qual o conetor se liga, como https://outlook.office365.com/EWS/Exchange.asmx.
  6. Clique em SEGUINTE.
  7. Na secção Autenticação, introduza os detalhes de autenticação. Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.

  8. Clicar em Seguinte.
  9. Rever: reveja os detalhes da ligação e da autenticação.
  10. Clique em Criar.

Configure a autenticação

Introduza os detalhes com base na autenticação de nome de utilizador e palavra-passe

  • Nome de utilizador: nome de utilizador do conetor.
  • Palavra-passe: Secret do Secret Manager que contém a palavra-passe associada ao conector.

Introduza os detalhes com base na autenticação do código de autorização do OAuth 2.0

  • ID de cliente: o ID de cliente usado para pedir tokens de acesso.
  • Âmbito: uma lista separada por vírgulas dos âmbitos pretendidos.
  • Segredo do cliente: o segredo do cliente usado para pedir tokens de acesso.
  • URL de autorização: o URL de autorização que gera quando cria um cliente OAuth. Introduza o URL no seguinte formato: https://login.microsoftonline.com/TENANT_IDENTIFIER;/oauth2/v2.0/authorize?prompt=consent. Por exemplo, https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize?prompt=consent.

Passos adicionais após a criação da associação

Se selecionou OAuth 2.0 - Authorization code para a autenticação, tem de realizar os seguintes passos adicionais após criar a associação:

  1. Na página Ligações, encontre a ligação criada recentemente.

    Tenha em atenção que o Estado do novo conetor é Autorização necessária.

  2. Clique em Autorização obrigatória.

    É apresentado o painel Editar autorização.

  3. Copie o valor do URI de redirecionamento para a sua aplicação externa.
  4. Valide os detalhes da autorização.
  5. Clique em Autorizar.

    Se a autorização for bem-sucedida, o estado da ligação é definido como Ativo na página Ligações.

Nova autorização para o código de autorização

Se estiver a usar o tipo de autenticação Authorization code e tiver feito alterações de configuração na sua aplicação Azure Synapse, tem de voltar a autorizar a ligação do Azure Synapse. Para autorizar novamente uma associação, siga estes passos:

  1. Clique na associação necessária na página Associações.

    É apresentada a página de detalhes da associação.

  2. Clique em Editar para editar os detalhes da associação.
  3. Valide os detalhes de OAuth 2.0 – Código de autorização na secção Autenticação.

    Se necessário, faça as alterações necessárias.

  4. Clique em Guardar. Esta ação direciona para a página de detalhes da associação.
  5. Clique em Editar autorização na secção Autenticação. É apresentado o painel Autorizar.
  6. Clique em Autorizar.

    Se a autorização for bem-sucedida, o estado da ligação é definido como Ativo na página Ligações.

Limitações do sistema

O conector do Microsoft Exchange pode processar 4 transações por segundo, por nó, e limita quaisquer transações que excedam este limite. Por predefinição, os Integration Connectors atribuem 2 nós (para uma melhor disponibilidade) a uma ligação.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Use a ligação do Microsoft Exchange numa integração

Depois de criar a ligação, esta fica disponível no Apigee Integration e no Application Integration. Pode usar a ligação numa integração através da tarefa Conectores.

  • Para compreender como criar e usar a tarefa Connectors no Apigee Integration, consulte o artigo Tarefa Connectors.
  • Para compreender como criar e usar a tarefa Connectors na integração de aplicações, consulte o artigo Tarefa Connectors.

Ações

O conetor do Microsoft Exchange oferece ações, como MoveItem e SendItem. Para compreender como configurar as ações, consulte os exemplos de ações.

Exemplos de ações

Esta secção descreve como realizar algumas das ações neste conector.

Exemplo: MoveItem

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação MoveItem e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo 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"
  }

Exemplos de operações de entidades

Exemplo: listar todos os SentItems

Este exemplo apresenta todos os registos na entidade SentItems.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione SentItems na lista Entity.
  3. Selecione a operação LIST e, de seguida, clique em Concluído.

Exemplo: obtenha um registo específico da entidade Sentitems

Este exemplo obtém um registo que tem o ID "568ea947-e03d-ef11-8409-7c1e5217e912" da entidade SentItems.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione SentItems na lista Entity.
  3. Selecione a operação GET e, de seguida, clique em Concluído.
  4. Na secção Entrada de tarefas da tarefa Conectores, clique em entityId e, de seguida, introduza 568ea947-e03d-ef11-8409-7c1e5217e912 no campo Valor predefinido.

    Aqui, Id é o valor-chave principal da entidade SentItems.

  5. Clique em Concluído.

Obtenha ajuda da comunidade do Google Cloud

Pode publicar as suas perguntas e discutir este conector na comunidade do Google Cloud nos Fóruns do Cloud.

O que se segue?