Audit.NET.AzureStorage
27.0.1
See the version list below for details.
dotnet add package Audit.NET.AzureStorage --version 27.0.1
NuGet\Install-Package Audit.NET.AzureStorage -Version 27.0.1
<PackageReference Include="Audit.NET.AzureStorage" Version="27.0.1" />
paket add Audit.NET.AzureStorage --version 27.0.1
#r "nuget: Audit.NET.AzureStorage, 27.0.1"
// Install Audit.NET.AzureStorage as a Cake Addin #addin nuget:?package=Audit.NET.AzureStorage&version=27.0.1 // Install Audit.NET.AzureStorage as a Cake Tool #tool nuget:?package=Audit.NET.AzureStorage&version=27.0.1
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
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
- For Azure Blob storage use:
Audit.NET.AzureStorageBlobs
- For Azure Table storage use:
Audit.NET.AzureStorageTables
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 IDhttps://storage.azure.com/
is used.EndpointSuffix
: (Optional) Specifies a custom DNS endpoint suffix to use for the storage services. Default iscore.windows.net
.UseHttps
: (Optional) Specifies whether to use HTTPS to connect to storage service endpoints. Default istrue
.
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.
Product | Versions 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. |
.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. |
-
.NETFramework 4.6.2
- Audit.NET (>= 27.0.1)
- Microsoft.Azure.Services.AppAuthentication (>= 1.0.3)
- Microsoft.IdentityModel.Clients.ActiveDirectory (>= 4.5.1)
- WindowsAzure.Storage (>= 9.3.3)
-
.NETStandard 2.0
- Audit.NET (>= 27.0.1)
- Microsoft.Azure.Services.AppAuthentication (>= 1.0.3)
- Microsoft.IdentityModel.Clients.ActiveDirectory (>= 4.5.1)
- WindowsAzure.Storage (>= 9.3.3)
-
net6.0
- Audit.NET (>= 27.0.1)
- Microsoft.Azure.Services.AppAuthentication (>= 1.0.3)
- Microsoft.IdentityModel.Clients.ActiveDirectory (>= 4.5.1)
- WindowsAzure.Storage (>= 9.3.3)
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 |
---|---|---|
27.0.3 | 165 | 9/25/2024 |
27.0.2 | 123 | 9/19/2024 |
27.0.1 | 183 | 9/4/2024 |
27.0.0 | 97 | 9/3/2024 |
26.0.1 | 129 | 8/22/2024 |
26.0.0 | 450 | 7/19/2024 |
25.0.7 | 512 | 7/4/2024 |
25.0.6 | 102 | 6/24/2024 |
25.0.5 | 818 | 6/18/2024 |
25.0.4 | 1,215 | 3/24/2024 |
25.0.3 | 181 | 3/13/2024 |
25.0.2 | 308 | 3/12/2024 |
25.0.1 | 430 | 2/28/2024 |
25.0.0 | 363 | 2/16/2024 |
24.0.1 | 229 | 2/12/2024 |
24.0.0 | 137 | 2/12/2024 |
23.0.0 | 3,584 | 12/14/2023 |
22.1.0 | 144 | 12/9/2023 |
22.0.2 | 198 | 12/1/2023 |
22.0.1 | 1,173 | 11/16/2023 |
22.0.0 | 140 | 11/14/2023 |
21.1.0 | 478 | 10/9/2023 |
21.0.4 | 229 | 9/15/2023 |
21.0.3 | 3,155 | 7/9/2023 |
21.0.2 | 204 | 7/6/2023 |
21.0.1 | 867 | 5/27/2023 |
21.0.0 | 1,037 | 4/15/2023 |
20.2.4 | 422 | 3/27/2023 |
20.2.3 | 290 | 3/17/2023 |
20.2.2 | 265 | 3/14/2023 |
20.2.1 | 290 | 3/11/2023 |
20.2.0 | 853 | 3/7/2023 |
20.1.6 | 315 | 2/23/2023 |
20.1.5 | 4,558 | 2/9/2023 |
20.1.4 | 2,273 | 1/28/2023 |
20.1.3 | 739 | 12/21/2022 |
20.1.2 | 504 | 12/14/2022 |
20.1.1 | 356 | 12/12/2022 |
20.1.0 | 542 | 12/4/2022 |
20.0.4 | 426 | 11/30/2022 |
20.0.3 | 1,705 | 10/28/2022 |
20.0.2 | 480 | 10/26/2022 |
20.0.1 | 517 | 10/21/2022 |
20.0.0 | 600 | 10/1/2022 |
19.4.1 | 933 | 9/10/2022 |
19.4.0 | 2,769 | 9/2/2022 |
19.3.0 | 860 | 8/23/2022 |
19.2.2 | 536 | 8/11/2022 |
19.2.1 | 518 | 8/6/2022 |
19.2.0 | 675 | 7/24/2022 |
19.1.4 | 13,019 | 5/23/2022 |
19.1.3 | 554 | 5/22/2022 |
19.1.2 | 657 | 5/18/2022 |
19.1.1 | 10,796 | 4/28/2022 |
19.1.0 | 19,615 | 4/10/2022 |
19.0.7 | 5,353 | 3/13/2022 |
19.0.6 | 652 | 3/7/2022 |
19.0.5 | 2,547 | 1/28/2022 |
19.0.4 | 911 | 1/23/2022 |
19.0.3 | 14,456 | 12/14/2021 |
19.0.2 | 449 | 12/11/2021 |
19.0.1 | 2,201 | 11/20/2021 |
19.0.0 | 813 | 11/11/2021 |
19.0.0-rc.net60.2 | 168 | 9/26/2021 |
19.0.0-rc.net60.1 | 211 | 9/16/2021 |
18.1.6 | 4,638 | 9/26/2021 |
18.1.5 | 5,050 | 9/7/2021 |
18.1.4 | 531 | 9/6/2021 |
18.1.3 | 3,583 | 8/19/2021 |
18.1.2 | 9,998 | 8/8/2021 |
18.1.1 | 2,266 | 8/5/2021 |
18.1.0 | 620 | 8/1/2021 |
18.0.1 | 533 | 7/30/2021 |
18.0.0 | 1,222 | 7/26/2021 |
17.0.8 | 1,076 | 7/7/2021 |
17.0.7 | 2,110 | 6/16/2021 |
17.0.6 | 548 | 6/5/2021 |
17.0.5 | 947 | 5/28/2021 |
17.0.4 | 7,431 | 5/4/2021 |
17.0.3 | 525 | 5/1/2021 |
17.0.2 | 1,506 | 4/22/2021 |
17.0.1 | 9,844 | 4/18/2021 |
17.0.0 | 4,407 | 3/26/2021 |
16.5.6 | 560 | 3/25/2021 |
16.5.5 | 530 | 3/23/2021 |
16.5.4 | 2,001 | 3/9/2021 |
16.5.3 | 829 | 2/26/2021 |
16.5.2 | 551 | 2/23/2021 |
16.5.1 | 1,088 | 2/21/2021 |
16.5.0 | 598 | 2/17/2021 |
16.4.5 | 531 | 2/15/2021 |
16.4.4 | 2,899 | 2/5/2021 |
16.4.3 | 1,271 | 1/27/2021 |
16.4.2 | 568 | 1/22/2021 |
16.4.1 | 587 | 1/21/2021 |
16.4.0 | 1,022 | 1/11/2021 |
16.3.3 | 605 | 1/8/2021 |
16.3.2 | 602 | 1/3/2021 |
16.3.1 | 605 | 12/31/2020 |
16.3.0 | 566 | 12/30/2020 |
16.2.1 | 3,637 | 12/27/2020 |
16.2.0 | 8,669 | 10/13/2020 |
16.1.5 | 653 | 10/4/2020 |
16.1.4 | 917 | 9/17/2020 |
16.1.3 | 1,419 | 9/13/2020 |
16.1.2 | 636 | 9/9/2020 |
16.1.1 | 706 | 9/3/2020 |
16.1.0 | 4,737 | 8/19/2020 |
16.0.3 | 736 | 8/15/2020 |
16.0.2 | 1,065 | 8/9/2020 |
16.0.1 | 727 | 8/8/2020 |
16.0.0 | 605 | 8/7/2020 |
15.3.0 | 3,815 | 7/23/2020 |
15.2.3 | 982 | 7/14/2020 |
15.2.2 | 11,232 | 5/19/2020 |
15.2.1 | 1,230 | 5/12/2020 |
15.2.0 | 674 | 5/9/2020 |
15.1.1 | 2,124 | 5/4/2020 |
15.1.0 | 6,564 | 4/13/2020 |
15.0.5 | 8,352 | 3/18/2020 |
15.0.4 | 2,561 | 2/28/2020 |
15.0.3 | 814 | 2/26/2020 |
15.0.2 | 6,674 | 1/20/2020 |
15.0.1 | 18,679 | 1/10/2020 |
15.0.0 | 944 | 12/17/2019 |
14.9.1 | 1,062 | 11/30/2019 |
14.9.0 | 693 | 11/29/2019 |
14.8.1 | 718 | 11/26/2019 |
14.8.0 | 713 | 11/20/2019 |
14.7.0 | 3,225 | 10/9/2019 |
14.6.6 | 748 | 10/8/2019 |
14.6.5 | 1,481 | 9/27/2019 |
14.6.4 | 909 | 9/21/2019 |
14.6.3 | 991 | 8/12/2019 |
14.6.2 | 766 | 8/3/2019 |
14.6.1 | 772 | 8/3/2019 |
14.6.0 | 767 | 7/26/2019 |
14.5.7 | 1,159 | 7/18/2019 |
14.5.6 | 870 | 7/10/2019 |
14.5.5 | 793 | 7/1/2019 |
14.5.4 | 746 | 6/17/2019 |
14.5.3 | 748 | 6/5/2019 |
14.5.2 | 781 | 5/30/2019 |
14.5.1 | 2,260 | 5/28/2019 |
14.5.0 | 955 | 5/24/2019 |
14.4.0 | 1,299 | 5/22/2019 |
14.3.4 | 807 | 5/14/2019 |
14.3.3 | 994 | 5/9/2019 |
14.3.2 | 828 | 4/30/2019 |
14.3.1 | 774 | 4/27/2019 |
14.3.0 | 795 | 4/24/2019 |
14.2.3 | 800 | 4/17/2019 |
14.2.2 | 801 | 4/10/2019 |
14.2.1 | 757 | 4/5/2019 |
14.2.0 | 16,196 | 3/16/2019 |
14.1.1 | 1,184 | 3/8/2019 |
14.1.0 | 1,102 | 2/11/2019 |
14.0.4 | 1,094 | 1/31/2019 |
14.0.3 | 1,348 | 1/22/2019 |
14.0.2 | 929 | 12/15/2018 |
14.0.1 | 1,686 | 11/29/2018 |
14.0.0 | 988 | 11/19/2018 |
13.3.0 | 943 | 11/16/2018 |
13.2.2 | 934 | 11/15/2018 |
13.2.1 | 959 | 11/13/2018 |
13.2.0 | 979 | 10/31/2018 |
13.1.5 | 946 | 10/31/2018 |
13.1.4 | 983 | 10/25/2018 |
13.1.3 | 1,023 | 10/18/2018 |
13.1.2 | 1,174 | 9/12/2018 |
13.1.1 | 1,014 | 9/11/2018 |
13.1.0 | 1,004 | 9/11/2018 |
13.0.0 | 1,742 | 8/29/2018 |
12.3.6 | 1,024 | 8/29/2018 |
12.3.5 | 1,125 | 8/22/2018 |
12.3.4 | 1,064 | 8/21/2018 |
12.3.3 | 25,774 | 8/21/2018 |
12.3.2 | 1,057 | 8/20/2018 |
12.3.1 | 1,059 | 8/20/2018 |
12.3.0 | 1,072 | 8/20/2018 |
12.2.2 | 1,121 | 8/15/2018 |
12.2.1 | 1,120 | 8/9/2018 |
12.2.0 | 1,114 | 8/8/2018 |
12.1.11 | 1,093 | 7/30/2018 |
12.1.10 | 1,082 | 7/20/2018 |
12.1.9 | 1,312 | 7/10/2018 |
12.1.8 | 1,156 | 7/2/2018 |
12.1.7 | 4,988 | 6/7/2018 |
12.1.6 | 1,254 | 6/4/2018 |
12.1.5 | 1,192 | 6/2/2018 |
12.1.4 | 1,125 | 5/25/2018 |
12.1.3 | 1,335 | 5/16/2018 |
12.1.2 | 1,158 | 5/15/2018 |
12.1.1 | 1,285 | 5/14/2018 |
12.1.0 | 1,219 | 5/9/2018 |
12.0.7 | 1,303 | 5/5/2018 |
12.0.6 | 1,178 | 5/4/2018 |
12.0.5 | 1,251 | 5/3/2018 |
12.0.4 | 1,337 | 4/30/2018 |
12.0.3 | 1,319 | 4/30/2018 |
12.0.2 | 1,295 | 4/27/2018 |
12.0.1 | 1,186 | 4/25/2018 |
12.0.0 | 1,192 | 4/22/2018 |
11.2.0 | 1,677 | 4/11/2018 |
11.1.0 | 1,174 | 4/8/2018 |
11.0.8 | 1,270 | 3/26/2018 |
11.0.7 | 1,271 | 3/20/2018 |
11.0.6 | 1,292 | 3/7/2018 |
11.0.5 | 1,125 | 2/22/2018 |
11.0.4 | 1,280 | 2/14/2018 |
11.0.3 | 1,219 | 2/12/2018 |
11.0.2 | 1,173 | 2/9/2018 |
11.0.1 | 1,250 | 1/29/2018 |
11.0.0 | 1,256 | 1/15/2018 |
10.0.3 | 1,314 | 12/29/2017 |
10.0.2 | 1,240 | 12/26/2017 |
10.0.1 | 1,261 | 12/18/2017 |
10.0.0 | 1,174 | 12/18/2017 |
9.3.0 | 1,346 | 12/17/2017 |
9.2.0 | 1,268 | 12/17/2017 |
9.1.3 | 11,515 | 12/5/2017 |
9.1.2 | 1,398 | 11/27/2017 |
9.1.1 | 1,242 | 11/21/2017 |
9.1.0 | 1,169 | 11/21/2017 |
9.0.1 | 1,211 | 11/11/2017 |
9.0.0 | 1,210 | 11/10/2017 |
8.7.0 | 1,202 | 11/9/2017 |
8.6.0 | 1,204 | 11/9/2017 |
8.5.0 | 2,059 | 10/3/2017 |
8.4.0 | 1,233 | 10/3/2017 |
8.3.1 | 1,550 | 9/8/2017 |
8.3.0 | 1,274 | 9/8/2017 |
8.2.0 | 1,256 | 9/4/2017 |
8.1.0 | 1,244 | 8/22/2017 |
8.0.0 | 5,957 | 8/19/2017 |
7.1.3 | 1,205 | 8/14/2017 |
7.1.2 | 1,189 | 8/2/2017 |
7.1.1 | 1,284 | 7/26/2017 |
7.1.0 | 1,309 | 7/5/2017 |
7.0.9 | 1,212 | 6/28/2017 |
7.0.8 | 1,245 | 6/19/2017 |
7.0.6 | 1,282 | 4/7/2017 |
7.0.5 | 1,236 | 3/21/2017 |
7.0.4 | 1,274 | 3/21/2017 |
7.0.3 | 1,301 | 3/20/2017 |
7.0.2 | 1,261 | 3/13/2017 |
7.0.0 | 1,296 | 3/1/2017 |
6.2.0 | 1,347 | 2/25/2017 |
6.1.0 | 1,268 | 2/14/2017 |
6.0.0 | 1,313 | 2/9/2017 |
5.3.0 | 1,285 | 2/5/2017 |
5.2.0 | 1,433 | 1/26/2017 |
5.1.0 | 1,242 | 1/19/2017 |
5.0.0 | 1,202 | 1/7/2017 |
4.11.0 | 1,285 | 1/5/2017 |
4.10.0 | 1,230 | 12/31/2016 |
4.9.0 | 1,238 | 12/26/2016 |
4.8.0 | 1,309 | 12/17/2016 |
4.7.0 | 1,269 | 12/8/2016 |
4.6.5 | 1,185 | 12/4/2016 |
4.6.4 | 1,248 | 11/25/2016 |
4.6.2 | 1,241 | 11/18/2016 |
4.6.1 | 1,227 | 11/15/2016 |
4.6.0 | 1,247 | 11/11/2016 |
4.5.9 | 1,551 | 11/2/2016 |
4.5.8 | 1,295 | 11/2/2016 |
4.5.7 | 1,229 | 10/26/2016 |
4.5.6 | 1,244 | 10/6/2016 |
4.5.5 | 1,279 | 10/3/2016 |
4.5.4 | 1,198 | 10/2/2016 |
4.5.3 | 1,202 | 9/30/2016 |
4.5.2 | 1,240 | 9/28/2016 |
4.5.1 | 1,215 | 9/28/2016 |
4.5.0 | 1,190 | 9/28/2016 |
4.4.0 | 1,437 | 9/23/2016 |
4.3.0 | 1,382 | 9/22/2016 |