Mengonfigurasi AWS Cognito untuk Mengirim Email Verifikasi pada Pembuatan Pengguna Admin

Menyiapkan Verifikasi Pengguna di AWS Cognito dengan AdminCreateUserCommand

Saat mengelola autentikasi dan otorisasi pengguna dalam aplikasi web, memastikan basis pengguna yang aman dan terverifikasi sangatlah penting. AWS Cognito memberikan solusi yang kuat untuk manajemen pengguna, namun mengintegrasikan alur verifikasi pengguna khusus, terutama ketika pengguna dibuat oleh admin, bisa jadi rumit. Biasanya, Cognito mengirimkan email undangan default saat admin membuat pengguna. Namun, menggantinya dengan email verifikasi khusus yang menyertakan kode dapat meningkatkan keamanan dan memberikan pengalaman pengguna yang lebih personal.

Untuk menerapkan hal ini, pengembang dapat memanfaatkan AWS CDK untuk pengaturan infrastruktur backend dan Amplify untuk operasi frontend. Pendekatan ini melibatkan konfigurasi kumpulan pengguna Cognito untuk memicu email verifikasi khusus selama proses pembuatan pengguna yang dimulai oleh AdminCreateUserCommand. Terlepas dari tantangan dan kesenjangan dokumentasi terkait alur pembuatan admin, proses verifikasi pengguna dapat disesuaikan dengan mengatur konfigurasi kumpulan pengguna tertentu dan memanfaatkan AWS Lambda untuk pesan khusus.

Memerintah	Keterangan
CognitoIdentityServiceProvider	Kelas dari AWS SDK for JavaScript ini menginisialisasi klien yang memungkinkan interaksi dengan layanan AWS Cognito.
AdminCreateUserCommand	Perintah ini digunakan untuk membuat pengguna baru secara langsung di kumpulan pengguna AWS Cognito sebagai admin tanpa memerlukan interaksi pengguna.
send	Metode yang digunakan untuk menjalankan AdminCreateUserCommand. Ini mengirimkan perintah ke layanan AWS untuk melakukan operasi pembuatan pengguna.
handler	Penangan fungsi AWS Lambda yang memproses peristiwa dari AWS Cognito, khususnya di sini digunakan untuk menyesuaikan pesan selama pembuatan pengguna.
triggerSource	Properti objek peristiwa di Lambda yang menunjukkan sumber pemicu, membantu mengeksekusi logika secara kondisional berdasarkan jenis operasi yang dipicu di Cognito.
response	Digunakan di Lambda untuk mengubah objek respons yang akan dikembalikan oleh Cognito, khususnya untuk mengatur subjek email khusus dan pesan untuk email verifikasi.

Penjelasan Mendetail tentang Implementasi Verifikasi Email AWS Cognito Kustom

Skrip yang disediakan memungkinkan pembuatan dan penyesuaian proses verifikasi pengguna di AWS Cognito ketika administrator menambahkan pengguna secara manual. Secara khusus, skrip pertama membuat pengguna baru di kolam pengguna Cognito menggunakan AdminCreateUserCommand dari AWS SDK for JavaScript. Perintah ini sangat berguna untuk skenario ketika administrator perlu melakukan orientasi pengguna tanpa mengharuskan mereka melalui proses pendaftaran seperti biasa. Perintah ini mencakup parameter seperti UserPoolId, Username, TemporaryPassword, dan UserAttributes, antara lain. Array UserAttributes dapat digunakan untuk meneruskan detail penting seperti email pengguna. Kata Sandi Sementara disediakan untuk login awal, dan parameter DesiredDeliveryMediums disetel ke 'EMAIL' untuk memastikan pengguna menerima komunikasi yang diperlukan melalui email. Bagian skrip ini sangat penting untuk menyiapkan akun pengguna tanpa interaksi dari pihak mereka.

Selain itu, skrip kedua melibatkan fungsi Lambda yang bertindak berdasarkan pemicu CustomMessage, sebuah kemampuan yang disediakan oleh AWS Cognito untuk menyesuaikan pesan untuk tindakan berbeda seperti undangan atau verifikasi pengguna. Fungsi Lambda ini memeriksa apakah peristiwa pemicunya adalah 'CustomMessage_AdminCreateUser' dan menyesuaikan konten email dan baris subjek. Dengan memodifikasi properti event.response, skrip menetapkan subjek email dan pesan yang dipersonalisasi yang menyertakan placeholder kode verifikasi. Kode ini penting untuk memverifikasi alamat email pengguna dan memastikan bahwa hanya pengguna terverifikasi yang dapat melanjutkan menggunakan aplikasi. Penyesuaian ini memberikan pengalaman pengguna yang lebih bermerek dan terkontrol, menyelaraskan interaksi pengguna awal dengan standar organisasi dan kebijakan keamanan.

import { CognitoIdentityServiceProvider } from '@aws-sdk/client-cognito-identity-provider';
import { AdminCreateUserCommand } from '@aws-sdk/client-cognito-identity-provider';
const cognitoClient = new CognitoIdentityServiceProvider({ region: 'us-west-2' });
const userPoolId = process.env.COGNITO_USER_POOL_ID;
const createUser = async (email, tempPassword) => {
  const params = {
    UserPoolId: userPoolId,
    Username: email,
    TemporaryPassword: tempPassword,
    UserAttributes: [{ Name: 'email', Value: email }],
    DesiredDeliveryMediums: ['EMAIL'],
    MessageAction: 'SUPPRESS',  // Suppress the default email
  };
  try {
    const response = await cognitoClient.send(new AdminCreateUserCommand(params));
    console.log('User created:', response);
    return response;
  } catch (error) {
    console.error('Error creating user:', error);
  }
};

exports.handler = async (event) => {
  if (event.triggerSource === 'CustomMessage_AdminCreateUser') {
    event.response.emailSubject = 'Verify your email for our awesome app!';
    event.response.emailMessage = \`Hello $\{event.request.userAttributes.name},
      Thanks for signing up to our awesome app! Your verification code is $\{event.request.codeParameter}.\`;
  }
  return event;
};

Meningkatkan Keamanan dan Pengalaman Pengguna dengan Proses Verifikasi Kustom AWS Cognito

Salah satu aspek penting dalam penerapan AWS Cognito untuk manajemen pengguna melibatkan peningkatan keamanan dan memberikan pengalaman pengguna yang lancar. Kemampuan untuk menyesuaikan proses verifikasi pengguna tidak hanya mengamankan aplikasi dengan memverifikasi identitas pengguna tetapi juga memungkinkan bisnis untuk menyesuaikan perjalanan pengguna sesuai dengan merek mereka. Penyesuaian ini bisa menjadi sangat penting dalam skenario yang mengutamakan kepercayaan dan keamanan, misalnya dalam aplikasi perbankan, layanan kesehatan, atau e-commerce. Dengan memanfaatkan kemampuan AWS Cognito untuk mengirim email khusus, administrator dapat memastikan bahwa pengguna menerima pengalaman yang konsisten dari titik kontak awal. Selain itu, penggunaan atribut khusus di Cognito, seperti 'lokal', memungkinkan aplikasi memberikan pengalaman yang dilokalkan, sehingga meningkatkan keterlibatan dan kepuasan pengguna.

Selain itu, mengintegrasikan fitur-fitur ini menggunakan AWS CDK (Cloud Development Kit) memungkinkan pengembang untuk menentukan sumber daya cloud mereka menggunakan bahasa pemrograman yang sudah dikenal. Pendekatan ini menyederhanakan proses penyiapan konfigurasi kompleks seperti alur verifikasi khusus. Dengan membuat skrip seluruh infrastruktur sebagai kode, hal ini meminimalkan risiko kesalahan manusia selama konfigurasi dan meningkatkan reproduktifitas penyiapan di berbagai lingkungan atau tahapan siklus hidup aplikasi. Integrasi AWS Amplify untuk frontend semakin menyempurnakan hal ini dengan menyediakan serangkaian alat dan layanan yang membantu dalam membangun aplikasi tumpukan penuh yang aman dan skalabel yang didukung oleh AWS.

Seiring dengan terus berkembangnya aplikasi berbasis cloud, kebutuhan akan sistem manajemen pengguna yang kuat menjadi semakin penting. AWS Cognito menawarkan solusi canggih untuk mengelola siklus hidup pengguna, khususnya dengan AdminCreateUserCommand. Fungsionalitas ini memungkinkan administrator untuk melewati alur kerja pendaftaran pengguna standar dan langsung membuat akun, memastikan bahwa semua pengguna diverifikasi melalui proses verifikasi email yang disesuaikan. Kemampuan untuk mengintegrasikannya dengan AWS CDK dan AWS Lambda untuk pesan khusus dan kode verifikasi selaras dengan praktik terbaik untuk pengembangan aplikasi yang aman. Selain itu, metode ini mendukung kepatuhan terhadap peraturan perlindungan data dengan memastikan bahwa hanya pengguna terverifikasi yang dapat mengakses fitur sensitif. Pada akhirnya, penerapan AWS Cognito untuk manajemen pengguna tidak hanya menyederhanakan tugas administratif namun juga meningkatkan keamanan dan kegunaan aplikasi di berbagai sektor.