Archivio chiavi BLOB di Archiviazione di Azure per Microsoft.AspNetCore.DataProtection

Articolo
04/03/2023

Il Azure.Extensions.AspNetCore.DataProtection.Blobs pacchetto consente di archiviare le chiavi di ASP.NET Core DataProtection in Archiviazione BLOB di Azure. Le chiavi possono essere condivise tra diverse istanze di un'app Web. Le app possono condividere i cookie di autenticazione o la protezione CSRF tra più server.

Introduzione

Installare il pacchetto

Installare il pacchetto con NuGet:

dotnet add package Azure.Extensions.AspNetCore.DataProtection.Blobs

Prerequisiti

Per usare questo pacchetto è necessaria una sottoscrizione di Azure, un account di archiviazione e un contenitore di archiviazione .

Per creare un nuovo account di archiviazione, è possibile usare il portale di Azure, Azure PowerShell o l'interfaccia della riga di comando di Azure. Di seguito è riportato un esempio basato sull'uso dell'interfaccia della riga di comando di Azure:

az storage account create --name <storage-account> --resource-group <resource-group> --location westus --sku Standard_LRS
az storage container create --account-name <storage-account> -n <container>

# Give write access to a user
az role assignment create --role "Storage Blob Data Contributor" --assignee <your_email> --scope "/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account>/blobServices/default/containers/<container>"

# OR give write access to a service principal (application)
az role assignment create --role "Storage Blob Data Contributor" --assignee-object-id <application_id> --scope "/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account>/blobServices/default/containers/<container>"

Concetti chiave

Thread safety

Microsoft garantisce che tutti i metodi di istanza client siano thread-safe e indipendenti l'uno dall'altro (linee guida). Ciò garantisce che la raccomandazione di riutilizzare le istanze client sia sempre sicura, anche tra thread.

Concetti aggiuntivi

Esempio

Per abilitare la persistenza delle chiavi per Archiviazione BLOB di Azure chiamare il PersistKeysToAzureBlobStorage metodo . L'oggetto Uri specificato deve essere un URI BLOB nel formato https://{storage_account}.blob.core.windows.net/{container}/{blob}seguente.

public void ConfigureServices(IServiceCollection services)
{
    services
        .AddDataProtection()
        .PersistKeysToAzureBlobStorage(new Uri("<full-blob-URI>"), new DefaultAzureCredential());
}

La libreria di identità di Azure offre un semplice supporto di Azure Active Directory per l'autenticazione.

Autenticazione tramite una stringa di connessione

public void ConfigureServices(IServiceCollection services)
{
    services
        .AddDataProtection()
        .PersistKeysToAzureBlobStorage("<connection string>", "<container name>", "<blob name>");
}

Passaggi successivi

Altre informazioni su DataProtection sono disponibili in ASP.NET Core.

Contributo

In questo progetto sono benvenuti i contributi e i suggerimenti. Per la maggior parte dei contenuti è necessario sottoscrivere un contratto di licenza di collaborazione (CLA, Contributor License Agreement) che stabilisce che l'utente ha il diritto di concedere, e di fatto concede a Microsoft i diritti d'uso del suo contributo. Per informazioni dettagliate, visitare cla.microsoft.com.

Questo progetto ha adottato il Codice di comportamento di Microsoft per l'open source. Per altre informazioni, vedere Code of Conduct FAQ (Domande frequenti sul Codice di comportamento Open Source di Microsoft) oppure contattare opencode@microsoft.com per eventuali altre domande o commenti.

Impression

Condividi tramite