View a markdown version of this page

Créez un connecteur C2C (Cloud-to-Cloud) - Intégrations gérées pour AWS IoT Device Management
Conditions préalablesAutorisations requisesExigences relatives aux connecteurs C2C

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Créez un connecteur C2C (Cloud-to-Cloud)

Les sections suivantes décrivent les étapes à suivre pour créer un connecteur C2C (Cloud-to-Cloud) pour les intégrations gérées pour AWS IoT Device Management.

Rubriques

Conditions préalables

Avant de créer un connecteur C2C (Cloud-to-Cloud), vous devez disposer des éléments suivants :

  • Et Compte AWS pour héberger votre connecteur C2C et l'enregistrer via des intégrations gérées. Pour plus d'informations, voir Créer un Compte AWS.

  • Lorsque vous créez votre connecteur, vous avez besoin de certaines autorisations IAM (voir la section Autorisations requises ci-dessous).

  • Déterminez le type d'autorisation que votre connecteur prendra en charge. Managed Integrations prend en charge l'autorisation OAuth 2.0 et l'autorisation générale.

    Pour les connecteurs OAuth 2.0 :

    Si votre connecteur est compatible avec OAuth 2.0, son développeur doit disposer des éléments suivants :

    • ID client provenant du cloud tiers à associer à votre connecteur C2C

    • Secret client provenant du cloud tiers à associer à votre connecteur C2C

    • URL d'autorisation OAuth 2.0

    • URL du jeton OAuth 2.0

    Pour les connecteurs d'autorisation personnalisés (également appelés connecteurs General/Custom d'autorisation) :

    Si votre connecteur prend en charge un mécanisme d'autorisation non basé sur OAuth, nous l'appelons connecteur d'autorisation général et l'utilisateur du connecteur devra conserver les informations d'identification pour ce schéma d'autorisation dans. AWS Secrets Manager Les informations d'identification pour ce schéma d'autorisation non OAuth peuvent être des jetons, des clés d'API ou d'autres informations d'identification, qui devraient être conservées. AWS Secrets Manager

  • Third-Party Exigences relatives à l'API :

    • Matériel d'autorisation spécifique au schéma d'autorisation qui pourrait être une API Keys/tokens (pour OAuth)

    • Toute liste d'autorisations pour l'URL de rappel OAuth hébergée par AWS

    Note

    Certains tiers autorisent explicitement une URL de redirection OAuth, tandis que d'autres disposent d'un flux de travail dans lequel les utilisateurs peuvent se connecter et enregistrer l'URL OAuth. Consultez le tiers concerné pour comprendre ce qui est requis pour autoriser le point de terminaison de redirection OAuth des intégrations gérées.

Autorisations requises

Lorsque vous créez votre connecteur, vous avez besoin de certaines autorisations IAM. Outre les iotmanagedintegrations: autorisations pour les actions, vous avez besoin des autorisations suivantes :

API-Specific Autorisations
Autorisations générales et autorisations

Si votre connecteur prend en charge l'autorisation générale, le rôle d'exécution Lambda de votre connecteur doit également avoir :

  • secretsmanager:GetSecretValue

  • kms:Decrypt

Ces autorisations sont nécessaires pour récupérer les informations d'identification du client AWS Secrets Manager. Pour de plus amples informations, veuillez consulter Autorisations Lambda pour GeneralAuthorization.

Ressources supplémentaires

Pour plus d'informations sur iotmanagedintegrations: les autorisations et les actions, consultez la section Actions définies par les intégrations AWS gérées.

Exigences relatives aux connecteurs C2C

Le connecteur C2C que vous développez facilite la communication bidirectionnelle entre les intégrations gérées pour AWS IoT Device Management et le cloud d'un fournisseur tiers. Le connecteur doit implémenter des interfaces pour les intégrations gérées pour AWS IoT Device Management afin d'effectuer des actions pour le compte des utilisateurs finaux.

Ces interfaces fournissent les fonctionnalités nécessaires pour :

  • Découvrez les appareils des utilisateurs finaux

  • Lancer des commandes d'appareil envoyées depuis des intégrations gérées pour AWS IoT Device Management

  • Identifier les utilisateurs

Pour prendre en charge le fonctionnement de l'appareil, le connecteur doit gérer la traduction des messages de demande et de réponse entre les intégrations gérées pour AWS IoT Device Management et la plateforme tierce associée.

Exigences de base

Les exigences relatives au connecteur C2C sont les suivantes :

  1. Conformité à OAuth 2.0 (le cas échéant)

    Si votre connecteur prend en charge OAuth 2.0, le serveur d'autorisation tiers doit être conforme aux normes OAuth 2.0 ainsi qu'aux configurations répertoriées dans. Exigences de configuration OAuth

  2. Conformité au modèle de données Matter

    Un connecteur C2C sera nécessaire pour interpréter les identifiants des AWS implémentations du modèle de données de matière et doit émettre les réponses et les événements conformes aux AWS implémentations du modèle de données de matière. Pour de plus amples informations, veuillez consulter AWS mise en œuvre du modèle de données Matter.

  3. Authentification SIGv4

    Un connecteur C2C doit être capable d'appeler les intégrations gérées pour les API AWS IoT Device Management avec SigV4 authentification. Pour les événements asynchrones envoyés SendConnectorEvent via l'API, les mêmes Compte AWS informations d'identification que celles utilisées pour enregistrer le connecteur doivent être utilisées pour signer la demande associée SendConnectorEvent .

  4. Opérations requises

    Le connecteur doit implémenter les quatre opérations suivantes :

  5. Transfert d'événements

    Lorsque votre connecteur C2C reçoit des événements tiers liés aux réponses aux commandes de l'appareil ou à la découverte d'un appareil, il doit les transmettre à Managed Integrations with the SendConnectorEvent API. Pour plus d'informations sur ces événements et l'SendConnectorEventAPI, consultez SendConnectorEvent.

Note

L'SendConnectorEventAPI fait partie du SDK d'intégrations gérées et est utilisée à la place de la création et de la signature manuelles des demandes.