Database Blob Auditing Policies - Get

Obtient la stratégie d’audit d’objets blob d’une base de données.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/auditingSettings/default?api-version=2021-11-01

Paramètres URI

Name In Required Type Description
blobAuditingPolicyName
path True

Nom de la stratégie d’audit d’objets blob.

databaseName
path True
  • string

Nom de la base de données.

resourceGroupName
path True
  • string

Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.

serverName
path True
  • string

Le nom du serveur

subscriptionId
path True
  • string

L’ID d’abonnement d’un abonnement Azure.

api-version
query True
  • string

Version de l’API à utiliser pour la requête.

Réponses

Name Type Description
200 OK

Récupération réussie de la stratégie d’audit d’objets blob de base de données.

Other Status Codes

Réponses d’erreur : ***

  • 400 BlobAuditingIsNotSupportedOnResourceType - L’audit d’objets blob n’est actuellement pas pris en charge pour ce type de ressource.

  • 404 SourceDatabaseNotFound : la base de données source n’existe pas.

  • 404 DatabaseDoesNotExist - L’utilisateur a spécifié un nom de base de données qui n’existe pas sur cette instance de serveur.

  • 500 DatabaseIsUnavailable - Échec du chargement. Veuillez réessayer plus tard.

Exemples

Get a database's blob auditing policy

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/blobauditingtest-6852/providers/Microsoft.Sql/servers/blobauditingtest-2080/databases/testdb/auditingSettings/default?api-version=2021-11-01

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/blobauditingtest-6852/providers/Microsoft.Sql/servers/blobauditingtest-2080/databases/testdb",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/auditingSettings",
  "kind": "V12",
  "properties": {
    "state": "Disabled",
    "storageEndpoint": "",
    "retentionDays": 0,
    "auditActionsAndGroups": [],
    "storageAccountSubscriptionId": "00000000-0000-0000-0000-000000000000",
    "isStorageSecondaryKeyInUse": false,
    "isAzureMonitorTargetEnabled": false,
    "isManagedIdentityInUse": false
  }
}

Définitions

blobAuditingPolicyName

Nom de la stratégie d’audit d’objets blob.

BlobAuditingPolicyState

Spécifie l’état de l’audit. Si l’état est Activé, storageEndpoint ou isAzureMonitorTargetEnabled sont requis.

DatabaseBlobAuditingPolicy

Stratégie d’audit d’objets blob de base de données.

blobAuditingPolicyName

Nom de la stratégie d’audit d’objets blob.

Name Type Description
default
  • string

BlobAuditingPolicyState

Spécifie l’état de l’audit. Si l’état est Activé, storageEndpoint ou isAzureMonitorTargetEnabled sont requis.

Name Type Description
Disabled
  • string
Enabled
  • string

DatabaseBlobAuditingPolicy

Stratégie d’audit d’objets blob de base de données.

Name Type Description
id
  • string

ID de la ressource

kind
  • string

Type de ressource.

name
  • string

Nom de la ressource.

properties.auditActionsAndGroups
  • string[]

Spécifie les Actions-Groups et les actions à auditer.

L’ensemble recommandé de groupes d’actions à utiliser est la combinaison suivante : cela permet d’auditer toutes les requêtes et procédures stockées exécutées sur la base de données, ainsi que les connexions réussies et ayant échoué :

BATCH_COMPLETED_GROUP, SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP, FAILED_DATABASE_AUTHENTICATION_GROUP.

Cette combinaison ci-dessus est également l’ensemble configuré par défaut lors de l’activation de l’audit à partir de l’Portail Azure.

Les groupes d’actions pris en charge à auditer sont (remarque : choisissez uniquement des groupes spécifiques qui couvrent vos besoins d’audit. L’utilisation de groupes inutiles peut entraîner de très grandes quantités d’enregistrements d’audit :

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 FAILED_DATABASE_AUTHENTICATION_GROUP SCHEMA_OBJECT_ACCESS_GROUP SCHEMA_OBJECT_CHANGE_GROUP SCHEMA_OBJECT_ OWNERSHIP_CHANGE_GROUP SCHEMA_OBJECT_PERMISSION_CHANGE_GROUP SUCCESSFUL_DATABASE_AUTHENTICATION_GROUP USER_CHANGE_PASSWORD_GROUP BATCH_STARTED_GROUP BATCH_COMPLETED_GROUP DBCC_GROUP DATABASE_OWNERSHIP_CHANGE_GROUP DATABASE_CHANGE_GROUP LEDGER_OPERATION_GROUP

Il s’agit de groupes qui couvrent toutes les instructions sql et les procédures stockées exécutées sur la base de données et qui ne doivent pas être utilisés en combinaison avec d’autres groupes, car cela entraîne des journaux d’audit en double.

Pour plus d’informations, consultez Groupes d’actions d’audit au niveau de la base de données.

Pour la stratégie d’audit de base de données, des actions spécifiques peuvent également être spécifiées (notez que les actions ne peuvent pas être spécifiées pour la stratégie d’audit de serveur). Les actions prises en charge à auditer sont les suivantes : SELECT UPDATE INSERT DELETE EXECUTE RECEIVE REFERENCES

Le formulaire général de définition d’une action à auditer est : {action} ON {object} BY {principal}

Notez que dans le format ci-dessus peut faire référence à un objet comme une table, une vue ou une procédure stockée, ou une base de données ou un schéma entier. Pour les derniers cas, les formulaires DATABASE::{db_name} et SCHEMA::{schema_name} sont utilisés, respectivement.

Par exemple : SELECT sur dbo.myTable by public SELECT on DATABASE::myDatabase by public SELECT on SCHEMA::mySchema by public

Pour plus d’informations, consultez Actions d’audit au niveau de la base de données

properties.isAzureMonitorTargetEnabled
  • boolean

Spécifie si les événements d’audit sont envoyés à Azure Monitor. Pour envoyer les événements à Azure Monitor, spécifiez « State » comme « Enabled » et « IsAzureMonitorTargetEnabled » comme true.

Lorsque vous utilisez l’API REST pour configurer l’audit, les paramètres de diagnostic avec la catégorie des journaux de diagnostic « SQLSecurityAuditEvents » sur la base de données doivent également être créés. Notez que pour l’audit au niveau du serveur, vous devez utiliser la base de données « master » comme {databaseName}.

Format d’URI des paramètres de diagnostic : PUT 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

Pour plus d’informations, consultez l’API REST des paramètresde diagnostic ou PowerShell des paramètres de diagnostic

properties.isManagedIdentityInUse
  • boolean

Spécifie si l’identité managée est utilisée pour accéder au stockage d’objets blob

properties.isStorageSecondaryKeyInUse
  • boolean

Spécifie si la valeur storageAccountAccessKey est la clé secondaire du stockage.

properties.queueDelayMs
  • integer

Spécifie la durée (en millisecondes) qui peut s'écouler avant que le traitement des actions d'audit ne soit forcé. La valeur minimale par défaut est 1000 (1 seconde). Le maximum est de 2 147 483 647.

properties.retentionDays
  • integer

Spécifie le nombre de jours à conserver dans les journaux d’audit du compte de stockage.

properties.state

Spécifie l’état de l’audit. Si l’état est Activé, storageEndpoint ou isAzureMonitorTargetEnabled sont requis.

properties.storageAccountAccessKey
  • string

Spécifie la clé d’identificateur du compte de stockage d’audit. Si l’état est Activé et storageEndpoint est spécifié, ne pas spécifier storageAccountAccessKey utilise l’identité managée affectée par le système SQL Server pour accéder au stockage. Conditions préalables à l’utilisation de l’authentification d’identité managée :

  1. Affectez SQL Server une identité managée affectée par le système dans Azure Active Directory (AAD).
  2. Accordez à SQL Server’identité l’accès au compte de stockage en ajoutant le rôle RBAC « Contributeur aux données Blob du stockage » à l’identité du serveur. Pour plus d’informations, consultez Audit au stockage à l’aide de l’authentification d’identité managée
properties.storageAccountSubscriptionId
  • string

Spécifie l’ID d’abonnement de stockage d’objets blob.

properties.storageEndpoint
  • string

Spécifie le point de terminaison de stockage d’objets blob (par exemple https://MyAccount.blob.core.windows.net). Si l’état est Activé, storageEndpoint ou isAzureMonitorTargetEnabled est requis.

type
  • string

Type de ressource.