Registo de aplicações do Microsoft Graph Data Connect

Este artigo fornece orientações de melhores práticas para utilizar a experiência de portal do Azure para registar uma aplicação Microsoft Entra com o Microsoft Graph Data Connect.

portal do Azure experiência

Na experiência portal do Azure, os programadores e administradores globais inquilinos podem rever todas as aplicações registadas, autorizar aplicações e gerir registos de aplicações.

Página de aterrissagem

Importante

Se o Microsoft Graph Data Connect não tiver sido ativado pelo seu administrador, a experiência do portal será desativada. Para obter detalhes sobre como os Administradores Globais podem ativar o Data Connect, consulte Ativar o Microsoft Graph Data Connect no seu inquilino do Microsoft 365

O primeiro ecrã da experiência de portal do Azure pede-lhe para registar a sua primeira aplicação com o Data Connect ou carregar os registos existentes para uma vista de tabela de resumo.

Captura de ecrã a mostrar a página de destino da experiência de portal do Azure.

A tabela inclui os seguintes campos de coluna:

  • Nome: o nome do registo da aplicação.
  • ID da Aplicação: o ID da aplicação Microsoft Entra.
  • Registado Em: a data em que a aplicação foi registada.
  • Programador: o programador que registou a aplicação.
  • Multi-inquilino: se a aplicação é multi-inquilino ou inquilino único.
  • Última modificação: a data mais recente em que a aplicação foi alterada.

Na parte superior da tabela, estão ativados três botões por predefinição: Adicionar, Atualizar e Eliminar. Adicionar inicia uma ação para um novo registo de aplicação. Atualize novamente as consultas de registos de aplicações existentes no inquilino e atualize a tabela. A opção Eliminar só está ativada para seleções individuais e inicia um processo de eliminação.

Registar uma nova aplicação

Ao adicionar um novo registo de aplicação com o Data Connect, siga o assistente de adição para concluir os detalhes necessários nos seguintes separadores: Informações de Registo, Conjuntos de Dados e Rever + criar.

Página Informações de Registo

A página Informações de Registo descreve os requisitos padrão para registos de aplicações. O registo de aplicações requer que selecione entradas que afetem os comportamentos predefinidos, como os seguintes campos:

  • ID da Aplicação (obrigatório): selecione a partir de Microsoft Entra aplicações no inquilino ou crie uma nova.
  • Descrição (obrigatório): forneça detalhes no campo de texto para o registo de aplicações, como o objetivo do projeto, o identificador exclusivo e o nome do projeto da organização.
  • Tipo de Publicação (obrigatório): selecione a partir de campos multi-inquilino ou de inquilino único.
  • Key Vault (obrigatório apenas para registos de aplicações multi-inquilino): especifique o cofre de chaves que permite a comunicação entre inquilinos.
  • Tipo de Computação (obrigatório): selecione a oferta de produto do Azure para esta aplicação.
  • Tipo de Atividade (obrigatório): selecione a atividade Data Factory/Synapse/Fabric utilizada para copiar os dados.

Em seguida, especifique os detalhes do projeto : um processo semelhante à criação de um recurso no Azure. Seguem-se os campos de detalhes do projeto:

  • Subscrição (obrigatório): selecione uma subscrição no inquilino que é utilizada exclusivamente para filtrar as quatro secções seguintes relacionadas com a configuração de destino de dados.

  • Grupo de Recursos (obrigatório): selecione a localização do grupo para o armazenamento de dados.

  • Tipo de Destino: selecione o tipo de armazenamento na Conta de Armazenamento do Azure ou SQL do Azure Servidor de Base de Dados.

    Nota: Se selecionar Banco de Dados SQL Server, a aplicação só suporta Mapping Data Flows tipos. Para obter mais informações, veja Mapping Data Flows in Azure Data Factory (Mapear Fluxos de Dados no Azure Data Factory).

  • Conta de Armazenamento (obrigatório): selecione a conta de armazenamento onde estão localizados os dados a aprovisionar com o Data Connect ou crie uma nova Conta de Armazenamento do Azure.

  • URI da Conta de Armazenamento (obrigatório): na conta de armazenamento que selecionou, selecione o URI a utilizar (Sistema de Ficheiros Distribuído (DFS) ou blob).

Observação

O serviço ligado que criar durante a configuração do pipeline deve estar alinhado com o que selecionou nos passos anteriores na página Informações de Registo. Se escolher DFS, utilize um serviço ligado Azure Data Lake Storage Gen2 e, se escolher blob, utilize Armazenamento de Blobs do Azure Serviço Ligado.

Se selecionar SQL para Conta de Armazenamento, o campo de detalhes do projeto Uri será desativado.

Captura de ecrã da página de registo para adicionar aplicações no Data Connect, incluindo campos relacionados com as secções Detalhes do Projeto e Detalhes da Instância.

Observação

Se selecionar o Microsoft Fabric como o Tipo de Computação, a aplicação só suporta o tipo Atividade de Cópia.

Captura de ecrã da página de registo para adicionar aplicações no Data Connect, incluindo campos relacionados com o Lakehouse e a respetiva área de trabalho.

Observação

Se selecionar o Microsoft Fabric como o tipo de computação, terá de registar um fornecedor de recursos Microsoft.GraphServices para a subscrição do Azure selecionada. A subscrição e o grupo de recursos selecionados são utilizados para faturação. Para obter mais informações, veja Fornecedores e tipos de recursos do Azure.

Conjuntos de dados

Depois de concluir a página Informações de Registo , especifique os conjuntos de dados que o registo de aplicações precisa de consultar. Este passo é crucial para a autorização. Apenas os conjuntos de dados que selecionar são transferidos para autorização de administrador. Para obter mais informações sobre conjuntos de dados, veja Conjuntos de dados, regiões e sinks.

O assistente mostra uma tabela que permite a entrada de vários conjuntos de dados, a seleção de colunas nos conjuntos de dados e mais detalhes, se aplicável, como opções de âmbito e âmbito. Pode selecionar cada conjunto de dados que a aplicação pedir autorização e todas ou várias colunas do conjunto de dados, consoante o nível de granularidade e privacidade necessários.

Captura de ecrã que mostra a coluna Conjuntos de dados selecionada durante o funcionamento do assistente de registo de aplicações do Data Connect.

Seleção de âmbito

Pode configurar o âmbito para cada conjunto de dados de três formas:

  • Todas as informações: a opção predefinida. Se deixar o campo em branco, todo o âmbito do conjunto de dados será registado.
  • Selecionar utilizadores ou grupos na organização: introduza os IDs de objeto dos utilizadores ou grupos separados por vírgulas. Saiba mais sobre Microsoft Entra grupos.
  • Predicados específicos: utilize o mecanismo de filtragem semelhante ao das APIs do Microsoft Graph para especificar um âmbito numa coluna do conjunto de dados. Saiba mais sobre a seleção de utilizadores.

Para obter mais informações sobre âmbitos, veja Capacidades de seleção e filtragem de utilizadores no Microsoft Graph Data Connect.

Quando tiver terminado, selecione Seguinte: Rever + criar.

Observação

Se faltam informações nos campos necessários nos separadores anteriores, o botão Seguinte: Rever + criar está desativado.

Rever + criar

O último passo do assistente mostra uma página de resumo para rever os detalhes especificados e confirmar a criação da entrada de registo de aplicações.

Gráfico a mostrar a seleção de conjuntos de dados para o registo de aplicações durante a execução do assistente de registo de aplicações do Data Connect.

Observação

Se tiver selecionado anteriormente o Microsoft Fabric como o tipo de computação, um recurso com o tipo Microsoft.GraphServices e o nome mgdc-your_app_id<> é registado na subscrição e no grupo de recursos selecionados. Este recurso é utilizado para faturação. Para obter mais informações sobre como ativar o fornecedor de recursos Microsoft.GraphServices , veja Fornecedores e tipos de recursos do Azure.

Ver detalhes do registo de aplicações

Depois de criar a entrada de registo de aplicações, para ver os detalhes que especificou, selecione o nome da aplicação na página de destino. Todos os detalhes especificados na criação são apresentados.

Captura de ecrã a mostrar a página de detalhes do registo de aplicações.

Atualizar entrada de registo de aplicações

Aceder à funcionalidade de atualização a partir da página de descrição geral da aplicação individual. O proprietário da aplicação ou o Administrador Global podem atualizar propriedades ou conjuntos de dados associados a uma aplicação do Data Connect. Conforme mostrado nas imagens seguintes, quaisquer atualizações ao armazenamento de destino da aplicação ou dos conjuntos de dados, esquema ou âmbitos associados à aplicação invalidam a autorização anterior e exigem que o Administrador Global aprove novamente a aplicação a partir do Centro de administração do Microsoft 365.

Captura de ecrã da página Propriedades de Atualização do registo de aplicações.

Captura de ecrã da página Atualizar Conjuntos de Dados do registo de aplicações.

Observação

Se ainda não tiver sido criado, é registado um recurso com o> nome mgdc-your_app_id< do tipo Microsoft.GraphServices na subscrição e grupo de recursos selecionados para o tipo de computação do Microsoft Fabric.

Eliminar uma entrada de registo de aplicação

Pode eliminar uma entrada de registo de aplicação da página de descrição geral da aplicação individual ou da página de destino. Atualmente, os proprietários de aplicações ou os Administradores Globais podem eliminar entradas de registo de aplicações. Quando elimina uma entrada de registo de aplicação, tem de escrever o nome da aplicação para confirmar a eliminação. Depois de a aplicação ser eliminada, qualquer dependência ou pipeline que a utilize torna-se inutilizável, especificamente:

  • Cada pipeline passa por múltiplas fases. Na primeira fase do pipeline, validamos o consentimento. Qualquer pipeline após a fase de validação de consentimento continua e é bem-sucedido.
  • Qualquer pipeline antes da fase de validação de autorização falha porque a aplicação está em falta.

Captura de ecrã da página de entrada Eliminar Registo do registo de aplicações.