Configurar o TLS (Transport Layer Security) para um aplicativo cliente

✔️ Aplica-se a: Armazenamento de Blobs do Azure, Azure Data Lake Storage, Armazenamento de Filas do Azure, Armazenamento de Tabelas do Azure

✖️ Não se aplica a: Arquivos do Azure (Microsoft.Storage ou Microsoft.FileShares)

Por questões de segurança, uma conta do Armazenamento do Azure pode exigir que os clientes usem uma versão mínima do Transport Layer Security (TLS) para enviar requisições. Chamadas para o Armazenamento do Azure falham se o cliente usar uma versão do TLS inferior à versão mínima exigida. Por exemplo, se uma conta de armazenamento requer TLS 1.2, uma solicitação enviada por um cliente que usa TLS 1.1 falha.

Este artigo descreve como configurar um aplicativo cliente para usar uma versão específica do TLS. Para obter informações sobre como configurar uma versão mínima necessária do TLS para uma conta de Armazenamento do Azure, consulte Configurar a versão mínima necessária do TLS (Transport Layer Security) para uma conta de armazenamento.

Para Arquivos do Azure, veja criptografia em trânsito do FileREST. Contas de armazenamento que contêm compartilhamentos de arquivos do Azure usam os mesmos requisitos de TLS, mas o artigo do Arquivos do Azure descreve considerações para o Arquivos do Azure.

Configurar a versão do TLS do cliente

Para enviar uma solicitação com uma versão específica do TLS, o sistema operacional deve suportar essa versão.

Os exemplos a seguir mostram como definir a versão do TLS do cliente como 1.2 do PowerShell ou do .NET. O .NET Framework usado pelo cliente deve dar suporte ao TLS 1.2. Para obter mais informações, consulte Suporte para TLS 1.2.

# Set the TLS version used by the PowerShell client to TLS 1.2.
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12;

# Create a new container.
$storageAccount = Get-AzStorageAccount -ResourceGroupName $rgName -Name $accountName
$ctx = $storageAccount.Context
New-AzStorageContainer -Name "sample-container" -Context $ctx

public static async Task ConfigureTls12()
{
    // Enable TLS 1.2 before connecting to Azure Storage
    System.Net.ServicePointManager.SecurityProtocol = System.Net.SecurityProtocolType.Tls12;

    // Add your connection string here.
    string connectionString = "";

    // Create a new container with Shared Key authorization.
    BlobContainerClient containerClient = new BlobContainerClient(connectionString, "sample-container");
    await containerClient.CreateIfNotExistsAsync();
}

Verificar a versão do TLS usada por um cliente

Para verificar se o cliente usou a versão especificada do TLS para enviar uma solicitação, use o Fiddler ou uma ferramenta similar. Abra o Fiddler para começar a capturar o tráfego da rede do cliente e então execute um dos exemplos da seção anterior. Examine o rastreamento do Fiddler para confirmar se a versão correta do TLS foi usada para enviar a solicitação, conforme mostrado na imagem a seguir.

Próximas etapas

• Configurar a versão mínima necessária do TLS (Transport Layer Security) para uma conta de armazenamento
• Recomendações de segurança para o armazenamento de blobs