Microsoft.Synapse-arbetsytor/sqlPools/auditingSettings

Bicep-resursdefinition

Resurstypen workspaces/sqlPools/auditingSettings kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Synapse/workspaces/sqlPools/auditingSettings-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.Synapse/workspaces/sqlPools/auditingSettings@2021-06-01' = {
  parent: resourceSymbolicName
  name: 'default'
  properties: {
    auditActionsAndGroups: [
      'string'
    ]
    isAzureMonitorTargetEnabled: bool
    isStorageSecondaryKeyInUse: bool
    retentionDays: int
    state: 'string'
    storageAccountAccessKey: 'string'
    storageAccountSubscriptionId: 'string'
    storageEndpoint: 'string'
  }
}

Egenskapsvärden

Microsoft.Synapse/workspaces/sqlPools/auditingSettings

Namn Beskrivning Värde
Namn Resursnamnet "standard" (krävs)
förälder I Bicep kan du ange den överordnade resursen för en underordnad resurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen.

Mer information finns i Underordnad resurs utanför den överordnade resursen.
Symboliskt namn för resurs av typen: arbetsytor/sqlPools
Egenskaper Resursegenskaper. SqlPoolBlobAuditingPolicyProperties (på engelska)

SqlPoolBlobAuditingPolicyProperties (på engelska)

Namn Beskrivning Värde
auditActionsAndGroups Anger Actions-Groups och åtgärder som ska granskas.

Den rekommenderade uppsättningen åtgärdsgrupper som ska användas är följande kombination – detta granskar alla frågor och lagrade procedurer som körs mot databasen samt lyckade och misslyckade inloggningar:

BATCH_COMPLETED_GROUP,
SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP,
FAILED_DATABASE_AUTHENTICATION_GROUP.

Den här kombinationen ovan är också den uppsättning som konfigureras som standard när du aktiverar granskning från Azure-portalen.

De åtgärdsgrupper som stöds för granskning är (obs! Välj endast specifika grupper som täcker dina granskningsbehov. Användning av onödiga grupper kan leda till mycket stora mängder granskningsposter:

APPLICATION_ROLE_CHANGE_PASSWORD_GROUP
BACKUP_RESTORE_GROUP
DATABASE_LOGOUT_GROUP
DATABASE_OBJECT_CHANGE_GROUP
DATABASE_OBJECT_OWNERSHIP_CHANGE_GROUP
DATABASE_OBJECT_PERMISSION_CHANGE_GROUP
DATABASE_OPERATION_GROUP
DATABASE_PERMISSION_CHANGE_GROUP
DATABASE_PRINCIPAL_CHANGE_GROUP
DATABASE_PRINCIPAL_IMPERSONATION_GROUP
DATABASE_ROLE_MEMBER_CHANGE_GROUP
MISSLYCKAD_DATABAS_AUTENTISERING_GRUPP
SCHEMA_OBJECT_ACCESS_GROUP
SCHEMA_OBJECT_CHANGE_GROUP
SCHEMA_OBJECT_OWNERSHIP_CHANGE_GROUP
SCHEMA_OBJECT_PERMISSION_CHANGE_GROUP
FRAMGÅNGSRIK_DATABAS_AUTENTISERING_GRUPP
USER_CHANGE_PASSWORD_GROUP
GRUPP_BATCH_STARTAD
Batch Avslutad Grupp

Det här är grupper som täcker alla sql-instruktioner och lagrade procedurer som körs mot databasen och som inte ska användas i kombination med andra grupper eftersom detta resulterar i dubbletter av granskningsloggar.

Mer information finns i Database-Level Granskningsåtgärdsgrupper.

För databasgranskningsprincip kan specifika åtgärder också anges (observera att Åtgärder inte kan anges för servergranskningsprincip). De åtgärder som stöds för granskning är:
UTVALD
UPPDATERA
INFOGA
TA BORT
UTFÖRA
MOTTAGA
REFERENSER

Det allmänna formuläret för att definiera en åtgärd som ska granskas är:
{action} PÅ {object} BY {principal}

Observera att <objekt> i ovanstående format kan referera till ett objekt som en tabell, vy eller lagrad procedur eller en hel databas eller ett helt schema. I de senare fallen används formulären DATABASE::{db_name} och SCHEMA::{schema_name} .

Till exempel:
VÄLJ på dbo.myTable efter offentlig
VÄLJ på DATABAS::myDatabase av public
VÄLJ på SCHEMA::mySchema efter offentlig

Mer information finns i Database-Level Granskningsåtgärder
string[]
isAzureMonitorTargetEnabled Anger om granskningshändelser skickas till Azure Monitor.
För att kunna skicka händelserna till Azure Monitor anger du "tillstånd" som "Aktiverad" och "isAzureMonitorTargetEnabled" som sant.

När du använder REST API för att konfigurera granskning bör diagnostikinställningar med diagnostikloggkategorin "SQLSecurityAuditEvents" i databasen också skapas.
Observera att för granskning på servernivå bör du använda huvuddatabasen som {databaseName}.

URI-format för diagnostikinställningar:
STÄLLA https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/providers/microsoft.insights/diagnosticSettings/{settingsName}?api-version=2017-05-01-preview

Mer information finns i rest-API:et för diagnostikinställningar
eller Diagnostikinställningar PowerShell
Bool
isStorageSecondaryKeyInUse Anger om storageAccountAccessKey-värdet är lagringens sekundära nyckel. Bool
retentionDays Anger hur många dagar som ska sparas i granskningsloggarna i lagringskontot. Int
stat Anger principens tillstånd. Om tillståndet är Aktiverat krävs storageEndpoint ellerazureMonitorTargetEnabled. "Inaktiverad"
"Aktiverad" (krävs)
storageAccountAccessKey Anger identifierarnyckeln för granskningslagringskontot. Om tillståndet är Aktiverat och storageEndpoint har angetts krävs storageAccountAccessKey. sträng
storageAccountSubscriptionId Anger prenumerations-ID för bloblagring. sträng

Begränsningar:
Min längd = 36
Maximal längd = 36
Mönster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
storageEndpoint (på engelska) Anger bloblagringsslutpunkten (t.ex. https://MyAccount.blob.core.windows.net). Om tillståndet är Aktiverat krävs storageEndpoint. sträng

Resursdefinition för ARM-mall

Resurstypen workspaces/sqlPools/auditingSettings kan distribueras med åtgärder som mål:

Användningsexempel

Resursformat

Om du vill skapa en Microsoft.Synapse/workspaces/sqlPools/auditingSettings-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.Synapse/workspaces/sqlPools/auditingSettings",
  "apiVersion": "2021-06-01",
  "name": "string",
  "properties": {
    "auditActionsAndGroups": [ "string" ],
    "isAzureMonitorTargetEnabled": "bool",
    "isStorageSecondaryKeyInUse": "bool",
    "retentionDays": "int",
    "state": "string",
    "storageAccountAccessKey": "string",
    "storageAccountSubscriptionId": "string",
    "storageEndpoint": "string"
  }
}

Egenskapsvärden

Microsoft.Synapse/workspaces/sqlPools/auditingSettings

Namn Beskrivning Värde
apiVersion API-versionen '2021-06-01'
Namn Resursnamnet "standard" (krävs)
Egenskaper Resursegenskaper. SqlPoolBlobAuditingPolicyProperties (på engelska)
typ Resurstypen "Microsoft.Synapse/workspaces/sqlPools/auditingSettings"

SqlPoolBlobAuditingPolicyProperties (på engelska)

Namn Beskrivning Värde
auditActionsAndGroups Anger Actions-Groups och åtgärder som ska granskas.

Den rekommenderade uppsättningen åtgärdsgrupper som ska användas är följande kombination – detta granskar alla frågor och lagrade procedurer som körs mot databasen samt lyckade och misslyckade inloggningar:

BATCH_COMPLETED_GROUP,
SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP,
FAILED_DATABASE_AUTHENTICATION_GROUP.

Den här kombinationen ovan är också den uppsättning som konfigureras som standard när du aktiverar granskning från Azure-portalen.

De åtgärdsgrupper som stöds för granskning är (obs! Välj endast specifika grupper som täcker dina granskningsbehov. Användning av onödiga grupper kan leda till mycket stora mängder granskningsposter:

APPLICATION_ROLE_CHANGE_PASSWORD_GROUP
BACKUP_RESTORE_GROUP
DATABASE_LOGOUT_GROUP
DATABASE_OBJECT_CHANGE_GROUP
DATABASE_OBJECT_OWNERSHIP_CHANGE_GROUP
DATABASE_OBJECT_PERMISSION_CHANGE_GROUP
DATABASE_OPERATION_GROUP
DATABASE_PERMISSION_CHANGE_GROUP
DATABASE_PRINCIPAL_CHANGE_GROUP
DATABASE_PRINCIPAL_IMPERSONATION_GROUP
DATABASE_ROLE_MEMBER_CHANGE_GROUP
MISSLYCKAD_DATABAS_AUTENTISERING_GRUPP
SCHEMA_OBJECT_ACCESS_GROUP
SCHEMA_OBJECT_CHANGE_GROUP
SCHEMA_OBJECT_OWNERSHIP_CHANGE_GROUP
SCHEMA_OBJECT_PERMISSION_CHANGE_GROUP
FRAMGÅNGSRIK_DATABAS_AUTENTISERING_GRUPP
USER_CHANGE_PASSWORD_GROUP
GRUPP_BATCH_STARTAD
Batch Avslutad Grupp

Det här är grupper som täcker alla sql-instruktioner och lagrade procedurer som körs mot databasen och som inte ska användas i kombination med andra grupper eftersom detta resulterar i dubbletter av granskningsloggar.

Mer information finns i Database-Level Granskningsåtgärdsgrupper.

För databasgranskningsprincip kan specifika åtgärder också anges (observera att Åtgärder inte kan anges för servergranskningsprincip). De åtgärder som stöds för granskning är:
UTVALD
UPPDATERA
INFOGA
TA BORT
UTFÖRA
MOTTAGA
REFERENSER

Det allmänna formuläret för att definiera en åtgärd som ska granskas är:
{action} PÅ {object} BY {principal}

Observera att <objekt> i ovanstående format kan referera till ett objekt som en tabell, vy eller lagrad procedur eller en hel databas eller ett helt schema. I de senare fallen används formulären DATABASE::{db_name} och SCHEMA::{schema_name} .

Till exempel:
VÄLJ på dbo.myTable efter offentlig
VÄLJ på DATABAS::myDatabase av public
VÄLJ på SCHEMA::mySchema efter offentlig

Mer information finns i Database-Level Granskningsåtgärder
string[]
isAzureMonitorTargetEnabled Anger om granskningshändelser skickas till Azure Monitor.
För att kunna skicka händelserna till Azure Monitor anger du "tillstånd" som "Aktiverad" och "isAzureMonitorTargetEnabled" som sant.

När du använder REST API för att konfigurera granskning bör diagnostikinställningar med diagnostikloggkategorin "SQLSecurityAuditEvents" i databasen också skapas.
Observera att för granskning på servernivå bör du använda huvuddatabasen som {databaseName}.

URI-format för diagnostikinställningar:
STÄLLA https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/providers/microsoft.insights/diagnosticSettings/{settingsName}?api-version=2017-05-01-preview

Mer information finns i rest-API:et för diagnostikinställningar
eller Diagnostikinställningar PowerShell
Bool
isStorageSecondaryKeyInUse Anger om storageAccountAccessKey-värdet är lagringens sekundära nyckel. Bool
retentionDays Anger hur många dagar som ska sparas i granskningsloggarna i lagringskontot. Int
stat Anger principens tillstånd. Om tillståndet är Aktiverat krävs storageEndpoint ellerazureMonitorTargetEnabled. "Inaktiverad"
"Aktiverad" (krävs)
storageAccountAccessKey Anger identifierarnyckeln för granskningslagringskontot. Om tillståndet är Aktiverat och storageEndpoint har angetts krävs storageAccountAccessKey. sträng
storageAccountSubscriptionId Anger prenumerations-ID för bloblagring. sträng

Begränsningar:
Min längd = 36
Maximal längd = 36
Mönster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
storageEndpoint (på engelska) Anger bloblagringsslutpunkten (t.ex. https://MyAccount.blob.core.windows.net). Om tillståndet är Aktiverat krävs storageEndpoint. sträng

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen workspaces/sqlPools/auditingSettings kan distribueras med åtgärder som mål:

  • Resursgrupper För en lista över ändrade egenskaper i varje API-version, se ändringslogg.

Resursformat

Om du vill skapa en Microsoft.Synapse/workspaces/sqlPools/auditingSettings-resurs lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Synapse/workspaces/sqlPools/auditingSettings@2021-06-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      auditActionsAndGroups = [
        "string"
      ]
      isAzureMonitorTargetEnabled = bool
      isStorageSecondaryKeyInUse = bool
      retentionDays = int
      state = "string"
      storageAccountAccessKey = "string"
      storageAccountSubscriptionId = "string"
      storageEndpoint = "string"
    }
  }
}

Egenskapsvärden

Microsoft.Synapse/workspaces/sqlPools/auditingSettings

Namn Beskrivning Värde
Namn Resursnamnet "standard" (krävs)
föräldra_id ID för resursen som är överordnad för den här resursen. ID för resurs av typen: arbetsytor/sqlPools
Egenskaper Resursegenskaper. SqlPoolBlobAuditingPolicyProperties (på engelska)
typ Resurstypen "Microsoft.Synapse/workspaces/sqlPools/auditingSettings@2021-06-01"

SqlPoolBlobAuditingPolicyProperties (på engelska)

Namn Beskrivning Värde
auditActionsAndGroups Anger Actions-Groups och åtgärder som ska granskas.

Den rekommenderade uppsättningen åtgärdsgrupper som ska användas är följande kombination – detta granskar alla frågor och lagrade procedurer som körs mot databasen samt lyckade och misslyckade inloggningar:

BATCH_COMPLETED_GROUP,
SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP,
FAILED_DATABASE_AUTHENTICATION_GROUP.

Den här kombinationen ovan är också den uppsättning som konfigureras som standard när du aktiverar granskning från Azure-portalen.

De åtgärdsgrupper som stöds för granskning är (obs! Välj endast specifika grupper som täcker dina granskningsbehov. Användning av onödiga grupper kan leda till mycket stora mängder granskningsposter:

APPLICATION_ROLE_CHANGE_PASSWORD_GROUP
BACKUP_RESTORE_GROUP
DATABASE_LOGOUT_GROUP
DATABASE_OBJECT_CHANGE_GROUP
DATABASE_OBJECT_OWNERSHIP_CHANGE_GROUP
DATABASE_OBJECT_PERMISSION_CHANGE_GROUP
DATABASE_OPERATION_GROUP
DATABASE_PERMISSION_CHANGE_GROUP
DATABASE_PRINCIPAL_CHANGE_GROUP
DATABASE_PRINCIPAL_IMPERSONATION_GROUP
DATABASE_ROLE_MEMBER_CHANGE_GROUP
MISSLYCKAD_DATABAS_AUTENTISERING_GRUPP
SCHEMA_OBJECT_ACCESS_GROUP
SCHEMA_OBJECT_CHANGE_GROUP
SCHEMA_OBJECT_OWNERSHIP_CHANGE_GROUP
SCHEMA_OBJECT_PERMISSION_CHANGE_GROUP
FRAMGÅNGSRIK_DATABAS_AUTENTISERING_GRUPP
USER_CHANGE_PASSWORD_GROUP
GRUPP_BATCH_STARTAD
Batch Avslutad Grupp

Det här är grupper som täcker alla sql-instruktioner och lagrade procedurer som körs mot databasen och som inte ska användas i kombination med andra grupper eftersom detta resulterar i dubbletter av granskningsloggar.

Mer information finns i Database-Level Granskningsåtgärdsgrupper.

För databasgranskningsprincip kan specifika åtgärder också anges (observera att Åtgärder inte kan anges för servergranskningsprincip). De åtgärder som stöds för granskning är:
UTVALD
UPPDATERA
INFOGA
TA BORT
UTFÖRA
MOTTAGA
REFERENSER

Det allmänna formuläret för att definiera en åtgärd som ska granskas är:
{action} PÅ {object} BY {principal}

Observera att <objekt> i ovanstående format kan referera till ett objekt som en tabell, vy eller lagrad procedur eller en hel databas eller ett helt schema. I de senare fallen används formulären DATABASE::{db_name} och SCHEMA::{schema_name} .

Till exempel:
VÄLJ på dbo.myTable efter offentlig
VÄLJ på DATABAS::myDatabase av public
VÄLJ på SCHEMA::mySchema efter offentlig

Mer information finns i Database-Level Granskningsåtgärder
string[]
isAzureMonitorTargetEnabled Anger om granskningshändelser skickas till Azure Monitor.
För att kunna skicka händelserna till Azure Monitor anger du "tillstånd" som "Aktiverad" och "isAzureMonitorTargetEnabled" som sant.

När du använder REST API för att konfigurera granskning bör diagnostikinställningar med diagnostikloggkategorin "SQLSecurityAuditEvents" i databasen också skapas.
Observera att för granskning på servernivå bör du använda huvuddatabasen som {databaseName}.

URI-format för diagnostikinställningar:
STÄLLA https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/providers/microsoft.insights/diagnosticSettings/{settingsName}?api-version=2017-05-01-preview

Mer information finns i rest-API:et för diagnostikinställningar
eller Diagnostikinställningar PowerShell
Bool
isStorageSecondaryKeyInUse Anger om storageAccountAccessKey-värdet är lagringens sekundära nyckel. Bool
retentionDays Anger hur många dagar som ska sparas i granskningsloggarna i lagringskontot. Int
stat Anger principens tillstånd. Om tillståndet är Aktiverat krävs storageEndpoint ellerazureMonitorTargetEnabled. "Inaktiverad"
"Aktiverad" (krävs)
storageAccountAccessKey Anger identifierarnyckeln för granskningslagringskontot. Om tillståndet är Aktiverat och storageEndpoint har angetts krävs storageAccountAccessKey. sträng
storageAccountSubscriptionId Anger prenumerations-ID för bloblagring. sträng

Begränsningar:
Min längd = 36
Maximal längd = 36
Mönster = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
storageEndpoint (på engelska) Anger bloblagringsslutpunkten (t.ex. https://MyAccount.blob.core.windows.net). Om tillståndet är Aktiverat krävs storageEndpoint. sträng