From 8d6d504658e21564bb48276a8e60813dadcb29b4 Mon Sep 17 00:00:00 2001
From: alexwolfmsft <93200798+alexwolfmsft@users.noreply.github.com>
Date: Thu, 6 Feb 2025 09:25:18 -0500
Subject: [PATCH 01/10] Curate topics (#44693)
* curate content
---
.openpublishing.redirection.ai.json | 8 +++
docs/ai/how-to/use-redis-for-memory.md | 61 -------------------
docs/ai/how-to/work-with-local-models.md | 63 --------------------
docs/ai/quickstarts/quickstart-assistants.md | 1 -
docs/ai/quickstarts/quickstart-local-ai.md | 1 -
docs/ai/toc.yml | 6 +-
6 files changed, 9 insertions(+), 131 deletions(-)
delete mode 100644 docs/ai/how-to/use-redis-for-memory.md
delete mode 100644 docs/ai/how-to/work-with-local-models.md
diff --git a/.openpublishing.redirection.ai.json b/.openpublishing.redirection.ai.json
index 8c73dbebb51da..b163e96c7859a 100644
--- a/.openpublishing.redirection.ai.json
+++ b/.openpublishing.redirection.ai.json
@@ -3,6 +3,14 @@
{
"source_path_from_root": "/docs/ai/quickstarts/get-started-azure-openai.md",
"redirect_url": "/dotnet/ai/quickstarts/get-started-openai"
+ },
+ {
+ "source_path_from_root": "/docs/ai/how-to/use-redis-for-memory.md",
+ "redirect_url": "/dotnet/ai"
+ },
+ {
+ "source_path_from_root": "/docs/ai/how-to/work-with-local-models.md",
+ "redirect_url": "/dotnet/ai"
}
]
}
\ No newline at end of file
diff --git a/docs/ai/how-to/use-redis-for-memory.md b/docs/ai/how-to/use-redis-for-memory.md
deleted file mode 100644
index 2015b7c3d870f..0000000000000
--- a/docs/ai/how-to/use-redis-for-memory.md
+++ /dev/null
@@ -1,61 +0,0 @@
----
-title: "Use Redis for Memory Storage with the Semantic Kernel SDK"
-description: "Learn how to use a Redis database together with the RediSearch module to give your AI memories in Semantic Kernel SDK for .NET."
-author: haywoodsloan
-ms.topic: how-to
-ms.date: 04/17/2024
-
-#customer intent: As a .NET developer, I want to use Redis for memory storage together with the Semantic Kernel SDK so that I can store and recall memories in my application.
-
----
-
-# Use Redis for memory storage with the Semantic Kernel SDK
-
-This article demonstrates how to integrate a Redis database with the RediSearch module into the [Semantic Kernel SDK](/semantic-kernel/overview) and use it for memory storage and retrieval.
-
-[Vector stores](/semantic-kernel/concepts/vector-store-connectors/) represent text information that has been stored alongside a precomputed embedding vector for the whole text. When an LLM is prompted to recall a memory, it uses these precomputed embeddings to efficiently evaluate whether a memory is relevant to the prompt. After the LLM finds a matching memory, it uses the memory's text information as context for the next steps in the prompt completion.
-
-Memory storage that's added to the Semantic Kernel SDK provides a broader context for your requests. It also enables you to store data in the same manner as you store a traditional database, but query it by using natural language.
-
-## Prerequisites
-
-* An Azure account that has an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
-* [.NET SDK](https://dotnet.microsoft.com/download/visual-studio-sdks)
-* [`Microsoft.SemanticKernel` NuGet package](https://www.nuget.org/packages/Microsoft.SemanticKernel)
-* [`Microsoft.SemanticKernel.Connectors.Redis` NuGet package](https://www.nuget.org/packages/Microsoft.SemanticKernel.Connectors.Redis)
-* [`Microsoft.SemanticKernel.Plugins.Memory` NuGet package](https://www.nuget.org/packages/Microsoft.SemanticKernel.Plugins.Memory)
-* [`StackExchange.Redis` NuGet package](https://www.nuget.org/packages/StackExchange.Redis)
-* A Redis database that has the RediSearch module, [deployed and accessible to your .NET application](/azure/azure-cache-for-redis/quickstart-create-redis-enterprise)
-
-## Implement memory storage using a Redis database
-
-Before you integrate your Redis database to the Semantic Kernel SDK, make sure that you have the RediSearch module enabled. For module information for _Azure Cache for Redis_, see [Use Redis modules with Azure Cache for Redis](/azure/azure-cache-for-redis/cache-redis-modules#adding-modules-to-your-cache).
-
-1. Initialize a connection to your Redis database. For example:
-
- :::code language="csharp" source="./snippets/semantic-kernel/MemoryExamples.cs" id="initRedis":::
-
-2. Build the `Kernel` by including `ITextEmbeddingGenerationService`. For example:
-
- :::code language="csharp" source="./snippets/semantic-kernel/MemoryExamples.cs" id="initKernel":::
-
-3. Wrap the Redis database in a `RedisMemoryStore` instance, and then initialize a `SemanticTextMemory` object by using the memory store and embedding generation service. For example:
-
- :::code language="csharp" source="./snippets/semantic-kernel/MemoryExamples.cs" id="initMemory":::
-
-4. Add the semantic text memory to the `Kernel` by using the `TextMemoryPlugin` class. For example:
-
- :::code language="csharp" source="./snippets/semantic-kernel/MemoryExamples.cs" id="addMemory":::
-
-5. Use the `Kernel` and plug-in to save, retrieve, and recall memories. For example:
-
- :::code language="csharp" source="./snippets/semantic-kernel/MemoryExamples.cs" id="useMemory":::
-
-6. Use memory recall as part of a prompt by using the [prompt template syntax `{{...}}`](/semantic-kernel/prompts/prompt-template-syntax). For example:
-
- :::code language="csharp" source="./snippets/semantic-kernel/MemoryExamples.cs" id="promptMemory":::
-
-## Related content
-
-* [Working with vector databases](../tutorials/tutorial-ai-vector-search.md)
-* [Chat using your own data sample for .NET](../get-started-app-chat-template.md)
diff --git a/docs/ai/how-to/work-with-local-models.md b/docs/ai/how-to/work-with-local-models.md
deleted file mode 100644
index c6643560c51a5..0000000000000
--- a/docs/ai/how-to/work-with-local-models.md
+++ /dev/null
@@ -1,63 +0,0 @@
----
-title: "Use Custom and Local AI Models with the Semantic Kernel SDK for .NET"
-titleSuffix: ""
-description: "Learn how to use custom or local models for text generation and chat completions in Semantic Kernel SDK for .NET."
-author: haywoodsloan
-ms.topic: how-to
-ms.date: 04/11/2024
-
-#customer intent: As a .NET developer, I want to use custom or local AI models with the Semantic Kernel SDK so that I can perform text generation and chat completions using any model available to me.
-
----
-
-# Use custom and local AI models with the Semantic Kernel SDK
-
-This article demonstrates how to integrate custom and local models into the [Semantic Kernel SDK](/semantic-kernel/overview) and use them for text generation and chat completions.
-
-You can adapt the steps to use them with any model that you can access, regardless of where or how you access it. For example, you can integrate the [codellama](https://ollama.com/library/codellama) model with the Semantic Kernel SDK to enable code generation and discussion.
-
-Custom and local models often provide access via REST APIs. For example, see [Ollama OpenAI compatibility](https://ollama.com/blog/openai-compatibility). Before you integrate your model, it will need to be hosted and accessible to your .NET application via HTTPS.
-
-## Prerequisites
-
-* An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
-* [.NET SDK](https://dotnet.microsoft.com/download/visual-studio-sdks)
-* [`Microsoft.SemanticKernel` NuGet package](https://www.nuget.org/packages/Microsoft.SemanticKernel)
-* A custom or local model, deployed and accessible to your .NET application
-
-## Implement text generation using a local model
-
-The following section shows how you can integrate your model with the Semantic Kernel SDK and then use it to generate text completions.
-
-1. Create a service class that implements the `ITextGenerationService` interface. For example:
-
- :::code language="csharp" source="./snippets/semantic-kernel/services/MyTextGenerationService.cs" id="service":::
-
-2. Include the new service class when building the `Kernel`. For example:
-
- :::code language="csharp" source="./snippets/semantic-kernel/LocalModelExamples.cs" id="addTextService":::
-
-3. Send a text generation prompt to your model directly through the `Kernel` or using the service class. For example:
-
- :::code language="csharp" source="./snippets/semantic-kernel/LocalModelExamples.cs" id="useTextService":::
-
-## Implement chat completion using a local model
-
-The following section shows how you can integrate your model with the Semantic Kernel SDK and then use it for chat completions.
-
-1. Create a service class that implements the `IChatCompletionService` interface. For example:
-
- :::code language="csharp" source="./snippets/semantic-kernel/services/MyChatCompletionService.cs" id="service":::
-
-2. Include the new service class when building the `Kernel`. For example:
-
- :::code language="csharp" source="./snippets/semantic-kernel/LocalModelExamples.cs" id="addChatService":::
-
-3. Send a chat completion prompt to your model directly through the `Kernel` or using the service class. For example:
-
- :::code language="csharp" source="./snippets/semantic-kernel/LocalModelExamples.cs" id="useChatService":::
-
-## Related content
-
-* [What is Semantic Kernel](/semantic-kernel/overview/)
-* [Understanding AI plugins in Semantic Kernel](/semantic-kernel/agents/plugins/?tabs=Csharp)
diff --git a/docs/ai/quickstarts/quickstart-assistants.md b/docs/ai/quickstarts/quickstart-assistants.md
index c2fa6918f82bd..e9a60417009b6 100644
--- a/docs/ai/quickstarts/quickstart-assistants.md
+++ b/docs/ai/quickstarts/quickstart-assistants.md
@@ -133,5 +133,4 @@ Complete the following steps to create a .NET console app and add the package ne
## Next steps
-- [Quickstart - Get insight about your data from an .NET Azure AI chat app](../how-to/work-with-local-models.md)
- [Generate text and conversations with .NET and Azure OpenAI Completions](/training/modules/open-ai-dotnet-text-completions/)
diff --git a/docs/ai/quickstarts/quickstart-local-ai.md b/docs/ai/quickstarts/quickstart-local-ai.md
index 26f8557c92dae..8bd22c102f4d5 100644
--- a/docs/ai/quickstarts/quickstart-local-ai.md
+++ b/docs/ai/quickstarts/quickstart-local-ai.md
@@ -146,5 +146,4 @@ The Semantic Kernel SDK provides many services and features to connect to AI mod
## Next steps
-- [Quickstart - Get insight about your data from an .NET Azure AI chat app](../how-to/work-with-local-models.md)
- [Generate text and conversations with .NET and Azure OpenAI Completions](/training/modules/open-ai-dotnet-text-completions/)
diff --git a/docs/ai/toc.yml b/docs/ai/toc.yml
index 103022e2b89fb..0220fb5b64337 100644
--- a/docs/ai/toc.yml
+++ b/docs/ai/toc.yml
@@ -55,12 +55,8 @@ items:
items:
- name: Authenticate to Azure OpenAI from an Azure hosted app
href: how-to/app-service-aoai-auth.md
- - name: Authenticate App Service to a vector database
+ - name: Authenticate to Azure Databases from an Azure hosted app
href: how-to/app-service-db-auth.md
- - name: Use Redis with Semantic Kernel
- href: how-to/use-redis-for-memory.md
- - name: Use custom & local AI models with Semantic Kernel
- href: how-to/work-with-local-models.md
- name: Work with content filtering
href: how-to/content-filtering.md
- name: Tutorials
From d3093232ae92d1662a8415cfad60395e84c52d66 Mon Sep 17 00:00:00 2001
From: Azure SDK Bot <53356347+azure-sdk@users.noreply.github.com>
Date: Thu, 6 Feb 2025 12:18:56 -0800
Subject: [PATCH 02/10] Update package index with latest published versions
(#44702)
---
docs/azure/includes/dotnet-all.md | 2 +-
docs/azure/includes/dotnet-new.md | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/azure/includes/dotnet-all.md b/docs/azure/includes/dotnet-all.md
index 7b475c9cd42af..c8cd9afff6481 100644
--- a/docs/azure/includes/dotnet-all.md
+++ b/docs/azure/includes/dotnet-all.md
@@ -333,7 +333,7 @@
| Resource Management - Service Fabric | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.ServiceFabric/1.1.0)
NuGet [1.2.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ServiceFabric/1.2.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ServiceFabric-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceFabric_1.1.0/sdk/servicefabric/Azure.ResourceManager.ServiceFabric/)
GitHub [1.2.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceFabric_1.2.0-beta.1/sdk/servicefabric/Azure.ResourceManager.ServiceFabric/) |
| Resource Management - Service Fabric Managed Clusters | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.ServiceFabricManagedClusters/1.2.0)
NuGet [1.3.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.ServiceFabricManagedClusters/1.3.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.ServiceFabricManagedClusters-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceFabricManagedClusters_1.2.0/sdk/servicefabricmanagedclusters/Azure.ResourceManager.ServiceFabricManagedClusters/)
GitHub [1.3.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceFabricManagedClusters_1.3.0-beta.2/sdk/servicefabricmanagedclusters/Azure.ResourceManager.ServiceFabricManagedClusters/) |
| Resource Management - Service Linker | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.ServiceLinker/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ServiceLinker-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceLinker_1.1.0/sdk/servicelinker/Azure.ResourceManager.ServiceLinker/) |
-| Resource Management - Service Networking | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.ServiceNetworking/1.0.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ServiceNetworking-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceNetworking_1.0.1/sdk/servicenetworking/Azure.ResourceManager.ServiceNetworking/) |
+| Resource Management - Service Networking | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.ServiceNetworking/1.0.1)
NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ServiceNetworking/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ServiceNetworking-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceNetworking_1.0.1/sdk/servicenetworking/Azure.ResourceManager.ServiceNetworking/)
GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceNetworking_1.1.0-beta.1/sdk/servicenetworking/Azure.ResourceManager.ServiceNetworking/) |
| Resource Management - SignalR | NuGet [1.1.3](https://www.nuget.org/packages/Azure.ResourceManager.SignalR/1.1.3) | [docs](/dotnet/api/overview/azure/ResourceManager.SignalR-readme) | GitHub [1.1.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.SignalR_1.1.3/sdk/signalr/Azure.ResourceManager.SignalR/) |
| Resource Management - Sphere | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Sphere/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Sphere-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Sphere_1.0.0/sdk/sphere/Azure.ResourceManager.Sphere/) |
| Resource Management - Spring App Discovery | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.SpringAppDiscovery/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.SpringAppDiscovery-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.SpringAppDiscovery_1.0.0-beta.1/sdk/springappdiscovery/Azure.ResourceManager.SpringAppDiscovery/) |
diff --git a/docs/azure/includes/dotnet-new.md b/docs/azure/includes/dotnet-new.md
index 013a808e88fca..ea2ffaa2a5a14 100644
--- a/docs/azure/includes/dotnet-new.md
+++ b/docs/azure/includes/dotnet-new.md
@@ -340,7 +340,7 @@
| Resource Management - Service Fabric | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.ServiceFabric/1.1.0)
NuGet [1.2.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ServiceFabric/1.2.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ServiceFabric-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceFabric_1.1.0/sdk/servicefabric/Azure.ResourceManager.ServiceFabric/)
GitHub [1.2.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceFabric_1.2.0-beta.1/sdk/servicefabric/Azure.ResourceManager.ServiceFabric/) |
| Resource Management - Service Fabric Managed Clusters | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.ServiceFabricManagedClusters/1.2.0)
NuGet [1.3.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.ServiceFabricManagedClusters/1.3.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.ServiceFabricManagedClusters-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceFabricManagedClusters_1.2.0/sdk/servicefabricmanagedclusters/Azure.ResourceManager.ServiceFabricManagedClusters/)
GitHub [1.3.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceFabricManagedClusters_1.3.0-beta.2/sdk/servicefabricmanagedclusters/Azure.ResourceManager.ServiceFabricManagedClusters/) |
| Resource Management - Service Linker | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.ServiceLinker/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ServiceLinker-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceLinker_1.1.0/sdk/servicelinker/Azure.ResourceManager.ServiceLinker/) |
-| Resource Management - Service Networking | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.ServiceNetworking/1.0.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ServiceNetworking-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceNetworking_1.0.1/sdk/servicenetworking/Azure.ResourceManager.ServiceNetworking/) |
+| Resource Management - Service Networking | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.ServiceNetworking/1.0.1)
NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ServiceNetworking/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ServiceNetworking-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceNetworking_1.0.1/sdk/servicenetworking/Azure.ResourceManager.ServiceNetworking/)
GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceNetworking_1.1.0-beta.1/sdk/servicenetworking/Azure.ResourceManager.ServiceNetworking/) |
| Resource Management - SignalR | NuGet [1.1.3](https://www.nuget.org/packages/Azure.ResourceManager.SignalR/1.1.3) | [docs](/dotnet/api/overview/azure/ResourceManager.SignalR-readme) | GitHub [1.1.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.SignalR_1.1.3/sdk/signalr/Azure.ResourceManager.SignalR/) |
| Resource Management - Sphere | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Sphere/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Sphere-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Sphere_1.0.0/sdk/sphere/Azure.ResourceManager.Sphere/) |
| Resource Management - Spring App Discovery | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.SpringAppDiscovery/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.SpringAppDiscovery-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.SpringAppDiscovery_1.0.0-beta.1/sdk/springappdiscovery/Azure.ResourceManager.SpringAppDiscovery/) |
From c1ee950badef9aaf3474cec3b2e1519807fc902b Mon Sep 17 00:00:00 2001
From: Azure SDK Bot <53356347+azure-sdk@users.noreply.github.com>
Date: Thu, 6 Feb 2025 13:12:56 -0800
Subject: [PATCH 03/10] Update package index with latest published versions
(#44705)
---
docs/azure/includes/dotnet-all.md | 4 ++--
docs/azure/includes/dotnet-new.md | 4 ++--
2 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/docs/azure/includes/dotnet-all.md b/docs/azure/includes/dotnet-all.md
index c8cd9afff6481..777dca0fa1f70 100644
--- a/docs/azure/includes/dotnet-all.md
+++ b/docs/azure/includes/dotnet-all.md
@@ -28,7 +28,7 @@
| Content Safety | NuGet [1.0.0](https://www.nuget.org/packages/Azure.AI.ContentSafety/1.0.0) | [docs](/dotnet/api/overview/azure/AI.ContentSafety-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.ContentSafety_1.0.0/sdk/contentsafety/Azure.AI.ContentSafety/) |
| Conversational Language Understanding | NuGet [1.1.0](https://www.nuget.org/packages/Azure.AI.Language.Conversations/1.1.0)
NuGet [2.0.0-beta.2](https://www.nuget.org/packages/Azure.AI.Language.Conversations/2.0.0-beta.2) | [docs](/dotnet/api/overview/azure/AI.Language.Conversations-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.Conversations_1.1.0/sdk/cognitivelanguage/Azure.AI.Language.Conversations/)
GitHub [2.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.Conversations_2.0.0-beta.2/sdk/cognitivelanguage/Azure.AI.Language.Conversations/) |
| Core - Client - AMQP | NuGet [1.3.1](https://www.nuget.org/packages/Azure.Core.Amqp/1.3.1) | [docs](/dotnet/api/overview/azure/Core.Amqp-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core.Amqp_1.3.1/sdk/core/Azure.Core.Amqp/) |
-| Core - Client - Core | NuGet [1.44.1](https://www.nuget.org/packages/Azure.Core/1.44.1) | [docs](/dotnet/api/overview/azure/Core-readme) | GitHub [1.44.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core_1.44.1/sdk/core/Azure.Core/) |
+| Core - Client - Core | NuGet [1.45.0](https://www.nuget.org/packages/Azure.Core/1.45.0) | [docs](/dotnet/api/overview/azure/Core-readme) | GitHub [1.45.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core_1.45.0/sdk/core/Azure.Core/) |
| Core Newtonsoft Json | NuGet [2.0.0](https://www.nuget.org/packages/Microsoft.Azure.Core.NewtonsoftJson/2.0.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.Core.NewtonsoftJson-readme) | GitHub [2.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Core.NewtonsoftJson_2.0.0/sdk/core/Microsoft.Azure.Core.NewtonsoftJson/) |
| Core WCF Storage Queues | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Microsoft.CoreWCF.Azure.StorageQueues/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Microsoft.CoreWCF.Azure.StorageQueues-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.CoreWCF.Azure.StorageQueues_1.0.0-beta.1/sdk/extension-wcf/Microsoft.CoreWCF.Azure.StorageQueues/) |
| Data Movement | NuGet [12.0.0-beta.6](https://www.nuget.org/packages/Azure.Storage.DataMovement/12.0.0-beta.6) | [docs](/dotnet/api/overview/azure/Storage.DataMovement-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [12.0.0-beta.6](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.DataMovement_12.0.0-beta.6/sdk/storage/Azure.Storage.DataMovement/) |
@@ -108,7 +108,7 @@
| Synapse - Monitoring | NuGet [1.0.0-beta.3](https://www.nuget.org/packages/Azure.Analytics.Synapse.Monitoring/1.0.0-beta.3) | [docs](/dotnet/api/overview/azure/Analytics.Synapse.Monitoring-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.Synapse.Monitoring_1.0.0-beta.3/sdk/synapse/Azure.Analytics.Synapse.Monitoring/) |
| Synapse - Spark | NuGet [1.0.0-preview.8](https://www.nuget.org/packages/Azure.Analytics.Synapse.Spark/1.0.0-preview.8) | [docs](/dotnet/api/overview/azure/Analytics.Synapse.Spark-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-preview.8](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.Synapse.Spark_1.0.0-preview.8/sdk/synapse/Azure.Analytics.Synapse.Spark/) |
| System Events | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Messaging.EventGrid.SystemEvents/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Messaging.EventGrid.SystemEvents-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Messaging.EventGrid.SystemEvents_1.0.0-beta.1/sdk/eventgrid/Azure.Messaging.EventGrid.SystemEvents/) |
-| System.ClientModel | NuGet [1.2.1](https://www.nuget.org/packages/System.ClientModel/1.2.1) | [docs](/dotnet/api/overview/azure/System.ClientModel-readme) | GitHub [1.2.1](https://github.com/Azure/azure-sdk-for-net/tree/System.ClientModel_1.2.1/sdk/core/System.ClientModel/) |
+| System.ClientModel | NuGet [1.3.0](https://www.nuget.org/packages/System.ClientModel/1.3.0) | [docs](/dotnet/api/overview/azure/System.ClientModel-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/System.ClientModel_1.3.0/sdk/core/System.ClientModel/) |
| Tables | NuGet [12.10.0](https://www.nuget.org/packages/Azure.Data.Tables/12.10.0) | [docs](/dotnet/api/overview/azure/Data.Tables-readme) | GitHub [12.10.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Data.Tables_12.10.0/sdk/tables/Azure.Data.Tables/) |
| Text Analytics | NuGet [5.3.0](https://www.nuget.org/packages/Azure.AI.TextAnalytics/5.3.0) | [docs](/dotnet/api/overview/azure/AI.TextAnalytics-readme) | GitHub [5.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.TextAnalytics_5.3.0/sdk/textanalytics/Azure.AI.TextAnalytics/) |
| Text Translation | NuGet [1.0.0](https://www.nuget.org/packages/Azure.AI.Translation.Text/1.0.0) | [docs](/dotnet/api/overview/azure/AI.Translation.Text-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Translation.Text_1.0.0/sdk/translation/Azure.AI.Translation.Text/) |
diff --git a/docs/azure/includes/dotnet-new.md b/docs/azure/includes/dotnet-new.md
index ea2ffaa2a5a14..dd97d3b9fe0e2 100644
--- a/docs/azure/includes/dotnet-new.md
+++ b/docs/azure/includes/dotnet-new.md
@@ -29,7 +29,7 @@
| Content Safety | NuGet [1.0.0](https://www.nuget.org/packages/Azure.AI.ContentSafety/1.0.0) | [docs](/dotnet/api/overview/azure/AI.ContentSafety-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.ContentSafety_1.0.0/sdk/contentsafety/Azure.AI.ContentSafety/) |
| Conversational Language Understanding | NuGet [1.1.0](https://www.nuget.org/packages/Azure.AI.Language.Conversations/1.1.0)
NuGet [2.0.0-beta.2](https://www.nuget.org/packages/Azure.AI.Language.Conversations/2.0.0-beta.2) | [docs](/dotnet/api/overview/azure/AI.Language.Conversations-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.Conversations_1.1.0/sdk/cognitivelanguage/Azure.AI.Language.Conversations/)
GitHub [2.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.Conversations_2.0.0-beta.2/sdk/cognitivelanguage/Azure.AI.Language.Conversations/) |
| Core - Client - AMQP | NuGet [1.3.1](https://www.nuget.org/packages/Azure.Core.Amqp/1.3.1) | [docs](/dotnet/api/overview/azure/Core.Amqp-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core.Amqp_1.3.1/sdk/core/Azure.Core.Amqp/) |
-| Core - Client - Core | NuGet [1.44.1](https://www.nuget.org/packages/Azure.Core/1.44.1) | [docs](/dotnet/api/overview/azure/Core-readme) | GitHub [1.44.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core_1.44.1/sdk/core/Azure.Core/) |
+| Core - Client - Core | NuGet [1.45.0](https://www.nuget.org/packages/Azure.Core/1.45.0) | [docs](/dotnet/api/overview/azure/Core-readme) | GitHub [1.45.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core_1.45.0/sdk/core/Azure.Core/) |
| Core Newtonsoft Json | NuGet [2.0.0](https://www.nuget.org/packages/Microsoft.Azure.Core.NewtonsoftJson/2.0.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.Core.NewtonsoftJson-readme) | GitHub [2.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Core.NewtonsoftJson_2.0.0/sdk/core/Microsoft.Azure.Core.NewtonsoftJson/) |
| Core WCF Storage Queues | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Microsoft.CoreWCF.Azure.StorageQueues/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Microsoft.CoreWCF.Azure.StorageQueues-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.CoreWCF.Azure.StorageQueues_1.0.0-beta.1/sdk/extension-wcf/Microsoft.CoreWCF.Azure.StorageQueues/) |
| Data Movement | NuGet [12.0.0-beta.6](https://www.nuget.org/packages/Azure.Storage.DataMovement/12.0.0-beta.6) | [docs](/dotnet/api/overview/azure/Storage.DataMovement-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [12.0.0-beta.6](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.DataMovement_12.0.0-beta.6/sdk/storage/Azure.Storage.DataMovement/) |
@@ -112,7 +112,7 @@
| Synapse - Monitoring | NuGet [1.0.0-beta.3](https://www.nuget.org/packages/Azure.Analytics.Synapse.Monitoring/1.0.0-beta.3) | [docs](/dotnet/api/overview/azure/Analytics.Synapse.Monitoring-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.Synapse.Monitoring_1.0.0-beta.3/sdk/synapse/Azure.Analytics.Synapse.Monitoring/) |
| Synapse - Spark | NuGet [1.0.0-preview.8](https://www.nuget.org/packages/Azure.Analytics.Synapse.Spark/1.0.0-preview.8) | [docs](/dotnet/api/overview/azure/Analytics.Synapse.Spark-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-preview.8](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.Synapse.Spark_1.0.0-preview.8/sdk/synapse/Azure.Analytics.Synapse.Spark/) |
| System Events | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Messaging.EventGrid.SystemEvents/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Messaging.EventGrid.SystemEvents-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Messaging.EventGrid.SystemEvents_1.0.0-beta.1/sdk/eventgrid/Azure.Messaging.EventGrid.SystemEvents/) |
-| System.ClientModel | NuGet [1.2.1](https://www.nuget.org/packages/System.ClientModel/1.2.1) | [docs](/dotnet/api/overview/azure/System.ClientModel-readme) | GitHub [1.2.1](https://github.com/Azure/azure-sdk-for-net/tree/System.ClientModel_1.2.1/sdk/core/System.ClientModel/) |
+| System.ClientModel | NuGet [1.3.0](https://www.nuget.org/packages/System.ClientModel/1.3.0) | [docs](/dotnet/api/overview/azure/System.ClientModel-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/System.ClientModel_1.3.0/sdk/core/System.ClientModel/) |
| Tables | NuGet [12.10.0](https://www.nuget.org/packages/Azure.Data.Tables/12.10.0) | [docs](/dotnet/api/overview/azure/Data.Tables-readme) | GitHub [12.10.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Data.Tables_12.10.0/sdk/tables/Azure.Data.Tables/) |
| Text Analytics | NuGet [5.3.0](https://www.nuget.org/packages/Azure.AI.TextAnalytics/5.3.0) | [docs](/dotnet/api/overview/azure/AI.TextAnalytics-readme) | GitHub [5.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.TextAnalytics_5.3.0/sdk/textanalytics/Azure.AI.TextAnalytics/) |
| Text Translation | NuGet [1.0.0](https://www.nuget.org/packages/Azure.AI.Translation.Text/1.0.0) | [docs](/dotnet/api/overview/azure/AI.Translation.Text-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Translation.Text_1.0.0/sdk/translation/Azure.AI.Translation.Text/) |
From 4dc82957092bb3d7def7431ed17c17386450aaab Mon Sep 17 00:00:00 2001
From: Bill Wagner
Date: Thu, 6 Feb 2025 16:26:23 -0500
Subject: [PATCH 04/10] Update reference topic types (#44708)
---
docfx.json | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/docfx.json b/docfx.json
index 2ab4a468a1a6b..b20d68ecd1ae7 100644
--- a/docfx.json
+++ b/docfx.json
@@ -268,7 +268,7 @@
"docs/csharp/roslyn-sdk/tutorials/*.md": "tutorial",
"docs/csharp/tour-of-csharp/tutorials/**": "tutorial",
"docs/csharp/tutorials/**": "tutorial",
- "docs/framework/additional-apis/**/**.md": "managed-reference",
+ "docs/framework/additional-apis/**/**.md": "reference",
"docs/framework/configure-apps/file-schema/**/**.md": "reference",
"docs/framework/data/adonet/ef/language-reference/*-entity-sql.md": "language-reference",
"docs/framework/debug-trace-profile/*-mda.md": "reference",
@@ -286,8 +286,8 @@
"docs/framework/**/troubleshooting*.md": "troubleshooting",
"docs/fsharp/language-reference/**/**.md": "language-reference",
"docs/iot/**/*.*": "conceptual",
- "docs/fundamentals/code-analysis/quality-rules/**.md": "reference",
- "docs/fundamentals/code-analysis/style-rules/**.md": "reference",
+ "docs/fundamentals/code-analysis/quality-rules/**.md": "error-reference",
+ "docs/fundamentals/code-analysis/style-rules/**.md": "error-reference",
"docs/fundamentals/diagnostics/runtime-*.md": "reference",
"docs/fundamentals/syslib-diagnostics/**/*.md": "error-reference",
"docs/standard/**/*how-to*.md": "how-to",
From 96b609737558b67f8c47ce0ddd3c96a33cad7fbd Mon Sep 17 00:00:00 2001
From: Bill Wagner
Date: Thu, 6 Feb 2025 16:26:57 -0500
Subject: [PATCH 05/10] clarify new rules on unsafe and sizeof (#44701)
* clarify new rules on unsafe and sizeof
Fixes #44137
The updates for `sizeof` and `unmanaged` in C# 11 weren't completely incorporated into the language reference articles correctly.
Update them and perform an edit pass.
* Apply suggestions from code review
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
---------
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
---
.../language-reference/operators/sizeof.md | 48 +++++++++++--------
docs/csharp/language-reference/unsafe-code.md | 47 +++++++++---------
2 files changed, 50 insertions(+), 45 deletions(-)
diff --git a/docs/csharp/language-reference/operators/sizeof.md b/docs/csharp/language-reference/operators/sizeof.md
index 0513d391dd672..8ce45f912157a 100644
--- a/docs/csharp/language-reference/operators/sizeof.md
+++ b/docs/csharp/language-reference/operators/sizeof.md
@@ -1,7 +1,7 @@
---
title: "sizeof operator - determine the storage needs for a type"
description: "Learn about the C# `sizeof` operator that returns the memory amount occupied by a variable of a given type."
-ms.date: 11/28/2022
+ms.date: 02/06/2025
f1_keywords:
- "sizeof_CSharpKeyword"
- "sizeof"
@@ -10,33 +10,39 @@ helpviewer_keywords:
---
# sizeof operator - determine the memory needs for a given type
-The `sizeof` operator returns the number of bytes occupied by a variable of a given type. The argument to the `sizeof` operator must be the name of an [unmanaged type](../builtin-types/unmanaged-types.md) or a type parameter that is [constrained](../../programming-guide/generics/constraints-on-type-parameters.md#unmanaged-constraint) to be an unmanaged type.
+The `sizeof` operator returns the number of bytes occupied by a variable of a given type. In safe code, the argument to the `sizeof` operator must be the name of an [unmanaged type](../builtin-types/unmanaged-types.md) or a type parameter that is [constrained](../../programming-guide/generics/constraints-on-type-parameters.md#unmanaged-constraint) to be an unmanaged type. Unmanaged types include all numeric types, enum types, and tuple and struct types where all members are unmanaged types.
-The `sizeof` operator requires an [unsafe](../keywords/unsafe.md) context. However, the expressions presented in the following table are evaluated in compile time to the corresponding constant values and don't require an unsafe context:
+The expressions presented in the following table are evaluated in compile time to the corresponding constant values and don't require an unsafe context:
-|Expression|Constant value|
-|---------|---------------|
-|`sizeof(sbyte)`|1|
-|`sizeof(byte)`|1|
-|`sizeof(short)`|2|
-|`sizeof(ushort)`|2|
-|`sizeof(int)`|4|
-|`sizeof(uint)`|4|
-|`sizeof(long)`|8|
-|`sizeof(ulong)`|8|
-|`sizeof(char)`|2|
-|`sizeof(float)`|4|
-|`sizeof(double)`|8|
-|`sizeof(decimal)`|16|
-|`sizeof(bool)`|1|
+| Expression | Constant value |
+|-------------------|----------------|
+| `sizeof(sbyte)` | 1 |
+| `sizeof(byte)` | 1 |
+| `sizeof(short)` | 2 |
+| `sizeof(ushort)` | 2 |
+| `sizeof(int)` | 4 |
+| `sizeof(uint)` | 4 |
+| `sizeof(long)` | 8 |
+| `sizeof(ulong)` | 8 |
+| `sizeof(char)` | 2 |
+| `sizeof(float)` | 4 |
+| `sizeof(double)` | 8 |
+| `sizeof(decimal)` | 16 |
+| `sizeof(bool)` | 1 |
-You also don't need to use an unsafe context when the operand of the `sizeof` operator is the name of an [enum](../builtin-types/enum.md) type.
+In unsafe code, the argument to `sizeof` can include pointer types and managed types, including unconstrained type parameters. Examples include `object` and `string`.
The following example demonstrates the usage of the `sizeof` operator:
-[!code-csharp[sizeof examples](snippets/shared/SizeOfOperator.cs)]
+:::code language="csharp" source="./snippets/shared/SizeOfOperator.cs":::
-The `sizeof` operator returns a number of bytes that would be allocated by the common language runtime in managed memory. For [struct](../builtin-types/struct.md) types, that value includes any padding, as the preceding example demonstrates. The result of the `sizeof` operator might differ from the result of the method, which returns the size of a type in *unmanaged* memory.
+The `sizeof` operator returns the number of bytes allocated by the common language runtime in managed memory. For [struct](../builtin-types/struct.md) types, that value includes any padding, as the preceding example demonstrates. The result of the `sizeof` operator might differ from the result of the method, which returns the size of a type in *unmanaged* memory.
+
+In unsafe code, when the argument is a managed type, the `sizeof` operator returns the size of a reference, not the number of bytes allocated for an instance of that type.
+
+> [!IMPORTANT]
+>
+> The value returned by `sizeof` can differ from the result of , which returns the size of the type in unmanaged memory.
## C# language specification
diff --git a/docs/csharp/language-reference/unsafe-code.md b/docs/csharp/language-reference/unsafe-code.md
index 89106a3bdbf1d..f3e4f95b032de 100644
--- a/docs/csharp/language-reference/unsafe-code.md
+++ b/docs/csharp/language-reference/unsafe-code.md
@@ -1,7 +1,7 @@
---
title: "Unsafe code, pointers to data, and function pointers"
description: Learn about unsafe code, pointers, and function pointers. C# requires you to declare an unsafe context to use these features to directly manipulate memory or function pointers (unmanaged delegates).
-ms.date: 04/01/2021
+ms.date: 02/06/2025
f1_keywords:
- "functionPointer_CSharpKeyword"
helpviewer_keywords:
@@ -12,32 +12,31 @@ helpviewer_keywords:
- "unsafe code [C#]"
- "C# language, pointers"
- "pointers [C#], about pointers"
-ms.assetid: b0fcca10-a92d-4f2a-835b-b0ccae6739ee
---
# Unsafe code, pointer types, and function pointers
Most of the C# code you write is "verifiably safe code." *Verifiably safe code* means .NET tools can verify that the code is safe. In general, safe code doesn't directly access memory using pointers. It also doesn't allocate raw memory. It creates managed objects instead.
-C# supports an [`unsafe`](keywords/unsafe.md) context, in which you may write *unverifiable* code. In an `unsafe` context, code may use pointers, allocate and free blocks of memory, and call methods using function pointers. Unsafe code in C# isn't necessarily dangerous; it's just code whose safety cannot be verified.
+C# supports an [`unsafe`](keywords/unsafe.md) context, in which you can write *unverifiable* code. In an `unsafe` context, code can use pointers, allocate and free blocks of memory, and call methods using function pointers. Unsafe code in C# isn't necessarily dangerous; it's just code whose safety can't be verified.
Unsafe code has the following properties:
- Methods, types, and code blocks can be defined as unsafe.
-- In some cases, unsafe code may increase an application's performance by removing array bounds checks.
+- In some cases, unsafe code can increase an application's performance by removing array bounds checks.
- Unsafe code is required when you call native functions that require pointers.
- Using unsafe code introduces security and stability risks.
- The code that contains unsafe blocks must be compiled with the [**AllowUnsafeBlocks**](compiler-options/language.md#allowunsafeblocks) compiler option.
## Pointer types
-In an unsafe context, a type may be a pointer type, in addition to a value type, or a reference type. A pointer type declaration takes one of the following forms:
+In an unsafe context, a type can be a pointer type, in addition to a value type, or a reference type. A pointer type declaration takes one of the following forms:
``` csharp
type* identifier;
void* identifier; //allowed but not recommended
```
-The type specified before the `*` in a pointer type is called the **referent type**. Only an [unmanaged type](builtin-types/unmanaged-types.md) can be a referent type.
+The type specified before the `*` in a pointer type is called the **referent type**.
Pointer types don't inherit from [object](builtin-types/reference-types.md) and no conversions exist between pointer types and `object`. Also, boxing and unboxing don't support pointers. However, you can convert between different pointer types and between pointer types and integral types.
@@ -48,7 +47,7 @@ int* p1, p2, p3; // Ok
int *p1, *p2, *p3; // Invalid in C#
```
-A pointer can't point to a reference or to a [struct](builtin-types/struct.md) that contains references, because an object reference can be garbage collected even if a pointer is pointing to it. The garbage collector doesn't keep track of whether an object is being pointed to by any pointer types.
+The garbage collector doesn't keep track of whether an object is being pointed to by any pointer types. If the referrant is an object in the managed heap (including local variables captured by lambda expressions or anonymous delegates), the object must be [pinned](./statements/fixed.md) for as long as the pointer is used.
The value of the pointer variable of type `MyType*` is the address of a variable of type `MyType`. The following are examples of pointer type declarations:
@@ -66,7 +65,7 @@ int* myVariable;
The expression `*myVariable` denotes the `int` variable found at the address contained in `myVariable`.
-There are several examples of pointers in the articles on the [`fixed` statement](statements/fixed.md). The following example uses the `unsafe` keyword and the `fixed` statement, and shows how to increment an interior pointer. You can paste this code into the Main function of a console application to run it. These examples must be compiled with the [**AllowUnsafeBlocks**](compiler-options/language.md#allowunsafeblocks) compiler option set.
+There are several examples of pointers in the articles on the [`fixed` statement](statements/fixed.md). The following example uses the `unsafe` keyword and the `fixed` statement, and shows how to increment an interior pointer. You can paste this code into the Main function of a console application to run it. These examples must be compiled with the [**AllowUnsafeBlocks**](compiler-options/language.md#allowunsafeblocks) compiler option set.
:::code language="csharp" source="snippets/unsafe-code/FixedKeywordExamples.cs" ID="5":::
@@ -74,21 +73,21 @@ You can't apply the indirection operator to a pointer of type `void*`. However,
A pointer can be `null`. Applying the indirection operator to a null pointer causes an implementation-defined behavior.
-Passing pointers between methods can cause undefined behavior. Consider a method that returns a pointer to a local variable through an `in`, `out`, or `ref` parameter or as the function result. If the pointer was set in a fixed block, the variable to which it points may no longer be fixed.
+Passing pointers between methods can cause undefined behavior. Consider a method that returns a pointer to a local variable through an `in`, `out`, or `ref` parameter or as the function result. If the pointer was set in a fixed block, the variable to which it points might no longer be fixed.
The following table lists the operators and statements that can operate on pointers in an unsafe context:
-|Operator/Statement|Use|
-|-------------------------|---------|
-|`*`|Performs pointer indirection.|
-|`->`|Accesses a member of a struct through a pointer.|
-|`[]`|Indexes a pointer.|
-|`&`|Obtains the address of a variable.|
-|`++` and `--`|Increments and decrements pointers.|
-|`+` and `-`|Performs pointer arithmetic.|
-|`==`, `!=`, `<`, `>`, `<=`, and `>=`|Compares pointers.|
-|[`stackalloc`](operators/stackalloc.md)|Allocates memory on the stack.|
-|[`fixed` statement](statements/fixed.md)|Temporarily fixes a variable so that its address may be found.|
+| Operator/Statement | Use |
+|------------------------------------------|----------------------------------------------------------------|
+| `*` | Performs pointer indirection. |
+| `->` | Accesses a member of a struct through a pointer. |
+| `[]` | Indexes a pointer. |
+| `&` | Obtains the address of a variable. |
+| `++` and `--` | Increments and decrements pointers. |
+| `+` and `-` | Performs pointer arithmetic. |
+| `==`, `!=`, `<`, `>`, `<=`, and `>=` | Compares pointers. |
+| [`stackalloc`](operators/stackalloc.md) | Allocates memory on the stack. |
+| [`fixed` statement](statements/fixed.md) | Temporarily fixes a variable so that its address can be found. |
For more information about pointer-related operators, see [Pointer-related operators](operators/pointer-related-operators.md).
@@ -116,7 +115,7 @@ A struct can contain an embedded array in unsafe code. In the following example,
:::code language="csharp" source="snippets/unsafe-code/FixedKeywordExamples.cs" ID="7":::
-The size of the 128 element `char` array is 256 bytes. Fixed-size [char](builtin-types/char.md) buffers always take 2 bytes per character, regardless of the encoding. This array size is the same even when char buffers are marshalled to API methods or structs with `CharSet = CharSet.Auto` or `CharSet = CharSet.Ansi`. For more information, see .
+The size of the 128 element `char` array is 256 bytes. Fixed-size [char](builtin-types/char.md) buffers always take 2 bytes per character, regardless of the encoding. This array size is the same even when char buffers are marshaled to API methods or structs with `CharSet = CharSet.Auto` or `CharSet = CharSet.Ansi`. For more information, see .
The preceding example demonstrates accessing `fixed` fields without pinning. Another common fixed-size array is the [bool](builtin-types/bool.md) array. The elements in a `bool` array are always 1 byte in size. `bool` arrays aren't appropriate for creating bit arrays or buffers.
@@ -158,7 +157,7 @@ Fixed-size buffers differ from regular arrays in the following ways:
The following example uses pointers to copy bytes from one array to another.
-This example uses the [unsafe](keywords/unsafe.md) keyword, which enables you to use pointers in the `Copy` method. The [fixed](statements/fixed.md) statement is used to declare pointers to the source and destination arrays. The `fixed` statement *pins* the location of the source and destination arrays in memory so that they will not be moved by garbage collection. The memory blocks for the arrays are unpinned when the `fixed` block is completed. Because the `Copy` method in this example uses the `unsafe` keyword, it must be compiled with the [**AllowUnsafeBlocks**](compiler-options/language.md#allowunsafeblocks) compiler option.
+This example uses the [unsafe](keywords/unsafe.md) keyword, which enables you to use pointers in the `Copy` method. The [fixed](statements/fixed.md) statement is used to declare pointers to the source and destination arrays. The `fixed` statement *pins* the location of the source and destination arrays in memory so that garbage collection doesn't move the arrays. The memory blocks for the arrays are unpinned when the `fixed` block is completed. Because the `Copy` method in this example uses the `unsafe` keyword, it must be compiled with the [**AllowUnsafeBlocks**](compiler-options/language.md#allowunsafeblocks) compiler option.
This example accesses the elements of both arrays using indices rather than a second unmanaged pointer. The declaration of the `pSource` and `pTarget` pointers pins the arrays.
@@ -168,7 +167,7 @@ This example accesses the elements of both arrays using indices rather than a se
C# provides [`delegate`](builtin-types/reference-types.md#the-delegate-type) types to define safe function pointer objects. Invoking a delegate involves instantiating a type derived from and making a virtual method call to its `Invoke` method. This virtual call uses the `callvirt` IL instruction. In performance critical code paths, using the `calli` IL instruction is more efficient.
-You can define a function pointer using the `delegate*` syntax. The compiler will call the function using the `calli` instruction rather than instantiating a `delegate` object and calling `Invoke`. The following code declares two methods that use a `delegate` or a `delegate*` to combine two objects of the same type. The first method uses a delegate type. The second method uses a `delegate*` declaration with the same parameters and return type:
+You can define a function pointer using the `delegate*` syntax. The compiler calls the function using the `calli` instruction rather than instantiating a `delegate` object and calling `Invoke`. The following code declares two methods that use a `delegate` or a `delegate*` to combine two objects of the same type. The first method uses a delegate type. The second method uses a `delegate*` declaration with the same parameters and return type:
:::code language="csharp" source="snippets/unsafe-code/FunctionPointers.cs" ID="UseDelegateOrPointer":::
@@ -184,7 +183,7 @@ The preceding code illustrates several of the rules on the function accessed as
The syntax has parallels with declaring `delegate` types and using pointers. The `*` suffix on `delegate` indicates the declaration is a *function pointer*. The `&` when assigning a method group to a function pointer indicates the operation takes the address of the method.
-You can specify the calling convention for a `delegate*` using the keywords `managed` and `unmanaged`. In addition, for `unmanaged` function pointers, you can specify the calling convention. The following declarations show examples of each. The first declaration uses the `managed` calling convention, which is the default. The next four use an `unmanaged` calling convention. Each specifies one of the ECMA 335 calling conventions: `Cdecl`, `Stdcall`, `Fastcall`, or `Thiscall`. The last declaration uses the `unmanaged` calling convention, instructing the CLR to pick the default calling convention for the platform. The CLR will choose the calling convention at run time.
+You can specify the calling convention for a `delegate*` using the keywords `managed` and `unmanaged`. In addition, for `unmanaged` function pointers, you can specify the calling convention. The following declarations show examples of each. The first declaration uses the `managed` calling convention, which is the default. The next four use an `unmanaged` calling convention. Each specifies one of the ECMA 335 calling conventions: `Cdecl`, `Stdcall`, `Fastcall`, or `Thiscall`. The last declaration uses the `unmanaged` calling convention, instructing the CLR to pick the default calling convention for the platform. The CLR chooses the calling convention at run time.
:::code language="csharp" source="snippets/unsafe-code/FunctionPointers.cs" ID="UnmanagedFunctionPointers":::
From 718ff51c656d953d7ef07be3db26edc4ad6dbb5b Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Thu, 6 Feb 2025 13:56:50 -0800
Subject: [PATCH 06/10] update ms.topic to match new guidelines (#44707)
---
docfx.json | 1 +
1 file changed, 1 insertion(+)
diff --git a/docfx.json b/docfx.json
index b20d68ecd1ae7..9c2b5973f1b6a 100644
--- a/docfx.json
+++ b/docfx.json
@@ -256,6 +256,7 @@
"docs/core/runtime-config/**.md": "reference",
"docs/core/tools/dotnet*.md": "reference",
"docs/core/tools/sdk-errors/*.md": "error-reference",
+ "docs/core/testing/mstest-analyzers/*.md": "error-reference",
"docs/core/tutorials/**.md": "tutorial",
"docs/csharp/getting-started/**/*.md": "overview",
"docs/csharp/how-to/**/*.md": "how-to",
From 90c1904b20bc8118c731e3350ac4c9bd8e172c3e Mon Sep 17 00:00:00 2001
From: Adit Sheth
Date: Thu, 6 Feb 2025 14:23:12 -0800
Subject: [PATCH 07/10] Enhance Attribute Retrieval Guide to Include
Member-Level Attributes (#44665)
* Fixed bug 40174.
* Resolving comments.
Co-authored-by: Bartosz Klonowski <70535775+BartoszKlonowski@users.noreply.github.com>
* Resolving comments.
Co-authored-by: Bartosz Klonowski <70535775+BartoszKlonowski@users.noreply.github.com>
* Resolving comments.
Co-authored-by: Bartosz Klonowski <70535775+BartoszKlonowski@users.noreply.github.com>
* Moved code to different folder.
* Added example section.
* Added snippet in new file.
* Build newly added file.
* removed extra space.
* Added csproj.
* Prevent auto-generate AssemblyInfo.cs.
---------
Co-authored-by: Adit Sheth
Co-authored-by: Bartosz Klonowski <70535775+BartoszKlonowski@users.noreply.github.com>
---
...ieving-information-stored-in-attributes.md | 14 ++++++-
.../conceptualAttrUsage.csproj | 12 ++++++
.../conceptual.attributes.usage/cs/makefile | 4 +-
.../conceptual.attributes.usage/cs/source4.cs | 40 +++++++++++++++++++
4 files changed, 67 insertions(+), 3 deletions(-)
create mode 100644 samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/conceptualAttrUsage.csproj
create mode 100644 samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source4.cs
diff --git a/docs/standard/attributes/retrieving-information-stored-in-attributes.md b/docs/standard/attributes/retrieving-information-stored-in-attributes.md
index 48c8942845941..f178f234fbb17 100644
--- a/docs/standard/attributes/retrieving-information-stored-in-attributes.md
+++ b/docs/standard/attributes/retrieving-information-stored-in-attributes.md
@@ -1,6 +1,6 @@
---
title: "Retrieving Information Stored in Attributes"
-description: Learn to retrieve information stored in attributes, such as for an attribute instance, many instances for the same scope, & many instances for different scopes.
+description: Learn to retrieve information stored in attributes, including for an attribute instance, multiple instances for the same scope, multiple instances for different scopes, and attributes applied to class members.
ms.date: "08/05/2022"
ms.custom: devdivchpfy22
dev_langs:
@@ -82,7 +82,17 @@ The attribute was not found.
If no instances of the `DeveloperAttribute` are found on the method level or class level, the `GetAttribute` method notifies the user that no attributes were found and displays the name of the method or class that doesn't contain the attribute. If an attribute is found, the console displays the `Name`, `Level`, and `Reviewed` fields.
- You can use the members of the class to get the individual methods and members in the passed class. This example first queries the `Type` object to get attribute information for the class level. Next, it uses to place instances of all methods into an array of objects to retrieve attribute information for the method level. You can also use the method to check for attributes on the property level or to check for attributes on the constructor level.
+ You can use the members of the class to get the individual methods and members in the passed class. This example first queries the `Type` object to get attribute information for the class level. Next, it uses to place instances of all methods into an array of objects to retrieve attribute information for the method level. You can also use the method to check for attributes on the property level or to check for attributes on the constructor level.
+
+## Retrieving Attributes from Class Members
+
+In addition to retrieving attributes at the class level, attributes can also be applied to individual members such as methods, properties, and fields. The `GetCustomAttribute` and `GetCustomAttributes` methods can be used to retrieve these attributes.
+
+### Example
+
+The following example demonstrates how to retrieve an attribute applied to a method:
+
+[!code-csharp[Conceptual.Attributes.Usage#21](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source4.cs#21)]
## See also
diff --git a/samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/conceptualAttrUsage.csproj b/samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/conceptualAttrUsage.csproj
new file mode 100644
index 0000000000000..759468c67814d
--- /dev/null
+++ b/samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/conceptualAttrUsage.csproj
@@ -0,0 +1,12 @@
+
+
+
+ Exe
+ net8.0
+ enable
+ enable
+ AttributeRetrieval
+ false
+
+
+
diff --git a/samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/makefile b/samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/makefile
index cd2eff1878c69..24bc3cdc22062 100644
--- a/samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/makefile
+++ b/samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/makefile
@@ -1,4 +1,4 @@
-all: source1.exe source2.dll source3.exe
+all: source1.exe source2.dll source3.exe source4.exe
source1.exe: source1.cs
csc source1.cs
@@ -9,3 +9,5 @@ source2.dll: source2.cs
source3.exe: source2.dll source3.cs
csc /r:source2.dll source3.cs
+source4.exe: source4.cs
+ csc source4.cs
diff --git a/samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source4.cs b/samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source4.cs
new file mode 100644
index 0000000000000..53a60dd093c72
--- /dev/null
+++ b/samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source4.cs
@@ -0,0 +1,40 @@
+//
+using System;
+using System.Reflection;
+
+[AttributeUsage(AttributeTargets.Method)]
+public class MyAttribute : Attribute
+{
+ public string Description { get; }
+ public MyAttribute(string description) { Description = description; }
+}
+
+public class MyClass
+{
+ [MyAttribute("This is a sample method.")]
+ public void MyMethod() { }
+}
+
+class AttributeRetrieval
+{
+ public static void Main()
+ {
+ // Create an instance of MyClass
+ MyClass myClass = new MyClass();
+
+ // Retrieve the method information for MyMethod
+ MethodInfo methodInfo = typeof(MyClass).GetMethod("MyMethod");
+ MyAttribute attribute = (MyAttribute)Attribute.GetCustomAttribute(methodInfo, typeof(MyAttribute));
+
+ if (attribute != null)
+ {
+ // Print the description of the method attribute
+ Console.WriteLine("Method Attribute: {0}", attribute.Description);
+ }
+ else
+ {
+ Console.WriteLine("Attribute not found.");
+ }
+ }
+}
+//
From 2ce6cc6367b553aa1cc40801ff6abdaa84a355b3 Mon Sep 17 00:00:00 2001
From: Cam Soper
Date: Thu, 6 Feb 2025 18:25:43 -0600
Subject: [PATCH 08/10] Breaking change correction (#44695)
* fixes #43828
* whoops extra line
---
docs/core/compatibility/10.0.md | 7 ++--
.../cryptography/10.0/version-override.md | 38 +++++++++++++++++++
docs/core/compatibility/toc.yml | 4 ++
3 files changed, 46 insertions(+), 3 deletions(-)
create mode 100644 docs/core/compatibility/cryptography/10.0/version-override.md
diff --git a/docs/core/compatibility/10.0.md b/docs/core/compatibility/10.0.md
index 3cfb3b62328eb..fc7e8837b7bf6 100644
--- a/docs/core/compatibility/10.0.md
+++ b/docs/core/compatibility/10.0.md
@@ -35,9 +35,10 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af
## Cryptography
-| Title | Type of change | Introduced version |
-|--------------------------------------------------------------------------------------------------------|-------------------|--------------------|
-| [X500DistinguishedName validation is stricter](cryptography/10.0/x500distinguishedname-validation.md) | Behavioral change | Preview 1 |
+| Title | Type of change | Introduced version |
+|------------------------------------------------------------------------------------------------------------|-------------------|--------------------|
+| [X500DistinguishedName validation is stricter](cryptography/10.0/x500distinguishedname-validation.md) | Behavioral change | Preview 1 |
+| [Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE](cryptography/10.0/version-override.md) | Behavioral change | Preview 1 |
## Windows Forms
diff --git a/docs/core/compatibility/cryptography/10.0/version-override.md b/docs/core/compatibility/cryptography/10.0/version-override.md
new file mode 100644
index 0000000000000..7fcb4574d7630
--- /dev/null
+++ b/docs/core/compatibility/cryptography/10.0/version-override.md
@@ -0,0 +1,38 @@
+---
+title: "Breaking change: Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE"
+description: Learn about the .NET 10 breaking change in .NET cryptography where the environment variable CLR_OPENSSL_VERSION_OVERRIDE was renamed to DOTNET_OPENSSL_VERSION_OVERRIDE.
+ms.date: 02/05/2025
+ai-usage: ai-assisted
+---
+
+# Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE
+
+.NET previously supported a configuration-switch environment variable called `CLR_OPENSSL_VERSION_OVERRIDE`, which allowed users to specify the preferred OpenSSL library version for apps running on Linux. In .NET 10, this environment variable has been renamed to `DOTNET_OPENSSL_VERSION_OVERRIDE` to align with the naming convention of other configuration switch environment variables in .NET.
+
+## Previous behavior
+
+The `CLR_OPENSSL_VERSION_OVERRIDE` environment variable was used to specify the preferred OpenSSL version to be loaded in the application.
+
+## New behavior
+
+The `DOTNET_OPENSSL_VERSION_OVERRIDE` environment variable is used to specify the preferred OpenSSL version to be loaded in the application.
+
+## Version introduced
+
+.NET 10 Preview 1
+
+## Type of breaking change
+
+This change is a [behavioral change](../../categories.md#behavioral-change).
+
+## Reason for change
+
+This change ensures the environment variable is consistent with the naming convention used for all [.NET environment variables](../../../tools/dotnet-environment-variables.md).
+
+## Recommended action
+
+If you have a .NET 10 app that previously used the `CLR_OPENSSL_VERSION_OVERRIDE` environment variable, use `DOTNET_OPENSSL_VERSION_OVERRIDE` instead.
+
+## Affected APIs
+
+N/A
diff --git a/docs/core/compatibility/toc.yml b/docs/core/compatibility/toc.yml
index d512dd2bc91aa..f708acc61586a 100644
--- a/docs/core/compatibility/toc.yml
+++ b/docs/core/compatibility/toc.yml
@@ -26,6 +26,8 @@ items:
items:
- name: X500DistinguishedName validation is stricter
href: cryptography/10.0/x500distinguishedname-validation.md
+ - name: Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE
+ href: cryptography/10.0/version-override.md
- name: Globalization
items:
- name: Environment variable renamed to DOTNET_ICU_VERSION_OVERRIDE
@@ -1584,6 +1586,8 @@ items:
items:
- name: X500DistinguishedName validation is stricter
href: cryptography/10.0/x500distinguishedname-validation.md
+ - name: Environment variable renamed to DOTNET_OPENSSL_VERSION_OVERRIDE
+ href: cryptography/10.0/version-override.md
- name: .NET 9
items:
- name: SafeEvpPKeyHandle.DuplicateHandle up-refs the handle
From 3da68b598aca74e7ab3e261634edc56019339e85 Mon Sep 17 00:00:00 2001
From: Maarten Balliauw
Date: Fri, 7 Feb 2025 01:49:29 +0100
Subject: [PATCH 09/10] Update identity-server.md to use latest documentation
links (#44680)
---
.../cloud-native/identity-server.md | 87 +++++++++----------
1 file changed, 41 insertions(+), 46 deletions(-)
diff --git a/docs/architecture/cloud-native/identity-server.md b/docs/architecture/cloud-native/identity-server.md
index 6725202e50614..cf10e0ea14d8e 100644
--- a/docs/architecture/cloud-native/identity-server.md
+++ b/docs/architecture/cloud-native/identity-server.md
@@ -1,7 +1,7 @@
---
title: IdentityServer for Cloud Native Apps
description: Architecting Cloud Native .NET Apps for Azure | IdentityServer
-ms.date: 04/06/2022
+ms.date: 02/06/2025
---
# IdentityServer for cloud-native applications
@@ -26,7 +26,7 @@ Typically, applications need to support some or all of the following scenarios:
In each of these scenarios, the exposed functionality needs to be secured against unauthorized use. At a minimum, this typically requires authenticating the user or principal making a request for a resource. This authentication may use one of several common protocols such as SAML2p, WS-Fed, or OpenID Connect. Communicating with APIs typically uses the OAuth2 protocol and its support for security tokens. Separating these critical cross-cutting security concerns and their implementation details from the applications themselves ensures consistency and improves security and maintainability. Outsourcing these concerns to a dedicated product like IdentityServer helps the requirement for every application to solve these problems itself.
-IdentityServer provides middleware that runs within an ASP.NET Core application and adds support for OpenID Connect and OAuth2 (see [supported specifications](https://docs.duendesoftware.com/identityserver/v6/overview/specs/)). Organizations would create their own ASP.NET Core app using IdentityServer middleware to act as the STS for all of their token-based security protocols. The IdentityServer middleware exposes endpoints to support standard functionality, including:
+IdentityServer provides middleware that runs within an ASP.NET Core application and adds support for OpenID Connect and OAuth2 (see [supported specifications](https://docs.duendesoftware.com/identityserver/v7/overview/specs/)). Organizations would create their own ASP.NET Core app using IdentityServer middleware to act as the STS for all of their token-based security protocols. The IdentityServer middleware exposes endpoints to support standard functionality, including:
- Authorize (authenticate the end user)
- Token (request a token programmatically)
@@ -39,57 +39,52 @@ IdentityServer provides middleware that runs within an ASP.NET Core application
## Getting started
-IdentityServer4 is available under dual license:
+IdentityServer is available:
-* RPL - lets you use the IdentityServer4 free if used in open-source work
-* Paid - lets you use the IdentityServer4 in a commercial scenario
+* With a community license, which lets you use the [IdentityServer free for small companies and non-profits](https://duendesoftware.com/products/communityedition) (conditions apply)
+* Paid, which lets you use the IdentityServer [in a commercial scenario](https://duendesoftware.com/products/identityserver)
For more information about pricing, see the official product's [pricing page](https://duendesoftware.com/products/identityserver).
-You can add it to your applications using its NuGet packages. The main package is [IdentityServer4](https://www.nuget.org/packages/IdentityServer4/), which has been downloaded over four million times. The base package doesn't include any user interface code and only supports in-memory configuration. To use it with a database, you'll also want a data provider like [IdentityServer4.EntityFramework](https://www.nuget.org/packages/IdentityServer4.EntityFramework), which uses Entity Framework Core to store configuration and operational data for IdentityServer. For user interface, you can copy files from the [Quickstart UI repository](https://github.com/IdentityServer/IdentityServer4.Quickstart.UI) into your ASP.NET Core MVC application to add support for sign in and sign out using IdentityServer middleware.
+You can add it to your applications using its NuGet packages. The main package is [IdentityServer](https://www.nuget.org/packages/Duende.IdentityServer/), which has been downloaded over four million times. The base package doesn't include any user interface code and only supports in-memory configuration. To use it with a database, you'll also want a data provider like [Duende.IdentityServer.Storage](https://www.nuget.org/packages/Duende.IdentityServer.Storage), which uses Entity Framework Core to store configuration and operational data for IdentityServer. For user interface, you can copy files from the [Quickstart UI repository](https://github.com/DuendeSoftware/IdentityServer.Quickstart.UI) into your ASP.NET Core MVC application to add support for sign in and sign out using IdentityServer middleware.
## Configuration
-IdentityServer supports different kinds of protocols and social authentication providers that can be configured as part of each custom installation. This is typically done in the ASP.NET Core application's `Program` class (or in the `Startup` class in the `ConfigureServices` method). The configuration involves specifying the supported protocols and the paths to the servers and endpoints that will be used. Figure 8-2 shows an example configuration taken from the IdentityServer4 Quickstart UI project:
+IdentityServer supports different kinds of protocols and social authentication providers that can be configured as part of each custom installation. This is typically done in the ASP.NET Core application's `Program` class (or in the `Startup` class in the `ConfigureServices` method). The configuration involves specifying the supported protocols and the paths to the servers and endpoints that will be used. Figure 8-2 shows an example configuration taken from the [IdentityServer Quickstart for ASP.NET Core applications](https://docs.duendesoftware.com/identityserver/v7/quickstarts/2_interactive/) project:
```csharp
-public class Startup
-{
- public void ConfigureServices(IServiceCollection services)
+// some details omitted
+builder.Services.AddIdentityServer();
+
+builder.Services.AddAuthentication(options =>
+ {
+ options.DefaultScheme = "Cookies";
+ options.DefaultChallengeScheme = "oidc";
+ })
+ .AddCookie("Cookies")
+ .AddGoogle("Google", options =>
+ {
+ options.SignInScheme = IdentityServerConstants.ExternalCookieAuthenticationScheme;
+
+ options.ClientId = "";
+ options.ClientSecret = "";
+ })
+ .AddOpenIdConnect("oidc", options =>
{
- services.AddMvc();
-
- // some details omitted
- services.AddIdentityServer();
-
- services.AddAuthentication()
- .AddGoogle("Google", options =>
- {
- options.SignInScheme = IdentityServerConstants.ExternalCookieAuthenticationScheme;
-
- options.ClientId = "";
- options.ClientSecret = "";
- })
- .AddOpenIdConnect("demoidsrv", "IdentityServer", options =>
- {
- options.SignInScheme = IdentityServerConstants.ExternalCookieAuthenticationScheme;
- options.SignOutScheme = IdentityServerConstants.SignoutScheme;
-
- options.Authority = "https://demo.identityserver.io/";
- options.ClientId = "implicit";
- options.ResponseType = "id_token";
- options.SaveTokens = true;
- options.CallbackPath = new PathString("/signin-idsrv");
- options.SignedOutCallbackPath = new PathString("/signout-callback-idsrv");
- options.RemoteSignOutPath = new PathString("/signout-idsrv");
-
- options.TokenValidationParameters = new TokenValidationParameters
- {
- NameClaimType = "name",
- RoleClaimType = "role"
- };
- });
- }
+ options.Authority = "https://localhost:5001";
+
+ options.ClientId = "web";
+ options.ClientSecret = "secret";
+ options.ResponseType = "code";
+
+ options.Scope.Clear();
+ options.Scope.Add("openid");
+ options.Scope.Add("profile");
+
+ options.MapInboundClaims = false; // Don't rename claim types
+
+ options.SaveTokens = true;
+ });
}
```
@@ -97,13 +92,13 @@ public class Startup
## JavaScript clients
-Many cloud-native applications use server-side APIs and rich client single page applications (SPAs) on the front end. IdentityServer ships a [JavaScript client](https://docs.duendesoftware.com/identityserver/v6/quickstarts/js_clients/) (`oidc-client.js`) via NPM that can be added to SPAs to enable them to use IdentityServer for sign in, sign out, and token-based authentication of web APIs.
+Many cloud-native applications use server-side APIs and rich client single page applications (SPAs) on the front end. IdentityServer ships a [JavaScript client](https://docs.duendesoftware.com/identityserver/v7/quickstarts/js_clients/) (`oidc-client.js`) via NPM that can be added to SPAs to enable them to use IdentityServer for sign in, sign out, and token-based authentication of web APIs. In addition, you can use a [backend-for-frontend (BFF)](https://docs.duendesoftware.com/identityserver/v7/quickstarts/js_clients/js_with_backend/) that implements all of the security protocol interactions with the token server and the IETF's [OAuth 2.0 for Browser-Based Applications spec](https://datatracker.ietf.org/doc/html/draft-ietf-oauth-browser-based-apps).
## References
-- [IdentityServer documentation](https://docs.duendesoftware.com/identityserver/v6/)
+- [IdentityServer documentation](https://docs.duendesoftware.com/identityserver/v7/)
- [Application types](/azure/active-directory/develop/app-types)
-- [JavaScript OIDC client](https://docs.duendesoftware.com/identityserver/v6/quickstarts/js_clients/)
+- [JavaScript OIDC client](https://docs.duendesoftware.com/identityserver/v7/quickstarts/js_clients/)
>[!div class="step-by-step"]
>[Previous](azure-active-directory.md)
From 63cc6839be730586c46dbb59b4d5d669a6edb69f Mon Sep 17 00:00:00 2001
From: alexwolfmsft <93200798+alexwolfmsft@users.noreply.github.com>
Date: Thu, 6 Feb 2025 20:10:50 -0500
Subject: [PATCH 10/10] Revamp article format and instructions. (#44703)
* Revamp article format and instructions.
---------
Co-authored-by: Scott Addie <10702007+scottaddie@users.noreply.github.com>
---
.../sdk/authentication/azure-hosted-apps.md | 94 ++++++++++++------
docs/azure/sdk/authentication/index.md | 2 +-
...managed-identity-to-role-azure-portal-1.md | 7 --
...managed-identity-to-role-azure-portal-2.md | 5 -
...managed-identity-to-role-azure-portal-3.md | 8 --
...managed-identity-to-role-azure-portal-4.md | 10 --
...managed-identity-to-role-azure-portal-5.md | 10 --
...managed-identity-to-role-azure-portal-6.md | 10 --
...managed-identity-to-role-azure-portal-7.md | 7 --
.../enable-managed-identity-azure-cli.md | 22 ----
.../enable-managed-identity-azure-portal-1.md | 7 --
.../enable-managed-identity-azure-portal-2.md | 7 --
.../enable-managed-identity-azure-portal-3.md | 10 --
...-identity-to-role-azure-portal-1-240px.png | Bin 7911 -> 0 bytes
...anaged-identity-to-role-azure-portal-1.png | Bin 24543 -> 0 bytes
...-identity-to-role-azure-portal-2-240px.png | Bin 11498 -> 0 bytes
...anaged-identity-to-role-azure-portal-2.png | Bin 29635 -> 0 bytes
...-identity-to-role-azure-portal-3-240px.png | Bin 15548 -> 0 bytes
...anaged-identity-to-role-azure-portal-3.png | Bin 44737 -> 0 bytes
...-identity-to-role-azure-portal-4-240px.png | Bin 24147 -> 0 bytes
...anaged-identity-to-role-azure-portal-4.png | Bin 42191 -> 0 bytes
...-identity-to-role-azure-portal-5-240px.png | Bin 12117 -> 0 bytes
...anaged-identity-to-role-azure-portal-5.png | Bin 29946 -> 0 bytes
...-identity-to-role-azure-portal-6-240px.png | Bin 10100 -> 0 bytes
...anaged-identity-to-role-azure-portal-6.png | Bin 18694 -> 0 bytes
...-identity-to-role-azure-portal-7-240px.png | Bin 14014 -> 0 bytes
...-managed-identity-azure-portal-1-240px.png | Bin 9038 -> 0 bytes
...enable-managed-identity-azure-portal-1.png | Bin 26651 -> 0 bytes
...-managed-identity-azure-portal-2-240px.png | Bin 49416 -> 0 bytes
...enable-managed-identity-azure-portal-2.png | Bin 57504 -> 0 bytes
...-managed-identity-azure-portal-3-240px.png | Bin 19494 -> 0 bytes
...enable-managed-identity-azure-portal-3.png | Bin 46658 -> 0 bytes
...ystem-assigned-identity-access-control.png | Bin 0 -> 47860 bytes
.../system-assigned-identity-assign-roles.png | Bin 0 -> 74492 bytes
.../media/system-assigned-identity-enable.png | Bin 0 -> 78934 bytes
35 files changed, 65 insertions(+), 134 deletions(-)
delete mode 100644 docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-1.md
delete mode 100644 docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-2.md
delete mode 100644 docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-3.md
delete mode 100644 docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-4.md
delete mode 100644 docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-5.md
delete mode 100644 docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-6.md
delete mode 100644 docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-7.md
delete mode 100644 docs/azure/sdk/includes/enable-managed-identity-azure-cli.md
delete mode 100644 docs/azure/sdk/includes/enable-managed-identity-azure-portal-1.md
delete mode 100644 docs/azure/sdk/includes/enable-managed-identity-azure-portal-2.md
delete mode 100644 docs/azure/sdk/includes/enable-managed-identity-azure-portal-3.md
delete mode 100644 docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-1-240px.png
delete mode 100644 docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-1.png
delete mode 100644 docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-2-240px.png
delete mode 100644 docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-2.png
delete mode 100644 docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-3-240px.png
delete mode 100644 docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-3.png
delete mode 100644 docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-4-240px.png
delete mode 100644 docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-4.png
delete mode 100644 docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-5-240px.png
delete mode 100644 docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-5.png
delete mode 100644 docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-6-240px.png
delete mode 100644 docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-6.png
delete mode 100644 docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-7-240px.png
delete mode 100644 docs/azure/sdk/media/enable-managed-identity-azure-portal-1-240px.png
delete mode 100644 docs/azure/sdk/media/enable-managed-identity-azure-portal-1.png
delete mode 100644 docs/azure/sdk/media/enable-managed-identity-azure-portal-2-240px.png
delete mode 100644 docs/azure/sdk/media/enable-managed-identity-azure-portal-2.png
delete mode 100644 docs/azure/sdk/media/enable-managed-identity-azure-portal-3-240px.png
delete mode 100644 docs/azure/sdk/media/enable-managed-identity-azure-portal-3.png
create mode 100644 docs/azure/sdk/media/system-assigned-identity-access-control.png
create mode 100644 docs/azure/sdk/media/system-assigned-identity-assign-roles.png
create mode 100644 docs/azure/sdk/media/system-assigned-identity-enable.png
diff --git a/docs/azure/sdk/authentication/azure-hosted-apps.md b/docs/azure/sdk/authentication/azure-hosted-apps.md
index d10ff44b5e48d..c0d5f4f17938b 100644
--- a/docs/azure/sdk/authentication/azure-hosted-apps.md
+++ b/docs/azure/sdk/authentication/azure-hosted-apps.md
@@ -3,37 +3,43 @@ title: Authenticate Azure-hosted .NET apps to Azure resources
description: Learn how to authenticate apps to Azure services when hosted in an Azure compute service like Azure App Service, Azure Functions, or Azure Virtual Machines.
ms.topic: how-to
ms.custom: devx-track-dotnet, engagement-fy23, devx-track-azurecli
-ms.date: 07/31/2024
+ms.date: 02/06/2025
---
# Authenticate Azure-hosted apps to Azure resources with the Azure SDK for .NET
-When an app is hosted in Azure using a service like Azure App Service, Azure Virtual Machines, or Azure Container Instances, the recommended approach to authenticating an app to Azure resources is to use a [managed identity](/entra/identity/managed-identities-azure-resources/overview).
+The recommended approach to authenticate an Azure-hosted app to other Azure resources is to use a [managed identity](/entra/identity/managed-identities-azure-resources/overview). This approach is [supported for most Azure services](/entra/identity/managed-identities-azure-resources/managed-identities-status), including apps hosted on Azure App Service, Azure Container Apps, and Azure Virtual Machines. Discover more about different authentication techniques and approaches on the [authentication overview](/dotnet/azure/sdk/authentication) page. In the sections ahead, you'll learn:
-A managed identity provides an identity for your app such that it can connect to other Azure resources without the need to use a secret key or other application secret. Internally, Azure knows the identity of your app and what resources it's allowed to connect to. Azure uses this information to automatically obtain Microsoft Entra tokens for the app to allow it to connect to other Azure resources, all without you having to manage any application secrets.
+- Essential managed identity concepts
+- How to create a managed identity for your app
+- How to assign roles to the managed identity
+- How to authenticate using the managed identity from your app code
-## Managed identity types
+## Essential managed identity concepts
-There are two types of managed identities:
+A managed identity enables your app to securely connect to other Azure resources without the use of secret keys or other application secrets. Internally, Azure tracks the identity and which resources it's allowed to connect to. Azure uses this information to automatically obtain Microsoft Entra tokens for the app to allow it to connect to other Azure resources.
-- **System-assigned** - This type of managed identity is provided by and tied directly to an Azure resource. When you enable managed identity on an Azure resource, you get a system-assigned managed identity for that resource. A system-assigned managed identity is tied to the lifecycle of the Azure resource it's associated with. When the resource is deleted, Azure automatically deletes the identity for you. Since all you have to do is enable managed identity for the Azure resource hosting your code, this is the easiest type of managed identity to use.
-- **User-assigned** - You may also create a managed identity as a standalone Azure resource. This is most frequently used when your solution has multiple workloads that run on multiple Azure resources that all need to share the same identity and same permissions. For example, if your solution had components that ran on multiple App Service and virtual machine instances that all needed access to the same set of Azure resources, creating and using a user-assigned managed identity across those resources would make sense.
+There are two types of managed identities to consider when configuring your hosted app:
-This article will cover the steps to enable and use a system-assigned managed identity for an app. If you need to use a user-assigned managed identity, see the article [Manage user-assigned managed identities](/entra/identity/managed-identities-azure-resources/how-manage-user-assigned-managed-identities?pivots=identity-mi-methods-azp) to see how to create a user-assigned managed identity.
+- **System-assigned** identities are enabled directly on an Azure resource and are tied to its life cycle. When the resource is deleted, Azure automatically deletes the identity for you. System-assigned identities provide a minimalistic approach to using managed identities.
+- **User-assigned** identities are created as standalone Azure resources and offer greater flexibility and capabilities. They are ideal for solutions involving multiple Azure resources that need to share the same identity and permissions. For example, if multiple virtual machines need to access the same set of Azure resources, a user-assigned managed identity provides reusability and optimized management.
-## 1 - Enable managed identity in the Azure resource hosting the app
+The sections ahead describe the steps to enable and use a system-assigned managed identity for an Azure-hosted app. If you need to use a user-assigned managed identity, visit the [Manage user-assigned managed identities](/entra/identity/managed-identities-azure-resources/how-manage-user-assigned-managed-identities?pivots=identity-mi-methods-azp) article for more information.
-The first step is to enable managed identity on Azure resource hosting your app. For example, if you're hosting a .NET app using Azure App Service, you need to enable managed identity for the App Service web app that is hosting your app. If you were using a virtual machine to host your app, you would enable your VM to use managed identity.
+## Enable a system-assigned managed identity on the Azure hosting resource
-You can enable managed identity to be used for an Azure resource using either the Azure portal or the Azure CLI.
+To get started using a system-assigned managed identity with your app, enable the identity on the Azure resource hosting your app, such as an Azure App Service, Azure Container App, or Azure Virtual Machine.
+
+You can enable a system-assigned managed identity for an Azure resource using either the Azure portal or the Azure CLI.
### [Azure portal](#tab/azure-portal)
-| Instructions | Screenshot |
-|:----------------|-----------:|
-| [!INCLUDE [Enable managed identity step 1](<../includes/enable-managed-identity-azure-portal-1.md>)] | :::image type="content" source="../media/enable-managed-identity-azure-portal-1-240px.png" alt-text="A screenshot showing how to use the top search bar in the Azure portal to locate and navigate to an Azure resource." lightbox="../media/enable-managed-identity-azure-portal-1.png"::: |
-| [!INCLUDE [Enable managed identity step 2](<../includes/enable-managed-identity-azure-portal-2.md>)] | :::image type="content" source="../media/enable-managed-identity-azure-portal-2-240px.png" alt-text="A screenshot showing the location of the Identity menu item in the left-hand menu for an Azure resource." lightbox="../media/enable-managed-identity-azure-portal-2.png"::: |
-| [!INCLUDE [Enable managed identity step 3](<../includes/enable-managed-identity-azure-portal-3.md>)] | :::image type="content" source="../media/enable-managed-identity-azure-portal-3-240px.png" alt-text="A screenshot showing how to enable managed identity for an Azure resource on the resource's Identity page." lightbox="../media/enable-managed-identity-azure-portal-3.png"::: |
+1. In the Azure portal, navigate to the resource that hosts your application code, such as an Azure App Service or Azure Container App instance.
+1. From the resource's **Overview** page, expand **Settings** and select **Identity** from the navigation.
+1. On the **Identity** page, toggle the **Status** slider to **On**.
+1. Select **Save** to apply your changes.
+
+ :::image type="content" source="../media/system-assigned-identity-enable.png" alt-text="A screenshot showing how to enable a system-assigned identity on a container app.":::
### [Azure CLI](#tab/azure-cli)
@@ -41,9 +47,23 @@ Azure CLI commands can be run in the [Azure Cloud Shell](https://shell.azure.com
The Azure CLI commands used to enable managed identity for an Azure resource are of the form `az identity --resource-group --name `. Specific commands for popular Azure services are shown below.
-[!INCLUDE [Enable managed identity Azure CLI](<../includes/enable-managed-identity-azure-cli.md>)]
+Azure App Service:
+
+```azurecli
+az webapp identity assign \
+ --resource-group \
+ --name
+```
+
+Azure Virtual Machine:
-The output will look like the following.
+```azurecli
+az vm identity assign \
+ --resource-group \
+ --name
+```
+
+The output resembles the following:
```json
{
@@ -58,21 +78,35 @@ The `principalId` value is the unique ID of the managed identity. Keep a copy of
---
-## 2 - Assign roles to the managed identity
+## Assign roles to the managed identity
+
+Next, determine which roles your app needs and assign those roles to the managed identity. You can assign roles to a managed identity at the following scopes:
-Next, determine which roles (permissions) your app needs and assign the managed identity to those roles in Azure. A managed identity can be assigned roles at a resource, resource group, or subscription scope. This example will show how to assign roles at the resource group scope since most applications group all their Azure resources into a single resource group.
+- **Resource**: The assigned roles only apply to that specific resource.
+- **Resource group**: The assigned roles apply to all resources contained in the resource group.
+- **Subscription**: The assigned roles apply to all resources contained in the subscription.
+
+The following example shows how to assign roles at the resource group scope, since many apps manage all their related Azure resources using a single resource group.
### [Azure portal](#tab/azure-portal)
-| Instructions | Screenshot |
-|:----------------|-----------:|
-| [!INCLUDE [Assign managed identity to role step 1](<../includes/assign-managed-identity-to-role-azure-portal-1.md>)] | :::image type="content" source="../media/assign-managed-identity-to-role-azure-portal-1-240px.png" alt-text="A screenshot showing how to use the top search bar in the Azure portal to locate and navigate to a resource group in Azure. This is the resource group that you'll assign roles (permissions) to." lightbox="../media/assign-managed-identity-to-role-azure-portal-1.png"::: |
-| [!INCLUDE [Assign managed identity to role step 2](<../includes/assign-managed-identity-to-role-azure-portal-2.md>)] | :::image type="content" source="../media/assign-managed-identity-to-role-azure-portal-2-240px.png" alt-text="A screenshot showing the location of the Access control (IAM) menu item in the left-hand menu of an Azure resource group." lightbox="../media/assign-managed-identity-to-role-azure-portal-2.png"::: |
-| [!INCLUDE [Assign managed identity to role step 3](<../includes/assign-managed-identity-to-role-azure-portal-3.md>)] | :::image type="content" source="../media/assign-managed-identity-to-role-azure-portal-3-240px.png" alt-text="A screenshot showing how to navigate to the role assignments tab and the location of the button used to add role assignments to a resource group." lightbox="../media/assign-managed-identity-to-role-azure-portal-3.png"::: |
-| [!INCLUDE [Assign managed identity to role step 4](<../includes/assign-managed-identity-to-role-azure-portal-4.md>)] | :::image type="content" source="../media/assign-managed-identity-to-role-azure-portal-4-240px.png" alt-text="A screenshot showing how to filter and select role assignments to be added to the resource group." lightbox="../media/assign-managed-identity-to-role-azure-portal-4.png"::: |
-| [!INCLUDE [Assign managed identity to role step 5](<../includes/assign-managed-identity-to-role-azure-portal-5.md>)] | :::image type="content" source="../media/assign-managed-identity-to-role-azure-portal-5-240px.png" alt-text="A screenshot showing how to select managed identity as the type of user you want to assign the role (permission) on the add role assignments page." lightbox="../media/assign-managed-identity-to-role-azure-portal-5.png"::: |
-| [!INCLUDE [Assign managed identity to role step 6](<../includes/assign-managed-identity-to-role-azure-portal-6.md>)] | :::image type="content" source="../media/assign-managed-identity-to-role-azure-portal-6-240px.png" alt-text="A screenshot showing how to use the select managed identities dialog to filter and select the managed identity to assign the role to." lightbox="../media/assign-managed-identity-to-role-azure-portal-6.png"::: |
-| [!INCLUDE [Assign managed identity to role step 7](<../includes/assign-managed-identity-to-role-azure-portal-7.md>)] | :::image type="content" source="../media/assign-managed-identity-to-role-azure-portal-7-240px.png" alt-text="A screenshot of the final add role assignment screen where a user needs to select the Review + Assign button to finalize the role assignment." lightbox="../media/assign-managed-identity-to-role-azure-portal-7.png"::: |
+1. Navigate to the **Overview** page of the resource group that contains the app with the system-assigned managed identity.
+1. Select **Access control (IAM)** on the left navigation.
+1. On the **Access control (IAM)** page, select **+ Add** on the top menu and then choose **Add role assignment** to navigate to the **Add role assignment** page.
+
+ :::image type="content" source="../media/system-assigned-identity-access-control.png" alt-text="A screenshot showing how to access the identity role assignment page.":::
+
+1. The **Add role assignment** page presents a tabbed, multi-step workflow to assign roles to identities. On the initial **Role** tab, use the search box at the top to locate the role you want to assign to the identity.
+1. Select the role from the results and then choose **Next** to move to the **Members** tab.
+1. For the **Assign access to** option, select **Managed identity**.
+1. For the **Members** option, choose **+ Select members** to open the **Select managed identities** panel.
+1. On the **Select managed identities** panel, use the **Subscription** and **Managed identity** dropdowns to filter the search results for your identities. Use the **Select** search box to locate the system-identity you enabled for the Azure resource hosting your app.
+
+ :::image type="content" source="../media/system-assigned-identity-assign-roles.png" alt-text="A screenshot showing the managed identity assignment process.":::
+
+1. Select the identity and choose **Select** at the bottom of the panel to continue.
+1. Select **Review + assign** at the bottom of the page.
+1. On the final **Review + assign** tab, select **Review + assign** to complete the workflow.
### [Azure CLI](#tab/azure-cli)
@@ -106,6 +140,6 @@ For information on assigning permissions at the resource or subscription level u
---
-## 3 - Implement DefaultAzureCredential in your application
+## Implement DefaultAzureCredential in your application
[!INCLUDE [Implement DefaultAzureCredential](<../includes/implement-defaultazurecredential.md>)]
diff --git a/docs/azure/sdk/authentication/index.md b/docs/azure/sdk/authentication/index.md
index 3c62834dadf98..5c906957d3ab4 100644
--- a/docs/azure/sdk/authentication/index.md
+++ b/docs/azure/sdk/authentication/index.md
@@ -6,7 +6,7 @@ ms.custom: devx-track-dotnet, engagement-fy23
ms.date: 08/02/2024
---
-# How to authenticate .NET apps to Azure services using the Azure Identity library
+# Authenticate .NET apps to Azure services using the Azure Identity library overview
When an app needs to access an Azure resource, the app must be authenticated to Azure. This is true for all apps, whether deployed to Azure, deployed on-premises, or under development on a local developer workstation. This article describes the recommended approaches to authenticate an app to Azure when using the Azure SDK client libraries.
diff --git a/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-1.md b/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-1.md
deleted file mode 100644
index e1624fba768b3..0000000000000
--- a/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-1.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-ms.topic: include
-ms.date: 08/05/2024
----
-Locate the resource group for your app by searching for the resource group name using the search box at the top of the Azure portal.
-
-Navigate to your resource group by selecting the resource group name under the **Resource Groups** heading in the dialog box.
diff --git a/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-2.md b/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-2.md
deleted file mode 100644
index 985e8728a6d1f..0000000000000
--- a/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-2.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-ms.topic: include
-ms.date: 08/05/2024
----
-On the page for the resource group, select **Access control (IAM)** from the left-hand menu.
diff --git a/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-3.md b/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-3.md
deleted file mode 100644
index 11ea4bd587fac..0000000000000
--- a/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-3.md
+++ /dev/null
@@ -1,8 +0,0 @@
----
-ms.topic: include
-ms.date: 08/05/2024
----
-On the **Access control (IAM)** page:
-
-1. Select the **Role assignments** tab.
-1. Select **+ Add** from the top menu and then **Add role assignment** from the resulting drop-down menu.
diff --git a/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-4.md b/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-4.md
deleted file mode 100644
index 42e1053ccaf80..0000000000000
--- a/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-4.md
+++ /dev/null
@@ -1,10 +0,0 @@
----
-ms.topic: include
-ms.date: 08/05/2024
----
-The **Add role assignment** page lists all of the roles that can be assigned for the resource group.
-
-1. Use the search box to filter the list to a more manageable size. This example shows how to filter for Storage Blob roles.
-1. Select the role that you want to assign.
-
-Select **Next** to go to the next screen.
diff --git a/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-5.md b/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-5.md
deleted file mode 100644
index c852352372f0a..0000000000000
--- a/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-5.md
+++ /dev/null
@@ -1,10 +0,0 @@
----
-ms.topic: include
-ms.date: 08/05/2024
----
-The next **Add role assignment** page allows you to specify what user to assign the role to.
-
-1. Select **Managed identity** under **Assign access to**.
-1. Select **+ Select members** under **Members**.
-
-A dialog box will open on the right-hand side of the Azure portal.
diff --git a/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-6.md b/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-6.md
deleted file mode 100644
index 323a0e7742ce6..0000000000000
--- a/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-6.md
+++ /dev/null
@@ -1,10 +0,0 @@
----
-ms.topic: include
-ms.date: 08/05/2024
----
-In the **Select managed identities** dialog:
-
-1. The **Managed identity** dropdown and **Select** text box can be used to filter the list of managed identities in your subscription. In this example, by selecting **App Service**, only managed identities associated with an App Service are displayed.
-1. Select the managed identity for the Azure resource hosting your app.
-
-Select **Select** at the bottom of the dialog to continue.
diff --git a/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-7.md b/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-7.md
deleted file mode 100644
index daf1585f2a026..0000000000000
--- a/docs/azure/sdk/includes/assign-managed-identity-to-role-azure-portal-7.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-ms.topic: include
-ms.date: 08/05/2024
----
-The managed identity will now show as selected on the **Add role assignment** screen.
-
-Select **Review + assign** to go to the final page and then **Review + assign** again to complete the process.
diff --git a/docs/azure/sdk/includes/enable-managed-identity-azure-cli.md b/docs/azure/sdk/includes/enable-managed-identity-azure-cli.md
deleted file mode 100644
index 499a6f56a8c76..0000000000000
--- a/docs/azure/sdk/includes/enable-managed-identity-azure-cli.md
+++ /dev/null
@@ -1,22 +0,0 @@
----
-ms.topic: include
-ms.date: 07/31/2024
-ms.custom: devx-track-azurecli
----
-#### [Azure App Service](#tab/azure-app-service)
-
-```azurecli
-az webapp identity assign \
- --resource-group \
- --name
-```
-
-#### [Azure Virtual Machines](#tab/azure-virtual-machines)
-
-```azurecli
-az vm identity assign \
- --resource-group \
- --name
-```
-
----
diff --git a/docs/azure/sdk/includes/enable-managed-identity-azure-portal-1.md b/docs/azure/sdk/includes/enable-managed-identity-azure-portal-1.md
deleted file mode 100644
index 386d24bd2dc1b..0000000000000
--- a/docs/azure/sdk/includes/enable-managed-identity-azure-portal-1.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-ms.topic: include
-ms.date: 07/31/2024
----
-Navigate to the resource that hosts your application code in the Azure portal.
-
-For example, you can type the name of your resource in the search box at the top of the page and navigate to it by selecting it in the dialog box.
diff --git a/docs/azure/sdk/includes/enable-managed-identity-azure-portal-2.md b/docs/azure/sdk/includes/enable-managed-identity-azure-portal-2.md
deleted file mode 100644
index 9ecfb55203cd6..0000000000000
--- a/docs/azure/sdk/includes/enable-managed-identity-azure-portal-2.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-ms.topic: include
-ms.date: 07/31/2024
----
-On the page for your resource, select the **Identity** menu item from the left-hand menu.
-
-All Azure resources capable of supporting managed identity will have an **Identity** menu item even though the layout of the menu may vary slightly.
diff --git a/docs/azure/sdk/includes/enable-managed-identity-azure-portal-3.md b/docs/azure/sdk/includes/enable-managed-identity-azure-portal-3.md
deleted file mode 100644
index 5276e6a4ab194..0000000000000
--- a/docs/azure/sdk/includes/enable-managed-identity-azure-portal-3.md
+++ /dev/null
@@ -1,10 +0,0 @@
----
-ms.topic: include
-ms.date: 07/31/2024
----
-On the **Identity** page:
-
-1. Change the **Status** slider to **On**.
-1. Select **Save**.
-
-A confirmation dialog will verify you want to enable managed identity for your service. Answer **Yes** and managed identity will be enabled for the Azure resource.
diff --git a/docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-1-240px.png b/docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-1-240px.png
deleted file mode 100644
index a8d30d5a18d6b4ccf27ed3d0a10a1af6c2b6aa61..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 7911
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
yoaO5IpR1Sa_`WtK3eI7y?05}d|q|`e{KcDaO
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
PkC2yDmdU$o=>7iyR{$ui
diff --git a/docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-2-240px.png b/docs/azure/sdk/media/assign-managed-identity-to-role-azure-portal-2-240px.png
deleted file mode 100644
index b671688cb34dbad4691a38e0951c224009a811b8..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 11498
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"aLe)#BBl-$ygF&~9iDf!P{_(a~_ARVz(S
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