Configure a autenticação no Microsoft Outlook.

info

Beta

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a este recurso na página de Pré-visualizações . Veja as prévias do Gerenciador Databricks.

Esta página descreve como configurar a autenticação OAuth máquina a máquina (M2M) para ingestão de dados do Microsoft Outlook no Databricks. O conector do Outlook usa credenciais de cliente OAuth 2.0 (M2M) para acessar a API gráfica Microsoft em nome da sua organização. Use essas credenciais para criar uma conexão Unity Catalog no Databricks.

Pré-requisitos

Para configurar a autenticação, você precisa do seguinte:

• Um tenant Microsoft 365.
• Permissão para registrar aplicativos no Microsoft Entra ID.
• Permissão para conceder consentimento de administrador para permissões de API em sua organização.

Registrar um aplicativo no Microsoft Entra ID

1. Faça login no centro de administração do Microsoft Entra.
2. Acesse Entra ID > Registros de aplicativos .
3. Clique em Novo registro .
4. Forneça um nome para o aplicativo (por exemplo, Databricks Outlook Connector).
5. Em Tipos account suportados , selecione a opção adequada para sua organização.
6. Clique em Registrar .

Configurar permissões de API

1. No registro do aplicativo, acesse Permissões da API > Adicionar uma permissão .

2. Selecione Microsoft Gráfico > Permissões do aplicativo .

3. Adicione as seguintes permissões:

   • User.Read.All ou Directory.Read.All — necessário apenas para descobrir e listar todas as caixas de correio no tenant. Se você definir a opção include_mailboxes para ingerir um conjunto específico de caixas de correio, o conector ignora a descoberta e não requer essa permissão. Consulte Opções do conector.
   • Mail.Read — necessário para ler mensagens email e anexos.

4. Clique em "Conceder consentimento de administrador" ou solicite que um administrador conceda o consentimento de administrador para sua organização.

nota

O conector requer permissões de aplicativo , não permissões delegadas. Confirme se o tipo de permissão está definido como Aplicativo para cada permissão adicionada.

Criar um segredo do cliente

1. No registro do aplicativo, acesse Certificados e segredos > Segredos do cliente .
2. Clique em Novo segredo do cliente , forneça uma descrição e um período de expiração e, em seguida, clique em Adicionar .
3. Copie imediatamente o valor do segredo do cliente. O valor não é exibido novamente depois que você sai da página.

Reúna os identificadores necessários.

Na página de Visão Geral do cadastro no aplicativo, anote as seguintes informações:

• ID da aplicação (cliente)
• ID do diretório (tenant)

Você deverá inserir esses valores ao criar a conexão com o Unity Catalog .

Próximos passos

Use o Explorador de Catálogos para criar uma conexão para que qualquer usuário com USE CONNECTION ou ALL PRIVILEGES possa criar pipelines. Consulte Criar uma conexão do Outlook.