Kuinka konfiguroida SQL-auditointilokit

1. Valitse Kangas-työtilassa varastonimikkeen asetukset .

2. Valitse SQL-valvontalokit-sivu .

3. Ota käyttöön Tallenna tapahtumat SQL-valvontalokeihin -asetus.

   

   Oletusarvoisesti kaikki toiminnot ovat käytössä ja säilyvät yhdeksän vuoden ajan.

4. Tallennettavat tapahtumat -kohdasta valitse, mitkä tapahtumat SQL-auditointilokit tallentavat. Valitse tapahtumakategoriat tai yksittäiset auditointiryhmät, jotka haluat tallentaa. Valitse vain tapahtumat, joita organisaatiosi edellyttää tallennuksen ja osuvuuden optimoinnissa.

   

5. Halutessasi voit syöttää predikaattilausekkeen suodattamaan tapahtumia, kuten sulkemalla pois toimintaa tunnetusta palvelupäähenkilöstä tai automaatioidentiteetistä. Käytä syntaksia, joka on kuvattu predikaattilausekkeen syntaksissa.

   

   Tärkeää

   Predikaattisuodatus koskee vain tapahtumia, jotka on jo valittu Tapahtumat tallennettavaksi. Esimerkiksi lauseiden suodattamiseksi SELECT sinun täytyy myös ottaa käyttöön Erä oli valmis.

6. Määritä haluamasi lokin säilytysaikavuosina, kuukausina ja päivinä.

   

7. Valitse Tallenna ottaaksesi asetukset käyttöön.

Varastosi tallentaa nyt valitut tarkastustapahtumat ja säilyttää lokit turvallisesti OneLakessa.

1. Lataa ja asenna Visual Studio Code.

2. Asenna REST Client -laajennus Visual Studio Marketplace:sta.

3. Hanki kantaja-token seuraamalla näitä vaiheita. Voit löytää Power BI -kantajatokenisi selaimesi kehittäjätyökaluista tai PowerShellin kautta.

   Edge-kehittäjätyökalujen käyttäminen Power BI kantajatokenin löytämiseen:

   1. Avaa Microsoft Fabric -työtilasi selaimessa (Microsoft Edge).
   2. Avaa Kehittäjätyökalut painamalla F12-näppäintä .
   3. Valitse Konsoli-välilehti. Avaa konsolin kehote tarvittaessa valitsemalla >.
   4. Kirjoita komento powerBIAccessToken ja paina Enter-näppäintä. Napsauta konsolissa palautettua suurta yksilöivää merkkijonoa hiiren kakkospainikkeella ja valitse Kopioi merkkijonon sisältö.
   5. Liitä se <bearer token> tilalle seuraavissa komentosarjoissa.

   PowerShellin käyttäminen Power BI kantajatokenin löytämiseen:

   1. Asenna MicrosoftPowerBIMgmt -moduuli Microsoftista Power BI Cmdletit Windows PowerShellille ja PowerShell Core:lle.

      Install-Module -Name MicrosoftPowerBIMgmt
      

   2. Käytä Connect-PowerBIServiceAccount yhdistääksesi Power BI PowerShelliin ja hakeaksesi kantajatokenin.

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

4. Kun olet saanut Power BI:n kantajatokenin, lähetä PATCH pyyntö käyttämällä REST Client -laajennusta. VS Codessa luo uusi tekstitiedosto päätteellä .http .

5. Kopioi ja liitä seuraava pyyntö:

   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"
   }
   

   • Korvaa <workspaceId> ja <warehouseId> vastaavilla Fabric-työtila- ja varastotunnuksilla. Löydät nämä arvot varastostasi Fabric-portaalista.
     • <workspaceID>: Etsi työtilan GUID-tunnus URL-osoitteesta -osan jälkeen /groups/ tai suorittamalla SELECT @@SERVERNAME olemassa olevassa varastossa. Esimerkiksi, 11aaa111-a11a-1111-1aaa-aa111111aaa. Älä lisää /-merkkejä.
     • <warehouseID>: Etsi varaston GUID-tunnus URL-osoitteesta /warehouses/-osan jälkeen tai suorittamalla SELECT @@SERVERNAME olemassa olevassa varastossa. Esimerkiksi, 11aaa111-a11a-1111-1aaa-aa111111aaa. Älä lisää /-merkkejä.
   • Korvaa <BEARER_TOKEN>haltijatunnuksellasi.
     • Asetettu state laittamaan Enabled auditointi päälle (käytä Disabled sitä pois päältä).
     • Aseta parametriksi retentionDays0 rajoittamaton säilytys. Tämä on oletusasetus.

   Tärkeää

   Laajennuksen esimerkkikoodiin on sisällytettävä tyhjä rivi heti haltijatunnuksen antamisen jälkeen. Tämä tyhjä rivi ilmoittaa laajennuksesta, jossa HTTP-otsikot päättyvät ja API-komentorunko alkaa, joten API voi erottaa nämä oikein.

6. Valitse Lähetä pyyntö.

Valvontalokin tilan tarkistaminen REST-ohjelmointirajapinnan avulla

Varmistaaksesi ovatko SQL-auditointilokit käytössä, lähetä GET-pyyntö käyttämällä samaa REST-asiakaslaajennusta.

1. VS Codessa luo uusi tekstitiedosto päätteellä .http .
2. Kopioi ja liitä seuraava pyyntö ja toimita omat workspaceId, <warehouseId>ja <BEARER_TOKEN>.

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

Vaste palauttaa ENABLED tai DISABLED ja nykyisen konfiguraation auditActionsAndGroups ja predicateExpression.

Valvontatoimintoryhmien määrittäminen REST-ohjelmointirajapinnan avulla

SQL-valvontalokit käyttävät ennalta määritettyjä toimintoryhmiä, jotka sieppaavat tiettyjä tapahtumia tietokannassa. Lisätietoja auditointitoimintaryhmistä löytyy SQL-auditointilokit Fabric tietovarasto:sta.

1. VS Codessa luo uusi tekstitiedosto päätteellä .http .

2. Kopioi ja liitä seuraava pyyntö ja toimita omat workspaceId, <warehouseId>ja <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. Valitse Lähetä pyyntö.

Määritä predikaattilauseke

Käytä samaa PATCH API-pyyntöä konfiguroidaksesi predikaattilausekkeen, joka sulkee pois tiettyjen tapahtumien, kuten tunnetun palvelupäähenkilön tai automaatioidentiteetin, generoinnin. Koko predikaattisyntaksi löytyy kohdasta predikaattilausekkeen syntaksi.

1. VS Codessa luo uusi tekstitiedosto päätteellä .http .

2. Kopioi ja liitä seuraava pyyntö ja toimita omat workspaceId, <warehouseId>ja <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 %'"
   }
   

   • Tämä esimerkki sulkee SELECT pois väitteiden auditoinnin kentän suodatuksen statement avulla.
   • Kun otat SQL-auditoinnin käyttöön ensimmäistä kertaa, poisjättäminen predicateExpression ei koske predikaattia. Myöhemmissä päivityksissä sen poisjättäminen jättää olemassa olevan predikaatin muuttumattomaksi. Määritä tyhjä merkkijono ("") poistaaksesi olemassa olevan predikaatin.

   Tärkeää

   Predikaattisuodatus arvioi vain tapahtumia, jotka on jo määritetty tallennettaviksi. Suodattaaksesi SELECT lauseita kuten tässä esimerkissä on esitetty, sinun täytyy myös ottaa käyttöön Erä Oli Valmis (BATCH_COMPLETED_GROUP) -toimintoryhmä. Lisätietoja löytyy osoitteesta Tietokantatason tarkastustoimintaryhmät ja toimenpiteet.

3. Valitse Lähetä pyyntö.