View a markdown version of this page

Otentikasi dengan kumpulan pengguna Amazon Cognito - Amazon Cognito

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

Otentikasi dengan kumpulan pengguna Amazon Cognito

Amazon Cognito mencakup beberapa metode untuk mengautentikasi pengguna Anda. Pengguna dapat masuk dengan kata sandi dan WebAuthn kunci sandi. Amazon Cognito dapat mengirimi mereka kata sandi satu kali dalam email atau pesan SMS. Anda dapat menerapkan fungsi Lambda yang mengatur urutan tantangan dan respons Anda sendiri. Ini adalah aliran otentikasi. Dalam alur otentikasi, pengguna memberikan rahasia dan Amazon Cognito memverifikasi rahasia, kemudian mengeluarkan token web JSON (JWT) untuk aplikasi untuk diproses dengan pustaka OIDC. Bab ini menjelaskan cara mengonfigurasi kumpulan pengguna dan klien aplikasi Anda untuk berbagai alur otentikasi di berbagai lingkungan aplikasi. Ini mencakup opsi untuk penggunaan halaman login yang di-host dari login terkelola, dan untuk membangun logika dan front end Anda sendiri dalam AWS SDK.

Semua kumpulan pengguna, apakah Anda memiliki domain atau tidak, dapat mengautentikasi pengguna di API kumpulan pengguna. Jika Anda menambahkan domain ke kumpulan pengguna, Anda dapat menggunakan titik akhir kumpulan pengguna. API kumpulan pengguna mendukung berbagai model otorisasi dan alur permintaan untuk permintaan API.

Untuk memverifikasi identitas pengguna, Amazon Cognito mendukung alur otentikasi yang menggabungkan jenis tantangan selain kata sandi seperti email dan pesan SMS kata sandi dan kunci sandi satu kali.

Sebelum Anda mengonfigurasi detailnya, pilih pendekatan otentikasi yang sesuai dengan aplikasi Anda. Bantuan keputusan berikut merangkum dua titik masuk dan, dalam aplikasi yang dibuat khusus, dua alur masuk awal. Setiap opsi menautkan ke bagian detailnya.

Apakah Anda ingin Amazon Cognito meng-host halaman masuk, atau membuat front end Anda sendiri?

Jika Anda menginginkan jalur upaya terendah, gunakan login terkelola. Amazon Cognito menghosting halaman login, sign-out, dan reset kata sandi, dan aplikasi Anda memproses hasilnya dengan library relying-party OpenID Connect (OIDC). Login terkelola secara otomatis menyajikan metode otentikasi yang diizinkan oleh kumpulan pengguna dan konfigurasi klien aplikasi Anda.

Jika Anda ingin membuat UI sendiri dan mengontrol logika masuk, gunakan AWS SDK. Aplikasi Anda memanggil API kumpulan pengguna secara langsung dan Anda menerapkan logika tantangan-respons.

Dalam aplikasi yang dibuat khusus, apakah Anda mengumpulkan metode masuk dari pengguna, atau mendeklarasikannya di depan?

Pilih autentikasi berbasis pilihan (USER_AUTHalur) saat Anda ingin menawarkan kepada pengguna daftar metode masuk yang tersedia dan biarkan mereka memilih salah satunya. Alur ini adalah satu-satunya cara untuk menawarkan login tanpa kata sandi dan kunci sandi.

Pilih otentikasi berbasis klien ketika aplikasi Anda sudah tahu bagaimana pengguna akan masuk dan mendeklarasikan aliran di depan, misalnya. USER_SRP_AUTH Client-basedotentikasi adalah satu-satunya cara untuk menggunakan otentikasi khusus dan menyegarkan aliran token.

Prasyarat untuk otentikasi berbasis pilihan

Choice-based otentikasi berlaku untuk login terkelola dan AWS SDK. Untuk menggunakannya, tambahkan ALLOW_USER_AUTH alur autentikasi yang diizinkan dari klien aplikasi Anda. Metode tanpa kata sandi dan kunci sandi juga memerlukan domain login terkelola dan paket fitur di atas tingkat Lite (Essentials atau Plus).

Contoh sesi otentikasi

Diagram berikut dan panduan langkah demi langkah menggambarkan skenario khas di mana pengguna masuk ke aplikasi. Aplikasi contoh menyajikan pengguna dengan beberapa opsi masuk. Mereka memilih satu dengan memasukkan kredensialnya, memberikan faktor otentikasi tambahan, dan masuk.

Diagram alur yang menampilkan aplikasi yang meminta pengguna untuk memasukkan dan menandatanganinya dengan SDK. AWS

Bayangkan aplikasi dengan halaman masuk tempat pengguna dapat masuk dengan nama pengguna dan kata sandi, meminta kode satu kali dalam pesan email, atau memilih opsi sidik jari.

  1. Sign-in prompt: Aplikasi Anda menampilkan layar beranda dengan tombol Masuk.

  2. Permintaan masuk: Pengguna memilih Masuk. Dari cookie atau cache, aplikasi Anda mengambil nama pengguna mereka, atau meminta mereka untuk memasukkannya.

  3. Opsi permintaan: Aplikasi Anda meminta opsi masuk pengguna dengan permintaan InitiateAuth API dengan USER_AUTH alur, meminta metode login yang tersedia untuk pengguna.

  4. Kirim opsi masuk: Amazon Cognito merespons PASSWORD denganEMAIL_OTP,, dan. WEB_AUTHN Responsnya mencakup pengenal sesi untuk Anda putar ulang di respons berikutnya.

  5. Opsi tampilan: Aplikasi Anda menampilkan elemen UI bagi pengguna untuk memasukkan nama pengguna dan kata sandi mereka, mendapatkan kode satu kali, atau memindai sidik jari mereka.

  6. Pilih option/Enter kredensil: Pengguna memasukkan nama pengguna dan kata sandi mereka.

  7. Memulai otentikasi: Aplikasi Anda menyediakan informasi login pengguna dengan permintaan RespondToAuthChallenge API yang mengonfirmasi login nama pengguna dan kata sandi dan menyediakan nama pengguna dan kata sandi.

  8. Validasi kredensil: Amazon Cognito mengonfirmasi kredensitas pengguna.

  9. Tantangan tambahan: Pengguna memiliki otentikasi multi-faktor yang dikonfigurasi dengan aplikasi autentikator. Amazon Cognito mengembalikan tantangan. SOFTWARE_TOKEN_MFA

  10. Challenge prompt: Aplikasi Anda menampilkan formulir yang meminta kata sandi satu kali berbasis waktu (TOTP) dari aplikasi autentikator pengguna.

  11. Tantangan jawaban: Pengguna mengirimkan TOTP.

  12. Menanggapi tantangan: Dalam RespondToAuthChallenge permintaan lain, aplikasi Anda menyediakan TOTP pengguna.

  13. Validasi respons tantangan: Amazon Cognito mengonfirmasi kode pengguna dan menentukan bahwa kumpulan pengguna Anda dikonfigurasi untuk tidak mengeluarkan tantangan tambahan kepada pengguna saat ini.

  14. Token masalah: Amazon Cognito mengembalikan ID, mengakses, dan menyegarkan token web JSON (JWT). Otentikasi awal pengguna selesai.

  15. Token toko: Aplikasi Anda menyimpan token pengguna sehingga dapat mereferensikan data pengguna, mengotorisasi akses ke sumber daya, dan memperbarui token saat kedaluwarsa.

  16. Render konten resmi: Aplikasi Anda menentukan akses pengguna ke sumber daya berdasarkan identitas dan peran mereka, dan memberikan konten aplikasi.

  17. Akses konten: Pengguna masuk dan mulai menggunakan aplikasi.

  18. Minta konten dengan token kedaluwarsa: Kemudian, pengguna meminta sumber daya yang memerlukan otorisasi. Token cache pengguna telah kedaluwarsa.

  19. Refresh token: Aplikasi Anda membuat InitiateAuth permintaan dengan token penyegaran yang disimpan pengguna.

  20. Token masalah: Amazon Cognito mengembalikan ID baru dan mengakses JWT. Sesi pengguna disegarkan dengan aman tanpa permintaan tambahan untuk kredensil.

Anda dapat menggunakan AWS Lambda pemicu untuk menyesuaikan cara pengguna mengautentikasi. Pemicu ini mengeluarkan dan memverifikasi tantangan mereka sendiri sebagai bagian dari alur autentikasi.

Anda juga dapat menggunakan alur otentikasi admin untuk server back-end yang aman. Anda dapat menggunakan alur autentikasi migrasi pengguna untuk memungkinkan migrasi pengguna tanpa mengharuskan pengguna untuk mengatur ulang kata sandi mereka.