Comment configurer les journaux d’audit SQL

1. Dans votre espace de travail Fabric, sélectionnez les paramètres de votre élément d’entrepôt.

2. Sélectionnez la page des journaux d’audit SQL.

3. Activez le paramètre Enregistrer les événements dans les journaux d’audit SQL.

   

   Par défaut, toutes les actions sont activées et conservées pendant neuf ans.

4. Dans la section Événements à enregistrer, sélectionnez quels événements les journaux d’audit SQL capturent. Sélectionnez les catégories d’événements ou les groupes d’actions d’audit individuels que vous souhaitez capturer. Sélectionnez uniquement les événements dont votre organisation a besoin pour optimiser le stockage et la pertinence.

   

5. En option, saisissez une expression de prédicat pour filtrer les événements, comme exclure une activité d’un principal de service connu ou d’une identité d’automatisation. Utilisez la syntaxe décrite dans la syntaxe des expressions de prédicat.

   

   Important

   Le filtrage des prédicats ne s’applique qu’aux événements déjà sélectionnés sous Événements à enregistrer. Par exemple, pour filtrer SELECT les instructions, vous devez également activer « Batch Was Completed ».

6. Spécifiez une période de rétention de journal souhaitée en années, mois et jours.

   

7. Sélectionnez Enregistrer pour appliquer vos paramètres.

Votre entrepôt enregistre désormais les événements d’audit sélectionnés et stocke les journaux en toute sécurité dans OneLake.

1. Téléchargez et installez Visual Studio Code.

2. Installez l’extension client REST à partir de la Place de marché Visual Studio.

3. Obtenez le jeton porteur en suivant ces étapes. Vous pouvez trouver votre jeton porteur Power BI dans les outils développeur de votre navigateur ou via PowerShell.

   Pour utiliser les outils de développement Edge pour trouver votre jeton d’accès de Power BI :

   1. Ouvrez votre espace de travail Microsoft Fabric dans un navigateur (Microsoft Edge).
   2. Appuyez sur F12 pour ouvrir les Outils de développement.
   3. Sélectionnez l’onglet Console. Si nécessaire, sélectionnez Développer Affichage rapide pour faire apparaître l’invite de console >.
   4. Tapez la commande powerBIAccessToken, puis appuyez sur Entrée. Cliquez avec le bouton droit sur la grande chaîne unique retournée dans la console, puis sélectionnez Copier le contenu de la chaîne.
   5. Collez le contenu à la place de <bearer token> dans les scripts suivants.

   Pour utiliser PowerShell pour rechercher votre jeton d'authentification de Power BI:

   1. Installez le module MicrosoftPowerBIMgmt depuis les Cmdlets Microsoft Power BI pour Windows PowerShell et PowerShell Core.

      Install-Module -Name MicrosoftPowerBIMgmt
      

   2. Utilisez Connect-PowerBIServiceAccount pour vous connecter à Power BI PowerShell et récupérer le jeton du porteur.

      Connect-PowerBIServiceAccount
      $token = (Get-PowerBIAccessToken).Authorization
      Write-Output "Bearer $token"
      

4. Après avoir obtenu le jeton porteur Power BI, envoyez une PATCH requête en utilisant l’extension client REST. Dans VS Code, créez un nouveau fichier texte avec l’extension .http .

5. Copiez et collez la requête suivante :

   PATCH https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/warehouses/<warehouseId>/settings/sqlAudit
   content-type: application/json
   Authorization: Bearer <BEARER_TOKEN>
   
   {
       "state": "Enabled",
       "retentionDays": "0"
   }
   

   • Remplacez <workspaceId> et <warehouseId> par les ID de l’espace de travail et de l’entrepôt Fabric correspondants. Pour trouver ces valeurs, rendez-vous dans votre entrepôt sur le portail Fabric.
     • <workspaceID> : recherchez le GUID de l’espace de travail dans l’URL après la section /groups/, ou en exécutant SELECT @@SERVERNAME dans un entrepôt existant. Par exemple : 11aaa111-a11a-1111-1aaa-aa111111aaa. N’incluez pas les caractères /.
     • <warehouseID> : recherchez le GUID de l’entrepôt directement dans l’URL après la section /warehouses/, ou en exécutant SELECT @@SERVERNAME dans un entrepôt existant. Par exemple : 11aaa111-a11a-1111-1aaa-aa111111aaa. N’incluez pas les caractères /.
   • Remplacez <BEARER_TOKEN> par votre jeton d'accès.
     • Réglez state pour Enabled activer l’audit (utilisez Disabled pour l’éteindre).
     • Réglez le retentionDays paramètre sur 0 une rétention illimitée. Il s’agit du paramètre par défaut.

   Important

   Dans l’exemple de code d’extension, vous devez inclure une ligne vide immédiatement après avoir fourni le jeton du porteur. Cette ligne vide signale l’extension où se terminent les en-têtes HTTP et commence le corps de commande de l’API, afin que l’API puisse correctement distinguer les deux.

6. Sélectionnez Envoyer une demande.

Vérifier l’état du journal d’audit avec l’API REST

Pour vérifier si les journaux d’audit SQL sont activés, envoyez une requête GET en utilisant la même extension client REST.

1. Dans VS Code, créez un nouveau fichier texte avec l’extension .http .
2. Copiez et collez la requête suivante, en indiquant vos propres valeurs workspaceId, <warehouseId> et <BEARER_TOKEN>.

GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/warehouses/<warehouseId>/settings/sqlAudit
content-type: application/json
Authorization: Bearer <BEARER_TOKEN>

La réponse retourne ENABLED ou DISABLED et la configuration actuelle de auditActionsAndGroups et predicateExpression.

Configurer des groupes d’actions d’audit avec l’API REST

Les journaux d’audit SQL se basent sur des groupes d’actions prédéfinis qui capturent des événements spécifiques dans la base de données. Pour plus d’informations sur les groupes d’actions d’audit, consultez les journaux d’audit SQL dans Fabric Data Warehouse.

1. Dans VS Code, créez un nouveau fichier texte avec l’extension .http .

2. Copiez et collez la requête suivante, en indiquant vos propres valeurs workspaceId, <warehouseId> et <BEARER_TOKEN>.

   POST https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/warehouses/<warehouseId>/settings/sqlAudit
   content-type: application/json
   Authorization: Bearer <BEARER_TOKEN>
   [  "DATABASE_OBJECT_PERMISSION_CHANGE_GROUP" ]
   

3. Sélectionnez Envoyer une demande.

Configurer une expression de prédicat

Utilisez la même PATCH requête API pour configurer une expression de prédicat qui exclut la génération d’événements spécifiques, tels que l’activité provenant d’un principal de service connu ou une identité d’automatisation. Pour la syntaxe complète des prédicats, voir Syntaxe d’expression des prédicats.

1. Dans VS Code, créez un nouveau fichier texte avec l’extension .http .

2. Copiez et collez la requête suivante, en indiquant vos propres valeurs workspaceId, <warehouseId> et <BEARER_TOKEN>.

   PATCH https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/warehouses/<warehouseId>/settings/sqlAudit
   content-type: application/json
   Authorization: ******
   
   {
       "state": "Enabled",
       "retentionDays": 10,
       "predicateExpression": "NOT statement LIKE 'SELECT %'"
   }
   

   • Cet exemple exclut SELECT les instructions d’être auditées par filtrage sur le statement champ.
   • Lorsque vous activez l’audit SQL pour la première fois, l’omission predicateExpression ne s’applique à aucun prédicat. Lors des mises à jour ultérieures, l’omettre laisse le prédicat existant inchangé. Spécifiez une chaîne vide ("") pour supprimer un prédicat existant.

   Important

   Le filtrage des prédicats n’évalue que les événements déjà configurés pour être capturés. Pour filtrer SELECT les instructions comme montré dans cet exemple, vous devez également activer le groupe d’actions Batch Was Completed (BATCH_COMPLETED_GROUP). Pour plus d’informations, voir Groupes d’actions et actions d’audit au niveau de la base de données.

3. Sélectionnez Envoyer une demande.