MrrHak.Extensions.FileProviders.S3FileProvider 1.1.0

The ID prefix of this package has been reserved for one of the owners of this package by Prefix Reserved
dotnet add package MrrHak.Extensions.FileProviders.S3FileProvider --version 1.1.0
NuGet\Install-Package MrrHak.Extensions.FileProviders.S3FileProvider -Version 1.1.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="MrrHak.Extensions.FileProviders.S3FileProvider" Version="1.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MrrHak.Extensions.FileProviders.S3FileProvider --version 1.1.0
#r "nuget: MrrHak.Extensions.FileProviders.S3FileProvider, 1.1.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.
// Install MrrHak.Extensions.FileProviders.S3FileProvider as a Cake Addin
#addin nuget:?package=MrrHak.Extensions.FileProviders.S3FileProvider&version=1.1.0

// Install MrrHak.Extensions.FileProviders.S3FileProvider as a Cake Tool
#tool nuget:?package=MrrHak.Extensions.FileProviders.S3FileProvider&version=1.1.0

S3 File Provider S3 File Provider

NuGet NuGet Downloads MyGet Version MyGet Downloads File count Repo size Code size Star on Github Forks on Github Test Status Publish Status SonarCloud Status Sonar Quality Gate Sonar Coverage Security Rating Reliability Rating Vulnerabilities Lines of Code License: MIT Developer Framework

This package represents a file provider with an Amazon S3 bucket. It constructs virtual file systems that implement IFileProvider and integrate with AWS S3 SDK to provide the functionality for serving static files in ASP.NET.

S3 File Provider

Where can I get it?

First, install NuGet. Then, install MrrHak.Extensions.FileProviders.S3FileProvider from the package manager console:

PM> NuGet\Install-Package MrrHak.Extensions.FileProviders.S3FileProvider

Or from the .NET CLI as:

dotnet add package MrrHak.Extensions.FileProviders.S3FileProvider

How do I get started?

.Net Core Configuration

Creating a S3FileProvider instance is very simple:

var s3FileProvider = new S3FileProvider(amazonS3, bucketName);

Or using GetS3FileProvider extension method

var s3FileProvider = app.Services.GetS3FileProvider(bucketName);

Using S3 for serve as static files

First, configure S3FileProvider with UseStaticFiles, in the program/startup of your application:

var s3FileProvider = new S3FileProvider(amazonS3, bucketName);
var staticFilesOption = new StaticFileOptions(){ FileProvider = s3FileProvider};

Or using UseS3StaticFiles extension method (recommended)

Parameter Type Required Default Value Description
bucketName string Yes The name of the S3 bucket
RequestPath string No null The request path for the static files
serveUnknownFileTypes bool No false Whether to serve unknown file types

Note: AWSSDK.S3 is required to create an Amazon S3 client.

For Amazon S3 Service instance

var amazonS3 = new AmazonS3Client("AccessKeyId", "SecretAccessKey", Amazon.RegionEndpoint.APSoutheast1);

Or if you have already registered Amazon S3 services

var amazonS3 = app.Services.GetService<IAmazonS3>();


Option Type Required Default Value Description
BucketName string Yes empty The name of the S3 bucket
RequestPath string No null The relative request path that maps to static resources
ServeUnknownFileTypes bool No false Whether to serve unknown file types
DefaultContentType string No null The default content type for a request if the ContentTypeProvider cannot determine one. None is provided by default, so the client must determine the format themselves
ContentTypeProvider IContentTypeProvider No null Used to map files to content-types
OnPrepareResponse Action<PrepareResponseContext> No null Called after the status code and headers have been set, but before the body has been written. This can be used to add or change the response headers


  1. Register IAmazonS3 client to services collection

        // This value should be get from appsettings.json
        const string S3_BUCKET_NAME = "bucket-name";
        const string S3_ACCESS_KEY = "access-key";
        const string S3_SECRET_KEY = "secret-key";
        const string DEFAULT_REGION = "region";
        // Get AWS profile info directly from configuration (Profile authentication)
        AWSOptions awsOptions = builder.Configuration.GetAWSOptions();
        awsOptions.Region = RegionEndpoint.GetBySystemName(DEFAULT_REGION);
        // IAM user authentication
        AWSOptions s3Options = awsOptions;
        if (!string.IsNullOrEmpty(S3_ACCESS_KEY) && !string.IsNullOrEmpty(S3_SECRET_KEY))
            s3Options = new AWSOptions() { Credentials = new BasicAWSCredentials(S3_ACCESS_KEY, S3_SECRET_KEY) };
            s3Options.Region = RegionEndpoint.GetBySystemName(DEFAULT_REGION);
  2. Register S3FileProvider with UseStaticFiles

    var amazonS3 = app.Services.GetService<IAmazonS3>();
    var s3FileProvider = new S3FileProvider(amazonS3, S3_BUCKET_NAME);
    var staticFilesOption = new StaticFileOptions(){ FileProvider = s3FileProvider};

    Or using UseS3StaticFiles extension method (recommended)


.Net Framework Configuration

1. Install Required Packages for .Net Framework
dotnet add package Microsoft.Owin.Host.SystemWeb
2. Create Owin Startup class
public class Startup
    public void Configuration(IAppBuilder app)
        var s3Client = new AmazonS3Client("your-access-key", "your-secret-key", Amazon.RegionEndpoint.APSoutheast1);
        app.UseS3StaticFiles(s3Client, "your-bucket-name");

        // Another implementation
3. Update Web.config
        <add name="Owin" verb="" path="*" type="Microsoft.Owin.Host.SystemWeb.OwinHttpHandler, Microsoft.Owin.Host.SystemWeb"/>

Build and Test Source Code

dotnet build
dotnet test

Buy me a coffee

Buy Me A Coffee Ko-fi

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 is compatible.  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 is compatible.  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. 
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
1.1.0 93 5/10/2024
1.0.1 91 5/4/2024
1.0.0 108 4/25/2024
1.0.0-beta.7 49 4/24/2024
1.0.0-beta.6 36 4/23/2024
1.0.0-beta.5 41 4/22/2024
1.0.0-beta.4 42 4/19/2024
1.0.0-beta.3 43 4/19/2024
1.0.0-beta.2 42 4/19/2024
1.0.0-beta.1 43 4/18/2024

## 1.1.0 (10-05-2024)
- Add new overloads for UseS3StaticFiles extension with Owin for .Net Framework
- Add sample project for .Net Framework
- Add more test coverage
- Upgrade AWS S3 SDK
- Update GitHub Action commitlint
- Update

## 1.0.1 (04-05-2024)
- Add new overloads for UseS3StaticFiles extension with S3StaticFileOptions
- Add local commitlint
- Add GitHub Action commitlint
- Upgrade AWS S3 SDK
- Update UseS3StaticFiles extension to allow passing requestPath and serveUnknownFileTypes
- Update

## 1.0.0 (25-04-2024)
- Move to stable version
- Update
- Add example project
- Add extensions helpers
 - GetS3FileProvider
 - UseS3StaticFiles

## 1.0.0-beta.7 (24-04-2024)
- Improvement
- Update

## 1.0.0-beta.6 (23-04-2024)
- Add Test coverage
- Improvement functionality
- Revert back AWS S3 SDK as public
- Update GitHub Action
- Update

## 1.0.0-beta.5 (22-04-2024)
- Make AWS S3 steam seek able
- Make AWS S3 SDK as private
- Upgrade AWS S3 SDK
- Update

## 1.0.0-beta.4 (19-04-2024)
- Upgrade AWS S3 SDK
- Update
- Update

## 1.0.0-beta.3 (19-04-2024)
- Update

## 1.0.0-beta.2 (19-04-2024)
- Add github action publish
- Update
- Update package metadata

## 1.0.0-beta.1 (18-04-2024)
- Initial version