Exercício: usar a API do Graph de um conector personalizado

  • 15 minutos

Neste exercício, você criará um conector personalizado e aprenderá a configurá-lo para acessar a API do Microsoft Graph usando a autenticação do Microsoft Entra ID. Como o foco está na autenticação, este exercício configurará apenas uma única ação chamada Última Utilização.

Importante

Use um ambiente de teste com o Microsoft Dataverse provisionado. Se você não tiver um, poderá se inscrever no plano da comunidade.

Tarefa 1: crie uma solução

Para criar uma solução, siga estas etapas:

  1. Vá para o Power Apps Maker Portal e verifique se está no ambiente correto.

  2. Selecione Soluções > + Nova solução.

  3. Insira Diagrama da Contoso em Nome de exibição, selecione Editor Padrão de CDS para Editor e, depois, Criar. Observação: Quando estiver trabalhando em um projeto real, é melhor criar seu próprio editor.

    Captura de tela da janela Criar nova solução.

  4. Não saia desta página depois de selecionar Criar.

Tarefa 2: use o Explorador do Graph para testar a API

Nesta tarefa, você usará o Explorador do Graph para executar uma ação da API que será configurada no conector personalizado.

  1. Em outra nova guia do navegador, vá para o Explorador do Graph.

  2. Selecione Entrar.

    Captura de tela do botão Entrar no Explorador do Graph.

  3. Faça logon com suas credenciais de usuário.

  4. Leia as permissões solicitadas e continue, se concordar.

  5. Selecione GET para o verbo, adicione /insights/used à URL e selecione Executar consulta.

    Captura de tela do menu Get, URL e botão Executar consulta.

  6. Você deverá ver um erro 403, indicando que o Explorador do Graph não tem sua permissão para executar essa ação.

  7. Selecione a guia Modificar permissões para conceder a permissão ao Explorador do Graph.

  8. Selecione Consentimento para Sites.Read.All.

  9. Leia as permissões solicitadas e continue, se concordar.

  10. Selecione Executar consulta novamente.

    Agora, você deve ver o status OK – 200.

    Captura de tela da visualização da resposta da consulta.

  11. Inicie uma nova guia de sessão do navegador.

  12. Vá para Armazenamento em Nuvem Pessoal do OneDrive e faça logon.

  13. Selecione + Novo e Documento do Word. Você está criando este documento para ter algum conteúdo em sua lista Última Utilização.

    Captura de tela do botão Criar novo documento do Word.

  14. Digite alguns textos de teste no arquivo do Word. O documento será salvo automaticamente para você.

  15. Volte para o Explorador do Graph.

  16. Execute a mesma consulta novamente.

    Agora você deve obter uma resposta com valores. Se você não vir uma resposta, volte para o documento que criou no OneDrive e faça as alterações; depois, volte e execute a consulta novamente.

  17. Selecione a resposta JSON, clique com o botão direito do mouse, selecione Copiar e salve.

    Captura de tela da resposta JSON selecionada com o recurso Copiar.

    Você precisará dessa resposta mais tarde neste exercício, pois ela será usada na configuração da resposta no conector personalizado.

Tarefa 3: registre um novo aplicativo e adicione permissões

Nesta tarefa, você configurará um novo aplicativo que será usado para acessar a API do Graph pelo conector personalizado. Você também configurará permissões para as ações específicas da API do Graph, assim como o fez ao modificar permissões no Explorador do Graph.

  1. Acesse o Microsoft Azure e faça logon com suas credenciais de usuário administrador.

  2. Selecione Mostrar menu do portal e Microsoft Entra ID.

    Captura de tela do botão de navegação Microsoft Entra ID.

  3. Selecione Registro de aplicativo > + Novo registro.

    Captura de tela do botão Criar novo registro de aplicativo.

  4. Insira Último conector usado do Learn para Nome, selecione Web, insira https://global.consent.azure-apim.net/redirect para URI de Redirecionamento e selecione Registrar.

    Captura de tela da janela Registrar um aplicativo.

  5. Selecione Permissões de API e + Adicionar uma permissão.

  6. Selecione Microsoft Graph.

  7. Selecione Permissões delegadas.

  8. Pesquise por sites e expanda Sites.

  9. Selecione Sites.Read.All, Sites.ReadWrite.All e Adicionar permissões.

    Captura de tela da janela Selecionar permissões.

  10. Agora você deve ter três permissões de API. Selecione Certificados e segredos.

    Captura de tela do menu Certificados e Segredos com três permissões de API.

  11. Selecione + Novo segredo do cliente.

    Captura de tela do botão Novo segredo do cliente.

  12. Digite Última ação usada do conector em Descrição, selecione 90 dias para Expira e, em seguida, selecione Adicionar.

  13. Copie o Valor e salve-o para mais tarde, pois ele não será mostrado novamente. Você usará esse segredo de usuário ao criar o conector.

    Captura de tela da janela Segredos do cliente.

  14. Selecione Visão Geral.

  15. Copie a ID do Aplicativo (Cliente) e salve-a no bloco de notas. Você usará essa ID do cliente ao criar o conector.

    Captura de tela da ID do Aplicativo (Cliente) com o recurso Copiar.

Tarefa 4: crie um conector personalizado

Siga estas etapas para criar um conector personalizado:

  1. Acesse o portal do administrador do Power Apps e verifique se está no ambiente correto.

  2. Selecione Soluções e, depois, a opção para abrir a solução Diagrama da Contoso criada na Tarefa 1: Criar uma solução.

  3. Selecione + Novo > Automação > Conector personalizado.

    Captura de tela do menu Novo com Conector personalizado selecionado.

  4. Insira Diagrama da Contoso em Nome do conector.

    Captura de tela do Diagrama da Contoso inserido como o nome do conector.

  5. Role para baixo, digite graph.microsoft.com em Host e /v1.0 para URL Base.

  6. Selecione Segurança.

    Captura de tela dos campos Host e URL Base com botão Segurança.

  7. Selecione OAuth 2,0 para Autenticação.

  8. Selecione Microsoft Entra ID para Provedor de Identidade.

  9. Cole a ID que você copiou do Azure no campo ID do cliente e cole o Valor copiado do Azure no campo Segredo do cliente.

  10. Digite https://graph.microsoft.com em URL do Recurso e selecione Criar conector.

    Captura de tela do botão Criar conector.

  11. Não saia desta página.

Tarefa 5: adicione a ação

Nesta tarefa, você configurará a dica de última ação usada chamada de API do Graph.

  1. Selecione Definição > + Nova ação.

    Captura de tela do botão Nova ação na janela Definição.

  2. Digite Última utilização em Resumo e LastUsed em ID da Operação.

  3. Vá para a seção Solicitação e selecione + Importar da amostra.

    Captura de tela do botão Importar da amostra na seção Solicitação.

  4. Selecione Get para o verbo, digite /me/insights/used para URL e selecione Importar.

  5. Role para baixo e selecione a resposta padrão.

    Captura de tela da resposta padrão na seção Resposta.

  6. Selecione + Importar da amostra.

    Captura de tela do botão Importar da amostra.

  7. Cole a resposta copiada do Explorador do Graph no campo Corpo e selecione Importar.

    Captura de tela da resposta no campo Corpo e do botão Importar.

  8. Selecione Atualizar conector.

  9. Não saia desta página.

Tarefa 6: teste o conector

Siga estas etapas para testar o conector:

  1. Selecione a guia Teste e, em seguida, selecione Nova conexão.

    Captura de tela do botão Nova conexão na guia Teste.

  2. Forneça as credenciais.

  3. Leia as permissões solicitadas e continue.

  4. Selecione Atualizar conexões.

  5. Selecione Testar operação.

    Captura de tela do botão Testar operação realçado.

    Você deverá ver o status 200 e a resposta deverá ser semelhante à imagem a seguir.

    Captura de tela do status 200 e do exemplo de resposta.