Mengelola dan mencari akun pengguna - Amazon Cognito
Melihat atribut penggunaMenyetel ulang kata sandi penggunaMencari atribut penggunaMencari pengguna dengan AWS Management ConsoleMencari pengguna dengan ListUsers APIContoh menggunakan ListUsers API

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 tab Pengguna di konsol Amazon Cognito, dan dengan. ListUsers Dari metode yang mengambil informasi tentang pengguna, ini adalah opsi yang tidak memiliki dampak biaya tidak seperti, misalnya, AdminGetUser.

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. Jika diminta, masukkan AWS kredensional Anda.

  2. Pilih Kolam Pengguna.

  3. Pilih kumpulan pengguna yang ada dari daftar.

  4. Pilih tab Pengguna, lalu pilih pengguna dalam daftar.

  5. 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. Jika diminta, masukkan AWS kredensional Anda.

  2. Pilih Kolam Pengguna.

  3. Pilih kumpulan pengguna yang ada dari daftar.

  4. Pilih tab Pengguna, lalu pilih pengguna dalam daftar.

  5. Pada halaman detail pengguna, pilih Tindakan, Setel ulang kata sandi.

  6. 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 menjadiRESET_REQUIRED. Kode Reset password 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 Cognito ListUsers API, 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_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 --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 AWS Command Line Interface

Mencari pengguna dengan AWS Management Console

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

AWS Management Console pencarian selalu awalan (“dimulai dengan”) pencarian.

Untuk mencari pengguna di konsol Amazon Cognito

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

  2. Pilih Kolam Pengguna.

  3. Pilih kumpulan pengguna yang ada dari daftar.

  4. Pilih tab Pengguna, 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, seperti Email, Nomor telepon, atau Nama belakang.

Mencari pengguna dengan ListUsers API

Untuk mencari pengguna dari aplikasi Anda, gunakan Amazon ListUsers APICognito. Ini API 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 "+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"
}