

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

# Sensitivitas casing kumpulan pengguna
<a name="user-pool-case-sensitivity"></a>

Kumpulan pengguna Amazon Cognito yang Anda buat secara default tidak peka huruf besar/kecil. Konsol Manajemen AWS 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` and juga tidak peka huruf besar/kecil.

Ketidakpekaan kasus berlaku tidak hanya untuk input atribut, tetapi juga output. Nilai atribut huruf campuran dalam kumpulan pengguna yang tidak peka huruf kecil diratakan menjadi huruf kecil dalam output teks kumpulan pengguna. [Contoh output teks kumpulan pengguna adalah respons [UserInfo](userinfo-endpoint.md), respons kueri pengguna seperti keluaran [GetUser](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_GetUser.html), dan peristiwa masukan ke pemicu Lambda.](cognito-user-pools-working-with-lambda-triggers.md)

Untuk memperhitungkan setelan sensitivitas huruf besar kumpulan pengguna, identifikasi pengguna dalam kode aplikasi Anda berdasarkan atribut pengguna alternatif. Karena kasus nama pengguna, nama pengguna yang disukai, 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, 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 kasus kumpulan pengguna Anda, Amazon Cognito mengharuskan pengguna gabungan dari penyedia identitas SAMP atau OIDC (iDP) meneruskan klaim atau unik dan peka huruf besar/kecil. `NameId` `sub` Untuk informasi selengkapnya tentang sensitivitas kasus pengenal unik dan SAMP IdPs, lihat. [Menerapkan masuk SAMP yang diinitasikan SP](cognito-user-pools-SAML-session-initiation.md#cognito-user-pools-saml-idp-authentication)

Membuat kumpulan pengguna yang peka huruf besar/kecil  
Jika Anda membuat resource dengan operasi AWS Command Line Interface (AWS CLI) dan API seperti [CreateUserPool](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateUserPool.html), Anda harus menyetel `CaseSensitive` parameter Boolean ke`false`. Pengaturan ini membuat kumpulan pengguna yang tidak peka huruf besar/kecil. Jika Anda tidak menentukan nilai, `CaseSensitive` defaultnya. `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 operasi. `CreateUserPool` Sebelum 12 Februari 2020, kumpulan pengguna default menjadi peka huruf besar/kecil terlepas dari platformnya.   
Di menu **Masuk** Konsol Manajemen AWS dan di `UsernameConfiguration` properti [DescribeUserPool](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_UserPoolType.html#CognitoUserPools-Type-UserPoolType-UsernameConfiguration), Anda dapat meninjau pengaturan sensitivitas kasus untuk setiap kumpulan pengguna di akun Anda.

Migrasi 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, memigrasikan 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 baru yang tidak peka huruf besar/kecil, tetapkan file. [Memigrasi pengguna pemicu Lambda](user-pool-lambda-migrate-user.md) AWS Lambda Fungsi ini dapat membuat pengguna di kumpulan pengguna baru yang tidak peka huruf besar/kecil. 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 [ForgotPassword](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_ForgotPassword.html)Lambda pengguna yang bermigrasi pada acara. 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 antara nama pengguna dan alamat email yang unik di 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 yang bermigrasi di antara kumpulan pengguna Amazon Cognito, [lihat Memigrasi Pengguna ke kumpulan pengguna Amazon Cognito](https://aws.amazon.com/blogs/mobile/migrating-users-to-amazon-cognito-user-pools/) di blog. AWS 