View a markdown version of this page

AWS.DeactivateUser オペレーションを実装する - のマネージド統合 AWS IoT Device Management
ユーザー非アクティブ化の概要AWS.DeactivateUser の要件

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

AWS.DeactivateUser オペレーションを実装する

ユーザー非アクティブ化の概要

提供されたユーザーアクセストークンの非アクティブ化は、顧客が AWS 顧客アカウントを削除する場合、またはエンドユーザーが AWS 顧客のシステムからシステム内のアカウントのリンクを解除する場合に必要です。どちらのユースケースのマネージド統合でも、C2C コネクタを使用してこのワークフローを容易にする必要があります。

次の図は、システムからエンドユーザーアカウントをリンク解除する方法を示しています。

ユーザー非アクティブ化ワークフロー
ユーザー非アクティブ化ワークフロー

  1. ユーザーは、 AWS 顧客のアカウントと C2C コネクタに関連付けられたサードパーティー認可サーバーとの間のリンク解除プロセスを開始します。

  2. お客様は、AWS IoT Device Management のマネージド統合を通じてユーザーの関連付けの削除を開始します。

  3. マネージド統合は、 AWS.DeactivateUserオペレーションインターフェイスを使用してコネクタへのリクエストを介して非アクティブ化プロセスを開始します。

    1. OAuth 2.0 の場合、ユーザーのアクセストークンは ヘッダーに含まれます。一般認可の場合、 AWS Secrets Manager リファレンスは ヘッダーに含まれます。

  4. C2C コネクタはリクエストを受け入れ、必要な非アクティブ化ステップを実行します。OAuth 2.0 の場合、これには、トークンとそのトークンが提供するアクセスを取り消すための認可サーバーの呼び出しが含まれます。一般認可の場合、これにはクリーンアップオペレーションやサードパーティープラットフォームへの通知が含まれる場合があります。

    1. たとえば、リンクされていないユーザーアカウントからのイベントは、 の実行後に Managed Integrations に送信されなくなりますAWS.DeactivateUser。

  5. 認可サーバーまたはサードパーティープラットフォームは非アクティブ化を処理し、C2C コネクタにレスポンスを返します。

  6. C2C コネクタは、AWS IoT Device Management のマネージド統合に、非アクティブ化が処理された ACK を送信します。

  7. Managed Integrations は、リソースサーバーに関連付けられたエンドユーザーが所有するすべてのリソースを削除します。

  8. Managed Integrations は、システムに関連するすべての関連付けが削除されたことを示す ACK を顧客に送信します。

  9. お客様は、アカウントがプラットフォームからリンク解除されたことをエンドユーザーに通知します。

AWS.DeactivateUser の要件

C2C コネクタがユーザーの非アクティブ化を正常に処理するには、次の要件を満たす必要があります。

  • リクエスト処理: C2C コネクタ Lambda 関数は、 マネージド統合からリクエストメッセージを受け取り、AWS.DeactivateUserオペレーションを処理します。

  • トークンの取り消し/クリーンアップ:

    • OAuth 2.0 の場合: C2C コネクタは、提供された OAuth 2.0 トークンと、認可サーバー内のユーザーの対応する更新トークンを取り消す必要があります。

    • 一般的な認可の場合: C2C コネクタは、サードパーティープラットフォームに必要なクリーンアップまたは非アクティブ化のステップを実行する必要があります。

リクエストの例

OAuth 2.0 リクエスト:

コネクタが OAuth 2.0 に対して受信するAWS.DeactivateUserリクエストの例を次に示します。

{
     "header": {
         "auth": {                 
             "token": "ashriu32yr97feqy7afsaf",   
             "type": "OAuth2.0" 
         }
     },
     "payload":{
         "operationName": "AWS.DeactivateUser",
         "operationVersion": "1.0",
         "connectorId": "Your-connector-Id"
     }
}

一般的な認可の例:

{
     "header": {
         "auth": {
             "secretsManager": {
                 "arn": "arn:aws:secretsmanager:us-east-1:123456789012:secret:my-secret-abc123",
                 "versionId": "EXAMPLE1-90ab-cdef-fedc-ba987EXAMPLE"
             },
             "type": "GeneralAuthorization"
         }
     },
     "payload":{
         "operationName": "AWS.DeactivateUser",
         "operationVersion": "1.0",
         "connectorId": "Your-connector-Id"
     }
}