Autenticação no Microsoft Fabric HorizonDB

O Fabric HorizonDB utiliza autenticação Microsoft Entra para conexões PostgreSQL. O principal chamador determina a identidade efetiva do PostgreSQL.

Importante

Fabric HorizonDB está em prévia pública. Somente a identidade Microsoft Entra que criou o banco de dados pode se conectar. Outros usuários e entidades de segurança não conseguem se conectar, mesmo que consigam abrir o item Fabric. Use os detalhes de conexão do seu próprio banco de dados. Para mais informações, consulte os recursos de pré-visualização do Microsoft Fabric.

Autenticação e autorização são diferentes

A autenticação verifica a identidade. A autorização determina o que essa identidade pode fazer.

Um login bem-sucedido por si só não concede:

  • Acesso ao espaço de trabalho ou item do Fabric.
  • Privilégio do PostgreSQL CONNECT.
  • Esquema USAGE.
  • Privilégios de tabela, sequência, função ou DDL.
  • Acesso a uma fonte de federação, origem do trabalho de cópia ou endpoint de análise SQL.

Para autorização, consulte Autorização.

Padrões de identidade suportados

Faça login como o criador do banco de dados para o editor Fabric SQL, Visual Studio Code, exercícios do aplicativo e conexão de destino de tarefa Copiar. Grupos Microsoft Entra, principais de serviço, identidades gerenciadas e outros usuários do Microsoft Entra não são suportados para conexões PostgreSQL na prévia atual.

Clientes interativos

Para o editor SQL do Fabric, o serviço usa o contexto do Fabric em que você iniciou sessão. A entidade de segurança chamadora determina a identidade efetiva do PostgreSQL.

Para Visual Studio Code:

  1. Instale a extensão Microsoft PostgreSQL.

  2. Selecione Visual Studio Code na barra de ferramentas do Fabric HorizonDB e, em seguida, selecione Abrir no VS Code no painel de conexão.

  3. Selecione o Entra Auth.

  4. Faça login no tenant correto como criador do banco de dados.

  5. Verifique o host, banco de dados, formato do usuário e configuração TLS.

  6. Executar:

    SELECT
        current_database(),
        current_user,
        clock_timestamp();
    

Autenticação do aplicativo

Uma aplicação deve:

  1. Carregue coordenadas de conexão não sensíveis a partir da configuração.
  2. Use a identidade Microsoft Entra do criador do banco de dados para o exercício de pré-visualização.
  3. Solicite um token usando o audience ou escopo especificado para sua conexão de visualização.
  4. Abra uma conexão PostgreSQL protegida por TLS e forneça o token como credencial equivalente à senha.
  5. Defina um tempo limite de conexão e um nome de aplicativo não sensível.
  6. Descarte o token quando não for mais necessário.

Não substitua o criador por um principal de serviço ou identidade gerenciada. Para um exercício local de Python, use Psycopg 3 e uma credencial interativa explícita. Veja como conectar com Python.

Ciclo de vida do token e do pool

A validação de token ocorre quando uma conexão física é estabelecida. Uma sessão existente não é automaticamente reautenticada antes de cada instrução.

  • Adquira um token novo para cada nova conexão física ou atualização do pool.
  • Substitua as conexões agrupadas antes da expiração do token.
  • Valide conexões emprestadas após pausa, dimensionamento ou manutenção.
  • Limite as tentativas de repetição e nunca tente novamente indefinidamente uma credencial inválida ou expirada.

Alterar permissões de itens Fabric não habilita identidades adicionais do PostgreSQL na pré-visualização atual.

Valide a identidade autenticada

Executar:

SELECT
    current_database() AS database_name,
    current_user AS current_role,
    session_user AS session_role,
    pg_backend_pid() AS session_id,
    clock_timestamp() AS checked_at;

Confirme se a identidade retornada representa o criador do banco de dados ou a identidade mapeada do banco de dados. Não crie roles de login do PostgreSQL para contornar a restrição da versão prévia.

Solucionar problemas de autenticação

Sintoma Verificação
Falha na aquisição de token Configuração de credenciais, seleção do locatário, acesso condicional e estado local de login.
PostgreSQL rejeita a credencial Escopo ou público do token, expiração, locatário, formato de usuário, clock do servidor e endpoint.
Portal funciona, mas o aplicativo falha Compare a identidade, banco de dados, formato do usuário, fluxo de tokens, modo TLS e acesso efetivo ao banco de dados.
Outro usuário não consegue se conectar Esperado na prévia atual. Reconecte-se como criador do banco de dados; compartilhar o item não permite a outra identidade PostgreSQL.
A autenticação funciona, mas a consulta é negada Verifique o banco de dados atual, a propriedade dos objetos e se a operação é suportada.
O banco de dados está pausado Use a retentativa de conexão limitada enquanto uma conexão autorizada retoma.

Registre a categoria de erro sanitizada, o timestamp UTC, a versão do cliente e do driver, e o ID de correlação. Nunca envie o token ou a cadeia de conexão completa.

Limitations

  • A autenticação por senha não é documentada como o modelo de identidade em visualização pública.
  • A configuração de superusuário do cliente e de autenticação do host não está disponível.
  • Somente o criador do banco de dados pode se conectar; usuários adicionais e entidades de segurança de aplicativo não são compatíveis.
  • Compartilhar não é uma solução alternativa para a restrição exclusiva do criador.
  • Não presuma que a administração de funções SQL ou o acesso multiusuário granular estejam disponíveis.
  • TLS e valores de endpoint não são intercambiáveis com outro serviço.