View a markdown version of this page

Menggunakan penyedia identitas sosial dengan kumpulan pengguna - Amazon Cognito
Menyiapkan aplikasi pengembangKonfigurasikan kumpulan pengguna AndaUji login sosial

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

Menggunakan penyedia identitas sosial dengan kumpulan pengguna

Pengguna web dan aplikasi seluler Anda dapat masuk melalui penyedia identitas (IdP) sosial seperti Facebook, Google, Amazon, dan Apple. Dengan UI web yang di-host bawaan, Amazon Cognito menyediakan penanganan dan pengelolaan token untuk semua pengguna yang diautentikasi. Dengan cara ini, sistem backend Anda dapat melakukan standarisasi pada satu set token kumpulan pengguna. Anda harus mengaktifkan login terkelola untuk berintegrasi dengan penyedia identitas sosial yang didukung. Saat Amazon Cognito membuat halaman login terkelola Anda, Amazon Cognito menciptakan titik akhir OAuth 2.0 yang digunakan Amazon Cognito dan OIDC dan sosial Anda untuk bertukar informasi. IdPs Untuk informasi selengkapnya, lihat referensi API Auth kumpulan pengguna Amazon Cognito.

Anda dapat menambahkan IdP sosial di Konsol Manajemen AWS, atau Anda dapat menggunakan AWS CLI atau Amazon Cognito API.

catatan

Sign-in melalui pihak ketiga (federasi) tersedia di kumpulan pengguna Amazon Cognito. Fitur ini independen dari federasi melalui kolam identitas Amazon Cognito (identitas federasi).

Menyiapkan akun dan aplikasi pengembang 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.

Facebook

Untuk informasi terbaru tentang konfigurasi akun pengembang Meta dan otentikasi, lihat Pengemb angan Aplikasi Meta.

Cara mendaftarkan aplikasi dengan Facebook/Meta

  1. Buat sebuah akun developer dengan Facebook.

  2. Masuk dengan kredensial Facebook Anda.

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

  4. Masukkan nama untuk aplikasi Facebook Anda, lalu pilih Buat ID Aplikasi.

  5. Di bilah navigasi kiri, pilih Peng aturan, lalu Dasar.

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

  7. Pilih + Tambahkan Platform dari bagian bawah halaman.

  8. Pilih Situs Web.

  9. Di bawah Situs Web, masukkan jalur ke halaman masuk untuk aplikasi Anda ke URL Situs.

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

  10. Pilih Simpan perubahan.

  11. Masukkan jalur ke root domain kumpulan pengguna Anda ke Domain Aplikasi.

    https://mydomain.auth.us-east-1.amazoncognito.com

  12. Pilih Simpan perubahan.

  13. Dari bilah navigasi pilih Tambahkan Produk dan pilih Atur untuk produk Login Facebook.

  14. Dari bilah navigasi pilih Facebook Login dan kemudian Pengaturan.

    Masukkan jalur ke titik akhir untuk domain /oauth2/idpresponse kumpulan pengguna Anda ke URI Pengalihan O Auth yang Valid. 

    
https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/idpresponse

  15. Pilih Simpan perubahan.

Login with Amazon

Untuk informasi terbaru tentang konfigurasi Login dengan akun pengembang Amazon dan otentikasi, lihat Login dengan Dokumentasi Amazon.

Cara mendaftarkan aplikasi dengan Login 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 URL Pemberitahuan Priv asi Persetujuan.

  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 Asal yang Diizinkan.

    https://mydomain.auth.us-east-1.amazoncognito.com

  10. Masukkan domain kumpulan pengguna Anda dengan /oauth2/idpresponse titik akhir ke URL Pengem balian yang Diizinkan.

    https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/idpresponse

  11. Pilih Simpan.

Google

Untuk informasi selengkapnya tentang OAuth 2.0 di platform Google Cloud, lihat Pel ajari tentang otentikasi & otorisasi di dokumentasi Google Workspace for Developers.

Cara mendaftarkan aplikasi dengan Google

  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 PROYEK BARU.

  5. Masukkan nama untuk produk Anda, lalu pilih BUAT.

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

  7. Masukkan informasi Aplikasi, domain Aplikasi, Domain resmi, dan informasi kontak Pengembang. Domain resmi Anda harus amazoncognito.com menyertakan dan root domain kustom Anda, misalnyaexample.com. Pilih SIMPAN DAN LANJUTKAN.

  8. 1. Di bawah C akupan, pilih Tam bah atau hapus cakupan, dan pilih, minimal, cakupan OAuth berikut.

    1. .../auth/userinfo.email

    2. .../auth/userinfo.profile

    3. openid

  9. Di bawah Uji pengguna, pilih Tambah pengguna. Masukkan alamat email Anda dan pengguna pengujian resmi lainnya, lalu pilih SIMPAN DAN LANJUTKAN.

  10. Perluas lagi bilah navigasi kiri, lalu pilih API dan Layanan, lalu Kre densi.

  11. Pilih BUAT KREDENSIAL, lalu ID klien OAuth.

  12. Pilih jenis Aplikasi dan beri klien Anda Nama.

  13. Di bawah A JavaScript sal resmi, pilih TAMBAHKAN URI. Masukkan domain kumpulan pengguna Anda.

    https://mydomain.auth.us-east-1.amazoncognito.com

  14. Di bawah URI pengalihan resmi, pilih TAMBAHKAN URI. Masukkan jalur ke /oauth2/idpresponse titik akhir domain kumpulan pengguna Anda.

    https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/idpresponse

  15. Pilih BUAT.

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

Sign in with Apple

Untuk informasi terbaru tentang pengaturan Masuk dengan Apple, lihat Mengon figurasi Lingkungan Anda untuk Masuk dengan Apple di dokumentasi Pengembang Apple.

Cara mendaftarkan aplikasi dengan Masuk dengan Apple (SIWA)

  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 Pengidentifikasi Baru, pilih ID Aplikasi, lalu pilih Lanjutkan.

  7. Pada halaman Pilih jenis, pilih Aplikasi, lalu pilih L anjutkan.

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

    1. Di bawah Deskripsi, masukkan deskripsi.

    2. Di bawah App ID Awal an, masukkan ID Bundle. Catat nilai di bawah App ID Prefix. Anda akan menggunakan nilai ini setelah memilih Apple sebagai penyedia identitas Anda diKonfigurasikan kumpulan pengguna Anda dengan IdP sosial.

    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 ID Aplikasi lainnya, lalu pilih S impan.

    5. Pilih Lanjutkan.

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

  10. Pada halaman Pengidentifikasi, pilih ikon +.

  11. Pada halaman Daftarkan Pengidentifikasi Baru, pilih ID Layanan, lalu pilih Lanjutkan.

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

    1. Di bawah Deskripsi, ketikkan deskripsi.

    2. Di bawah Pengidentifikasi, ketikkan pengidentifikasi. Buat catatan dari ID Layanan ini karena Anda akan memerlukan nilai ini setelah Anda memilih Apple sebagai penyedia identitas di Konfigurasikan kumpulan pengguna Anda dengan IdP sosial.

    3. Pilih Lanjutkan, lalu Daftar.

  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 URL Situs Web.

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

      mydomain.auth.us-east-1.amazoncognito.com

    5. Di bawah URL Return, masukkan jalur ke /oauth2/idpresponse titik akhir domain kumpulan pengguna Anda.

      https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/idpresponse

    6. Pilih Berikutnya, lalu Sel esai. Anda tidak perlu memverifikasi domain.

    7. Pilih Lanjutkan, lalu pilih S impan.

  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 Konfigurasi Kunci dan 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 dan catat ID K unci yang ditampilkan, lalu pilih Sel esai. Anda akan membutuhkan kunci privat ini dan nilai ID Kunci yang ditampilkan di halaman ini setelah Anda memilih Apple sebagai penyedia identitas di Konfigurasikan kumpulan pengguna Anda dengan IdP sosial.

Konfigurasikan kumpulan pengguna Anda dengan IdP sosial

Untuk mengkonfigurasi IdP sosial kumpulan pengguna dengan Konsol Manajemen AWS

  1. Masuk ke Konsol Amazon Cognito. Jika diminta, masukkan AWS kredensi Anda.

  2. Pilih Kumpulan Pengguna.

  3. Pilih kumpulan pengguna yang ada dari daftar atau buat kumpulan pengguna.

  4. Pilih menu Penyedia sosial dan eksternal, lalu pilih Tambahkan penyedia identitas.

  5. Pilih IdP sosial: Facebook, Google, Mas uk dengan Amazon, atau Mas uk dengan Apple.

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

    • Google dan Masuk dengan Amazon — Masukkan ID klien aplikasi dan rahasia klien aplikasi yang dibuat di bagian sebelumnya.

    • Facebook — Masukkan ID klien aplikasi dan rahasia klien aplikasi yang dihasilkan di bagian sebelumnya, lalu pilih versi API (misalnya, versi 2.12). Kami menyarankan Anda memilih versi terbaru yang mungkin, karena setiap API Facebook memiliki siklus hidup dan tanggal penghentian. Cakupan dan atribut Facebook dapat bervariasi antara versi API. Kami menyarankan Anda menguji identitas sosial Anda masuk dengan Facebook untuk memastikan bahwa federasi berfungsi seperti yang Anda inginkan.

    • Masuk dengan Apple — Masukkan ID Layanan, ID Tim, ID Kunci, dan kunci pribadi yang dihasilkan 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 untuk memberikan atribut ini ke aplikasi Anda. Untuk informasi selengkapnya tentang cakupan penyedia sosial, lihat dokumentasi dari Google, Facebook, Masuk dengan 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 (bisa dari kegagalan internal dalam Amazon Cognito atau apa pun yang ditulis oleh pengembang)

    • Pengidentifikasi ID layanan digunakan di seluruh kumpulan pengguna layanan otentikasi and/or lainnya

    • Developer menambahkan cakupan tambahan setelah pengguna akhir masuk sebelumnya (tidak ada informasi baru yang diambil)

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

  8. Petakan atribut dari IdP Anda ke kumpulan pengguna Anda. Untuk informasi selengkapnya, lihat Menentukan Pemetaan Atribut Penyedia Identitas untuk Kolam Pengguna Anda.

  9. Pilih Buat.

  10. Dari menu Klien aplikasi, pilih klien aplikasi dari daftar. Untuk menambahkan penyedia identitas sosial baru ke klien aplikasi, navigasikan ke tab Halaman masuk dan pilih Edit pada konfigurasi halaman login terkelola.

  11. Pilih Simpan perubahan.

Menguji konfigurasi IdP sosial Anda

Dalam aplikasi Anda, Anda harus memanggil browser di klien pengguna sehingga mereka dapat masuk dengan penyedia sosial mereka. Uji login dengan penyedia layanan sosial Anda setelah Anda menyelesaikan prosedur penyiapan di bagian sebelumnya. URL contoh berikut memuat halaman masuk untuk kumpulan pengguna Anda dengan domain awalan.


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

Tautan ini adalah halaman yang diarahkan Amazon Cognito ketika Anda membuka menu Klien aplikasi, pilih klien aplikasi, navigasikan ke tab Halaman masuk, dan pilih Lihat halaman login. Untuk informasi selengkapnya tentang domain kumpulan pengguna, lihatMengkonfigurasi domain kumpulan pengguna. Untuk informasi selengkapnya tentang klien aplikasi, termasuk ID klien dan URL panggilan balik, lihatPengaturan khusus aplikasi dengan klien aplikasi.

Contoh tautan berikut mengatur pengalihan diam ke penyedia sosial dari parameter Otorisasi titik akhir dengan identity_provider kueri. URL ini melewati login kumpulan pengguna interaktif dengan login terkelola dan langsung menuju ke halaman masuk IdP.


https://mydomain.auth.us-east-1.amazoncognito.com/oauth2/authorize?identity_provider=Facebook|Google|LoginWithAmazon|SignInWithApple&response_type=code&client_id=1example23456789&redirect_uri=https://www.example.com