Tambahkan login sosial ke kumpulan pengguna (opsional)

Anda dapat mengaktifkan pengguna aplikasi Anda untuk masuk melalui penyedia identitas (IdP) sosial seperti Facebook, Google, Amazon, dan Apple. Apakah pengguna Anda masuk secara langsung atau melalui pihak ketiga, semua pengguna memiliki profil di kolam pengguna. Lewati langkah ini jika Anda tidak ingin menambahkan masuk melalui penyedia identitas masuk sosial.

Daftar dengan iDP sosial

Sebelum Anda membuat IdP sosial dengan Amazon Cognito, Anda harus mendaftarkan aplikasi Anda dengan IdP sosial untuk menerima ID klien dan rahasia klien.

Untuk mendaftarkan aplikasi dengan Facebook

1. Buat sebuah akun developer dengan Facebook.

2. Masuk dengan kredensial Facebook Anda.

3. Dari menu Aplikasi Saya, pilih Buat Aplikasi Baru.

   Jika Anda tidak memiliki aplikasi Facebook yang ada, Anda akan melihat opsi yang berbeda. Pilih Buat Aplikasi.

4. Pada halaman Buat aplikasi, pilih kasus penggunaan untuk aplikasi Anda, lalu pilih Berikutnya.

5. Masukkan nama untuk aplikasi Facebook Anda dan pilih Buat Aplikasi.

6. Di bilah navigasi kiri, pilih Pengaturan Aplikasi, lalu pilih Dasar.

7. Perhatikan ID Aplikasi dan Rahasia Aplikasi. Anda akan menggunakannya di bagian selanjutnya.

8. Pilih + Tambahkan platform dari bagian bawah halaman.

9. Pada layar Pilih Platform, pilih platform Anda, lalu pilih Berikutnya.

10. Pilih Simpan perubahan.

11. Untuk Domain Aplikasi, masukkan domain kumpulan pengguna Anda.

    https://your_user_pool_domain

12. Pilih Simpan perubahan.

13. Dari bilah navigasi, pilih Produk, lalu pilih Konfigurasi dari Login Facebook.

14. Dari menu Konfigurasi Login Facebook, pilih Pengaturan.

    Masukkan pengalihan Anda URL ke Pengalihan yang Valid OAuth. URIs Pengalihan URL terdiri dari domain kumpulan pengguna Anda dengan titik /oauth2/idpresponse akhir.

    https://your_user_pool_domain/oauth2/idpresponse

15. Pilih Simpan perubahan.

Untuk mendaftarkan aplikasi dengan Amazon

1. Buat sebuah akun developer dengan Amazon.

2. Masuk dengan kredensial Amazon Anda.

3. Anda perlu untuk membuat profil keamanan Amazon untuk menerima ID klien dan rahasia klien Amazon.

   Pilih Aplikasi dan Layanan dari bilah navigasi di bagian atas halaman, lalu pilih Login with Amazon.

4. Pilih Buat Profil Keamanan.

5. Masukkan Nama Profil Keamanan, Deskripsi Profil Keamanan, dan Pemberitahuan Privasi Persetujuan URL.

6. Pilih Simpan.

7. Pilih ID Klien dan Rahasia Klien untuk menampilkan ID dan rahasia klien. Anda akan menggunakannya di bagian selanjutnya.

8. Arahkan kursor ke ikon roda gigi dan pilih Pengaturan Web, lalu pilih Edit.

9. Masukkan domain kumpulan pengguna Anda ke dalam Asal yang Diizinkan.

   https://<your-user-pool-domain>

10. Masukkan domain pool pengguna Anda dengan /oauth2/idpresponse titik akhir ke Return URLs yang Diizinkan.

    https://<your-user-pool-domain>/oauth2/idpresponse

11. Pilih Simpan.

Untuk mendaftarkan aplikasi dengan Google

Untuk informasi selengkapnya tentang OAuth 2.0 di platform Google Cloud, lihat Pelajari tentang autentikasi & otorisasi di dokumentasi Google Workspace for Developers.

1. Buat sebuah akun developer dengan Google.

2. Masuk ke konsol Google Cloud Platform.

3. Dari bilah navigasi atas, pilih Pilih proyek. Jika Anda sudah memiliki proyek di platform Google, menu ini menampilkan proyek default Anda sebagai gantinya.

4. Pilih NEWPROJECT.

5. Masukkan nama untuk produk Anda dan kemudian pilih CREATE.

6. Di bilah navigasi kiri, pilih APIsdan Layanan, lalu pilih layar persetujuan Oauth.

7. Masukkan informasi aplikasi, domain Aplikasi, domain Resmi, dan informasi kontak Pengembang. Domain resmi Anda harus menyertakan amazoncognito.com dan akar domain kustom Anda. Sebagai contoh: example.com. Pilih SAVEANDCONTINUE.

8. 1. Di bawah Lingkup, pilih Tambah atau hapus cakupan, lalu pilih, minimal, cakupan berikutOAuth.

   1. .../auth/userinfo.email

   2. .../auth/userinfo.profile

   3. openid

9. Di bawah Uji pengguna, pilih Tambahkan pengguna. Masukkan alamat email Anda dan pengguna uji resmi lainnya, lalu pilih SAVEANDCONTINUE.

10. Perluas bilah navigasi kiri lagi, pilih APIsdan Layanan, lalu pilih Kredensial.

11. Pilih CREATECREDENTIALS, lalu pilih ID OAuth klien.

12. Pilih jenis Aplikasi dan beri nama klien Anda.

13. Di bawah JavaScript Asal resmi, pilih ADDURI. Masukkan domain pool pengguna Anda.

    https://<your-user-pool-domain>

14. Di bawah Pengalihan resmi URIs, pilih ADDURI. Masukkan jalur ke /oauth2/idpresponse titik akhir domain kumpulan pengguna Anda.

    https://<your-user-pool-domain>/oauth2/idpresponse

15. Pilih CREATE.

16. Simpan nilai yang ditampilkan Google dengan aman di bawah ID klien Anda dan rahasia klien Anda. Berikan nilai ini ke Amazon Cognito saat Anda menambahkan Google iDP.

Untuk mendaftarkan aplikasi dengan Apple

Untuk informasi selengkapnya tentang pengaturan Masuk dengan Apple, lihat Mengonfigurasi Lingkungan Anda untuk Masuk dengan Apple di dokumentasi Pengembang Apple.

1. Buat sebuah akun developer dengan Apple.

2. Masuk dengan kredensial Apple Anda.

3. Di bilah navigasi kiri, pilih Sertifikat, Pengidentifikasi & Profil.

4. Di bilah navigasi sebelah kiri, pilih Pengidentifikasi.

5. Pada halaman Pengidentifikasi, pilih ikon +.

6. Pada halaman Daftarkan Pengenal Baru, pilih Aplikasi IDs, lalu pilih Lanjutkan.

7. Pada halaman Pilih jenis, pilih Aplikasi, lalu pilih Lanjutkan.

8. Pada halaman Daftarkan ID Aplikasi, lakukan hal berikut:

   1. Di bawah Deskripsi, masukkan deskripsi.

   2. Di bawah Awalan ID Aplikasi, masukkan ID Bundel. Catat nilai di bawah Awalan ID Aplikasi. Anda akan menggunakan nilai ini setelah memilih Apple sebagai penyedia identitas AndaLangkah 2: Tambahkan iDP sosial ke kolam pengguna Anda.

   3. Pada Kemampuan, pilih Masuk dengan Apple, lalu pilih Edit.

   4. Pada halaman Masuk dengan Apple: Konfigurasi ID Aplikasi, pilih untuk mengatur aplikasi sebagai primer atau dikelompokkan dengan Aplikasi lainIDs, lalu pilih Simpan.

   5. Pilih Lanjutkan.

9. Pada halaman Konfirmasi ID Aplikasi Anda, pilih Daftarkan.

10. Pada halaman Pengidentifikasi, pilih ikon +.

11. Pada halaman Daftarkan Pengenal Baru, pilih Layanan IDs, lalu pilih Lanjutkan.

12. Pada halaman Daftarkan ID Layanan, lakukan hal berikut:

    1. Di bawah Deskripsi, masukkan deskripsi.

    2. Di bawah Identifier, masukkan pengenal. Catat ID Layanan ini karena Anda memerlukan nilai ini setelah memilih Apple sebagai penyedia identitas AndaLangkah 2: Tambahkan iDP sosial ke kolam pengguna Anda.

    3. Pilih Lanjutkan, lalu pilih Daftarkan.

13. Pilih ID Layanan yang baru saja Anda buat dari halaman Pengidentifikasi.

    1. Pilih Masuk dengan Apple, lalu pilih Konfigurasi.

    2. Pada halaman Konfigurasi Otentikasi Web, pilih ID aplikasi yang Anda buat sebelumnya sebagai ID Aplikasi Utama.

    3. Pilih ikon + di sebelah Situs Web URLs.

    4. Di bawah Domain dan subdomain, masukkan domain kumpulan pengguna Anda tanpa awalan. https://

       <your-user-pool-domain>

    5. Di bawah Return URLs, masukkan path ke /oauth2/idpresponse endpoint domain pool pengguna Anda.

       https://<your-user-pool-domain>/oauth2/idpresponse

    6. Pilih Berikutnya, lalu pilih Selesai. Anda tidak perlu memverifikasi domain.

    7. Pilih Lanjutkan, lalu pilih Simpan.

14. Di bilah navigasi sebelah kiri, pilih Kunci.

15. Pada halaman Kunci, pilih ikon +.

16. Pada halaman Daftarkan Kunci Baru, lakukan hal berikut:

    1. Di bawah Nama Kunci, masukkan nama kunci.

    2. Pilih Masuk dengan Apple, lalu pilih Konfigurasi.

    3. Pada halaman Configure Key, pilih ID aplikasi yang Anda buat sebelumnya sebagai ID Aplikasi Utama. Pilih Simpan.

    4. Pilih Lanjutkan, lalu pilih Daftarkan.

17. Pada halaman Unduh Kunci Anda, pilih Unduh untuk mengunduh kunci pribadi, catat ID Kunci yang ditampilkan, lalu pilih Selesai. Anda akan membutuhkan kunci privat ini dan nilai ID Kunci yang ditampilkan di halaman ini setelah Anda memilih Apple sebagai penyedia identitas di Langkah 2: Tambahkan iDP sosial ke kolam pengguna Anda.

Tambahkan iDP sosial ke kumpulan pengguna Anda

Di bagian ini, Anda mengonfigurasi IdP sosial di kolam pengguna Anda menggunakan ID klien dan rahasia klien dari bagian sebelumnya.

Untuk mengonfigurasi penyedia identitas sosial kumpulan pengguna dengan AWS Management Console

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

2. Pilih Kolam Pengguna.

3. Pilih kolam pengguna yang ada dari daftar, atau buat kolam pengguna.

4. Pilih tab Pengalaman masuk. Cari Masuk Federasi dan pilih Tambahkan penyedia identitas.

5. Pilih penyedia identitas sosial: Facebook, Google, Login with Amazon, atau Masuk dengan Apple.

6. Pilih dari langkah-langkah berikut, berdasarkan pilihan penyedia identitas sosial Anda:

   • Google dan Login with Amazon — Masukkan ID klien aplikasi dan rahasia klien aplikasi yang dihasilkan di bagian sebelumnya.

   • Facebook — Masukkan ID klien aplikasi dan rahasia klien aplikasi yang dihasilkan di bagian sebelumnya, lalu pilih API versi (misalnya, versi 2.12). Sebaiknya pilih versi terbaru yang mungkin—setiap Facebook API memiliki siklus hidup dan tanggal penghentian. Lingkup dan atribut Facebook dapat bervariasi antar API versi. Kami merekomendasikan pengujian login identitas sosial Anda dengan Facebook untuk memastikan bahwa federasi berfungsi sebagaimana dimaksud.

   • Masuk dengan Apple — Masukkan ID Layanan, ID Tim, ID Kunci, dan kunci pribadi yang dibuat di bagian sebelumnya.

7. Masukkan nama cakupan Resmi yang ingin Anda gunakan. Cakupan menentukan atribut pengguna (seperti name dan email) mana yang ingin Anda akses dengan aplikasi Anda. Untuk Facebook, ini harus dipisahkan dengan koma. Untuk Google dan Login with Amazon, mereka harus dipisahkan dengan spasi. Untuk Masuk dengan Apple, pilih kotak centang untuk cakupan yang ingin Anda akses.

   Penyedia identitas sosial	Contoh cakupan
   Facebook	public_profile, email
   Google	profile email openid
   Login with Amazon	profile postal_code
   Masuk dengan Apple	email name

   Pengguna aplikasi Anda diminta untuk menyetujui penyediaan atribut ini ke aplikasi Anda. Untuk informasi selengkapnya tentang cakupan penyedia sosial, lihat dokumentasi dari Google, Facebook, Login with Amazon, atau Masuk dengan Apple.

   Dengan Masuk dengan Apple, berikut ini adalah skenario pengguna di mana cakupan mungkin tidak dikembalikan:

   • Pengguna akhir mengalami kegagalan setelah meninggalkan halaman masuk Apple (ini bisa dari kegagalan internal dalam Amazon Cognito atau apa pun yang ditulis oleh pengembang).

   • Pengenal ID layanan digunakan di seluruh kumpulan pengguna dan/atau layanan otentikasi lainnya.

   • Pengembang menambahkan cakupan tambahan setelah pengguna masuk. Pengguna hanya mengambil informasi baru ketika mereka mengautentikasi dan ketika mereka menyegarkan token mereka.

   • Pengembang menghapus pengguna dan kemudian pengguna masuk lagi tanpa menghapus aplikasi dari profil ID Apple mereka.

8. Petakan atribut dari penyedia identitas Anda ke kumpulan pengguna Anda. Untuk informasi selengkapnya, lihat Hal yang perlu diketahui tentang pemetaan.

9. Pilih Buat.

10. Dari tab Integrasi klien aplikasi, pilih salah satu klien Aplikasi dalam daftar dan Edit pengaturan UI yang dihosting. Tambahkan penyedia identitas sosial baru ke klien aplikasi di bawah Penyedia identitas.

11. Pilih Simpan perubahan.

Uji konfigurasi iDP sosial Anda

Anda dapat membuat login URL dengan menggunakan elemen dari dua bagian sebelumnya. Gunakan URL login itu untuk menguji konfigurasi IdP sosial Anda.

https://mydomain.us-east-1.amazoncognito.com/login?response_type=code&client_id=1example23456789&redirect_uri=https://www.example.com

Anda dapat menemukan domain Anda di halaman konsol Nama Domain kolam pengguna. client_id ada di halaman Pengaturan klien aplikasi. Gunakan callback Anda URL untuk parameter redirect_uri. Ini adalah halaman di mana pengguna Anda akan diarahkan setelah otentikasi berhasil. URL

catatan

Amazon Cognito membatalkan permintaan otentikasi yang tidak selesai dalam 5 menit, dan mengarahkan pengguna ke UI yang dihosting. Halaman menampilkan pesan Something went wrong kesalahan.