Skip to content

Commit eff5b23

Browse files
authored
Merge pull request #192045 from kgremban/mar17-protocolgateway
Add redirect note and NOINDEX protocol gateway; remove links to article
2 parents ab9fd00 + 289deb2 commit eff5b23

File tree

4 files changed

+11
-20
lines changed

4 files changed

+11
-20
lines changed

articles/iot-hub/iot-hub-amqp-support.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -370,5 +370,5 @@ To learn more about the AMQP Protocol, see the [AMQP v1.0 specification](https:/
370370
To learn more about IoT Hub messaging, see:
371371

372372
* [Cloud-to-device messages](./iot-hub-devguide-messages-c2d.md)
373-
* [Support for additional protocols](iot-hub-protocol-gateway.md)
373+
* [Support for additional protocols](../iot-edge/iot-edge-as-gateway.md)
374374
* [Support for the Message Queuing Telemetry Transport (MQTT) Protocol](./iot-hub-mqtt-support.md)

articles/iot-hub/iot-hub-dev-guide-sas.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -382,8 +382,7 @@ For a device/module to connect to your hub, you must still add it to the IoT Hub
382382

383383
### Comparison with a custom gateway
384384

385-
The token service pattern is the recommended way to implement a custom identity registry/authentication scheme with IoT Hub. This pattern is recommended because IoT Hub continues to handle most of the solution traffic. However, if the custom authentication scheme is so intertwined with the protocol, you may require a *custom gateway* to process all the traffic. An example of such a scenario is using [Transport Layer Security (TLS) and pre-shared keys (PSKs)](https://tools.ietf.org/html/rfc4279). For more information, see the [protocol gateway](iot-hub-protocol-gateway.md) article.
386-
385+
The token service pattern is the recommended way to implement a custom identity registry/authentication scheme with IoT Hub. This pattern is recommended because IoT Hub continues to handle most of the solution traffic. However, if the custom authentication scheme is so intertwined with the protocol, you may require a *custom gateway* to process all the traffic. An example of such a scenario is using [Transport Layer Security (TLS) and pre-shared keys (PSKs)](https://tools.ietf.org/html/rfc4279). For more information, see [How an IoT Edge device can be used as a gateway](../iot-edge/iot-edge-as-gateway.md).
387386

388387
## Additional reference material
389388

articles/iot-hub/iot-hub-mqtt-support.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -431,18 +431,14 @@ To respond, the device sends a message with a valid JSON or empty body to the to
431431

432432
For more information, see the [Direct method developer's guide](iot-hub-devguide-direct-methods.md).
433433

434-
## Additional considerations
435-
436-
As a final consideration, if you need to customize the MQTT protocol behavior on the cloud side, you should review the [Azure IoT protocol gateway](iot-hub-protocol-gateway.md). This software enables you to deploy a high-performance custom protocol gateway that interfaces directly with IoT Hub. The Azure IoT protocol gateway enables you to customize the device protocol to accommodate brownfield MQTT deployments or other custom protocols. This approach does require, however, that you run and operate a custom protocol gateway.
437-
438434
## Next steps
439435

440436
To learn more about the MQTT protocol, see the [MQTT documentation](https://mqtt.org/).
441437

442438
To learn more about planning your IoT Hub deployment, see:
443439

444440
* [Azure Certified for IoT device catalog](https://devicecatalog.azure.com/)
445-
* [Support additional protocols](iot-hub-protocol-gateway.md)
441+
* [Support additional protocols](../iot-edge/iot-edge-as-gateway.md)
446442
* [Compare with Event Hubs](iot-hub-compare-event-hubs.md)
447443
* [Scaling, HA, and DR](iot-hub-scaling.md)
448444

articles/iot-hub/iot-hub-protocol-gateway.md

Lines changed: 8 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -7,14 +7,20 @@ ms.author: kgremban
77
ms.service: iot-hub
88
services: iot-hub
99
ms.topic: conceptual
10-
ms.date: 08/19/2021
10+
ms.date: 03/17/2022
1111
ms.custom: [amqp, mqtt, 'Role: Cloud Development', 'Role: IoT Device']
12+
ROBOTS: NOINDEX
1213
---
1314

1415
# Support additional protocols for IoT Hub
1516

1617
Azure IoT Hub natively supports communication over the MQTT, AMQP, and HTTPS protocols. In some cases, devices or field gateways might not be able to use one of these standard protocols and require protocol adaptation. In such cases, you can use a custom gateway. A custom gateway enables protocol adaptation for IoT Hub endpoints by bridging the traffic to and from IoT Hub. You can use the [Azure IoT protocol gateway](https://github.com/Azure/azure-iot-protocol-gateway/blob/master/README.md) as a custom gateway to enable protocol adaptation for IoT Hub.
1718

19+
>[!NOTE]
20+
>The Azure IoT protocol gateway is no longer the recommended method for protocol adaptation. Instead, consider using Azure IoT Edge as a gateway.
21+
>
22+
>For more information, see [How an IoT Edge device can be used as a gateway](../iot-edge/iot-edge-as-gateway.md).
23+
1824
## Azure IoT protocol gateway
1925

2026
The Azure IoT protocol gateway is a framework for protocol adaptation that is designed for high-scale, bidirectional device communication with IoT Hub. The protocol gateway is a pass-through component that accepts device connections over a specific protocol. It bridges the traffic to IoT Hub over AMQP 1.0.
@@ -31,14 +37,4 @@ For flexibility, the Azure IoT protocol gateway and MQTT implementation are prov
3137

3238
To learn more about the Azure IoT protocol gateway and how to use and deploy it as part of your IoT solution, see:
3339

34-
* [Azure IoT protocol gateway repository on GitHub](https://github.com/Azure/azure-iot-protocol-gateway/blob/master/README.md)
35-
36-
* [Azure IoT protocol gateway developer guide](https://github.com/Azure/azure-iot-protocol-gateway/blob/master/docs/DeveloperGuide.md)
37-
38-
To learn more about planning your IoT Hub deployment, see:
39-
40-
* [Compare with Event Hubs](iot-hub-compare-event-hubs.md)
41-
42-
* [Scaling, high availability, and disaster recovery](iot-hub-scaling.md)
43-
44-
* [IoT Hub developer guide](iot-hub-devguide.md)
40+
* [Azure IoT protocol gateway repository on GitHub](https://github.com/Azure/azure-iot-protocol-gateway/blob/master/README.md)

0 commit comments

Comments
 (0)