Azure AD (Entra ID)

O conector do Azure AD (Entra ID) permite-lhe realizar operações de inserção, eliminação, atualização e leitura no Azure Active Directory.

Antes de começar

Antes de usar o conector do Azure AD (Entra ID), faça 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.

  • Antes de criar uma ligação do Azure AD (Entra ID), crie uma aplicação no portal do Azure/Microsoft Entra ID. Para mais informações, consulte os artigos Início rápido: registe uma aplicação na plataforma de identidade da Microsoft e Registe uma aplicação cliente no Microsoft Entra ID.

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.

      As regiões suportadas para conetores incluem:

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

    2. Clicar em Seguinte.
  4. Na secção Detalhes da associação, conclua o seguinte:
    1. Conector: selecione Azure AD (Entra ID) 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. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
    6. 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.

    7. Para usar a associação para subscrições de eventos, selecione Ativar subscrição de eventos. Se selecionar esta opção, são apresentadas as seguintes opções:
      • Ativar subscrição de eventos com entidade e ações: selecione esta opção para usar a associação para a subscrição de eventos e as operações do conetor (entidades e ações).
      • Ativar apenas subscrição de eventos: selecione esta opção para usar a associação apenas para a subscrição de eventos. Se selecionar esta opção, clique em Seguinte e, de seguida, configure a subscrição de eventos.
    8. Inquilino do Azure: o inquilino online da Microsoft que está a ser usado para aceder aos dados. Se não for especificado, é usado o seu inquilino predefinido.
    9. Obter propriedades de extensão para utilizadores: determina se devem ser obtidas propriedades de extensão.
    10. Opcionalmente, clique em + Adicionar etiqueta para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
    11. Clicar em Seguinte.
  5. Na secção Autenticação, introduza os detalhes de autenticação.
    1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.

      Os seguintes tipos de autenticação são suportados pela ligação do Azure AD (Entra ID):

      • Azure AD (tipo de concessão com código de autorização)
      • Credenciais de cliente OAuth 2.0
      • Credenciais de cliente OAuth 2.0 com portador JWT

      2. Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.

    2. Clicar em Seguinte.
  6. Rever: reveja os detalhes da ligação e da autenticação.
  7. Clique em Criar.

Configure a autenticação

Introduza os detalhes com base na autenticação que quer usar.

  • Azure AD (tipo de concessão de código de autorização)
    • ID de cliente: o ID de cliente usado para pedir tokens de acesso.
    • Âmbitos: uma lista separada por vírgulas dos âmbitos pretendidos.
    • Segredo do cliente: o segredo do cliente usado para pedir tokens de acesso.
    • Versão do Secret: a versão do segredo do cliente.
    • 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.
  • Credenciais de cliente OAuth 2.0
    • ID de cliente: o ID de cliente fornecido pelo Azure AD (Entra ID) para a app que criou.
    • Segredo do cliente: segredo do Secret Manager que contém o segredo do cliente da app associada que criou.
    • Versão do Secret: a versão do segredo do cliente.
  • Credenciais de cliente OAuth 2.0 com portador JWT
    • Chave privada: segredo do Secret Manager que contém o conteúdo do ficheiro de chave privada no formato PEM. A chave privada tem de corresponder à chave pública/certificado.
    • Palavra-passe da chave privada: segredo do Secret Manager que contém a palavra-passe (frase de acesso) do ficheiro de chave privada.
    • Versão do Secret: a versão do Secret da chave privada.
    • ID de cliente: o ID de cliente usado para pedir tokens de acesso.

Exemplos de configuração de ligação

Esta secção apresenta os valores de exemplo para os vários campos que configura quando cria a associação do Azure AD (Entra ID).

Tipo de ligação do Azure AD (tipo de concessão com código de autorização)

Nome do campo Detalhes
Localização europe-west1
Conetor Azure AD (Entra ID)
Versão do conetor 1
Nome da ligação azure-ad-connection
Ative o Cloud Logging Sim
Conta de serviço XXXX@serviceaccount
Inquilino do Azure 9b25e811-f983-4982-82e4-263c1ca48112
Número mínimo de nós 2
Número máximo de nós 50
Autenticação Sim
Azure AD Sim
ID do cliente XXXX
Âmbito https://graph.microsoft.com/user.read
Segredo do cliente XXXX
Versão do Secret 1
URL de autorização https://login.microsoftonline.com/9bxxxxxxxxx8112/oauth2/v2.0/authorize?prompt=consent
Antes de especificar um valor para o campo Âmbito, certifique-se do seguinte:
  • Tem de conceder as autorizações User.Read.All e User.Write.All ao nível da associação e ao nível da app Azure.
  • Pode adicionar os âmbitos restantes ao nível do registo da app do Azure AD e também ao nível da ligação, de acordo com os seus requisitos.
  • Certifique-se de que as autorizações são adicionadas ao nível da aplicação para autorizações delegadas e de aplicação. Os seguintes âmbitos são usados frequentemente:
    • https://graph.microsoft.com/group.readwrite.all
    • https://graph.microsoft.com/groupmember.readwrite.all
    • https://graph.microsoft.com/user.read.all
    • https://graph.microsoft.com/user.read
    • https://graph.microsoft.com/directory.readwrite.all
    • https://graph.microsoft.com/RoleManagement.ReadWrite.Directory
    • https://graph.microsoft.com/directory.accessasuser.all
    • https://graph.microsoft.com/domain.readwrite.all
    • https://graph.microsoft.com/device.read.all
    • https://graph.microsoft.com/RoleManagement.Read.Directory
    • https://graph.microsoft.com/organization.Read.all
    • https://graph.microsoft.com/Application.ReadWrite.all
    • https://graph.microsoft.com/AuditLog.Read.All
    • https://graph.microsoft.com/DeviceLocalCredential.Read.All.

Tipo de ligação de credenciais de cliente OAuth 2.0

Nome do campo Detalhes
Localização us-central1
Conetor Azure AD (Entra ID)
Versão do conetor 1
Nome da ligação azure-ad-client-credentials
Ative o Cloud Logging Sim
Conta de serviço XXXX@serviceaccount
Inquilino do Azure 9b25e811-f983-4982-82e4-263c1ca48112
Número mínimo de nós 2
Número máximo de nós 50
Autenticação Sim
OAuth 2.0 – Credenciais de cliente com segredo do cliente Sim
ID do cliente XXXX
Segredo do cliente XXXX
Versão do Secret 1

Credenciais de cliente OAuth 2.0 com tipo de ligação de portador JWT

Nome do campo Detalhes
Localização europe-west1
Conetor Azure AD (Entra ID)
Versão do conetor 1
Nome da ligação azure-jwt
Ative o Cloud Logging Sim
Conta de serviço XXXX@serviceaccount
Inquilino do Azure 9b25e811-f983-4982-82e4-263c1ca48112
Número mínimo de nós 2
Número máximo de nós 50
Autenticação Sim
OAuth 2.0 – Credenciais de cliente com portador JWT Sim
Chave privada XXXX
Versão do Secret 1
ID do cliente XXXX
Quando usa as credenciais do cliente OAuth 2.0 com o tipo de ligação de portador JWT, conclua as seguintes tarefas:
  • Crie um certificado autoassinado e transfira o certificado de chave privada e a chave pública. Para mais informações, consulte o artigo Crie um certificado autossinado.
  • Carregue o certificado de chave pública na aplicação do Azure AD em Certificados e segredos.
  • Num campo de chave privada, transmita o valor do certificado de chave privada e o valor do certificado de chave pública numa única chave secreta. Não tem de criar segredos separados para as chaves privada e pública.

Para ver informações sobre como estabelecer a conetividade através do Postman, consulte o artigo Conetividade JWT através da API.

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 AD, tem de voltar a autorizar a ligação do Azure AD (Entra ID). 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.

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.

Configure a subscrição de eventos

Se ativou a subscrição de eventos, introduza os seguintes valores na secção Detalhes da subscrição de eventos:

  1. Introduza os detalhes de autenticação.
    1. ID de cliente: o ID de cliente usado para pedir tokens de acesso.
    2. Segredo do cliente: o segredo do cliente usado para pedir tokens de acesso.
    3. Versão do Secret: selecione uma versão do Secret.
    4. Estado do cliente: o segredo do Secret Manager que contém o estado do cliente. Isto é usado para a autenticação de notificações de alterações.
  2. Inquilino do Azure: o inquilino online da Microsoft que está a ser usado para aceder aos dados. Se não especificar um inquilino, é usado o seu inquilino predefinido.
  3. Opcionalmente, selecione Ativar enriquecimento de dados se quiser que sejam anexadas informações adicionais à resposta do sistema de back-end.

    As informações adicionais são específicas da entidade para a qual configurou o evento. Para mais informações, consulte o artigo Enriquecimento de dados em notificações de eventos.

  4. Selecione Ativar conetividade privada para uma conetividade segura entre a sua aplicação de back-end e a sua ligação. Se selecionar esta opção, tem de realizar passos de configuração adicionais depois de criar a associação. Para mais informações, consulte o artigo Conetividade privada para subscrição de eventos.
  5. Introduza a configuração de mensagens não entregues. Se configurar a fila de mensagens rejeitadas, a ligação escreve os eventos não processados no tópico Pub/Sub especificado. Introduza os seguintes detalhes:
    1. ID do projeto de mensagens não entregues: o ID do projeto do Google Cloud onde configurou o tópico Pub/Sub de mensagens não entregues.
    2. Tópico de mensagens não entregues: o tópico do Pub/Sub onde quer escrever os detalhes do evento não processado.
  6. Se quiser usar um proxy para estabelecer ligação ao seu back-end (para a subscrição de eventos), introduza os seguintes detalhes:
    1. Tipo de SSL do proxy: o tipo de SSL a usar quando se liga ao servidor proxy. Selecione qualquer um dos seguintes tipos de autenticação:
      • Sempre: a ligação está sempre ativada com SSL para a subscrição de eventos.
      • Nunca: a ligação não tem o SSL ativado para a subscrição de eventos.
    2. Esquema de autenticação de proxy: selecione o tipo de autenticação para autenticar com o servidor proxy. Os seguintes tipos de autenticação são suportados:
      • Básica: autenticação HTTP básica.
    3. Utilizador do proxy: introduza o nome de utilizador a usar para a autenticação junto do servidor proxy.
    4. Palavra-passe do proxy: selecione o segredo do Secret Manager da palavra-passe do utilizador.
    5. Versão do Secret: selecione a versão do Secret.
    6. Na secção Servidor proxy, introduza os detalhes do servidor proxy.
      1. Clique em + Adicionar destino e, de seguida, selecione o Tipo de destino como Endereço do anfitrião.
      2. Introduza o nome de anfitrião ou o endereço IP do servidor proxy e o número da porta do servidor proxy.

Entidades, operações e ações

Todos os conetores de integração oferecem uma camada de abstração para os objetos da aplicação ligada. Só pode aceder aos objetos de uma aplicação através desta abstração. A abstração é exposta como entidades, operações e ações.

  • Entidade: pode considerar uma entidade como um objeto ou uma coleção de propriedades na aplicação ou no serviço associado. A definição de uma entidade difere de um conetor para um conetor. Por exemplo, num conetor de base de dados, as tabelas são as entidades. Num conetor de servidor de ficheiros, as pastas são as entidades. Num conetor de sistema de mensagens, as filas são as entidades.

    No entanto, é possível que um conector não suporte ou não tenha entidades, caso em que a lista Entities estará vazia.

  • Operação: uma operação é a atividade que pode realizar numa entidade. Pode realizar qualquer uma das seguintes operações numa entidade:

    Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para a entidade. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa de conectores. No entanto, se um conector não suportar nenhuma das operações de entidades, essas operações não suportadas não são apresentadas na lista Operations.

  • Ação: uma ação é uma função de primeira classe que é disponibilizada à integração através da interface do conetor. Uma ação permite-lhe fazer alterações a uma ou mais entidades e varia de conetor para conetor. Normalmente, uma ação tem alguns parâmetros de entrada e um parâmetro de saída. No entanto, é possível que um conector não suporte nenhuma ação, caso em que a lista Actions está vazia.

Limitações do sistema

O conector do Azure AD (Entra ID) pode processar 5 transações por segundo, por nó, e limita todas as 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.

Ações

Esta secção apresenta algumas das ações suportadas pelo conetor. Para compreender como configurar as ações, consulte os exemplos de ações.

Ação AddGroupMember

Esta ação adiciona um membro a um grupo.

Parâmetros de entrada da ação AddGroupMember

Nome do parâmetro Tipo de dados Obrigatória Descrição
MemberId String Sim O identificador exclusivo do membro.
GroupId String Sim O identificador exclusivo do grupo.

Para ver um exemplo de como configurar esta ação, consulte Exemplos de ações.

Ação RemoveGroupMember

Esta ação remove um membro de um grupo.

Parâmetros de entrada da ação RemoveGroupMember

Nome do parâmetro Tipo de dados Obrigatória Descrição
MemberId String Sim O identificador exclusivo do membro.
GroupId String Sim O identificador exclusivo do grupo.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação AddGroupMember(conta de convidado)

Esta ação adiciona um membro a um grupo.

Parâmetros de entrada da ação AddGroupMember

Nome do parâmetro Tipo de dados Obrigatória Descrição
MemberId String Sim O identificador exclusivo do membro.
GroupId String Sim O identificador exclusivo do grupo.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação RemoveGroupMember (conta de convidado)

Esta ação remove um membro de um grupo

Parâmetros de entrada da ação RemoveGroupMember

Nome do parâmetro Tipo de dados Obrigatória Descrição
MemberId String Sim O identificador exclusivo do membro.
GroupId String Sim O identificador exclusivo do grupo.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação AddUserApplicationRoleAssignment

Esta ação adiciona um utilizador a uma atribuição de função da aplicação.

Introduza os parâmetros da ação AddUserApplicationRoleAssignment

Nome do parâmetro Tipo de dados Obrigatória Descrição
ResourceId String Sim O identificador exclusivo do recurso.
AppRoleId String Sim O identificador exclusivo da função da app.
Id do utilizador String Sim O identificador exclusivo do utilizador.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação RemoveUserApplicationRoleAssignment

Esta ação remove um utilizador de uma atribuição de função da aplicação.

Introduza os parâmetros da ação RemoveUserApplicationRoleAssignment

Nome do parâmetro Tipo de dados Obrigatória Descrição
AppRoleAssignmentId String Sim O identificador exclusivo da atribuição de função da app.
Id do utilizador String Sim O identificador exclusivo do utilizador.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação AddGroupApplicationRoleAssignment

Esta ação adiciona um grupo a uma atribuição de função da aplicação./p>

Parâmetros de entrada da ação AddGroupApplicationRoleAssignment

Nome do parâmetro Tipo de dados Obrigatória Descrição
ResourceId String Sim O identificador exclusivo do recurso.
AppRoleId String Sim O identificador exclusivo da função da app.
GroupId String Sim O identificador exclusivo do grupo

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação RemoveGroupApplicationRoleAssignment

Esta ação remove um grupo de uma atribuição de função da aplicação.

Introduza os parâmetros da ação RemoveGroupApplicationRoleAssignment

Nome do parâmetro Tipo de dados Obrigatória Descrição
AppRoleAssignmentId String Sim O identificador exclusivo da atribuição de função da app.
GroupId String Sim O identificador exclusivo do grupo.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação ActivateDirectoryRole

Esta ação ativa uma função de diretório.

Parâmetros de entrada da ação ActivateDirectoryRole

Nome do parâmetro Tipo de dados Obrigatória Descrição
RoleTemplateId String Sim O ID do directoryRoleTemplate no qual a função se baseia.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação VerifyDomain

Esta ação valida um domínio.

Parâmetros de entrada da ação VerifyDomain

Nome do parâmetro Tipo de dados Obrigatória Descrição
ID String Sim O ID do domínio a validar.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação ChangePassword

Esta ação altera a palavra-passe de um utilizador.

Introduza os parâmetros da ação ChangePassword

Nome do parâmetro Tipo de dados Obrigatória Descrição
NewPassword String Sim A nova palavra-passe do utilizador.
CurrentPassword String Sim A palavra-passe atual do utilizador.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação ResetPassword

Esta ação repõe a palavra-passe de um utilizador.

Introduza os parâmetros da ação ResetPassword

Nome do parâmetro Tipo de dados Obrigatória Descrição
Palavra-passe String Sim A palavra-passe enviada pelo utilizador para a repor. Se deixar em branco, é criada uma palavra-passe gerada pelo sistema.
Id do utilizador String Sim O identificador exclusivo do utilizador.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação AssignLicense

Esta ação atribui uma licença a um utilizador.

Parâmetros de entrada da ação AssignLicense

Nome do parâmetro Tipo de dados Obrigatória Descrição
UserPrincipalName String Sim O nome principal do utilizador ao qual a licença tem de ser atribuída.Não indique o nome de utilizador com o qual iniciou sessão.
Id do utilizador String Sim O ID do utilizador ao qual é preciso atribuir a licença. Não indique o nome de utilizador com o qual iniciou sessão.
AddLicenseSkuId String Sim O identificador exclusivo do SKU.
DisabledPlans String Não Uma coleção dos identificadores exclusivos separados por vírgulas dos planos que foram desativados.
RemoveLicenses String Não Uma coleção de GUIDs separados por vírgulas que identificam as licenças a remover.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação RemoveLicense

Esta ação remove a licença atribuída a um utilizador.

Parâmetros de entrada da ação RemoveLicense

Nome do parâmetro Tipo de dados Obrigatória Descrição
UserPrincipalName String Sim O nome principal do utilizador ao qual é preciso atribuir a licença. Não indique o nome de utilizador com o qual iniciou sessão.
Id do utilizador String Sim O ID do utilizador ao qual é preciso atribuir a licença. Não indique o nome de utilizador com o qual iniciou sessão.
AddLicenseSkuId String Não O identificador exclusivo do SKU.
DisabledPlans String Não Uma coleção dos identificadores exclusivos separados por vírgulas dos planos que foram desativados.
RemoveLicenses String Sim Uma coleção de GUIDs separados por vírgulas que identificam as licenças a remover.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação FetchAdditionalUserFields

Esta ação obtém campos de atributos obrigatórios.

Parâmetros de entrada da ação FetchAdditionalUserFields

Nome do parâmetro Tipo de dados Obrigatória Descrição
Id do utilizador String Sim O identificador exclusivo do utilizador.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação AddGroupOwner

Esta ação adiciona um proprietário a um grupo.

Parâmetros de entrada da ação AddGroupOwner

Nome do parâmetro Tipo de dados Obrigatória Descrição
GroupId String Sim O identificador exclusivo do grupo.
OwnerId String Sim O identificador exclusivo do proprietário.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação RemoveGroupOwner

Esta ação remove um proprietário do grupo.

Introduza os parâmetros da ação RemoveGroupOwner

Nome do parâmetro Tipo de dados Obrigatória Descrição
GroupId String Sim O identificador exclusivo do grupo.
OwnerId String Sim O identificador exclusivo do proprietário.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação InviteExternalUser

Esta ação convida um utilizador externo para a organização.

Parâmetros de entrada da ação InviteExternalUser

Nome do parâmetro Tipo de dados Obrigatória Descrição
UserEmailAddress String Sim O endereço de email do utilizador que está a convidar.
RedirectURL String Sim O URL para o qual o utilizador é redirecionado após o resgate.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação AddPhoneAuthenticationMethod

Esta ação permitia aos utilizadores realizar tarefas específicas

Parâmetros de entrada da ação AddPhoneAuthenticationMethod

Nome do parâmetro Tipo de dados Obrigatória Descrição
UserID String Sim O ID do utilizador ao qual adicionar um método de autenticação por telefone.
PhoneNumber String Sim O número de telefone do método de autenticação.
PhoneType String Sim O tipo de telemóvel do método de autenticação. Os valores possíveis são: mobile, alternateMobile e office.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação RemovePhoneAuthenticationMethod

Esta ação remove o método de autenticação por telefone de um utilizador.

Parâmetros de entrada da ação RemovePhoneAuthenticationMethod

Nome do parâmetro Tipo de dados Obrigatória Descrição
UserID String Sim O ID do utilizador para remover um método de autenticação por telefone. Não indique o nome de utilizador com o qual iniciou sessão.
ID String Sim O ID do método de telefone correspondente ao phoneType.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação UpdatePhoneAuthenticationMethod

Esta ação atualiza o método de autenticação por telefone de um utilizador.

Parâmetros de entrada da ação UpdatePhoneAuthenticationMethod

Nome do parâmetro Tipo de dados Obrigatória Descrição
UserID String Sim O ID do utilizador para atualizar um método de autenticação por telefone.
ID String Sim O ID do método de telefone correspondente ao phoneType.
PhoneNumber String Sim O número de telefone do método de autenticação.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação AddPrivilegedRole

Esta ação adiciona uma função privilegiada a um utilizador.

Introduza os parâmetros da ação AddPrivilegedRole

Nome do parâmetro Tipo de dados Obrigatória Descrição
PrincipalId String Sim Identificador do principal ao qual foi concedida a elegibilidade para a função.
RoleDefinitionId String Sim Identificador do objeto unifiedRoleDefinition que está a ser atribuído ao principal.
Justificação String Sim Uma mensagem fornecida por utilizadores e administradores.
ScheduleInfo String Sim O período de elegibilidade da função.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação RemovePrivilegedRole

Esta ação remove a função privilegiada de um utilizador.<

Parâmetros de entrada da ação RemovePrivilegedRole

Nome do parâmetro Tipo de dados Obrigatória Descrição
PrincipalId String Sim Identificador do principal ao qual foi concedida a elegibilidade para a função.
RoleDefinitionId String Sim Identificador do objeto unifiedRoleDefinition que está a ser removido do principal.
Justificação String Sim Uma mensagem fornecida por utilizadores e administradores.

Ação RetrieveUserPhoto

Esta ação obtém uma foto de um utilizador.

Parâmetros de entrada da ação RetrieveUserPhoto

Nome do parâmetro Tipo de dados Obrigatória Descrição
Id do utilizador String Sim ID do ficheiro que quer transferir.
FileLocation String Não Onde guardar o ficheiro. Especifique o caminho completo do ficheiro e o nome do ficheiro.
Codificação String Não O tipo de codificação de entrada FileData.
FileStream String Não Uma instância de uma stream de saída na qual os dados dos ficheiros são escritos. Apenas usado se FileLocation não for fornecido.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação UpdateUserPhoto

Esta ação atualiza a foto de um utilizador.

Introduza os parâmetros da ação UpdateUserPhoto

Nome do parâmetro Tipo de dados Obrigatória Descrição
LocalFile String Não Localização do ficheiro local que contém a foto a carregar. Especifique o caminho completo do ficheiro e o nome do ficheiro.
ContentStream String Não O conteúdo como InputStream a ser carregado quando localpath ou folderpath não é especificado
Id do utilizador String Sim ID do utilizador.
Conteúdo String Sim Conteúdo de fotos a carregar.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação RemoveUserPhoto

Esta ação remove a foto de um utilizador.

Parâmetros de entrada da ação RemoveUserPhoto

Nome do parâmetro Tipo de dados Obrigatória Descrição
Id do utilizador String Sim ID do utilizador.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação AssignManager

Esta ação atribui um gestor a um utilizador específico.

Parâmetros de entrada da ação AssignManager

Nome do parâmetro Tipo de dados Obrigatória Descrição
ObjectId String Sim O identificador exclusivo do objeto.
ObjectName String Sim O objeto directoryObject, user ou organizational contact a ser adicionado.
Id do utilizador String Sim O identificador exclusivo do utilizador.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação RemoveManager

Esta ação remove o gestor atribuído a um utilizador.

Parâmetros de entrada da ação RemoveManager

Nome do parâmetro Tipo de dados Obrigatória Descrição
Id do utilizador String Sim O identificador exclusivo do utilizador.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação RetrieveManagerChain

Esta ação obtém um gestor de um utilizador.

Parâmetros de entrada da ação RetrieveManagerChain

Nome do parâmetro Tipo de dados Obrigatória Descrição
Níveis String Sim O número de níveis de gestores a obter. Especifique o valor máximo para devolver todos os gestores.
Id do utilizador String Sim O ID do utilizador.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Ação AddProfileCardProperty

Esta ação adiciona uma nova ProfileCardProperty para uma organização.

Parâmetros de entrada da ação AddProfileCardProperty

Nome do parâmetro Tipo de dados Obrigatória Descrição
DirectoryPropertyName String Sim Identifica um recurso profileCardProperty.
Notas String Sim Permite a um administrador definir uma etiqueta de apresentação personalizada para a propriedade do diretório.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

A tabela seguinte indica as autorizações necessárias para realizar as operações List e Get em profilecardproperties:

Autorização Tipo
People.Read.All Aplicação
PeopleSettings.Read.All Delegada
PeopleSettings.Read.All Aplicação

A tabela seguinte indica as autorizações necessárias para realizar a ação Create em profilecardproperties:

Autorização Tipo
PeopleSettings.ReadWrite.All Aplicação
PeopleSettings.ReadWrite.All Delegada

Ação RemoveProfileCardProperty

Esta ação remove uma ProfileCardProperty de uma organização.

Parâmetros de entrada da ação RemoveProfileCardProperty

Nome do parâmetro Tipo de dados Obrigatória Descrição
DirectoryPropertyName String Sim Identifica um recurso profileCardProperty.

Para ver um exemplo de como configurar esta ação, consulte Exemplos.

Exemplos de ações

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

Exemplo: AddGroupMember

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AddGroupMember 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: 
    {
  "MemberId": "5408040c-fb7d-4c36-8b67-3b66e9edaad3",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }

    4. Esta ação devolve uma mensagem de confirmação de AddGroupMember. Se a ação for bem-sucedida, o parâmetro de resposta da AddGroupMember tarefa connectorOutputPayload tem um valor semelhante ao seguinte:

    [{
  "Success": "True"
  }]

Exemplo: RemoveGroupMember

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação RemoveGroupMember 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: 
    {
  "MemberId": "5408040c-fb7d-4c36-8b67-3b66e9edaad3",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:RemoveGroupMemberconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo: AddGroupMember(Guest Account)

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AddGroupMember 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: 
    {
  "MemberId": "735fac93-32df-45c9-b6a3-beee95270a6a",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:AddGroupMemberconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo: RemoveGroupMember(Guest Account)

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação RemoveGroupMember 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: 
    {
  "MemberId": "735fac93-32df-45c9-b6a3-beee95270a6a",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:RemoveGroupMemberconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo: AddUserApplicationRoleAssignment

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AddUserApplicationRoleAssignment 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: 
    {
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "ResourceId": "3a914726-ab97-49a0-ab7d-4f742fbc271e",
  "AppRoleId": "820afb79-d975-4da7-8f29-0e2c0cff1217"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:AddUserApplicationRoleAssignmentconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo: RemoveUserApplicationRoleAssignment

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação RemoveUserApplicationRoleAssignment 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: 
    {
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "AppRoleAssignmentId": "bspYNS4s00GoVL-SSaPJE0xC2--0GxxIu8uS4aeindU"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:RemoveUserApplicationRoleAssignmentconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo: AddGroupApplicationRoleAssignment

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AddGroupApplicationRoleAssignment 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: 
    {
  "ResourceId": "3a914726-ab97-49a0-ab7d-4f742fbc271e",
  "AppRoleId": "820afb79-d975-4da7-8f29-0e2c0cff1217",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:AddGroupApplicationRoleAssignmentconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo: RemoveGroupApplicationRoleAssignment

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação RemoveGroupApplicationRoleAssignment 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: 
    {
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
  "AppRoleAssignmentId": "p3luD3g1tEid3t7Pu3uxAMT7DwI3p29HlrxMuZ143eU"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:RemoveGroupApplicationRoleAssignmentconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo: ActivateDirectoryRole

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação ActivateDirectoryRole 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: 
     {
  "RoleTemplateId": "f023fd81-a637-4b56-95fd-791ac0226033"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:ActivateDirectoryRoleconnectorOutputPayload

    [{
  "id": "c865d9cb-57da-416c-97a3-753e733da678",
  "roleTemplateId": "f023fd81-a637-4b56-95fd-791ac0226033",
  "displayName": "Service Support Administrator",
  "description": "Can read service health information and manage support tickets."
  }]

Exemplo: VerifyDomain

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação VerifyDomain 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: 
    {
  "Id": "eternalsolarsolutions.com"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:VerifyDomainconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo: ChangePassword

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação ChangePassword 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: 
    {
  "NewPassword": "XXX@9876",
  "CurrentPassword": "XXX@123"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:ChangePasswordconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo: ResetPassword

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação ResetPassword 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: 
    {
  "Password": "XXX@9876",
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:ResetPasswordconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo: AssignLicense

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AssignLicense 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: 
    {
  "UserID": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "UserPrincipalName": "Gcp_test@z8474.onmicrosoft.com",
  "AddLicenseSkuId": "6ec92958-3cc1-49db-95bd-bc6b3798df71"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:AssignLicenseconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo – RemoveLicense

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AssignLicense 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: 
    {
  "UserID": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "UserPrincipalName": "Gcp_test@z8474.onmicrosoft.com",
  "RemoveLicenses": "6ec92958-3cc1-49db-95bd-bc6b3798df71"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:RemoveLicenseconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo: FetchAdditionalUserFields

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação FetchAdditionalUserFields 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: 
    {
  "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:FetchAdditionalUserFieldsconnectorOutputPayload

    [{
    "id": "9630c9d7-cf15-4406-8d21-598e41a058cc",
    "deleteddatetime": null,
    "accountenabled": "true",
    "agegroup": null,
    "businessphones": "",
    "city": null,
    "companyname": null,
    "consentprovidedforminor": null,
    "country": null,
    "createddatetime": "2024-04-12T10:24:42Z",
    "creationtype": null,
    "department": null,
    "displayname": "Azure_AD_Test",
    "employeehiredate": null,
    "employeeid": null,
    "employeeleavedatetime": null,
    "employeetype": null,
    "externaluserstate": null,
    "externaluserstatechangedatetime": null,
    "faxnumber": null,
    "givenname": null,
    "imaddresses": "",
    "isresourceaccount": null,
    "jobtitle": null,
    "lastpasswordchangedatetime": "2024-05-14T05:07:15Z",
    "legalagegroupclassification": null,
    "mail": null,
    "mailnickname": "Azure_AD_Test",
    "mobilephone": null,
    "officelocation": null,
    "onpremisesdistinguishedname": null,
    "onpremisesdomainname": null,
    "onpremisesimmutableid": null,
    "onpremiseslastsyncdatetime": null,
    "onpremisessamaccountname": null,
    "onpremisessecurityidentifier": null,
    "onpremisessyncenabled": null,
    "onpremisesuserprincipalname": null,
    "othermails": "",
    "passwordpolicies": null,
    "postalcode": null,
    "preferreddatalocation": null,
    "preferredlanguage": null,
    "proxyaddresses": "",
    "securityidentifier": "S-1-12-1-2519779799-1141296917-2388205965-3428360257",
    "showinaddresslist": null,
    "signinsessionsvalidfromdatetime": "2024-05-14T05:07:15Z",
    "state": null,
    "streetaddress": null,
    "surname": null,
    "usagelocation": "IN",
    "userprincipalname": "Azure_AD_Test@z8474.onmicrosoft.com",
    "usertype": "Member",
    "aboutme": null,
    "birthday": "0001-01-01T08:00:00Z",
    "hiredate": "0001-01-01T08:00:00Z",
    "interests": "",
    "mysite": null,
    "pastprojects": "",
    "preferredname": "",
    "responsibilities": "",
    "schools": "",
    "skills": "",
    "assignedlicenses": "",
    "assignedplans": "[\r\n  {\r\n    \"assignedDateTime\": \"2024-05-16T10:17:45Z\",\r\n    \"capabilityStatus\": \"Deleted\",\r\n    \"service\": \"DynamicsNAV\",\r\n    \"servicePlanId\": \"3f2afeed-6fb5-4bf9-998f-f2912133aead\"\r\n  }\r\n]",
  "authorizationinfo_certificateuserids": "",
  "identities": "[\r\n  {\r\n    \"signInType\": \"userPrincipalName\",\r\n    \"issuer\": \"z8474.onmicrosoft.com\",\r\n    \"issuerAssignedId\": \"Azure_AD_Test@z8474.onmicrosoft.com\"\r\n  }\r\n]",
  "licenseassignmentstates": "",
  "onpremisesextensionattributes_extensionattribute1": null,
  "onpremisesextensionattributes_extensionattribute2": null,
  "onpremisesextensionattributes_extensionattribute3": null,
  "onpremisesextensionattributes_extensionattribute4": null,
  "onpremisesextensionattributes_extensionattribute5": null,
  "onpremisesextensionattributes_extensionattribute6": null,
  "onpremisesextensionattributes_extensionattribute7": null,
  "onpremisesextensionattributes_extensionattribute8": null,
  "onpremisesextensionattributes_extensionattribute9": null,
  "onpremisesextensionattributes_extensionattribute10": null,
  "onpremisesextensionattributes_extensionattribute11": null,
  "onpremisesextensionattributes_extensionattribute12": null,
  "onpremisesextensionattributes_extensionattribute13": null,
  "onpremisesextensionattributes_extensionattribute14": null,
  "onpremisesextensionattributes_extensionattribute15": null,
  "onpremisesprovisioningerrors": "",
  "provisionedplans": "",
  "serviceprovisioningerrors": "",
  "customsecurityattributes": "{\r\n  \"ConnectorTesting\": {\r\n    \"@odata.type\": \"#microsoft.graph.customSecurityAttributeValue\",\r\n    \"FavouriteSport\": \"cricket\",\r\n    \"FavouriteMovie\": \"3 idiots\"\r\n  }\r\n}",
  "signinactivity_lastsignindatetime": "2024-05-14T07:04:51Z",
  "signinactivity_lastsigninrequestid": "ed35b322-d0d9-4fcb-8e71-f9ee7e065e00",
  "signinactivity_lastnoninteractivesignindatetime": "2024-05-15T09:00:02Z",
  "signinactivity_lastnoninteractivesigninrequestid": "0d4ce88b-710a-440f-a612-f590954d6800",
  "signinactivity_lastsuccessfulsignindatetime": "2024-05-15T06:45:42Z",
  "signinactivity_lastsuccessfulsigninrequestid": "64643e9d-3468-4e4d-b7c3-8bd316956600"
  }

Exemplo: AddGroupOwner

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AddGroupOwner 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: 
    {
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
  "OwnerId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta AddGroupOwnerconnectorOutputPayload da tarefa tem um valor semelhante ao seguinte:

    [{
  "Success": "True"
  }]

Exemplo: RemoveGroupOwner

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação RemoveGroupOwner 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: 
    {
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
  "OwnerId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:RemoveGroupOwnerconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo: InviteExternalUser

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação InviteExternalUser 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: 
    {
  "UserEmailAddress": "taleprajyot97@gmail.com",
  "RedirectURL": "https://www.example.com"
  }

    4. Esta ação devolve uma mensagem de confirmação de InviteExternalUser. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa InviteExternalUserconnectorOutputPayload tem um valor semelhante ao seguinte:

    [{
  "Success": "True",
  "Id": "70905aef-361f-4cb1-8d04-41f9e377ebd3",
  "ReedemURL": "https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitations.microsoft.com%2fredeem%2f%3ftenant%3d9b25e811-f983-4982-82e4-263c1ca48112%26user%3d70905aef-361f-4cb1-8d04-41f9e377ebd3%26ticket%3dx5aOZc%25252bE9XslKcOdb101qLnoe2V%25252b8%25252beeFlNhYA5WvTg%25253d%26ver%3d2.0",
  "InvitedUserId": "d5eeb199-a544-4985-b726-e3073751050c"
  }]

Exemplo – AddPhoneAuthenticationMethod

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AddPhoneAuthenticationMethod 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: 
    {
  "PhoneType": "mobile",
  "UserID": "93e42f0d-74d7-445b-b15a-dd6ceb013d81",
  "PhoneNumber": "+91 9898989890"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta AddPhoneAuthenticationMethod da tarefa connectorOutputPayload tem um valor semelhante ao seguinte:

    [{
  "Success": "True"
  }]

Exemplo: RemovePhoneAuthenticationMethod

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação RemovePhoneAuthenticationMethod 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: 
    {
  "PhoneType": "mobile",
  "UserID": "93e42f0d-74d7-445b-b15a-dd6ceb013d81",
  "PhoneNumber": "+91 9898989890"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta RemovePhoneAuthenticationMethod da tarefa connectorOutputPayload tem um valor semelhante ao seguinte:

    [{
  "Success": "True"
  }]

Exemplo: UpdatePhoneAuthenticationMethod

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação UpdatePhoneAuthenticationMethod 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: 
    {
  "securityComplianceNotificationPhones": "9899999999",
  "securityComplianceNotificationMails": "abc@gmail.com"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:UpdatePhoneAuthenticationMethodconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo: AddPrivilegedRole

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AddPrivilegedRole 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: 
    {
  "PrincipalId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "RoleDefinitionId": "729827e3-9c14-49f7-bb1b-9608f156bbb8",
  "Justification": "Add Privileged Role",
  "ScheduleInfo": "{\n\"StartDateTime\" : \"2022-09-09T21:31:27.91Z\",\n\"Expiration\"    : {\n\"Type\"        : \"Eligible\"}\n}"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:çAddPrivilegedRoleconnectorOutputPayload 

    [{
  "Success": "True"
  }]

Exemplo: RemovePrivilegedRole

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação RemovePrivilegedRole 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: 
    {
  "PrincipalId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "RoleDefinitionId": "729827e3-9c14-49f7-bb1b-9608f156bbb8",
  "Justification": "Removing Privileage Role"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:RemovePrivilegedRoleconnectorOutputPayload

    [{
  "Success": "True"
  }]

Exemplo: RetrieveUserPhoto

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação RetrieveUserPhoto 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: 
    {
  "UserId": "8e22c728-c523-436b-8f46-3b21cc1b5f80"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:RetrieveUserPhotoconnectorOutputPayload

    [{
    "Status": "Success",
    "FileData": "77+9UE5HDQoaCgAAAA1JSERSAAADUgAAAjYIBgAAAFo077+977+9AAAAAXNSR0IA77+977+9HO+/vQAAAARnQU1BAADvv73vv70L77+9YQUAAAAJcEhZcwAADu+/vQAADu+/vQHvv71v77+9ZAAA77+977+9SURBVHhe77+977+9ZXwcV9K+LWlmZCbvv71O77+977+977+9ZO+/vcmG77+9Ge+/vThmZmZm77+9OO+/vcmG77+977+9MTMzM++/vS0z77+977+977+9eu+/ve+/vXTvv71o77+9KAvvv73vv73vv71w77+9DjRO77+977+9Vl3vv70677+9KWsrR2zvv71zEe+/ve+/vUTvv73vv717KGrvv709EO+/ve+/vWjvv71RG01777+977+9Me+/ve+/vWjvv73vv719OmJLyqfZuu+/vRHvv71ZK++/vQ7Uj9iJ77+977+9du+/vUXEslrvv73vv73vv70uzbzvv70pFu+/vUrvv709Yl4P77+9eu+/vSDvv73vv71n77+977+977+9Gu+/ve+/vV3vv71sP2Vm77+977+9be+/vWbvv707RmxV77+9VFvvv70u77+9Fu+/ve+/vdqi77+9aTbvv71N77+977+9Re+/ve+/vWPvv70tYe+/vRXvv73vv70677+9bu+/vTRbS++/ve+/ve+/vWxkP1vvv71FbWt377+977+9LdW277+977+977+977+977+9ae+/ve+/vXvvv73vv73vv70Z77+9Xe+/vSLvv73vv70X77+977+9E++/vT1ob1/vv71+ae+/ve+/vWx3by1P77+9XT3vv71sL++/ve+/ve+/vWbvv73vv73vv71m77+9F+e0s2vvv712dErvv73vv73vv73vv73vv73vv71p77+977+9Le+/vW/vv73vv71oZ0vvv73vv70577+9R3tb77+92b7vv70R77+977+9KmIHKQ/vv73vv73agdapdu+/vU3vv73vv73vv73vv73vv71zXe+/ve+/ve+/ve+/ve+/vRTvv70777+977+977+96pqK77+9LO+/vXN077+9PO+/ve+/ve+/vVp2f++/vdOgNO+/ve+/veyBlO+/ve+/vQdQ77+9cO+/vTc477+9bBDvv71S77+977+977+977+9Zu+/ve+/vW8I77+977+977+9ZQ8paFnvv70LWnxwYe+/ve+/vVEWNBvvv71O77+977+9eQMKW++/vV8x77+977+9FO+/vd6k77+977+9LmHvv70eRS3erQBiG++/vXXvv71DzLI577+9LO+/vT3vv73vv71077+9Ze+/ve+/ve+/vTcebe+/vWbvv73vv71E77+9UEPvv71r77+9NMus77+9Zu+/ve+/vUVsXe+/ve+/ve+/ve+/ve+/vWZr77+9c29qRG0177+9VdWi77+977+9eu+/ve+/ve+/vUlfTe+/ve+/vW/vv73NujVTbX3vv73vv73vv73vv70V77+9He+/ve+/vXUj77+977+9AdeeMe+/ve+/ve+/ve+/ve+/ve+/vQHvv73vv70Y77+9aFcj77+9Y2Pvv700Zjtpb2vvv73vv73vv73vv73ZmHvXnHvvv70Y77+904Lvv73vv70y77+977+9EO+/ve+/vRjvv73vv71077+9dDvbs++/ve+/vXsX4bqU77+9Wu+/vVsH77+977+977+977+9P1vvv73vv70y77+9fO+/ve+/vV8pZd6rJe+/vXvvv70cy6Yef++/ve+/vWXvv71U1LJf77+9Wg3vv73vv71j1otF77+9NO+/ve+/vQTvv73vv70A77+9SO+/vWZHD++/vQ3vv71ta++/ve+/ve+/veO+rmDvv73vv73vv71c77+9cD1+77+9Hu+/ve+/vSpG77+977+9Y++/ve+/vWfvv73vv73vv70zMXvvv73vv73vv73
  ...[too long to view on UI. Please use the API to view the full content.]

Exemplo: UpdateUserPhoto

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação UpdateUserPhoto 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: 
    {
  "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc",
  "Content": "iVBORw0KGgoAAAANSUhEUgAAA1IAAAI2CAIAAADVVi6oAAAgAElEQVR4AZy9d3Rc1dX3r3POHVmWrG6ckIQHN0gCCYEkT/IkJA89lARc1Xsf1ZlR78W2iis4BFuybMAFMMW4qctFknu31XvvzTbu0tx9fmufOzMWJe+b97fWXmede2ekBYs/8sm3bJm1uLAry9jJt2jFq9Khl6XDL0vFr0ilr0pHXlMdf52ee5tdXU5b3diAN50IYHdCyYMINh1FIJpCnJmcRCGFQSqBdDNIJzhp5H4Su5FIx5PYYDzrjaVdcaxRS+qjyWWNdFlHL2jZBR27ECNdiqNX41l9HG1MYI0JtCWBtSTSjiTWnSz1pNCuZNKXKvWl0e4U0p/GhtLZcDodz2QjmWw0i42soiOZdDiDDaXToVQ6ms76k2lvEuuKZ71xbCBJ6o+nA7F0IIb260ifhg5p6EAkHdGycS0bjaJjGjYWxSY17IZOmtCQ61p6P0a6HU1vRtPbsfRePH2QQO8lkXtJdDqN4aRTfRbRryaQQ+Ucqs+mshj9GiqvocpLyKU8h0CueMwmPJtCDoE8CtlMn2cxnWsh51pCnrWca8FzzSHPAtZYyqusIdMG0s15hq2cOkdOniUnW8hxVI5V6WPpdDSd1kn3IsndKPZNOL2hZteD6HgAHfSnff6s1ZM1u9NmD9biKTW500Z3qdGDNnmxFi+pyYO2+7BWL9Lmy9q8WbuP1OHHegJZVwDr8qc9gawvkPYF0cEgOhTMhkPYcKhqIIj2BpP+IDoQQkfD2WgEG4mgY5EqPCPodS27FUfvJ5lPpVnJGVaQbS9n28o5c+V1j+rXzYWN8+RN9vCuLWyep99kL2901G+Yo19rAevw33p6vdX9XPM72Wwiiw2l0v5U1p9Ge1Kk1gRaH8dOR7Ayf/alh2qnk7RjhWrbUmnLO6p332DrX6fZr0iZL7KUF1jCn1TaP86K/P2siN9Zhj43R/1b68DfWPv+ysbrlw5uT9g6L7JducjeeZGjy6J5zo/buyxwdF9g77nIwfcJ+9Bfzo34pX3MMw4Jv7LP/K3tpj/b5L9gu/0Fq89fn130zpzyFXNOONuecZ1z0WtOnd+ctiDrjkCbwTDH4Qjrm9qf3on9yd34H02n/Jc+9TFIf1xOX6hPexwyF0Da49NJj00nPXYndt7tuB9N6hyGImx71datfrOueNHTrtKR5axkmVS2fHaN67wLvovq1c+26f7cl/zqZPbye5u99NuC4JMI2B8LFelwIodffg/qtkBzIbTthI5dvHMP7/4cp+dL3vcVH9jPBw/CUDEfKYPRMj5Wzscq+dgRPirOh5dK8VH5d04YKYVR8YOj5TBSir9kpIwPlcJwKQyXwHAJFwNDxfg4VGx6lAcP8YGHA/0H8bH/EO8Tl76DeOk7CP378Z+wfx/v3wf9+6Dva7kXT+jbB31fQe9X0P0V79mH0/0V71LmS979BXR9bjp59xe86wve+Tl07OWdnxtnL+/cCx2fKcM7PoP2T6H9Uy5OaPuEt38C7Z/wtj3Qsou37sZp2cNb9sgte3gzDjTv4U27efNO3vwxb/4Ip0lM807etBMaP4KGHdCwgzd+iO8bP+SNH0KT4aXhfcN2qC/k9dvlum1Qvw3qxGPdNj5joN74WFsw8z3eDW8KeJ34qLYA3xhHrsuH+nxel89r83ndVsPP1hZA7VbAx628Lh8atvLGfF6/Va4v4LVbceryeaPxfWM+NObzhgLegC+VAeXeUIAX/KgA3xu/gL+wYSv+lGmMH+GbpgLT4HdmPP7f780FvHnrw2nZyvHNNpyWfN4i7k3boLmAt4pp2cZbC7npbNnGWwrxo5Z8aM0X39kGbQWG6djK2/OhrYC35z+cjnxow/e8Ix/E8M4C6MjnnQUPp2sb79qGj8rZOeOufPS9E7rF
  ...[too long to view on UI. Please use the API to view the full content.]

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:UpdateUserPhotoconnectorOutputPayload

     [{
  "Status": "Success"
  }]

Exemplo: RemoveUserPhoto

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação RemoveUserPhoto 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: 
     {
  "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:RemoveUserPhotoconnectorOutputPayload

     [{
  "Status": "Success"
  }]

Exemplo: AssignManager

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AssignManager 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: 
    {
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "ObjectId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "ObjectName": "users"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:AssignManagerconnectorOutputPayload

     [{
  "Status": "True"
  }]

Exemplo: RemoveManager

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação RemoveManager 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: 
    {
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:RemoveManagerconnectorOutputPayload

     [{
  "Status": "True"
  }]

Exemplo: RetrieveManagerChain

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação RetrieveManagerChain 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: 
    {
  "UserId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "Levels": "max"
  }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:RetrieveManagerChainconnectorOutputPayload

    [{
  "id": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "displayName": "test1",
  "manager": "{\r\n  \"@odata.type\": \"#microsoft.graph.user\",\r\n  \"id\": \"9630c9d7-cf15-4406-8d21-598e41a058cc\",\r\n  \"deletedDateTime\": null,\r\n  \"accountEnabled\": true,\r\n  \"ageGroup\": null,\r\n  \"businessPhones\": [],\r\n  \"city\": null,\r\n  \"companyName\": null,\r\n  \"consentProvidedForMinor\": null,\r\n  \"country\": null,\r\n  \"createdDateTime\": \"2024-04-12T10:24:42Z\",\r\n  \"creationType\": null,\r\n  \"department\": null,\r\n  \"displayName\": \"Azure_AD_Test\",\r\n  \"employeeId\": null,\r\n  \"employeeHireDate\": null,\r\n  \"employeeLeaveDateTime\": null,\r\n  \"employeeType\": null,\r\n  \"externalUserState\": null,\r\n  \"externalUserStateChangeDateTime\": null,\r\n  \"faxNumber\": null,\r\n  \"givenName\": null,\r\n  \"isLicenseReconciliationNeeded\": false,\r\n  \"jobTitle\": null,\r\n  \"legalAgeGroupClassification\": null,\r\n  \"mail\": null,\r\n  \"mailNickname\": \"Azure_AD_Test\",\r\n  \"mobilePhone\": null,\r\n  \"onPremisesDistinguishedName\": null,\r\n  \"onPremisesDomainName\": null,\r\n  \"onPremisesImmutableId\": null,\r\n  \"onPremisesLastSyncDateTime\": null,\r\n  \"onPremisesSecurityIdentifier\": null,\r\n  \"onPremisesSamAccountName\": null,\r\n  \"onPremisesSyncEnabled\": null,\r\n  \"onPremisesUserPrincipalName\": null,\r\n  \"otherMails\": [],\r\n  \"passwordPolicies\": null,\r\n  \"officeLocation\": null,\r\n  \"postalCode\": null,\r\n  \"preferredDataLocation\": null,\r\n  \"preferredLanguage\": null,\r\n  \"proxyAddresses\": [],\r\n  \"refreshTokensValidFromDateTime\": \"2024-05-14T05:07:15Z\",\r\n  \"imAddresses\": [],\r\n  \"isResourceAccount\": null,\r\n  \"showInAddressList\": null,\r\n  \"securityIdentifier\": \"S-1-12-1-2519779799-1141296917-2388205965-3428360257\",\r\n  \"signInSessionsValidFromDateTime\": \"2024-05-14T05:07:15Z\",\r\n  \"state\": null,\r\n  \"streetAddress\": null,\r\n  \"surname\": null,\r\n  \"usageLocat
  ...[too long to view on UI. Please use the API to view the full content.]

Exemplo: AddProfileCardProperty

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação AddProfileCardProperty 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: 
     {
"Annotations": "[{"displayName": "Attributes"}]",
"DirectoryPropertyName": "CustomAttribute15"
}

    4. Se a ação for bem-sucedida, o parâmetro de resposta da AddProfileCardProperty tarefaconnectorOutputPayload tem um valor semelhante ao seguinte:

     [{
"Status": "True"
}]

Exemplo: RemoveProfileCardProperty

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação RemoveProfileCardProperty 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: 
    {
"DirectoryPropertyName": "CustomAttribute12"
}
    4. Se a ação for bem-sucedida, o parâmetro de resposta da RemoveProfileCardProperty tarefaconnectorOutputPayload tem um valor semelhante ao seguinte:

     [{
"Status": "True"
}]

Exemplos de operações de entidades

Esta secção mostra como realizar algumas das operações de entidades neste conector.

Exemplo: listar os grupos

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Grupos na lista Entity.
  3. Selecione a operação LIST e, de seguida, clique em Concluído.
  4. Na secção Task Input da tarefa Connectors, pode definir o filterClause de acordo com o requisito do cliente.

Tem de usar aspas simples (') para incluir o valor da cláusula de filtro. Pode usar a cláusula filter para filtrar registos com base nas colunas.

Também pode realizar operações LIST nas seguintes entidades:

  • Utilizador
  • GroupMembers
  • Domínios
  • RoleAssignments
  • Aplicações
  • Dispositivos
  • Contactos
  • DirectoryRoleTemplates
  • DirectoryRoles
  • AdministrativeUnits
  • SubscribedSKUs
  • PhoneAuthenticationMethod
  • Organização
  • DeviceLocalCredentials
  • ProfileCardProperties

Exemplo: obtenha um único registo do grupo

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Grupos na lista Entity.
  3. Selecione a operação GET e, de seguida, clique em Concluído.
  4. Defina o ID da entidade como "bb4756c7-38c0-426b-97aa-03b6443e7f16", que é a chave a ser transmitida. Para definir o ID da entidade, na secção Mapeador de dados do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e, em seguida, introduza "bb4756c7-38c0-426b-97aa-03b6443e7f16" no campo Valor de entrada e escolha EntityId como variável local.

Também pode realizar operações GET nas seguintes entidades:

  • Utilizador
  • GroupMembers
  • Domínios
  • RoleAssignments
  • Aplicações
  • Dispositivos
  • Contactos
  • DirectoryRoleTemplates
  • DirectoryRoles
  • AdministrativeUnits
  • PhoneAuthenticationMethod
  • Organização
  • UserManagers
  • DeviceLocalCredentials

Exemplo: elimine um registo do grupo

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Grupos na lista Entity.
  3. Selecione a operação DELETE e, de seguida, clique em Concluído.
  4. Defina o ID da entidade como "62008bbe-effa-4341-9d29-eac7f67b84fe", que é a chave a ser transmitida. Para definir o ID da entidade, na secção Mapeador de dados do Mapeamento de dados, clique em Abrir editor de mapeamento de dados e, em seguida, introduza "62008bbe-effa-4341-9d29-eac7f67b84fe" no campo Valor de entrada e escolha EntityId como variável local.

    Se estiverem presentes duas chaves compostas ou principais, a transmissão de um ID da entidade pode gerar um erro. Nesses casos, pode usar a cláusula de filtro, como id='62008bbe-effa-4341-9d29-eac7f67b84fe'.

Também pode realizar operações DELETE nas seguintes entidades:

  • Utilizador
  • Domínios
  • Aplicações
  • Dispositivos

    • Exemplo: criar uma entidade de grupo (Microsoft 365)

    1. Na caixa de diálogo Configure connector task, clique em Entities.
    2. Selecione Grupos na lista Entity.
    3. Selecione a operação Create e, de seguida, clique em Concluído.
    4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload como variável local. 
      {
"securityEnabled": true,
"displayName": "GoogleGCP",
"description": "This Group is creating for gcp testing.",
"mailEnabled": false,
"mailNickname": "GoogleGCP",
"groupTypes": "Unified"
}

      Este exemplo cria os registos de grupos. Se a integração for bem-sucedida, o parâmetro de resposta da tarefa tem um valor semelhante ao seguinte:GroupsconnectorOutputPayload

      {
"id": "30fc13b3-79b3-4ac5-a3ba-684d4e887ecc"
}

    Exemplo: atualize um utilizador

    1. Na caixa de diálogo Configure connector task, clique em Entities.
    2. Selecione Utilizadores na lista Entity.
    3. Selecione a operação Update e, de seguida, clique em Concluído.
    4. Na secção Mapeador de dados da tarefa Mapeamento de dados, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como variável local. 
      {
"jobTitle": "Software Engineer"
}
    5. Defina o ID da entidade no mapeador de dados para a entidade dos utilizadores. Para definir o ID da entidade, clique em Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input Value e escolha EntityId/ConnectorInputPayload/FilterClause como uma variável local.

      Em alternativa, em vez de especificar o entityId, também pode definir o filterClause como 7ad59ec3-1c37-4932-be51-7513fe98c3c3.

      Este exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conetor:

      {
"id": "7ad59ec3-1c37-4932-be51-7513fe98c3c3"
}

    Use a ligação do Azure AD (Entra ID) 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.

    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?