Partager via


Prise en charge des identités

Microsoft Fabric API REST sont conçues pour apporter des modifications à Fabric. Pour apporter ces modifications, vous devez autoriser l’API à se connecter à Fabric. Cet article explique les différents types d’identités que vous utilisez pour vous authentifier lors de l’accès au service Fabric.

  • Utilisateur - Utilisateur Microsoft Entra. L'utilisateur doit disposer des étendues spécifiées par l'API pour accéder au service Fabric.

  • Principal de service : un principal de service est une entité utilisée pour exécuter une application ou un service. Les principaux de service peuvent être utilisés pour authentifier et autoriser les applications à accéder aux ressources dans Fabric.

  • Identité managée - Une identité managed fournit une identité managée automatiquement dans Microsoft Entra ID pour les applications, sans avoir à gérer les informations d’identification. Votre API peut utiliser des identités managées pour s'authentifier lorsqu'elle se connecte à Fabric.

Pour plus d’informations sur la modification de l’identité d’un élément, consultez Associer l’identité de l’élément.

Prise en charge des principaux de service et des identités managées

Cette section décrit la prise en charge de l’API REST Fabric pour les principaux de services et les identités gérées.

Paramètre du principal de service du locataire

Pour utiliser des principaux de service et des identités managées avec les API REST de Fabric, vous devez activer le paramètre de locataire Les principaux de service peuvent utiliser les API Fabric. Pour activer le paramètre, vous devez être administrateur Fabric. Si vous n'avez pas le rôle d'administrateur Fabric, contactez un administrateur Fabric de votre organisation pour activer le paramètre.

Capture d’écran montrant le changement de tenant : l'utilisateur du service peut utiliser le tenant des API publiques.

API prises en charge

La page de référence de chaque API indique si l’API prend en charge les principaux de service et les identités managées. Lorsque vous utilisez des API, déterminez si l’appel d’API s’appuie sur d’autres API ou éléments qui ne prennent pas en charge l’identité d’appel. Dans ce cas, votre appel échoue.

Exemple d’API non prise en charge

Lors de l’appel de l’API Items - Créer un élément qui prend en charge les principaux de services et les identités managées, si vous essayez de créer un entrepôt de données qui ne prend pas en charge les principaux de services et les identités managées, l’appel d'API échoue.

Exemple d’élément non pris en charge

Lors de l'appel de l'API Job Scheduler - Exécuter le travail à la demande qui prend en charge les principaux de service et les identités managées, si vous transmettez un "notebook" jobType qui ne les prend pas en charge, l'appel d'API échoue.