Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pemicu Lambda SMS pengirim kustom

Saat Anda menetapkan pemicu SMS pengirim khusus ke kumpulan pengguna, Amazon Cognito akan memanggil fungsi Lambda, bukan perilaku defaultnya saat peristiwa pengguna mengharuskannya mengirim pesan. SMS Dengan pemicu pengirim khusus, AWS Lambda fungsi Anda dapat mengirim SMS pemberitahuan ke pengguna Anda melalui metode dan penyedia yang Anda pilih. Kode kustom fungsi Anda harus memproses dan mengirimkan semua SMS pesan dari kumpulan pengguna Anda.

Pemicu ini menyajikan skenario di mana Anda mungkin ingin memiliki kontrol yang lebih besar atas cara kumpulan pengguna Anda mengirim SMS pesan. Fungsi Lambda Anda dapat menyesuaikan panggilan ke SNS API operasi Amazon, misalnya saat Anda ingin mengelola beberapa originasi IDs atau silang. Wilayah AWS Fungsi Anda juga dapat mengarahkan pesan ke media pengiriman lain atau layanan pihak ketiga.

Untuk mengatur pemicu ini, lakukan langkah-langkah berikut:

Parameter pemicu Lambda SMS pengirim kustom

Permintaan yang diteruskan Amazon Cognito ke fungsi Lambda ini adalah kombinasi dari parameter di bawah ini dan parameter umum yang ditambahkan Amazon Cognito ke semua permintaan.

JSON

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

Parameter permintaan SMS pengirim kustom

Parameter respons SMS pengirim kustom

Amazon Cognito tidak mengharapkan informasi pengembalian tambahan dalam tanggapan. Fungsi Anda dapat menggunakan API operasi untuk menanyakan dan memodifikasi sumber daya Anda, atau merekam metadata peristiwa ke sistem eksternal.

Mengaktifkan pemicu SMS Lambda pengirim khusus

Anda dapat mengatur pemicu SMS pengirim kustom yang menggunakan logika kustom untuk mengirim SMS pesan ke kumpulan pengguna Anda. Prosedur berikut menetapkan pemicu kustom, SMS pemicu email kustom, atau keduanya ke kumpulan pengguna Anda. Setelah menambahkan pemicu SMS pengirim kustom, Amazon Cognito selalu mengirimkan atribut pengguna, termasuk nomor telepon, dan kode satu kali ke fungsi Lambda, bukan perilaku default yang mengirim SMS pesan dengan Amazon Simple Notification Service.

Untuk menghapus pemicu Lambda pengirim kustom dengan update-user-pool AWS CLI, hilangkan CustomSMSSender parameter CustomEmailSender atau --lambda-config dari, dan sertakan semua pemicu lain yang ingin Anda gunakan dengan kumpulan pengguna Anda.

Untuk menghapus pemicu Lambda pengirim kustom dengan UpdateUserPool API permintaan, hilangkan CustomSMSSender parameter CustomEmailSender atau dari badan permintaan yang berisi konfigurasi kumpulan pengguna lainnya.

Contoh kode

Contoh Node.js berikut memproses peristiwa SMS pesan dalam fungsi Lambda SMS pengirim kustom Anda. Contoh ini mengasumsikan fungsi Anda memiliki dua variabel lingkungan yang ditentukan.

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;
};

Mengevaluasi kemampuan SMS pesan dengan fungsi SMS pengirim kustom

Fungsi Lambda SMS pengirim kustom menerima SMS pesan yang akan dikirim oleh kumpulan pengguna Anda, dan fungsi tersebut mengirimkan konten berdasarkan logika kustom Anda. Amazon Cognito mengirimkan Parameter pemicu Lambda SMS pengirim kustom ke fungsi Anda. Fungsi Anda dapat melakukan apa yang Anda inginkan dengan informasi ini. Misalnya, Anda dapat mengirim kode ke topik Amazon Simple Notification Service (AmazonSNS). Pelanggan SNS topik Amazon dapat berupa SMS pesan, HTTPS titik akhir, atau alamat email.

Untuk membuat lingkungan pengujian untuk SMS perpesanan Amazon Cognito dengan fungsi Lambda SMS pengirim khusus, amazon-cognito-user-poollihat development-and-testing-with - sms-redirected-to-email - di pustaka aws-samples pada. GitHub Repositori berisi AWS CloudFormation template yang dapat membuat kumpulan pengguna baru, atau bekerja dengan kumpulan pengguna yang sudah Anda miliki. Template ini membuat fungsi Lambda dan topik AmazonSNS. Fungsi Lambda yang ditetapkan template sebagai pemicu SMS pengirim khusus, mengalihkan SMS pesan Anda ke pelanggan ke topik Amazon. SNS

Saat Anda menerapkan solusi ini ke kumpulan pengguna, semua pesan yang biasanya dikirim Amazon Cognito SMS melalui pesan, fungsi Lambda malah mengirim ke alamat email pusat. Gunakan solusi ini untuk menyesuaikan dan melihat pratinjau SMS pesan, dan untuk menguji peristiwa kumpulan pengguna yang menyebabkan Amazon Cognito mengirim SMS pesan. Setelah Anda menyelesaikan pengujian, putar kembali CloudFormation tumpukan, atau hapus tugas fungsi SMS pengirim kustom dari kumpulan pengguna Anda.

Sumber pemicu Lambda SMS pengirim khusus

Tabel berikut menunjukkan peristiwa pemicu untuk sumber SMS pemicu kustom dalam kode Lambda Anda.