dotnet / dotnet/announcements

Upcoming Change to .NET Download Infrastructure

Open
#383 0 comments 0 reactions 0 assignees View on GitHub
Breaking Change PSA Release
Dominant language
No language data
Stars
1.4k
Forks
53
PR merge metrics
No merged PRs in 30d

Description

## What's changing:

We are updating the .NET download infrastructure to align with Microsoft's security best practices by removing anonymous public access to the dotnetcli storage account.

**Note:** This issue is a locked mirror of dotnet/core#10262. See that issue for discussion.

## Background:

The dotnetcli storage account and its dotnet container serve as the origin for the official .NET CDN (builds.dotnet.microsoft.com). Before the .NET CDN was made available, .NET releases could be downloaded by directly accessing the storage account, for example:
`https://dotnetcli.blob.core.windows.net/dotnet/Sdk/10.0.102/dotnet-sdk-10.0.102-win-x64.exe`

This anonymous public access pattern is no longer aligned with Microsoft's secure access initiatives and will be discontinued.

## Action required:

- **If you're using builds.dotnet.microsoft.com**: No action needed. This change will be transparent to you.
- **If you're accessing dotnetcli.blob.core.windows.net directly**: Update your configuration to use builds.dotnet.microsoft.com.

## Unsupported configurations:

Accessing .NET downloads by bypassing the official CDN endpoint — for example, through hosts file overrides, custom DNS resolution, or direct IP access — is not supported and is outside the scope of any Microsoft support commitment. These methods may stop working without notice as infrastructure changes are made. Please use `builds.dotnet.microsoft.com` for all .NET download scenarios.

## Timeline:

- **Now**: We recommend updating any configurations that directly access dotnetcli.blob.core.windows.net to use builds.dotnet.microsoft.com instead.
- **Target date: July 2026**: We plan to remove anonymous public access to the dotnetcli storage account. The exact timing will depend on migration signals to ensure we minimize disruption to users still accessing the storage account directly.

We will monitor usage patterns and provide updates as we approach the transition date. Our goal is to ensure a smooth migration for all users before enforcing this security change.

## Related announcements:

This change is part of our ongoing effort to secure .NET infrastructure. For related work, see:
- https://github.com/dotnet/announcements/issues/336
- https://github.com/dotnet/announcements/issues/375

Contributor guide

No contributing guide indexed for this repository

Research direction

This locked mirror names no files, tests, or entry points. Start by reading dotnet/core#10262 and the linked announcements; completion is migration of any direct dotnetcli.blob.core.windows.net consumers to builds.dotnet.microsoft.com before July 2026, not a change in this repository.

Written by the indexing model from the issue text.

Assessment

Domain
cloud, infrastructure
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
15/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.