Graph Data Connect e permissões do Microsoft Graph explicadas: configuração, consentimento, privilégio mínimo
By Mirko Peters ·
O que o Microsoft Graph Data Connect faz, como ele se diferencia da API do Graph, as etapas de configuração e aprovação, e como funcionam as permissões do Graph (delegadas, de aplicativo e consentimento).
Automatically translated with AI from the original post. Read the English original
O Microsoft Graph Data Connect e as permissões do Microsoft Graph são dois assuntos separados, que costumam ser pesquisados juntos. O Data Connect é um serviço de extração de dados em lote para análises do Microsoft 365. As permissões do Graph controlam o que um aplicativo pode fazer por meio da API do Graph. Ambos dependem de consentimento e recompensam o mesmo hábito: solicitar o menor acesso que realize a tarefa.
Pontos-chave
- O Graph Data Connect extrai dados do Microsoft 365 em lote para o armazenamento do Azure, para análises. A API do Graph é adequada para pequenas quantidades de dados de usuários e grupos selecionados.
- A configuração exige um Administrador Global para habilitar o recurso, um registro de aplicativo no Entra, uma conta de armazenamento do Azure e a aprovação de um administrador para a solicitação de acesso aos dados.
- Os pipelines têm uma sobrecarga de cerca de 45 minutos, e a primeira execução pode levar mais de 40 minutos, incluindo o consentimento.
- As permissões do Graph são de dois tipos. As permissões delegadas atuam em nome de um usuário conectado. As permissões de aplicativo atuam sem um usuário e exigem consentimento de administrador.
- A Microsoft recomenda o modelo delegado sempre que ele atender às necessidades do aplicativo, e a menor permissão que funcione.
- Os nomes das permissões seguem o padrão {resource}.{operation}.{constraint}, como Application.ReadWrite.OwnedBy.
O que é o Graph Data Connect
A Microsoft descreve o Data Connect como um acesso seguro e escalável a conjuntos de dados do Microsoft 365 no Microsoft Fabric, no Azure Synapse e no Azure Data Factory, para análises corporativas. Os dados vêm de fontes como o Microsoft Entra ID, Outlook, Teams, SharePoint, Viva Insights e grupos do Microsoft 365.
Os conjuntos de dados se dividem em três grupos: básicos (conteúdo bruto criado pelo cliente), limpos (normalizados ou sem duplicidades) e curados (criados para um cenário específico). A lista inclui, por exemplo, TeamsCallRecords_v1, SharePointPermissions_v1, GroupMembers_v0 e PlannerTasks_v0. Os conjuntos de dados do Viva Insights exigem uma licença do Viva Insights, que é a única menção a licença na página de conjuntos de dados.
Data Connect ou API do Graph
A FAQ do Data Connect resume assim: ambos acessam os mesmos dados subjacentes. O Data Connect extrai grandes volumes em lote de toda a organização. As APIs do Graph são adequadas para pequenas quantidades de dados de usuários e grupos selecionados. A FAQ sugere combinar os dois, por exemplo, usar o Data Connect para a extração inicial e as APIs do Graph para trabalhos em tempo real depois.
Limitações conhecidas, segundo a FAQ:
- Os pipelines têm uma sobrecarga de cerca de 45 minutos, independentemente do tamanho dos dados.
- Usuários do Exchange local não são suportados, inclusive em configurações híbridas.
- Mensagens e eventos de contas de recursos não são suportados.
- O acesso a conjuntos de dados entre locatários não está disponível. Os recursos do Azure e o Microsoft 365 precisam estar no mesmo locatário do Entra.
Etapas de configuração
O guia de início rápido percorre estas etapas. Os nomes dos menus são os mesmos que a Microsoft apresenta.
- Habilite o Data Connect. Entre em admin.microsoft.com como Administrador Global. Selecione Configurações > Configurações da organização e, na guia Serviços, selecione Microsoft Graph Data Connect. Marque a opção para ativar o recurso em toda a organização e salve.
- Crie o aplicativo no Microsoft Entra. No centro de administração do Microsoft Entra, acesse Registros de aplicativo > Novo registro. Escolha "Somente contas neste diretório organizacional." Copie a ID do aplicativo (cliente) e a ID do locatário, crie um segredo do cliente e salve o valor imediatamente. O proprietário do aplicativo precisa de uma caixa de correio e, de acordo com o guia de início rápido, de uma assinatura E5 funcional.
- Crie o Armazenamento do Azure. Crie uma conta de armazenamento em uma região que corresponda à região do seu Microsoft 365. Conceda ao aplicativo a função Colaborador de Dados de Blob de Armazenamento em Controle de acesso (IAM) e crie um contêiner privado.
- Registre o aplicativo no Data Connect no portal do Azure. Escolha o destino, o aplicativo e os conjuntos de dados e colunas.
- Aprove a solicitação. Um administrador abre Configurações > Configurações da organização > Segurança e privacidade > Aplicativos do Microsoft Graph Data Connect. O aplicativo exibe Pré-consentimento. Revise os conjuntos de dados e selecione Aprovar. O guia de início rápido alerta que você não pode se autoaprovar.
- Execute o pipeline no Synapse, no Data Factory ou no Fabric. O status passa por Inicializando, Consentimento Pendente, Extraindo Dados, Persistindo Dados e Êxito. A primeira execução pode levar mais de 40 minutos.
Os destinos compatíveis incluem o Azure Data Lake Storage Gen2, o Blob do Armazenamento do Azure, o Banco de Dados SQL do Azure (somente em fluxos de dados de mapeamento) e o Microsoft Fabric OneLake. A autenticação por entidade de serviço é o único mecanismo compatível.
Consentimento e custo
O consentimento abrange o escopo da extração: conjuntos de dados, colunas, usuários e destino. Uma execução com o mesmo escopo não exige uma nova solicitação. A cobrança é feita por meio das assinaturas do Azure, por execução do pipeline, com frações arredondadas para cima. No exemplo das perguntas frequentes, 20 execuções de 500 linhas cada são cobradas como 20 unidades, e não 10. As páginas consultadas não informam as tarifas.
Permissões do Graph: o básico
Para a API do Graph, a Microsoft define dois tipos de permissão.
| | Delegadas | De aplicativo | |---|---|---| | Atuam | Em nome de um usuário conectado | Sem usuário | | Acesso efetivo | Limitado pelas permissões do aplicativo e pelas próprias do usuário | Quaisquer dados cobertos pela permissão | | Quem pode consentir | Usuários, ou administradores para todos os usuários | Somente administradores | | Outros nomes | Escopos | Funções de aplicativo |
O consentimento para permissões de aplicativo exige a função Administrador de Função Privilegiada ou Administrador Global. O consentimento do usuário para permissões delegadas ainda pode ser restringido pelas políticas de consentimento de aplicativos do locatário.
Nomenclatura e privilégio mínimo
As permissões seguem o padrão {resource}.{operation}.{constraint}. Os exemplos da página usam operações como Read e ReadWrite e restrições como All e OwnedBy. Se nenhuma restrição for informada, o acesso fica limitado aos dados de propriedade do usuário conectado. Por exemplo, Application.ReadWrite.OwnedBy gerencia apenas os aplicativos que o app criou ou possui, enquanto Application.ReadWrite.All gerencia todos eles.
A orientação da Microsoft é conceder o mínimo de permissão necessário. Use Directory.AccessAsUser.All, Directory.ReadWrite.All e Directory.Read.All com cautela e prefira permissões mais restritas. O consentimento específico de recurso permite que um usuário conceda acesso a uma instância de recurso, como uma equipe, em vez de todo o locatário. Ele é compatível com apenas um subconjunto de recursos.
Problemas comuns
- O registro do agente conector falha. O Learn informa que permissões delegadas não são compatíveis com o registro do agente conector. Solicite permissões de aplicativo com privilégio mínimo e conceda consentimento de administrador em todo o locatário.
- Os membros mostram apenas id e @odata.type. O aplicativo não tem permissão para ler esse tipo de membro.
- Permissões demais em um único aplicativo. Aplicativos cujo público de entrada inclui contas pessoais da Microsoft podem solicitar no máximo 30 permissões; públicos organizacionais podem solicitar até 400.
O que a documentação não diz
As páginas do Data Connect consultadas não descrevem por quanto tempo uma aprovação permanece válida nem informam tarifas. Também não listam requisitos de licenciamento além da configuração de tutorial do guia de início rápido.
Relacionados
- Microsoft Graph Data Connect
- Permissões do Microsoft Graph
- Consentimento de administrador
- Registro de aplicativo
Fontes
- Visão geral do Microsoft Graph Data Connect
- Início rápido do Data Connect
- Perguntas frequentes sobre o Data Connect
- Conjuntos de dados, regiões e destinos
- Visão geral das permissões do Microsoft Graph
Perguntas frequentes
Qual é a diferença entre o Graph Data Connect e a API do Microsoft Graph?
A FAQ do Data Connect no Microsoft Learn explica que ambos dão acesso aos mesmos dados subjacentes, mas de formas diferentes. O Data Connect foi projetado para extrair grandes volumes de dados em lote de toda a organização, enquanto as APIs do Graph são adequadas para pequenas quantidades de dados de usuários e grupos selecionados.
Quem aprova um aplicativo do Graph Data Connect?
No guia de início rápido da Microsoft, um administrador aprova a solicitação no centro de administração do Microsoft 365, em Configurações > Configurações da organização > Segurança e privacidade > Aplicativos do Microsoft Graph Data Connect. O guia informa que você não pode aprovar os próprios aplicativos.
Cada execução de pipeline exige uma nova solicitação de consentimento?
Não. De acordo com a FAQ do Data Connect, desde que o escopo permaneça o mesmo para conjuntos de dados, colunas, usuários e destino, uma execução não precisa de nova solicitação de consentimento. Executar o mesmo escopo para datas diferentes também está coberto.
Um aplicativo deve usar permissões delegadas ou de aplicativo?
O Microsoft Learn afirma que as permissões de aplicativo têm privilégios elevados e que, do ponto de vista do privilégio mínimo, o modelo delegado é recomendado sempre que atender às necessidades do aplicativo. As permissões de aplicativo sempre exigem consentimento de administrador.