Skip to content

Latest commit

 

History

History
57 lines (43 loc) · 2.72 KB

Readme.md

File metadata and controls

57 lines (43 loc) · 2.72 KB
Raw

Media Upload

The blog supports uploading media assets (images, etc.) directly to Azure Blob Storage while writing blog posts.

Configuration

The following settings in appsettings.json control media upload functionality:

{
  "ImageStorageProvider": "Azure",
  "ImageStorage": {
    "AuthenticationMode": "Default",
    "ConnectionString": "",
    "ServiceUrl": "", 
    "ContainerName": ""
  }
}
Property Type Description
ImageStorageProvider string Currently only supports Azure for Azure Blob Storage.
AuthenticationMode string Authentication method - either Default for Microsoft Entra ID or ConnectionString for connection string auth
ConnectionString string Azure Storage connection string (only used and mandatory when AuthenticationMode is ConnectionString)
ServiceUrl string Azure Blob Storage service URL (only used and mandatory when AuthenticationMode is Default)
ContainerName string Name of the Azure Storage container to store uploaded files.
CdnEndpoint string Optional CDN endpoint to use for uploaded images. If set, the blog will return this URL instead of the storage account URL for uploaded assets.

Authentication Methods

Default Authentication

Uses Microsoft Entra ID (formerly Azure AD) managed identity or default credentials. This requires:

  1. Setting up proper RBAC permissions in Azure
  2. Configuring the ServiceUrl to point to your storage account
  3. No sensitive credentials needed in config

Connection String Authentication

Uses a storage account connection string for authentication:

  1. Get connection string from Azure Portal
  2. Add it to the ConnectionString setting
  3. No additional Azure setup required

Usage

  1. Start writing a blog post in the markdown editor
  2. Drag & drop images onto the editor
  3. A dialog appears asking for:
    • File name (can include subdirectories)
    • Whether to enable browser caching via Cache-Control headers (currently set to one week)
  4. The image gets uploaded and a markdown image link is inserted

Performance Note

Use a CDN endpoint for uploaded images to improve performance. This can be set in the CdnEndpoint setting. Azure CDN has integrated support for HTTP/2 and bring other performance benefits.