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

自訂SMS寄件者 Lambda 觸

當您將自訂SMS寄件者觸發器指派給使用者集區時，當使用者事件要求傳送訊息時，Amazon Cognito 會叫用 Lambda 函數而非預設行為。SMS使用自定義發件人觸發器，您的 AWS Lambda 功能可以SMS通過您選擇的方法和提供程序向用戶發送通知。函數的自定義代碼必須處理並傳遞來自用戶池的所有SMS消息。

此觸發器可提供您可能希望更好地控制使用者集區傳送SMS郵件的方式的案例。您的 Lambda 函數可以自訂對 Amazon SNS API 作業的呼叫，例如當您要管理多個起始IDs或交叉 AWS 區域作業時。您的功能也可能會將郵件重新導向至其他傳遞媒介或第三方服務。

若要設定此觸發程序，請執行下列步驟：

自訂SMS寄件者 Lambda 觸發器

Amazon Cognito 傳遞至此 Lambda 函數的請求，是以下參數和 Amazon Cognito 新增至所有請求的常用參數之組合。

JSON

{
    "request": {
        "type": "customSMSSenderRequestV1",
        "code": "string",
        "clientMetadata": {
            "string": "string",
             . . .
            },
        "userAttributes": {
            "string": "string",
            . . .
         }
}

自訂SMS寄件者要求參數

自訂SMS寄件者回應參數

Amazon Cognito 不預期會在回應中收到任何其他傳回的資訊。您的函數可以使用API操作來查詢和修改資源，或將事件中繼資料記錄到外部系統。

啟用自訂SMS寄件者 Lambda 觸發器

您可以設定使用自訂邏輯傳送使用者集區的SMS郵SMS件的自訂寄件者觸發器。下列程序會將自訂SMS觸發器、自訂電子郵件觸發器或兩者指派給您的使用者集區。新增自訂SMS寄件者觸發器後，Amazon Cognito 一律會傳送使用者屬性 (包括電話號碼和一次性代碼) 到 Lambda 函數，而不是使用 Amazon 簡單通知服務傳送SMS訊息的預設行為。

若要使用移除自訂寄件者 Lambda 觸發程序 update-user-pool AWS CLI，請省略CustomSMSSender或CustomEmailSender參數--lambda-config，然後包含您要與使用者集區搭配使用的所有其他觸發程序。

若要移除含有UpdateUserPoolAPI要求的自訂寄件者 Lambda 觸發程序，請從包含其餘使用者集區組態的要求主體中省略CustomSMSSender或CustomEmailSender參數。

程式碼範例

下列 Node.js 範例會處理自訂SMS寄件者 Lambda 函數中的SMS訊息事件。此範例假設您的函數定義了兩個環境變數。

const AWS = require('aws-sdk');
const b64 = require('base64-js');
const encryptionSdk = require('@aws-crypto/client-node');
//Configure the encryption SDK client with the KMS key from the environment variables.  
const { encrypt, decrypt } = encryptionSdk.buildClient(encryptionSdk.CommitmentPolicy.REQUIRE_ENCRYPT_ALLOW_DECRYPT);
const generatorKeyId = process.env.KEY_ALIAS;
const keyIds = [ process.env.KEY_ARN ];
const keyring = new encryptionSdk.KmsKeyringNode({ generatorKeyId, keyIds })
exports.handler = async (event) => {
	//Decrypt the secret code using encryption SDK.
	let plainTextCode;
	if(event.request.code){
		const { plaintext, messageHeader } = await decrypt(keyring, b64.toByteArray(event.request.code));
		plainTextCode = plaintext
	}
	//PlainTextCode now contains the decrypted secret.
	if(event.triggerSource == 'CustomSMSSender_SignUp'){
		//Send an SMS message to your user via a custom provider.
		//Include the temporary password in the message.
	}
	else if(event.triggerSource == 'CustomSMSSender_ResendCode'){
	}
	else if(event.triggerSource == 'CustomSMSSender_ForgotPassword'){
	}
	else if(event.triggerSource == 'CustomSMSSender_UpdateUserAttribute'){
	}
	else if(event.triggerSource == 'CustomSMSSender_VerifyUserAttribute'){
	}
	else if(event.triggerSource == 'CustomSMSSender_AdminCreateUser'){
	}
	else if(event.triggerSource == 'CustomSMSSender_AccountTakeOverNotification'){
	}
	return;
};

使用自訂SMS傳送者函數評估SMS訊息功能

自訂SMS寄件者 Lambda 函數會接受使用者集區將傳送的SMS訊息，而函數會根據您的自訂邏輯提供內容。Amazon Cognito 將 自訂SMS寄件者 Lambda 觸發器 傳送到您的函數中。您的函數可以進行您想要使用此資訊做的事。例如，您可以將程式碼傳送至 Amazon 簡單通知服務 (AmazonSNS) 主題。Amazon SNS 主題訂閱者可以是SMS訊息、HTTPS端點或電子郵件地址。

若要使用自訂SMS寄件者 Lambda 函數建立 Amazon Cognito SMS 簡訊的測試環境，請參閱上的 AWS 範例程式庫sms-redirected-to-email中的 amazon-cognito-user-pooldevelopment-and-testing-with-。 GitHub存放庫包含可 AWS CloudFormation 建立新使用者集區或使用您已有的使用者集區的範本。這些範本會建立 Lambda 函數和 Amazon SNS 主題。範本指派為自訂SMS寄件者觸發器的 Lambda 函數，可將訊SMS息重新導向至訂閱者至 Amazon SNS 主題。

將此解決方案部署到使用者集區時，Amazon Cognito 通常透過SMS簡訊傳送的所有訊息，Lambda 函數會改為傳送到中央電子郵件地址。使用此解決方案可自訂和預覽SMS訊息，以及測試造成 Amazon Cognito 傳送SMS訊息的使用者集區事件。完成測試後，回滾 CloudFormation 堆棧，或從用戶池中刪除自定義SMS發送者函數分配。

自訂SMS寄件者 Lambda 觸發器

下表顯示 Lambda 程式碼中自訂SMS觸發器來源的觸發事件。