Switch branches/tags
Nothing to show
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
ConfigurationApi
Properties
Providers
Audit.NET.AzureStorage.csproj
README.md

README.md

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

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 example:

Audit.Core.Configuration.DataProvider = new AzureBlobDataProvider()
{
    ConnectionString = "DefaultEndpointsProtocol=https;AccountName=your account;AccountKey=your key",
    ContainerName = "event",
    BlobNameBuilder = ev => $"{ev.StartDate:yyyy-MM}/{ev.Environment.UserName}/{Guid.NewGuid()}.json"
};

Or by using the fluent configuration API via UseAzureBlobStorage method:

Audit.Core.Configuration.Setup()
    .UseAzureBlobStorage(config => config
        .ConnectionString("DefaultEndpointsProtocol=https;AccountName=your account;AccountKey=your key")
        .ContainerName("event")
        .BlobNameBuilder(ev => $"{ev.StartDate:yyyy-MM}/{ev.Environment.UserName}/{Guid.NewGuid()}.json"));

Provider Options

Mandatory:

  • ConnectionString/ConnectionStringBuilder: The Azure Storage connection string.

Optional:

  • ContainerName/ContainerNameBuilder: The container name to use (see the naming restrictions here). By default, "event" is used as the container name.
  • BlobNameBuilder: 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.
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(e => 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($"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 defined 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.