Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengelola dan mencari akun pengguna
Kumpulan pengguna dapat berisi jutaan pengguna. Bekerja dengan kumpulan data sebesar ini merupakan tantangan bagi administrator. Amazon Cognito memiliki alat untuk menemukan dan memodifikasi profil pengguna. Metode teratas untuk menemukan pengguna adalah menu **Pengguna** dari konsol Amazon Cognito, dan dengan. [ListUsers](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_ListUsers.html) Dari metode yang mengambil informasi tentang pengguna, ini adalah opsi yang tidak memiliki dampak biaya tidak seperti, misalnya, [AdminGetUser](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminGetUser.html).
Bagian panduan ini memiliki informasi tentang menemukan dan memperbarui profil pengguna di kumpulan pengguna.
## Melihat atribut pengguna
Gunakan prosedur berikut untuk melihat atribut pengguna di konsol Amazon Cognito.
**Untuk melihat atribut pengguna**
1. Masuk ke [Konsol Amazon Cognito](https://console.aws.amazon.com/cognito/home). Jika diminta, masukkan AWS kredensialnya.
1. Pilih **Kolam Pengguna**.
1. Pilih kumpulan pengguna yang ada dari daftar.
1. Pilih menu **Pengguna** dan pilih pengguna dalam daftar.
1. Pada halaman detail pengguna, di bawah **atribut Pengguna**, Anda dapat melihat atribut mana yang terkait dengan pengguna.
## Menyetel ulang kata sandi pengguna
Gunakan prosedur berikut untuk mengatur ulang kata sandi pengguna di konsol Amazon Cognito.
**Untuk mengatur ulang kata sandi pengguna**
1. Masuk ke [Konsol Amazon Cognito](https://console.aws.amazon.com/cognito/home). Jika diminta, masukkan AWS kredensialnya.
1. Pilih **Kolam Pengguna**.
1. Pilih kumpulan pengguna yang ada dari daftar.
1. Pilih menu **Pengguna** dan pilih pengguna dalam daftar.
1. Pada halaman detail pengguna, pilih **Tindakan**, **Setel ulang kata sandi**.
1. Dalam dialog **Setel ulang kata sandi**, tinjau informasi dan ketika siap, pilih **Atur ulang**.
Tindakan ini segera menghasilkan kode konfirmasi yang dikirim ke pengguna dan menonaktifkan kata sandi pengguna saat ini dengan mengubah status pengguna menjadi`RESET_REQUIRED`. Kode **Reset password** berlaku selama 1 jam.
## Mengaktifkan, menonaktifkan, dan menghapus akun pengguna
Anda dapat menghapus profil pengguna yang tidak digunakan atau, jika Anda ingin mencegah akses sementara, nonaktifkan mereka. Pengguna dapat menghapus akun mereka sendiri, tetapi hanya administrator kumpulan pengguna yang dapat mengaktifkan dan menonaktifkan akun pengguna.
**Pengaruh penghapusan**
Pengguna tidak dapat masuk dengan akun pengguna yang dihapus dan untuk mendapatkan kembali akses, harus mendaftar atau dibuat lagi.
**Efek menonaktifkan akun**
[Saat Anda menonaktifkan akun pengguna, Amazon Cognito secara otomatis membatalkan semua sesi yang diautentikasi, menonaktifkan akun pengguna untuk masuk, dan mencabut akses dan penyegaran token mereka.](token-revocation.md) Amazon Cognito mengembalikan `invalid_request` kesalahan dengan pesan `User is not enabled` saat pengguna mencoba masuk ke akun yang Anda nonaktifkan. Perilaku ini tidak berubah dengan [setelan pengungkapan keberadaan pengguna](cognito-user-pool-managing-errors.md) Anda untuk klien aplikasi. Anda dapat menonaktifkan akun pengguna lokal dan profil lokal akun pengguna federasi. Ketika pengguna masuk dengan login terkelola atau UI yang dihosting klasik, maka Anda menonaktifkan akun mereka, dan kemudian mereka mencoba masuk lagi dengan cookie browser yang mempertahankan sesi otentikasi mereka, Amazon Cognito mengarahkan mereka ke halaman login.
**Pengaruh mengaktifkan akun**
Pengguna dapat langsung masuk ke akun setelah Anda mengaktifkannya. Akun pengguna diaktifkan secara default. Atribut dan kata sandi pengguna tetap sama seperti sebelum akun mereka dinonaktifkan. Token yang dicabut aplikasi Anda, baik Anda menonaktifkan akun pengguna atau mencabut token penyegaran secara terpisah, tetap tidak valid setelah Anda mengaktifkan akun pengguna yang memiliki token tersebut.
------
#### [ Delete a user account (console) ]
**Untuk menghapus akun pengguna**
1. Masuk ke [Konsol Amazon Cognito](https://console.aws.amazon.com/cognito/home). Jika diminta, masukkan AWS kredensialnya.
1. Pilih **Kolam Pengguna**.
1. Pilih kumpulan pengguna yang ada dari daftar.
1. Pilih menu **Pengguna** dan pilih tombol radio di sebelah nama pengguna pengguna dalam daftar.
1. Pilih **Hapus**.
1. Pilih **Nonaktifkan akses pengguna**.
1. Pilih **Hapus**.
------
#### [ Delete a user account (API) ]
Pengguna dapat menghapus akun mereka dengan operasi access-token-authorized [DeleteUser](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_DeleteUser.html)API swalayan. Berikut ini adalah contoh badan `DeleteUser` permintaan.
```
{
"AccessToken": "eyJra456defEXAMPLE"
}
```
Administrator dapat menghapus akun pengguna dengan operasi API yang diotorisasi oleh IAM [AdminDeleteUser](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminDeleteUser.html). Berikut ini adalah contoh badan `AdminDeleteUser` permintaan.
```
{
"Username": "testuser",
"UserPoolId": "us-west-2_EXAMPLE"
}
```
------
#### [ Disable a user account (console) ]
**Untuk menonaktifkan akun pengguna**
1. Masuk ke [Konsol Amazon Cognito](https://console.aws.amazon.com/cognito/home). Jika diminta, masukkan AWS kredensialnya.
1. Pilih **Kolam Pengguna**.
1. Pilih kumpulan pengguna yang ada dari daftar.
1. Pilih menu **Pengguna** dan pilih nama pengguna pengguna dalam daftar.
1. Pada halaman detail pengguna, pilih **Tindakan**, **Nonaktifkan akses pengguna**.
1. Dalam dialog yang dibuat, pilih **Nonaktifkan**.
------
#### [ Disable a user account (API) ]
Administrator dapat menonaktifkan akun pengguna dengan operasi API yang diotorisasi oleh IAM [AdminDisableUser](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminDisableUser.html). Berikut ini adalah contoh badan `AdminDisableUser` permintaan.
```
{
"Username": "testuser",
"UserPoolId": "us-west-2_EXAMPLE"
}
```
------
#### [ Enable a user account (console) ]
**Untuk mengaktifkan akun pengguna**
1. Masuk ke [Konsol Amazon Cognito](https://console.aws.amazon.com/cognito/home). Jika diminta, masukkan AWS kredensialnya.
1. Pilih **Kolam Pengguna**.
1. Pilih kumpulan pengguna yang ada dari daftar.
1. Pilih menu **Pengguna** dan pilih nama pengguna pengguna dalam daftar.
1. Pada halaman detail pengguna, pilih **Tindakan**, **Aktifkan akses pengguna**.
1. Dalam dialog yang dibuat, pilih **Aktifkan**.
------
#### [ Enable a user account (API) ]
Administrator dapat mengaktifkan akun pengguna dengan operasi API yang diotorisasi oleh IAM [AdminEnableUser](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AdminEnableUser.html). Berikut ini adalah contoh badan `AdminEnableUser` permintaan.
```
{
"Username": "testuser",
"UserPoolId": "us-west-2_EXAMPLE"
}
```
------
## Mencari atribut pengguna
Jika Anda telah membuat kolam pengguna, Anda dapat mencari dari panel **Pengguna** di Konsol Manajemen AWS. **Anda juga dapat menggunakan Amazon Cognito [ListUsers API](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_ListUsers.html), yang menerima parameter Filter.**
Anda dapat mencari salah satu dari atribut standar berikut. Atribut kustom tidak dapat dicari.
+ nama pengguna (peka huruf besar/kecil)
+ email
+ phone\$1number
+ nama
+ given\$1name
+ family\$1name
+ preferred\$1username
+ cognito:user\$1status (dipanggil **Status** di konsol tersebut) (peka huruf besar/kecil)
+ status (disebut **Diaktifkan** di konsol tersebut) (peka huruf besar/kecil)
+ sub
**catatan**
Anda juga dapat membuat daftar pengguna dengan filter sisi klien. Filter sisi server cocok tidak lebih dari 1 atribut. Untuk pencarian lanjutan, gunakan filter sisi klien dengan `--query` parameter `list-users` tindakan di file. AWS Command Line Interface Saat Anda menggunakan filter sisi klien, ListUsers mengembalikan daftar paginasi nol atau lebih pengguna. Anda dapat menerima beberapa halaman berturut-turut dengan hasil nol. Ulangi kueri dengan setiap token pagination yang dikembalikan hingga Anda menerima nilai token pagination null, lalu tinjau hasil gabungannya.
[Untuk informasi selengkapnya tentang pemfilteran sisi server dan sisi klien, lihat Memfilter keluaran di Panduan Pengguna. AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-filter.html) AWS Command Line Interface
## Mencari pengguna dengan Konsol Manajemen AWS
Jika Anda telah membuat kolam pengguna, Anda dapat mencari dari panel **Pengguna** di Konsol Manajemen AWS.
Konsol Manajemen AWS pencarian selalu awalan (“dimulai dengan”) pencarian.
**Untuk mencari pengguna di konsol Amazon Cognito**
1. Masuk ke [Konsol Amazon Cognito](https://console.aws.amazon.com/cognito/home). Anda mungkin diminta untuk AWS kredensialnya.
1. Pilih **Kolam Pengguna**.
1. Pilih kumpulan pengguna yang ada dari daftar.
1. Pilih menu **Pengguna** dan masukkan nama pengguna di bidang pencarian. Perhatikan bahwa beberapa nilai atribut peka huruf besar/kecil (misalnya, **Nama Pengguna**).
Anda juga dapat menemukan pengguna dengan menyesuaikan filter pencarian untuk mempersempit cakupan ke properti pengguna lainnya, seperti **Email**, **Nomor telepon**, atau **Nama belakang**.
## Mencari pengguna dengan `ListUsers` API
[Untuk mencari pengguna dari aplikasi Anda, gunakan Amazon Cognito APIListUsers .](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_ListUsers.html) API ini menggunakan parameter berikut:
+ `AttributesToGet`: Sebuah array dari string, di mana setiap string adalah nama dari atribut pengguna yang akan dikembalikan untuk setiap pengguna dalam hasil pencarian. Untuk mengambil semua atribut, jangan sertakan `AttributesToGet` parameter atau permintaan `AttributesToGet` dengan nilai string `null` literal.
+ `Filter`: Sebuah string filter dari bentuk “`AttributeName` `Filter-Type` “`AttributeValue`“”. Tanda kutip dalam string filter harus diloloskan menggunakan karakter garis miring terbalik (`\`). Misalnya, `"family_name = \"Reddy\""`. Jika string filter kosong, `ListUsers` mengembalikan semua pengguna di kolam pengguna.
+ `AttributeName`: Nama atribut yang akan dicari. Anda hanya dapat mencari satu atribut dalam satu waktu.
**catatan**
Anda hanya dapat mencari atribut standar. Atribut kustom tidak dapat dicari. Ini karena hanya atribut terindeks yang dapat dicari, dan atribut khusus tidak dapat diindeks.
+ `Filter-Type`: Untuk pencocokan tepat, gunakan `=`, misalnya, `given_name = "Jon"`. Untuk kecocokan awalan ("dimulai dengan"), gunakan `^=`, misalnya, `given_name ^= "Jon"`.
+ `AttributeValue`: Nilai atribut yang harus dicocokkan untuk setiap pengguna.
+ `Limit`: Jumlah maksimum pengguna yang akan dikembalikan.
+ `PaginationToken`: Token untuk mendapatkan lebih banyak hasil dari pencarian sebelumnya. Amazon Cognito kedaluwarsa token pagination setelah satu jam.
+ `UserPoolId`: ID kolam pengguna untuk kolam pengguna tempat pencarian harus dilakukan.
Semua pencarian tidak peka huruf besar/kecil. Hasil pencarian diurutkan berdasarkan atribut yang diberi nama oleh string `AttributeName`, dalam urutan naik.
## Contoh menggunakan `ListUsers` API
Contoh berikut mengembalikan semua pengguna dan mencakup semua atribut.
```
{
"AttributesToGet": null,
"Filter": "",
"Limit": 10,
"UserPoolId": "us-east-1_samplepool"
}
```
Contoh berikut menampilkan semua pengguna yang nomor teleponnya dimulai dengan "\$11312" dan mencakup semua atribut.
```
{
"AttributesToGet": null,
"Filter": "phone_number ^= \"+1312\"",
"Limit": 10,
"UserPoolId": "us-east-1_samplepool"
}
```
Contoh berikut mengembalikan 10 pengguna pertama yang nama keluarganya "Reddy". Untuk setiap pengguna, hasil pencarian mencakup nama pengguna, nomor telepon, dan alamat email. Jika ada lebih dari 10 pengguna yang cocok di kolam pengguna, responsnya mencakup token pemberian nomor halaman.
```
{
"AttributesToGet": [
"given_name",
"phone_number",
"email"
],
"Filter": "family_name = \"Reddy\"",
"Limit": 10,
"UserPoolId": "us-east-1_samplepool"
}
```
Jika contoh sebelumnya mengembalikan token pemberian nomor halaman, contoh berikut mengembalikan 10 pengguna berikutnya yang cocok dengan string filter yang sama.
```
{
"AttributesToGet": [
"given_name",
"phone_number",
"email"
],
"Filter": "family_name = \"Reddy\"",
"Limit": 10,
"PaginationToken": "pagination_token_from_previous_search",
"UserPoolId": "us-east-1_samplepool"
}
```