Audit.NET.AzureStorage 31.0.0

Suggested Alternatives

Audit.NET.AzureStorageBlobs

Additional Details

This library uses the legacy client WindowsAzure.Storage package which has been deprecated and split into multiple client libraries (Azure.Storage.Blobs, Azure.Data.Tables, etc).

Suggested Alternatives

For Azure Blob storage use: Audit.NET.AzureStorageBlobs
For Azure Table storage use: Audit.NET.AzureStorageTables

dotnet add package Audit.NET.AzureStorage --version 31.0.0
                    
NuGet\Install-Package Audit.NET.AzureStorage -Version 31.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Audit.NET.AzureStorage" Version="31.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Audit.NET.AzureStorage" Version="31.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Audit.NET.AzureStorage" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Audit.NET.AzureStorage --version 31.0.0
                    
#r "nuget: Audit.NET.AzureStorage, 31.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Audit.NET.AzureStorage@31.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Audit.NET.AzureStorage&version=31.0.0
                    
Install as a Cake Addin
#tool nuget:?package=Audit.NET.AzureStorage&version=31.0.0
                    
Install as a Cake Tool

Audit.NET.AzureStorage

Azure Blob and Azure Table storage providers for Audit.NET library (An extensible framework to audit executing operations in .NET).

Store the audit events in an Azure Storage container, as Blob files in JSON format, or as rows on an Azure Table.

Install

NuGet Package To install the package run the following command on the Package Manager Console:

PM> Install-Package Audit.NET.AzureStorage

NuGet Status NuGet Count

IMPORTANT NOTES

Warning

This library has been deprecated.

This library uses the legacy client WindowsAzure.Storage package which has been deprecated and split into multiple client libraries (Azure.Storage.Blobs, Azure.Data.Tables, etc).

Suggested Alternatives

Usage

Please see the Audit.NET Readme

Configuration

Set the static Audit.Core.Configuration.DataProvider property to set one of the Azure Storage data providers, or call the UseAzureBlobStorage()/UseAzureTableStorage() methods on the fluent configuration. This should be done before any AuditScope creation, i.e. during application startup.

1- Azure Blob Storage

Stores each audit event as a BLOB file with the JSON representation of the Audit Event.

Configuration examples

Using a connection string:

Audit.Core.Configuration.Setup()
    .UseAzureBlobStorage(config => config
        .ConnectionString("DefaultEndpointsProtocol=https;AccountName=your account;AccountKey=your key")
        .ContainerName("event")
        .BlobName(ev => $"{ev.StartDate:yyyy-MM}/{ev.Environment.UserName}/{Guid.NewGuid()}.json")
        .WithAccessTier(StandardBlobTier.Cool)
        .WithMetadata(ev => new Dictionary<string, string>() { { "user", ev.Environment.UserName } }));

Using Azure Active Directory (authentication token):

Audit.Core.Configuration.Setup()
    .UseAzureBlobStorage(config => config
        .AzureActiveDirectory(adConfig => adConfig
            .AccountName("your account")
            .TenantId("your tenant ID"))
        .ContainerName("event")
        .BlobName(ev => $"{Guid.NewGuid()}.json"));
Provider Options
Authentication options

Depending on the authentication method, you can call one of the following two methods:

  • ConnectionString: To use Account Access Key or SAS authentication via an Azure Storage connection string.
  • AzureActiveDirectory: To use Azure Active Directory authentication via access tokens acquired automatically.
AzureActiveDirectory configuration

When using Azure Active Directory authentication you can provide the following configuration to AzureActiveDirectory() method:

  • AccountName: The Account Name of your Azure Storage.

  • TenantId: The Tenant ID, this is your Azure Active Directory ID. See How to get it.

  • AuthConnectionString: (Optional) Specifies a custom connection string for the Token Provider. Check this for more information.

  • ResouceUrl: (Optional) Specifies a custom resource URL to acquire the tokens for. By default the Azure Storage resource ID https://storage.azure.com/ is used.

  • EndpointSuffix: (Optional) Specifies a custom DNS endpoint suffix to use for the storage services. Default is core.windows.net.

  • UseHttps: (Optional) Specifies whether to use HTTPS to connect to storage service endpoints. Default is true.

Container options
  • ContainerName/ContainerNameBuilder: The container name to use (see the naming restrictions here). By default, "event" is used as the container name.
  • BlobName: A function that takes an Audit Event and returns a unique blob name for the event. The resulting name can include path information (slash separated sub-folders). By default, a random Guid is used as the blob name.
  • WithAccessTier: (optional) A function that takes an Audit Event and returns the Standard BLOB Access Tier to set after the blob upload. Note that using this setting implies that each upload will require two calls: one to upload the blob, and another one to set the access tier.
  • WithMetadata: (optional) A function that takes an Audit Event and returns a set of key-value pairs to be associated with the blob storage resource.
Query events

This provider implements GetEvent and GetEventAsync methods to obtain an audit event by id:

var event = blobDataProvider.GetEvent("eventId");

2- Azure Table Storage

Stores each audit event as a new row on an Azure Table, allowing to dynamically configure the columns.

Configuration example:

Audit.Core.Configuration.DataProvider = new AzureTableDataProvider()
{
    ConnectionString = "DefaultEndpointsProtocol=https;AccountName=your account;AccountKey=your key",
    TableName = "Events",
    TableEntityMapper = ev => new AuditEventTableEntity(ev)
};

Or by using the fluent configuration API via UseAzureTableStorage method:

Audit.Core.Configuration.Setup()
    .UseAzureTableStorage(_ => _
        .ConnectionString("DefaultEndpointsProtocol=https;AccountName=your account;AccountKey=your key")
        .TableName("Events")
        .EntityMapper(ev => new AuditEventTableEntity(ev)));

You can set the entity mapper to return any class implementing ITableEntity, as the provided default AuditEventTableEntity.

As an alternative, you can use EntityBuilder() method to configure the columns mapping:

Audit.Core.Configuration.Setup()
    .UseAzureTableStorage(_ => _
        .ConnectionString("DefaultEndpointsProtocol=https;AccountName=your account;AccountKey=your key")
        .TableName("Events")
        .EntityBuilder(e => e
            .PartitionKey(ev => $"Events{ev.StartDate:yyyyMM}")
            .RowKey(ev => Guid.NewGuid().ToString())
            .Columns(c => c.FromObject(ev => new { Date = ev.StartDate, AuditEventJson = ev.ToJson() }))));
Provider Options

Mandatory:

  • ConnectionString/ConnectionStringBuilder: The Azure Storage connection string.

Optional:

  • TableName: The table name to use. By default, "event" is used as the table name.
  • EntityMapper: A function that defines a mapping from an Audit Event to a Table Entity.
  • EntityBuilder: An alternative way to dynamically specify the table entity mapping for audit events:
    • PartitionKey: A function of the audit event that returns the partition key to use.
    • RowKey: A function of the audit event that returns the row key to use.
    • Columns: Provides a way to generate the extra columns from an anonymous object or a dictionary.
Query events

The Azure Table data provider does not implements GetEvent nor GetEventAsync methods.

ZZZ Projects - Sponsorship

Entity Framework Extensions and Dapper Plus are major sponsors and are proud to contribute to the development of Audit.NET

Combine the power of auditing with the speed of Bulk Operations to get the best of both worlds — audit and performance.

Entity Framework Extensions - Sponsor

Dapper Plus - Sponsor

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
31.0.0 0 8/22/2025 31.0.0 is deprecated because it is no longer maintained.
30.1.3 16 8/19/2025
30.1.2 95 8/14/2025
30.1.1 98 8/13/2025
30.0.2 408 6/26/2025
30.0.1 274 5/29/2025
30.0.0 165 5/27/2025
29.0.1 254 5/8/2025
29.0.0 190 5/6/2025
28.0.0 190 5/5/2025
27.5.3 246 4/23/2025
27.5.2 502 4/9/2025
27.5.1 171 4/4/2025
27.5.0 2,779 3/5/2025
27.4.1 218 2/9/2025
27.4.0 351 1/29/2025
27.3.3 280 1/21/2025
27.3.2 1,034 12/11/2024
27.3.1 150 12/10/2024
27.3.0 183 12/8/2024
27.2.0 292 11/23/2024
27.1.1 1,505 10/28/2024
27.1.0 853 10/24/2024
27.0.3 7,183 9/25/2024
27.0.2 562 9/19/2024
27.0.1 287 9/4/2024
27.0.0 142 9/3/2024
26.0.1 172 8/22/2024
26.0.0 1,626 7/19/2024
25.0.7 860 7/4/2024
25.0.6 157 6/24/2024
25.0.5 867 6/18/2024
25.0.4 1,601 3/24/2024
25.0.3 222 3/13/2024
25.0.2 752 3/12/2024
25.0.1 622 2/28/2024
25.0.0 410 2/16/2024
24.0.1 288 2/12/2024
24.0.0 179 2/12/2024
23.0.0 6,451 12/14/2023
22.1.0 171 12/9/2023
22.0.2 247 12/1/2023
22.0.1 1,698 11/16/2023
22.0.0 171 11/14/2023
21.1.0 604 10/9/2023
21.0.4 270 9/15/2023
21.0.3 3,625 7/9/2023
21.0.2 257 7/6/2023
21.0.1 974 5/27/2023
21.0.0 1,094 4/15/2023
20.2.4 508 3/27/2023
20.2.3 347 3/17/2023
20.2.2 327 3/14/2023
20.2.1 342 3/11/2023
20.2.0 930 3/7/2023
20.1.6 381 2/23/2023
20.1.5 4,613 2/9/2023
20.1.4 2,523 1/28/2023
20.1.3 804 12/21/2022
20.1.2 602 12/14/2022
20.1.1 421 12/12/2022
20.1.0 609 12/4/2022
20.0.4 480 11/30/2022
20.0.3 1,786 10/28/2022
20.0.2 545 10/26/2022
20.0.1 584 10/21/2022
20.0.0 671 10/1/2022
19.4.1 1,001 9/10/2022
19.4.0 3,602 9/2/2022
19.3.0 924 8/23/2022
19.2.2 599 8/11/2022
19.2.1 584 8/6/2022
19.2.0 738 7/24/2022
19.1.4 13,270 5/23/2022
19.1.3 622 5/22/2022
19.1.2 730 5/18/2022
19.1.1 11,271 4/28/2022
19.1.0 20,264 4/10/2022
19.0.7 5,442 3/13/2022
19.0.6 734 3/7/2022
19.0.5 2,626 1/28/2022
19.0.4 987 1/23/2022
19.0.3 14,550 12/14/2021
19.0.2 534 12/11/2021
19.0.1 2,334 11/20/2021
19.0.0 912 11/11/2021
19.0.0-rc.net60.2 252 9/26/2021
19.0.0-rc.net60.1 293 9/16/2021
18.1.6 4,762 9/26/2021
18.1.5 6,015 9/7/2021
18.1.4 615 9/6/2021
18.1.3 3,704 8/19/2021
18.1.2 10,081 8/8/2021
18.1.1 2,347 8/5/2021
18.1.0 703 8/1/2021
18.0.1 608 7/30/2021
18.0.0 1,529 7/26/2021
17.0.8 4,722 7/7/2021
17.0.7 2,195 6/16/2021
17.0.6 633 6/5/2021
17.0.5 1,031 5/28/2021
17.0.4 7,523 5/4/2021
17.0.3 606 5/1/2021
17.0.2 1,602 4/22/2021
17.0.1 14,378 4/18/2021
17.0.0 6,730 3/26/2021
16.5.6 652 3/25/2021
16.5.5 619 3/23/2021
16.5.4 2,106 3/9/2021
16.5.3 1,020 2/26/2021
16.5.2 651 2/23/2021
16.5.1 1,206 2/21/2021
16.5.0 700 2/17/2021
16.4.5 617 2/15/2021
16.4.4 2,992 2/5/2021
16.4.3 1,363 1/27/2021
16.4.2 657 1/22/2021
16.4.1 675 1/21/2021
16.4.0 1,119 1/11/2021
16.3.3 700 1/8/2021
16.3.2 697 1/3/2021
16.3.1 689 12/31/2020
16.3.0 664 12/30/2020
16.2.1 3,723 12/27/2020
16.2.0 9,967 10/13/2020
16.1.5 750 10/4/2020
16.1.4 1,023 9/17/2020
16.1.3 1,513 9/13/2020
16.1.2 728 9/9/2020
16.1.1 802 9/3/2020
16.1.0 4,850 8/19/2020
16.0.3 832 8/15/2020
16.0.2 1,161 8/9/2020
16.0.1 820 8/8/2020
16.0.0 710 8/7/2020
15.3.0 4,120 7/23/2020
15.2.3 1,078 7/14/2020
15.2.2 11,332 5/19/2020
15.2.1 1,338 5/12/2020
15.2.0 780 5/9/2020
15.1.1 2,277 5/4/2020
15.1.0 7,937 4/13/2020
15.0.5 8,587 3/18/2020
15.0.4 2,663 2/28/2020
15.0.3 921 2/26/2020
15.0.2 7,568 1/20/2020
15.0.1 19,964 1/10/2020
15.0.0 1,054 12/17/2019
14.9.1 1,554 11/30/2019
14.9.0 800 11/29/2019
14.8.1 824 11/26/2019
14.8.0 810 11/20/2019
14.7.0 3,494 10/9/2019
14.6.6 844 10/8/2019
14.6.5 1,578 9/27/2019
14.6.4 1,007 9/21/2019
14.6.3 1,097 8/12/2019
14.6.2 872 8/3/2019
14.6.1 886 8/3/2019
14.6.0 873 7/26/2019
14.5.7 1,269 7/18/2019
14.5.6 967 7/10/2019
14.5.5 899 7/1/2019
14.5.4 853 6/17/2019
14.5.3 850 6/5/2019
14.5.2 898 5/30/2019
14.5.1 8,046 5/28/2019
14.5.0 1,067 5/24/2019
14.4.0 1,403 5/22/2019
14.3.4 921 5/14/2019
14.3.3 1,106 5/9/2019
14.3.2 937 4/30/2019
14.3.1 878 4/27/2019
14.3.0 909 4/24/2019
14.2.3 908 4/17/2019
14.2.2 913 4/10/2019
14.2.1 860 4/5/2019
14.2.0 16,306 3/16/2019
14.1.1 1,289 3/8/2019
14.1.0 1,212 2/11/2019
14.0.4 1,210 1/31/2019
14.0.3 1,460 1/22/2019
14.0.2 1,042 12/15/2018
14.0.1 1,811 11/29/2018
14.0.0 1,116 11/19/2018
13.3.0 1,073 11/16/2018
13.2.2 1,058 11/15/2018
13.2.1 1,085 11/13/2018
13.2.0 1,106 10/31/2018
13.1.5 1,072 10/31/2018
13.1.4 1,107 10/25/2018
13.1.3 1,149 10/18/2018
13.1.2 1,312 9/12/2018
13.1.1 1,142 9/11/2018
13.1.0 1,154 9/11/2018
13.0.0 1,881 8/29/2018
12.3.6 1,160 8/29/2018
12.3.5 1,257 8/22/2018
12.3.4 1,200 8/21/2018
12.3.3 25,916 8/21/2018
12.3.2 1,207 8/20/2018
12.3.1 1,201 8/20/2018
12.3.0 1,215 8/20/2018
12.2.2 1,265 8/15/2018
12.2.1 1,263 8/9/2018
12.2.0 1,335 8/8/2018
12.1.11 1,309 7/30/2018
12.1.10 1,299 7/20/2018
12.1.9 1,626 7/10/2018
12.1.8 1,374 7/2/2018
12.1.7 5,306 6/7/2018
12.1.6 1,563 6/4/2018
12.1.5 1,515 6/2/2018
12.1.4 1,349 5/25/2018
12.1.3 1,657 5/16/2018
12.1.2 1,379 5/15/2018
12.1.1 1,605 5/14/2018
12.1.0 1,556 5/9/2018
12.0.7 1,630 5/5/2018
12.0.6 1,393 5/4/2018
12.0.5 1,572 5/3/2018
12.0.4 1,665 4/30/2018
12.0.3 1,646 4/30/2018
12.0.2 1,619 4/27/2018
12.0.1 1,407 4/25/2018
12.0.0 1,417 4/22/2018
11.2.0 2,010 4/11/2018
11.1.0 1,398 4/8/2018
11.0.8 1,600 3/26/2018
11.0.7 1,596 3/20/2018
11.0.6 1,616 3/7/2018
11.0.5 1,351 2/22/2018
11.0.4 1,607 2/14/2018
11.0.3 1,551 2/12/2018
11.0.2 1,399 2/9/2018
11.0.1 1,571 1/29/2018
11.0.0 1,581 1/15/2018
10.0.3 1,645 12/29/2017
10.0.2 1,565 12/26/2017
10.0.1 1,586 12/18/2017
10.0.0 1,403 12/18/2017
9.3.0 1,666 12/17/2017
9.2.0 1,615 12/17/2017
9.1.3 11,740 12/5/2017
9.1.2 1,624 11/27/2017
9.1.1 1,469 11/21/2017
9.1.0 1,397 11/21/2017
9.0.1 1,434 11/11/2017
9.0.0 1,450 11/10/2017
8.7.0 1,431 11/9/2017
8.6.0 1,438 11/9/2017
8.5.0 2,280 10/3/2017
8.4.0 1,466 10/3/2017
8.3.1 2,101 9/8/2017
8.3.0 1,507 9/8/2017
8.2.0 1,480 9/4/2017
8.1.0 1,470 8/22/2017
8.0.0 6,285 8/19/2017
7.1.3 1,427 8/14/2017
7.1.2 1,416 8/2/2017
7.1.1 1,507 7/26/2017
7.1.0 1,534 7/5/2017
7.0.9 1,440 6/28/2017
7.0.8 1,472 6/19/2017
7.0.6 1,513 4/7/2017
7.0.5 1,460 3/21/2017
7.0.4 1,503 3/21/2017
7.0.3 1,538 3/20/2017
7.0.2 1,486 3/13/2017
7.0.0 1,531 3/1/2017
6.2.0 1,575 2/25/2017
6.1.0 1,501 2/14/2017
6.0.0 1,539 2/9/2017
5.3.0 1,512 2/5/2017
5.2.0 1,666 1/26/2017
5.1.0 1,476 1/19/2017
5.0.0 1,438 1/7/2017
4.11.0 1,516 1/5/2017
4.10.0 1,459 12/31/2016
4.9.0 1,468 12/26/2016
4.8.0 1,542 12/17/2016
4.7.0 1,494 12/8/2016
4.6.5 1,415 12/4/2016
4.6.4 1,481 11/25/2016
4.6.2 1,469 11/18/2016
4.6.1 1,449 11/15/2016
4.6.0 1,478 11/11/2016
4.5.9 1,776 11/2/2016
4.5.8 1,525 11/2/2016
4.5.7 1,462 10/26/2016
4.5.6 1,465 10/6/2016
4.5.5 1,504 10/3/2016
4.5.4 1,433 10/2/2016
4.5.3 1,438 9/30/2016
4.5.2 1,472 9/28/2016
4.5.1 1,445 9/28/2016
4.5.0 1,417 9/28/2016
4.4.0 1,785 9/23/2016
4.3.0 1,616 9/22/2016