View a markdown version of this page

Sensitivitas huruf kumpulan pengguna - Amazon Cognito

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

Sensitivitas huruf kumpulan pengguna

Kumpulan pengguna Amazon Cognito yang Anda buat di dalamnya tidak peka Konsol Manajemen AWS huruf besar/kecil secara default. Jika kumpulan pengguna tidak peka huruf besar/kecil, user@example.com dan User@example.com merujuk ke pengguna yang sama. Ketika nama pengguna dalam kumpulan pengguna tidak peka huruf besar/kecil, email atribut preferred_username dan juga tidak peka huruf besar/kecil.

Insensitivitas huruf besar tidak hanya berlaku untuk input atribut, tetapi juga output. Mixed-casenilai atribut dalam kumpulan pengguna yang tidak peka huruf besar/kecil diratakan menjadi huruf kecil dalam output teks kumpulan pengguna. Contoh keluaran teks kumpulan pengguna adalah respons userInfo, respons kueri pengguna seperti output GetUser, dan peristiwa input ke pemicu Lambda.

Untuk memperhitungkan setelan sensitivitas huruf besar kumpulan pengguna, identifikasi pengguna dalam kode aplikasi berdasarkan atribut pengguna alternatif. Karena kasus nama pengguna, nama pengguna pilihan, atau atribut alamat email dapat bervariasi di profil pengguna yang berbeda, rujuk ke sub atribut. Anda juga dapat membuat atribut kustom yang tidak dapat diubah di kumpulan pengguna Anda, dan menetapkan nilai pengenal unik Anda sendiri ke atribut di setiap profil pengguna baru. Saat pertama kali membuat pengguna, Anda dapat menulis nilai ke atribut kustom yang tidak dapat diubah yang Anda buat.

catatan

Terlepas dari pengaturan sensitivitas huruf kecil dari kumpulan pengguna Anda, Amazon Cognito mengharuskan pengguna federasi dari penyedia identitas SAML atau OIDC (IdP) meneruskan klaim atau klaim yang unik dan peka huruf besar-kecil. NameId sub Untuk informasi selengkapnya tentang sensitivitas huruf besar pengidentifikasi unik dan SAML IdPs, lihatTerapkan SP-initated masuk SAML.

Membuat kumpulan pengguna yang peka huruf besar/kecil

Jika Anda membuat sumber daya dengan operasi AWS Command Line Interface (AWS CLI) dan API seperti CreateUserPool, Anda harus mengatur CaseSensitive parameter Boolean ke. false Pengaturan ini membuat kumpulan pengguna yang tidak peka huruf besar/kecil. Jika Anda tidak menentukan nilai, CaseSensitive defaultnya adalah. true Kumpulan pengguna yang Anda buat di konsol Amazon Cognito tidak peka huruf besar/kecil. Untuk menghasilkan kumpulan pengguna yang peka huruf besar/kecil, Anda harus menggunakan CreateUserPool operasi. Sebelum 12 Februari 2020, kumpulan pengguna secara default peka huruf besar/kecil terlepas dari platformnya.

Di Sign-in menu Konsol Manajemen AWS dan di UsernameConfiguration properti DescribeUserPool, Anda dapat meninjau pengaturan sensitivitas huruf besar/kecil untuk setiap kumpulan pengguna di akun Anda.

Bermigrasi ke kumpulan pengguna baru

Karena potensi konflik antar profil pengguna, Anda tidak dapat mengubah kumpulan pengguna Amazon Cognito dari peka huruf besar/kecil menjadi tidak peka huruf besar/kecil. Sebagai gantinya, migrasikan pengguna Anda ke kumpulan pengguna baru. Anda harus membuat kode migrasi untuk menyelesaikan konflik terkait kasus. Kode ini harus mengembalikan pengguna baru yang unik atau menolak upaya masuk saat mendeteksi konflik. Di kumpulan pengguna yang tidak peka huruf besar/kecil baru, tetapkan a. Memigrasi pengguna pemicu Lambda AWS Lambda Fungsi ini dapat membuat pengguna di kumpulan pengguna yang tidak peka huruf besar-kecil yang baru. Ketika pengguna gagal masuk dengan kumpulan pengguna yang tidak peka huruf besar-kecil, fungsi Lambda menemukan dan menduplikasi pengguna dari kumpulan pengguna yang peka huruf besar-kecil. Anda juga dapat mengaktifkan pemicu Lambda pengguna migrasi pada ForgotPassword peristiwa. Amazon Cognito meneruskan informasi pengguna dan metadata peristiwa dari tindakan masuk atau pemulihan kata sandi ke fungsi Lambda Anda. Anda dapat menggunakan data peristiwa untuk mengelola konflik antara nama pengguna dan alamat email saat fungsi Anda membuat pengguna baru di kumpulan pengguna yang tidak peka huruf besar/kecil. Konflik ini terjadi antara nama pengguna dan alamat email yang akan unik dalam kumpulan pengguna yang peka huruf besar-kecil, tetapi identik dalam kumpulan pengguna yang tidak peka huruf besar-kecil.

Untuk informasi selengkapnya tentang cara menggunakan pemicu Lambda pengguna migrasi antara kumpulan pengguna Amazon Cognito, lihat Migrasi Pengguna ke kumpulan pengguna Amazon Cognito di blog. AWS