使用 Lambda 觸發程序來自訂使用者集區工作流程

Amazon Cognito 傳送給您的 Lambda 觸發程序的事件可能會隨著新功能而變更。JSON 階層中回應和請求元素的位置可能會變更，或者可能會新增元素名稱。在 Lambda 函數中，您可以期望收到本指南中所述的輸入元素鍵值對，但更嚴格的輸入驗證可能會導致函數失敗。

您可以選擇 Amazon Cognito 傳送至某些觸發程序的多個版本事件之一。某些版本可能會要求您接受 Amazon Cognito 定價的變更。如需定價的詳細資訊，請參閱 Amazon Cognito 定價。若要在產生權杖前 Lambda 觸發程序中自訂存取權杖，您必須使用進階安全性功能設定使用者集區，並更新 Lambda 觸發程序組態以使用第 2 版事件。

除了自訂寄件者 Lambda 觸發程序之外，Amazon Cognito 會同步叫用 Lambda 函數。當 Amazon Cognito 呼叫您的 Lambda 函數時，該函數必須在 5 秒內回應。若未回應，而可以重試呼叫，則 Amazon Cognito 會重試呼叫。嘗試失敗 3 次後，函數會發生逾時。您無法變更此 5 秒逾時值。如需詳細資訊，請參閱《AWS Lambda 開發人員指南》中的 Lambda 程式設計模型。

Amazon Cognito 不會重試傳回調用錯誤且 HTTP 狀態碼為 500-599 的函數呼叫。這些代碼表示發生組態問題，導致 Lambda 無法啟動該函數。如需詳細資訊，請參閱 AWS Lambda 中錯誤處理和自動重試。

您無法在 Lambda 觸發程式組態中宣告函數版本。Amazon Cognito 使用者集區預設會調用最新版本的函數。但是，您可以將函數版本與別名相關聯，並在 CreateUserPool 或 UpdateUserPool API 請求中將觸發程式 LambdaArn 設為別名 ARN。此選項無法用於 AWS Management Console 中。若要進一步了解別名，請參閱 AWS Lambda 開發人員指南中的 Lambda 函數別名。

若刪除 Lambda 觸發程序，必須更新使用者集區內對應的觸發程序。例如，若您刪除驗證後觸發，便須在對應的使用者集區內，將 Post authentication (身分驗證後) 觸發設為 none (無)。

如果您的 Lambda 函數未將請求和回應參數傳回至 Amazon Cognito，或傳回錯誤，則驗證事件不會成功。您可以在函數中傳回錯誤，以防止使用者註冊、驗證、產生權杖，或進行驗證流程中調用 Lambda 觸發程序的任何其他階段。

Amazon Cognito 託管 UI 會在登入提示上方，以錯誤文字的形式傳回 Lambda 觸發程序產生的錯誤。Amazon Cognito 使用者集區 API 會使用 [trigger] failed with error [error text from response] 格式傳回觸發程序錯誤。最佳實務是僅在您希望使用者看到的 Lambda 函數中產生錯誤。使用類似 print() 的輸出方法將任何敏感或偵錯資訊記錄到 CloudWatch Logs。如需範例，請參閱 註冊前範例：如果使用者名稱少於五個字元，則拒絕註冊。

您可以在另一個 AWS 帳戶 中新增 Lambda 函數，做為使用者集區的觸發程序。您必須使用 CreateUserPool 和 UpdateUserPool API 操作或與 AWS CloudFormation 中和 AWS CLI 中的對等項目來新增跨帳戶觸發程序。您無法在 AWS Management Console 中新增跨帳戶功能。

當您在 Amazon Cognito 主控台中新增 Lambda 觸發程序時，Amazon Cognito 會在您的函數中新增以資源為基礎的政策，以允許您的使用者集區叫用該函數。在 Amazon Cognito 主控台外部建立 Lambda 觸發程序時，包括跨帳戶之間的函數，您必須為 Lambda 函數新增基於資源政策的許可。您新增的許可必須允許 Amazon Cognito 以代表您的使用者集區叫用函數。您可以從 Lambda 主控台新增許可或使用 Lambda AddPermission API 操作。

以 Lambda 資源為基礎的政策範例

下列 Lambda 資源型政策範例允許 Amazon Cognito 叫用 Lambda 函數的有限功能。執行此操作時，Amazon Cognito 只能代表 aws:SourceArn 條件中的使用者集區和 aws:SourceAccount 條件中的帳戶叫用函數。

{
    "Version": "2012-10-17",
    "Id": "default",
    "Statement": [
        {
            "Sid": "lambda-allow-cognito",
            "Effect": "Allow",
            "Principal": {
                "Service": "cognito-idp.amazonaws.com"
            },
            "Action": "lambda:InvokeFunction",
            "Resource": "<your Lambda function ARN>",
            "Condition": {
                "StringEquals": {
                    "AWS:SourceAccount": "<your account number>"
                },
                "ArnLike": {
                    "AWS:SourceArn": "<your user pool ARN>"
                }
            }
        }
    ]
}