Mengelola dan mencari akun pengguna

Setelah membuat kolam pengguna, Anda dapat melihat dan mengelola pengguna menggunakan AWS Management Console, serta AWS Command Line Interface atau API Amazon Cognito. Topik ini menjelaskan bagaimana Anda dapat melihat dan mencari pengguna menggunakan AWS Management Console.

Melihat atribut pengguna

Gunakan prosedur berikut untuk melihat atribut pengguna di konsol Amazon Cognito.

Untuk melihat atribut pengguna

1. Masuk ke Konsol Amazon Cognito. Jika diminta, masukkanAWSkredensi.

2. PilihKolam Pengguna.

3. Pilih kumpulan pengguna yang ada dari daftar.

4. PilihPenggunatab, dan kemudian pilih pengguna dalam daftar.

5. Pada halaman detail pengguna, di bawahAtribut 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. Jika diminta, masukkanAWSkredensi.

2. PilihKolam Pengguna.

3. Pilih kumpulan pengguna yang ada dari daftar.

4. PilihPenggunatab, dan kemudian pilih pengguna dalam daftar.

5. Pada halaman detail pengguna, pilihTindakan,Setel ulang kata sandi.

6. DalamSetel ulang kata sandidialog, tinjau informasi dan ketika siap, pilihSetel ulang.

   Tindakan ini segera menghasilkan kode konfirmasi yang dikirim ke pengguna dan menonaktifkan kata sandi pengguna saat ini dengan mengubah status pengguna menjadiRESET_REQUIRED. TheSetel ulang kata sandikode berlaku selama 1 jam.

Mencari atribut pengguna

Jika Anda telah membuat kolam pengguna, Anda dapat mencari dari panel Pengguna di AWS Management Console. Anda juga dapat menggunakan Amazon CognitoListUsersAPI, yang menerimaFilterparameter.

Anda dapat mencari salah satu dari atribut standar berikut. Atribut kustom tidak dapat dicari.

• nama pengguna (peka huruf besar/kecil)

• email

• phone_number

• nama

• given_name

• family_name

• preferred_username

• cognito:user_status (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--queryparameter darilist-usersaksi diAWS Command Line Interface. Saat Anda menggunakan filter sisi klien,ListUsersmengembalikan daftar paginasi dari 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, lihatPenyaringanAWS CLIkeluarandiAWS Command Line InterfacePanduan Pengguna.

Mencari pengguna denganAWS Management Console

Jika Anda telah membuat kolam pengguna, Anda dapat mencari dari panel Pengguna di AWS Management Console.

Pencarian AWS Management Console selalu merupakan awalan pencarian ("dimulai dengan").

Untuk mencari pengguna di konsol Amazon Cognito

1. Masuk ke Konsol Amazon Cognito. Anda mungkin diminta untuk kredensial AWS Anda.

2. PilihKolam Pengguna.

3. Pilih kumpulan pengguna yang ada dari daftar.

4. PilihPenggunatab, lalu masukkan nama pengguna 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, sepertiEmail,Nomor telepon, atauNama belakang.

Mencari pengguna denganListUsersAPI

Untuk mencari pengguna dari aplikasi Anda, gunakan Amazon CognitoListUsersAPI. 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 sertakanAttributesToGetparameter atau permintaanAttributesToGetdengan nilai string literalnull.

• 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 menggunakanListUsersAPI

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 "+1312" 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"
}