View a markdown version of this page

C2C (Cloud-to-Cloud) コネクタを構築する - のマネージド統合 AWS IoT Device Management
前提条件必要なアクセス許可C2C コネクタの要件

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

C2C (Cloud-to-Cloud) コネクタを構築する

以下のセクションでは、AWS IoT Device Management のマネージド統合用の C2C (Cloud-to-Cloud) コネクタを構築する手順について説明します。

トピック

前提条件

C2C (Cloud-to-Cloud) コネクタを作成する前に、以下が必要です。

  • C2C コネクタを AWS アカウント ホストし、マネージド統合を通じて登録するための 。詳細については、「 の作成 AWS アカウント」を参照してください。

  • コネクタを構築するときは、特定の IAM アクセス許可が必要です (以下の「必要なアクセス許可」セクションを参照）。

  • コネクタがサポートする認可タイプを決定します。マネージド統合は、OAuth 2.0 認可と一般認可をサポートしています。

    OAuth 2.0 コネクタの場合:

    コネクタが OAuth 2.0 をサポートする場合、コネクタの開発者には以下が必要です。

    • C2C コネクタに関連付けるサードパーティークラウドからのクライアント ID

    • C2C コネクタに関連付けるサードパーティークラウドからのクライアントシークレット

    • OAuth 2.0 認可 URL

    • OAuth 2.0 トークン URL

    カスタム認可コネクタ (一般/カスタム認可コネクタとも呼ばれます) の場合:

    コネクタが非 OAuth ベースの認可メカニズムをサポートしている場合は、一般認可コネクタと呼ばれ、コネクタユーザーはこの認可スキームの認証情報を保持する必要があります AWS Secrets Manager。この非 OAuth 認可スキームの認証情報は、トークン、API キー、またはその他の認証情報であり、保持されることが想定されます AWS Secrets Manager。

  • サードパーティー API の要件:

    • API キー/トークン (OAuth 用) である可能性のある認可スキームに固有の認可マテリアル

    • によってホストされる OAuth コールバック URL の許可リスト AWS

    注記

    OAuth リダイレクト URL を明示的に許可リストに登録するサードパーティーもあれば、ユーザーがログインして OAuth URL を登録できるワークフローを持つサードパーティーもあります。マネージド統合 OAuth リダイレクトエンドポイントを許可リストに登録するために必要なものについては、特定のサードパーティーにお問い合わせください。

必要なアクセス許可

コネクタを構築するときは、特定の IAM アクセス許可が必要です。アクションのiotmanagedintegrations:アクセス許可に加えて、次のアクセス許可が必要です。

API 固有のアクセス許可
一般的な認可のアクセス許可

コネクタが一般認可をサポートしている場合、コネクタ Lambda 実行ロールには以下も必要です。

  • secretsmanager:GetSecretValue

  • kms:Decrypt

これらのアクセス許可は、顧客から認証情報を取得するために必要です AWS Secrets Manager。詳細については、「GeneralAuthorization の Lambda アクセス許可」を参照してください。

その他のリソース

アクセスiotmanagedintegrations:許可とアクションの詳細については、AWS 「 Managed Integrations で定義されるアクション」を参照してください。

C2C コネクタの要件

開発する C2C コネクタは、AWS IoT Device Management のマネージド統合とサードパーティーベンダークラウド間の双方向通信を容易にします。コネクタは、エンドユーザーに代わってアクションを実行するために、AWS IoT Device Management のマネージド統合用のインターフェイスを実装する必要があります。

これらのインターフェイスは、以下の機能を提供します。

  • エンドユーザーデバイスを検出する

  • AWS IoT Device Management のマネージド統合から送信されるデバイスコマンドを開始する

  • ユーザーを特定する

デバイスオペレーションをサポートするために、コネクタは AWS IoT Device Management のマネージド統合と関連するサードパーティープラットフォームとの間のリクエストおよびレスポンスメッセージの変換を管理する必要があります。

コア要件

C2C コネクタの要件は次のとおりです。

  1. OAuth 2.0 コンプライアンス (該当する場合)

    コネクタが OAuth 2.0 をサポートしている場合、サードパーティーの認可サーバーは OAuth 2.0 標準および に記載されている設定に準拠している必要がありますOAuth 設定要件。

  2. Matter データモデルのコンプライアンス

    Matter Data Model の AWS 実装から識別子を解釈するには C2C コネクタが必要であり、 Matter Data Model の AWS 実装に準拠するレスポンスとイベントを出力する必要があります。詳細については、「AWS Matter データモデルの実装」を参照してください。

  3. SigV4 認証

    C2C コネクタは、SigV4認証を使用して AWS IoT Device Management APIsマネージド統合を呼び出すことができる必要があります。SendConnectorEvent API で送信される非同期イベントの場合、関連する SendConnectorEvent リクエストに署名するには、コネクタの登録に使用したのと同じ AWS アカウント 認証情報を使用する必要があります。

  4. 必要なオペレーション

    コネクタは、次の 4 つのオペレーションを実装する必要があります。

  5. イベント転送

    C2C コネクタは、デバイスコマンドレスポンスまたはデバイス検出に関連するサードパーティーイベントを受信すると、SendConnectorEventそれらを API との Managed Integrations に転送する必要があります。これらのイベントと SendConnectorEvent API の詳細については、SendConnectorEvent」を参照してください。

注記

SendConnectorEvent API はマネージド統合 SDK の一部であり、リクエストを手動で構築して署名する代わりに使用されます。