View a markdown version of this page

實作 AWS.ActivateUser 操作 - 的受管整合 AWS IoT Device Management

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

實作 AWS.ActivateUser 操作

受管整合需要 AWS.ActivateUser操作， AWS IoT Device Management 才能從最終使用者擷取使用者識別符。對於 OAuth 2.0， 的受管整合 AWS IoT Device Management 會在請求標頭中傳遞 OAuth 字符。對於一般授權，適用於 的受管整合 AWS IoT Device Management 將傳遞 AWS Secrets Manager 參考。連接器必須在回應承載中包含全域唯一使用者識別符。

要求

下列清單概述連接器協助成功AWS.ActivateUser流程的需求：

  • 您的 C2C 連接器 Lambda 可以處理來自 受管整合AWS.ActivateUser的操作請求訊息 AWS IoT Device Management。

  • 您的 C2C 連接器 Lambda 可以判斷唯一的使用者識別符。對於 OAuth 2.0，如果它是 JWT 字符，或從授權伺服器請求，則可以從字符本身擷取。對於一般授權，這可能會從您的第三方平台擷取或從授權內容衍生。

AWS.ActivateUser 工作流程

步驟 1：受管整合會叫用您的 Lambda

的受管整合會根據授權類型，使用下列其中一個承載 AWS IoT Device Management 調用 C2C 連接器 Lambda：

OAuth 2.0 請求：

{
   "header": {
        "auth": {                 
            "token": "ashriu32yr97feqy7afsaf",  
            "type": "OAuth2.0"
        }
   },
   "payload": {
        "operationName": "AWS.ActivateUser",
        "operationVersion": "1.0.0",
        "connectorId": "Your-Connector-ID"
   }
}

一般授權請求：

{
   "header": {
        "auth": {
            "secretsManager": {
                "arn": "string",
                "versionId": "string"
            },
            "type": "GeneralAuthorization"
        }
   },
   "payload": {
        "operationName": "AWS.ActivateUser",
        "operationVersion": "1.0.0",
        "connectorId": "Your-Connector-ID"
   }
}

步驟 2：判斷使用者 ID

C2C 連接器會決定要包含在AWS.ActivateUser回應中的使用者 ID。

  • 對於 OAuth 2.0：這是從字符或透過查詢您的授權伺服器擷取的。

  • 對於一般授權：這可能會從您的第三方平台擷取，或從授權內容衍生。

步驟 3：使用使用者識別符回應

C2C 連接器會回應AWS.ActivateUser操作 Lambda 調用，包括預設承載以及 userId 欄位內對應的使用者識別符。

回應格式：

{
     "header": {
          "responseCode":200
     },
     "payload": {
          "responseMessage": "Successfully activated user with connector-id `Your-Connector-Id.”,
          "userId": "123456" 
     }
}