如何建立秘密資源 (主控台)

登入 AWS Secrets Manager 主控台。

選擇 Store a new secret (存放新機密)。

在 [選擇密碼類型] 下，選擇 [其他密碼類型]。

在 Specify the key/value pairs to be stored for this secret (指定此秘密要儲存的金鑰/數值組) 下：

保持為加密金鑰選取 aws/秘密管理員，然後選擇 [下一步]。

針對 Secret name (私密名稱)，輸入 greengrass-TestSecret，然後選擇 Next (下一步)。

本教學課程不需要旋轉，因此請選擇「停用自動旋轉」，然後選擇「下一步」。

在 Review (檢閱) 頁面上，檢閱設定，然後選擇 Store (儲存)。

接著，您可以在 Greengrass 群組中建立一個參考私密的私密資源。

在AWS IoT主控台瀏覽窗格的 [管理] 下，展開 [Greengrass 裝置]，然後選擇 [群組 (V1)]。

選擇您要將私密資源新增至其中的群組。

在群組設定頁面上，選擇 [資源] 索引標籤，然後向下捲動至 [機密] 區段。「密碼」段落會顯示屬於群組的秘密資源。您可以在此區段中新增、編輯和移除秘密資源。

在「密碼」區段下選擇「新增」。

在 [新增秘密資源] 頁面上，輸MyTestSecret入資源名稱。

在「秘密」下，選擇「綠色」。TestSecret

在「選取標籤 (選擇性)」段落中， AWSCURRENT 暫存標籤代表最新版本的密碼。此標籤一律包含在私密資源中。

選擇 Add resource (新增資源)。

從AWS IoT Greengrass核心 SDK 下載頁面，將 Python 的AWS IoT Greengrass核心 SDK 下載到您的計算機。

解壓縮下載的封裝，以取得軟體開發套件。SDK 為 greengrasssdk 資料夾。

將以下 Python 程式碼函數儲存在名為 secret_test.py 的本機檔案中。

import greengrasssdk

secrets_client = greengrasssdk.client("secretsmanager")
iot_client = greengrasssdk.client("iot-data")
secret_name = "greengrass-TestSecret"
send_topic = "secrets/output"


def function_handler(event, context):
    """
    Gets a secret and publishes a message to indicate whether the secret was
    successfully retrieved.
    """
    response = secrets_client.get_secret_value(SecretId=secret_name)
    secret_value = response.get("SecretString")
    message = (
        f"Failed to retrieve secret {secret_name}."
        if secret_value is None
        else f"Successfully retrieved secret {secret_name}."
    )
    iot_client.publish(topic=send_topic, payload=message)
    print("Published: " + message)

此get_secret_value函數支援密碼 Secrets Manager 碼的名稱或 ARN SecretId 值。此範例使用私密名稱。在此秘密範例中，AWS IoT Greengrass 會傳回鍵值組：{"test":"abcdefghi"}。

將下列項目壓縮成名為 secret_test_python.zip 的檔案。當您建立 ZIP 檔案時，只包含程式碼及其依存項目，而不包含資料夾。

這是您的 Lambda 函數部署套件。

首先，建立 Lambda 函數。

1. 於 AWS Management Console，請選擇服務，開啟 AWS Lambda 主控台。

2. 選擇創建功能，然後選擇從頭開始作者。

3. 在 Basic information (基本資訊) 區段中，使用下列值：

   • 針對 函數名稱 ，請輸入 SecretTest。

   • 針對 Runtime (執行時間)，選擇 Python 3.7。

   • 對於「權限」，請保留預設設定。這會建立授與基本 Lambda 權限的執行角色。此角色不被使用AWS IoT Greengrass。

4. 在頁面底部，選擇 [建立功能]。

接下來，註冊處理常式並上傳您的 Lambda 函數部署套件。

1. 在 [程式碼] 索引標籤的 [程式碼來源] 下，選擇 [上傳自] 從下拉式清單中選擇 .zip 檔案。

   

2. 選擇「上傳」，然後選擇您的secret_test_python.zip部署套件。然後選擇 Save (儲存)。

3. 在函數的 [程式碼] 索引標籤上的 [執行階段設定] 下，選擇 [編輯]，然後輸入下列值。

   • 針對 Runtime (執行時間)，選擇 Python 3.7。

   • 對於 Handler (處理常式)，輸入 secret_test.function_handler。

4. 選擇 儲存 。

   注意

   AWS Lambda控制台上的「測試」按鈕不適用於此功能。AWS IoT Greengrass核心 SDK 不包含在主控台中獨立執行 Greengrass Lambda 函數所需的模組。AWS Lambda這些模塊（例如，greengrass_common）在部署到 Greengrass 核心後，將提供給函數。

現在，發佈 Lambda 函數的第一個版本，並為該版本建立別名。

1. 請從操作功能表中選擇發行新版本。

2. 針對 Version description (版本描述)，輸入 First version，然後選擇 Publish (發佈)。

3. 在 SecretTest：1 組態頁面的「動作」功能表中，選擇「建立別名」。

4. 在建立警示頁面上使用下列值：

   • 對於 Name (名稱)，輸入 GG_SecretTest。

   • 對於 Version (版本)，選擇 1。

   注意

   AWS IoT Greengrass不支持 $ 最新版本的 Lambda 別名。

5. 選擇 建立 。

在群組設定頁面上，選擇 Lambda 函數索引標籤。

在 [我的 Lambda 函數] 區段下，選擇 [新增]。

對於 L ambda 函數，請選擇SecretTest。

對於 Lambda 函數版本，請選擇您發佈的版本的別名。

在 Lambda 函數設定區段中，進行下列更新。

1. 若要在不含容器化的情況下執行：

   • 對於 [系統使用者和群組]，請選擇Another user ID/group ID。對於「系統使用者 ID」，請輸入0。對於「系統群組 ID」，輸入0。

     這可讓您的 Lambda 函數以根使用者身分執行。如需以 root 身分執行的詳細資訊，請參閱設定群組中 Lambda 函數的預設存取身分。

     提示

     您也必須更新config.json檔案，以授與 Lambda 函數的根存取權。如需程序的資訊，請參閱以根身份運行 Lambda 函數。

   • 對於 Lambda 函數容器化，請選擇「無容器」。

     如需在沒有容器化的情況下執行的詳細資訊，請參閱。選擇 Lambda 函數容器化時的考量事項

   • 針對 Timeout (逾時)，輸入 10 seconds。

   • 針對「釘選」，選擇「True」。

     如需詳細資訊，請參閱Greengrass Lambda 函數的生命週期組態。

   • 在「其他參數」下，對於 /sys 目錄的讀取權限，請選擇已啟用。

2. 要在容器化模式下運行：

   注意

   除非您的業務案例需要，否則我們不建議以容器化模式執行。

   • 對於系統使用者和群組，請選擇使用群組預設值。

   • 對於 Lambda 函數容器化，請選擇 [使用群組預設值]。

   • 針對 Memory limit (記憶體限制)，輸入 1024 MB。

   • 針對 Timeout (逾時)，輸入 10 seconds。

   • 針對「釘選」，選擇「True」。

     如需詳細資訊，請參閱Greengrass Lambda 函數的生命週期組態。

   • 在「其他參數」下，對於 /sys 目錄的讀取權限，請選擇已啟用。

選擇新增 Lambda 函數。

在群組設定頁面上，選擇 Lambda 函數索引標籤。

選擇SecretTest功能。

在函數的詳細資訊頁面上，選擇資源。

捲動至「密碼」區段，然後選擇「關聯」。

選擇 MyTestSecret，然後選擇「關聯」。

在群組設定頁面上，選擇 [訂閱] 索引標籤，然後選擇 [新增訂閱]。

建立一個允許 AWS IoT 將訊息發佈至函數的訂閱。

在群組設定頁面上，選擇 [訂閱] 索引標籤，然後選擇 [新增訂閱]。

在 [建立訂閱] 頁面上，設定來源和目標，如下所示：

1. 在 [來源類型] 中，選擇 [Lambda 函數]，然後選擇 [IoT 雲端]。

2. 在 [目標類型] 中，選擇 [服務]，然後選擇SecretTest。

3. 在 [主題] 篩選器中，輸入secrets/input，然後選擇 [建立訂閱]。

新增第二個訂閱。選擇「訂閱」索引標籤，選擇「新增訂閱」，然後設定來源和目標，如下所示：

1. 在 [來源類型] 中，選擇 [服務]，然後選擇SecretTest。

2. 在 [目標類型] 中，選擇 [Lambda 函數]，然後選擇 [IoT 雲端]。

3. 在 [主題] 篩選器中，輸入secrets/output，然後選擇 [建立訂閱]。

請確定AWS IoT Greengrass核心正在執行。如果需要，請在您的 Raspberry Pi 終端機執行以下命令。

1. 檢查精靈是否有在運作：

   ps aux | grep -E 'greengrass.*daemon'

   若輸出的 root 含有 /greengrass/ggc/packages/ggc-version/bin/daemon 項目，則精靈有在運作。

   注意

   路徑的版本取決於安裝在您的核心裝置中的 AWS IoT Greengrass 核心軟體版本。

2. 若要啟動協助程式：

   cd /greengrass/ggc/core/
   sudo ./greengrassd start

在 [群組設定] 頁面上，選擇 [部署]。

1. 在 Lambda 函數索引標籤的系統 Lambda 函數區段下，選取 IP 偵測器，然後選擇編輯。

2. 在 [編輯 IP 偵測器設定] 對話方塊中，選取 [自動偵測並覆寫 MQTT 代理程式端點]。

3. 選擇 儲存 。

   這可讓裝置自動取得核心的連接資訊，例如 IP 位址、DNS、連接埠編號。建議使用自動偵測，但是 AWS IoT Greengrass 也支援手動指定端點。只會在第一次部署群組時收到復原方法的提示。

   注意

   如果出現提示，請授予建立 Greengrass 服務角色的權限，並將其與目前服務角色相關聯。AWS 帳戶 AWS 區域此角色可AWS IoT Greengrass讓您存取AWS服務中的資源。

   此部署頁面會顯示部署時間戳記、版本 ID 和狀態。完成時，顯示的部署狀態應為 [已完成]。

   如需故障診斷協助，請參閱AWS IoT Greengrass 疑難排解。

在AWS IoT主控台首頁上，選擇 [測試]。

對於訂閱主題，請使用下列值，然後選擇訂閱。

對於「發佈至」主題，請使用下列值，然後選擇「發佈」以呼叫函數。

如果成功，函數會發佈「Success (成功)」訊息。