|
1 | 1 | ---
|
2 | 2 | title: Hybrid connections in Azure App Service
|
3 | 3 | description: Learn how to create and use hybrid connections in Azure App Service to access resources in disparate networks.
|
4 |
| -author: madsd |
| 4 | +author: seligj95 |
5 | 5 | ms.assetid: 66774bde-13f5-45d0-9a70-4e9536a4f619
|
6 | 6 | ms.topic: article
|
7 |
| -ms.date: 05/06/2025 |
8 |
| -ms.author: madsd |
| 7 | +ms.date: 06/04/2025 |
| 8 | +ms.author: jordanselig |
9 | 9 | ms.custom:
|
10 | 10 | - "UpdateFrequency3, fasttrack-edit"
|
11 | 11 | - build-2025
|
@@ -56,7 +56,7 @@ Things you can't do with Hybrid Connections include:
|
56 | 56 |
|
57 | 57 | ## Add and Create Hybrid Connections in your app
|
58 | 58 |
|
59 |
| -To create a Hybrid Connection: |
| 59 | +To create a Hybrid Connection in the Azure portal: |
60 | 60 |
|
61 | 61 | 1. In the [Azure portal], select your app. Select **Settings** > **Networking**.
|
62 | 62 | 1. Next to **Hybrid connections**, select the **Not configured** link. Here you can see the Hybrid Connections that are configured for your app.
|
@@ -84,6 +84,23 @@ When a Hybrid Connection is added to your app, you can see details on it simply
|
84 | 84 |
|
85 | 85 | :::image type="content" source="media/app-service-hybrid-connections/hybrid-connections-properties.png" alt-text="Screenshot of Hybrid connections details.":::
|
86 | 86 |
|
| 87 | +### Create a Hybrid Connection in ARM/Bicep |
| 88 | + |
| 89 | +To create a Hybrid Connection using an ARM/Bicep template, add the following resource to your existing template. You must include the `userMetadata` to have a valid Hybrid Connection. If you don't include the `userMetadata`, the Hybrid Connection doesn't work. If you create the Hybrid Connection in the Azure portal, this property is automatically filled in for you. |
| 90 | + |
| 91 | +The `userMetadata` property should be a string representation of a JSON array in the format `[{"key": "endpoint", "value : "host:port"}]`. The following Bicep template has a sample for this property. For more information, see [Microsoft.Relay namespaces/hybridConnections](./azure/templates/microsoft.relay/namespaces/hybridconnections). |
| 92 | + |
| 93 | +```bicep |
| 94 | +resource hybridConnection 'Microsoft.Relay/namespaces/hybridConnections@2024-01-01' = { |
| 95 | + parent: relayNamespace |
| 96 | + name: hybridConnectionName |
| 97 | + properties: { |
| 98 | + requiresClientAuthorization: true |
| 99 | + userMetadata: '[{"key": "endpoint", "value : "<HOST>:<PORT>"}]' |
| 100 | + } |
| 101 | +} |
| 102 | +``` |
| 103 | + |
87 | 104 | ### Create a Hybrid Connection in the Azure Relay portal
|
88 | 105 |
|
89 | 106 | In addition to the portal experience from within your app, you can create Hybrid Connections from within the Azure Relay portal. For a Hybrid Connection to be used by App Service, it must:
|
|
0 commit comments