Compartilhar via

Conectar-se a uma conta do Azure Data Lake Storage usando uma entidade de serviço do Microsoft Entra

  • Artigo

Observação

O Azure Active Directory agora é o Microsoft Entra ID. Saiba mais

O Dynamics 365 Customer Insights - Data oferece uma opção para se conectar a uma conta do Azure Data Lake Storage usando uma entidade de serviço do Microsoft Entra.

As ferramentas automatizadas que usam os serviços do Azure devem ter permissões restritas. Em vez de fazer com que os aplicativos entrem como um usuário totalmente privilegiado, o Azure oferece entidades de serviço. Use entidades de serviço para adicionar ou editar uma pasta do Common Data Model como uma fonte de dados ou criar ou atualizar um ambiente com segurança.

Pré-requisitos

  • A conta do Data Lake Storage tem o recurso namespace hierárquico habilitado.
  • Permissões de administrador para seu locatário do Azure, se você precisar criar uma entidade de serviço.

Crie entidade de serviço do Microsoft Entra para o Customer Insights

Antes de criar uma nova entidade de serviço para o Customer Insights, verifique se ela já existe na sua organização. Na maioria dos casos, já existe.

Procurar uma entidade de serviço existente

  1. Acesse o portal administrativo do Azure e faça logon em sua organização.

  2. Em Serviços do Azure, selecione Microsoft Entra.

  3. Em Gerenciar, selecione Aplicativo da Microsoft.

  4. Adicione um filtro para A ID do aplicativo começa com0bfc4568-a4ba-4c58-bd3e-5d3e76bd7fff ou procure o nome Dynamics 365 AI for Customer Insights.

  5. Se encontrar um registro correspondente, significará que a entidade de serviço já existe. Conceder permissões para a entidade de serviço para acessar a conta de armazenamento.

    Captura de tela mostrando uma entidade de serviço existente.

  6. Se nenhum resultado for retornado, crie uma entidade de serviço.

Criar uma entidade de serviço

  1. Instale a versão mais recente do ID PowerShell para o Graph do Microsoft Entra. Para obter mais informações, acesse Instalar o ID PowerShell para o Graph do Microsoft Entra.

    1. No seu PC, pressione a tecla Windows no teclado, procure por Windows PowerShell e selecione Executar como administrador.

    2. Na janela do PowerShell que é aberta, digite Install-Module AzureAD.

  2. Crie a entidade de serviço com o módulo PowerShell da ID do Microsoft Entra.

    1. Na janela do PowerShell, digite Connect-AzureAD -TenantId "[your Directory ID]" -AzureEnvironmentName Azure. Substitua [sua ID de Diretório] pela ID de Diretório real da assinatura do Azure na qual você deseja criar a entidade de serviço. O parâmetro de nome de ambiente, AzureEnvironmentName, é opcional.

    2. Insira New-AzureADServicePrincipal -AppId "0bfc4568-a4ba-4c58-bd3e-5d3e76bd7fff" -DisplayName "Dynamics 365 AI for Customer Insights". Este comando cria a entidade de serviço na assinatura do Azure selecionada.

Conceder permissões à entidade de serviço para acessar a conta de armazenamento

Para conceder permissões à entidade de serviço para a conta de armazenamento que você deseja usar no Customer Insights - Data, uma das funções a seguir deve ser atribuída à conta de armazenamento ou ao contêiner:

Credencial Requisitos
Usuário conectado no momento Ao se conectar ao Azure Data Lake usando a opção de assinatura do Azure:
  • Função: Leitor de Dados de Blob de Armazenamento, Colaborador de Blob de Armazenamento ou Proprietário de Blob de Armazenamento.
  • Nível: permissões concedidas na conta de armazenamento ou no contêiner.

Ao se conectar ao Azure Data Lake usando a opção de recurso do Azure:
  • Função: Microsoft.Storage/storageAccounts/read action
  • Nível: permissão concedida na conta de armazenamento

E
  • Função: Leitor de Dados de Blob de Armazenamento, Colaborador de Blob de Armazenamento ou Proprietário de Blob de Armazenamento.
  • Nível: permissões concedidas na conta de armazenamento ou no contêiner.

A função Leitor de Dados do Blob de Armazenamento é suficiente para ler e ingerir os dados no Customer Insights – Data. No entanto, a função Colaborador ou Proprietário de Dados do Storage Blob é necessária para editar os arquivos de manifesto dentro da experiência de conexão dos dados.
Entidade de Serviço do Customer Insights -
Usando o Azure Data Lake Storage como uma fonte de dados
 Opção 1
  • Função: Leitor de Dados de Blob de Armazenamento, Colaborador de Dados de Blob de Armazenamento ou Proprietário de Dados de Blob de Armazenamento.
  • Nível: permissões concedidas na conta de armazenamento.
Opção 2 (sem compartilhamento de acesso de Entidade de Serviço à conta de armazenamento)
  • Função 1: Leitor de Dados de Blob de Armazenamento, Colaborador de Dados de Blob de Armazenamento ou Proprietário de Dados de Blob de Armazenamento.
  • Nível: permissões concedidas no contêiner.
  • Função 2: Delegante de Dados do Blob de Armazenamento.
  • Nível: permissões concedidas na conta de armazenamento.
Entidade de Serviço do Customer Insights -
Usando o Azure Data Lake Storage como saída ou destino
 Opção 1
  • Função: Colaborador de Blob de Armazenamento ou Proprietário de Blob de Armazenamento.
  • Nível: permissões concedidas na conta de armazenamento.
Opção 2 (sem compartilhamento de acesso de Entidade de Serviço à conta de armazenamento)
  • Função: Colaborador de Blob de Armazenamento ou Proprietário de Blob de Armazenamento.
  • Nível: permissões concedidas no contêiner.
  • Função 2: Delegante do Blob de Armazenamento.
  • Nível: permissões concedidas na conta de armazenamento.

  1. Acesse o portal administrativo do Azure e faça logon em sua organização.

  2. Abra a conta de armazenamento à qual você deseja que a entidade de serviço tenha acesso.

  3. No painel esquerdo, selecione a opção Controle de acesso (IAM) e selecione Adicionar>Adicionar atribuição de função.

    Captura de tela mostrando o portal do Azure enquanto adiciona uma atribuição de função.

  4. No painel Adicionar atribuição de função, defina as seguintes propriedades:

    • Função: Leitor de Dados de Blob de Armazenamento, Colaborador de Dados de Blob de Armazenamento ou Proprietário de Blob de Armazenamento com base nas credenciais listadas acima.
    • Atribua acesso a: Usuário, grupo ou entidade de serviço
    • Selecione membros: Dynamics 365 AI for Customer Insights (a entidade de serviço pesquisada anteriormente neste procedimento)

  5. Selecione Revisar + atribuir.

A propagação das alterações pode levar até 15 minutos.

Insira a ID do recurso do Azure ou os detalhes da assinatura do Azure no anexo da conta de armazenamento para o Customer Insights -Data

Anexe uma conta do Data Lake Storage no Customer Insights - Data para armazenar dados de saída ou usá-la como uma fonte de dados. Escolha entre uma abordagem baseada em recursos ou uma abordagem baseada em assinaturas e siga essas etapas.

Conexão de conta de armazenamento baseada em recursos

  1. Acesse o portal administrativo do Azure, entre na sua assinatura e abra a conta de armazenamento.

  2. No painel à esquerda, acesse Configurações>Pontos de Extremidade.

  3. Copie o valor da ID do recurso da conta de armazenamento.

  4. No Customer Insights - Data, insira a ID do recurso no campo de recurso exibido na tela de conexão da conta de armazenamento.

    Insira as informações de ID do recurso da conta de armazenamento.

  5. Continue com as etapas restantes para anexar a conta de armazenamento.

Conexão de conta de armazenamento baseada em assinatura

  1. Acesse o portal administrativo do Azure, entre na sua assinatura e abra a conta de armazenamento.

  2. No painel esquerdo, acesse Configurações>Propriedades.

  3. Reveja a Assinatura, o Grupo de recursos e o Nome da conta de armazenamento para certificar-se de que selecionou os valores certos no Customer Insights - Data.

  4. No Customer Insights - Data, escolha os valores dos campos correspondentes ao anexar a conta de armazenamento.

  5. Continue com as etapas restantes para anexar a conta de armazenamento.