Partilhar via


Suporte de identidade

As APIs REST do Microsoft Fabric são concebidas para fazer alterações ao Fabric. Para fazer estas alterações, é necessário permitir que a API faça login no Fabric. Este artigo explica os diferentes tipos de identidades que utiliza para autenticar ao aceder ao serviço Fabric.

  • User - Um utilizador Microsoft Entra. O utilizador é obrigado a ter os escopos especificados pela API para aceder ao serviço Fabric.

  • Principal de serviço - Um principal de serviço é uma entidade usada para executar uma aplicação ou serviço. As entidades de serviço podem ser usadas para autenticar e autorizar aplicações a aceder a recursos no Fabric.

  • Identidade gerida - Uma identidade gerida fornece uma identidade gerida automaticamente em Microsoft Entra ID para aplicações, sem necessidade de gerir credenciais. A tua API pode usar identidades geridas para autenticar quando faz login no Fabric.

Para informações sobre como alterar a identidade de um item, consulte Associar identidade do item.

Suporte a princípios de serviço e identidades geridas

Esta secção discute o suporte da API Fabric REST para principais de serviço e identidades geridas.

Configuração principal de inquilino de serviço

Para usar principais de serviço e identidades geridas com as APIs REST do Fabric, precisa de ativar a configuração de tenant Principais de serviço podem usar APIs do Fabric. Para ativar a definição, necessita de ser um administrador Fabric. Se não tiver a função de administrador Fabric, contacte um administrador Fabric na sua organização para ativar a definição.

Captura de ecrã a mostrar a mudança de inquilino: o utilizador do serviço pode usar o inquilino das APIs públicas.

APIs suportadas

A página de referência de cada API indica se a API suporta princípios de serviço e identidades geridas. Ao usar APIs, considere se a chamada à API depende de outras APIs ou de itens que não suportam a identidade da chamada. Nesses casos, a sua chamada falhará.

Exemplo de API não suportada

Ao chamar a API Itens - Criar Item que suporta principais de serviço e identidades geridas, se tentar criar um data warehouse que não suporta principais de serviço e identidades geridas, a chamada à API falha.

Exemplo de item não suportado

Ao chamar a API Job Scheduler - Run On Demand Item que suporta principais de serviço e identidades geridas, se passar um bloco de notas jobType que não suporta principais de serviço e identidades geridas, a chamada à API falha.