Skip to content

Commit 978e09f

Browse files
Merge pull request #229055 from Y-Sindo/patch-2
Add SignalR Service to the service list that supports identity-based connection
2 parents d411514 + 3c60791 commit 978e09f

File tree

1 file changed

+10
-6
lines changed

1 file changed

+10
-6
lines changed

articles/azure-functions/functions-reference.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Guidance for developing Azure Functions
2+
title: Guidance for developing Azure Functions
33
description: Learn the Azure Functions concepts and techniques that you need to develop functions in Azure, across all programming languages and bindings.
44
ms.assetid: d8efe41a-bef8-4167-ba97-f3e016fcd39e
55
ms.topic: conceptual
@@ -43,7 +43,7 @@ The `bindings` property is where you configure both triggers and bindings. Each
4343
| name | Function identifier.<br><br>For example, `myQueue`. | string | The name that is used for the bound data in the function. For C#, this is an argument name; for JavaScript, it's the key in a key/value list. |
4444

4545
## Function app
46-
A function app provides an execution context in Azure in which your functions run. As such, it is the unit of deployment and management for your functions. A function app is comprised of one or more individual functions that are managed, deployed, and scaled together. All of the functions in a function app share the same pricing plan, deployment method, and runtime version. Think of a function app as a way to organize and collectively manage your functions. To learn more, see [How to manage a function app](functions-how-to-use-azure-function-app-settings.md).
46+
A function app provides an execution context in Azure in which your functions run. As such, it is the unit of deployment and management for your functions. A function app is comprised of one or more individual functions that are managed, deployed, and scaled together. All of the functions in a function app share the same pricing plan, deployment method, and runtime version. Think of a function app as a way to organize and collectively manage your functions. To learn more, see [How to manage a function app](functions-how-to-use-azure-function-app-settings.md).
4747

4848
> [!NOTE]
4949
> All functions in a function app must be authored in the same language. In [previous versions](functions-versions.md) of the Azure Functions runtime, this wasn't required.
@@ -105,7 +105,7 @@ For example, the `connection` property for an Azure Blob trigger definition migh
105105

106106
> [!NOTE]
107107
> When using [Azure App Configuration](../azure-app-configuration/quickstart-azure-functions-csharp.md) or [Key Vault](../key-vault/general/overview.md) to provide settings for Managed Identity connections, setting names should use a valid key separator such as `:` or `/` in place of the `__` to ensure names are resolved correctly.
108-
>
108+
>
109109
> For example, `Storage1:blobServiceUri`.
110110
111111
### Configure an identity-based connection
@@ -122,7 +122,8 @@ Identity-based connections are supported by the following components:
122122
| Azure Event Hubs triggers and bindings | All | [Azure Event Hubs extension version 5.0.0 or later][eventhubv5],<br/>[Extension bundle 3.3.0 or later][eventhubv5] |
123123
| Azure Service Bus triggers and bindings | All | [Azure Service Bus extension version 5.0.0 or later][servicebusv5],<br/>[Extension bundle 3.3.0 or later][servicebusv5] |
124124
| Azure Cosmos DB triggers and bindings | All | [Azure Cosmos DB extension version 4.0.0 or later][cosmosv4],<br/> [Extension bundle 4.0.2 or later][cosmosv4]|
125-
| Durable Functions storage provider (Azure Storage) | All | [Durable Functions extension version 2.7.0 or later][durable-identity],<br/>[Extension bundle 3.3.0 or later][durable-identity] |
125+
| Azure SignalR triggers and bindings | All | [Azure SignalR extension version 1.7.0 or later][signalr] <br/>[Extension bundle 3.6.1 or later][signalr] |
126+
| Durable Functions storage provider (Azure Storage) | All | [Durable Functions extension version 2.7.0 or later][durable-identity],<br/>[Extension bundle 3.3.0 or later][durable-identity] |
126127
| Host-required storage ("AzureWebJobsStorage") - Preview | All | [Connecting to host storage with an identity](#connecting-to-host-storage-with-an-identity-preview) |
127128

128129
[blobv5]: ./functions-bindings-storage-blob.md#install-extension
@@ -131,6 +132,7 @@ Identity-based connections are supported by the following components:
131132
[servicebusv5]: ./functions-bindings-service-bus.md
132133
[cosmosv4]: ./functions-bindings-cosmosdb-v2.md?tabs=extensionv4
133134
[tablesv1]: ./functions-bindings-storage-table.md#table-api-extension
135+
[signalr]: ./functions-bindings-signalr-service.md#install-extension
134136
[durable-identity]: ./durable/durable-functions-configure-durable-functions-with-credentials.md
135137

136138
[!INCLUDE [functions-identity-based-connections-configuration](../../includes/functions-identity-based-connections-configuration.md)]
@@ -161,6 +163,8 @@ Choose a tab below to learn about permissions for each component:
161163

162164
[!INCLUDE [functions-cosmos-permissions](../../includes/functions-cosmos-permissions.md)]
163165

166+
# [Azure SignalR extension](#tab/signalr)
167+
You'll need to create a role assignment that provides access to Azure SignalR Service data plane REST APIs. We recommend you to use the built-in role [SignalR Service Owner](../role-based-access-control/built-in-roles.md#signalr-service-owner). Management roles like [Owner](../role-based-access-control/built-in-roles.md#owner) aren't sufficient.
164168

165169
# [Durable Functions storage provider (preview)](#tab/durable)
166170

@@ -186,7 +190,7 @@ Additional options may be supported for a given connection type. Please refer to
186190
##### Local development with identity-based connections
187191

188192
> [!NOTE]
189-
> Local development with identity-based connections requires updated versions of the [Azure Functions Core Tools](./functions-run-local.md). You can check your currently installed version by running `func -v`. For Functions v3, use version `3.0.3904` or later. For Functions v4, use version `4.0.3904` or later.
193+
> Local development with identity-based connections requires updated versions of the [Azure Functions Core Tools](./functions-run-local.md). You can check your currently installed version by running `func -v`. For Functions v3, use version `3.0.3904` or later. For Functions v4, use version `4.0.3904` or later.
190194
191195
When running locally, the above configuration tells the runtime to use your local developer identity. The connection will attempt to get a token from the following locations, in order:
192196

@@ -207,7 +211,7 @@ In some cases, you may wish to specify use of a different identity. You can add
207211
| Client ID | `<CONNECTION_NAME_PREFIX>__clientId` | The client (application) ID of an app registration in the tenant. |
208212
| Client secret | `<CONNECTION_NAME_PREFIX>__clientSecret` | A client secret that was generated for the app registration. |
209213

210-
Here is an example of `local.settings.json` properties required for identity-based connection to Azure Blobs:
214+
Here is an example of `local.settings.json` properties required for identity-based connection to Azure Blobs:
211215

212216
```json
213217
{

0 commit comments

Comments
 (0)