Skip to content

Commit dba9560

Browse files
Covering EnvironmentCredential env vars
1 parent d12b324 commit dba9560

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

articles/azure-functions/functions-reference.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -163,12 +163,12 @@ For example, the `connection` property for an Azure Blob trigger definition migh
163163
164164
### Configure an identity-based connection
165165

166-
Some connections in Azure Functions can be configured to use an identity instead of a secret. Support depends on the extension using the connection. In some cases, a connection string may still be required in Functions even though the service to which you're connecting supports identity-based connections. For a tutorial on configuring your function apps with managed identities, see the [creating a function app with identity-based connections tutorial](./functions-identity-based-connections-tutorial.md).
167-
166+
Some connections in Azure Functions can be configured to use an identity instead of a secret. Support depends on the runtime version and the extension using the connection. In some cases, a connection string may still be required in Functions even though the service to which you're connecting supports identity-based connections. For a tutorial on configuring your function apps with managed identities, see the [creating a function app with identity-based connections tutorial](./functions-identity-based-connections-tutorial.md).
168167

169168
> [!NOTE]
170169
> When running in a Consumption or Elastic Premium plan, your app uses the [`WEBSITE_AZUREFILESCONNECTIONSTRING`](functions-app-settings.md#website_contentazurefileconnectionstring) and [`WEBSITE_CONTENTSHARE`](functions-app-settings.md#website_contentshare) settings when connecting to Azure Files on the storage account used by your function app. Azure Files doesn't support using managed identity when accessing the file share. For more information, see [Azure Files supported authentication scenarios](../storage/files/storage-files-active-directory-overview.md#supported-authentication-scenarios)
171170
171+
Identity-based connections are only supported on Functions 4.x, If you are using version 1.x, you must first [migrate to version 4.x](./migrate-version-1-version-4.md).
172172

173173
The following components support identity-based connections:
174174

@@ -255,6 +255,15 @@ An identity-based connection for an Azure service accepts the following common p
255255

256256
Other options may be supported for a given connection type. Refer to the documentation for the component making the connection.
257257

258+
##### Azure SDK Environment Variables
259+
260+
> [!CAUTION]
261+
> Use of the Azure SDK's [`EnvironmentCredential`][environment-credential] environment variables is not recommended due to the potentially unintentional impact on other connections. They also are not fully supported when deployed to Azure Functions.
262+
263+
The environment variables associated with the Azure SDK's [`EnvironmentCredential`][environment-credential] can also be set, but these are not processed by the Functions service for scaling in Consumption plans. These environment variables are not specific to any one connection and will apply as a default unless a corresponding property is not set for a given connection. For example, if `AZURE_CLIENT_ID` is set, this would be used as if `<CONNECTION_NAME_PREFIX>__clientId` had been configured. Explicitly setting `<CONNECTION_NAME_PREFIX>__clientId` would override this default.
264+
265+
[environment-credential]: /dotnet/api/azure.identity.environmentcredential
266+
258267
##### Local development with identity-based connections
259268

260269
> [!NOTE]

0 commit comments

Comments
 (0)