Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Sebagai alternatif untuk menggunakan peran dan kebijakan IAM atau otorisasi Lambda (sebelumnya dikenal sebagai otorisasi khusus), Anda dapat menggunakan kumpulan pengguna Amazon Cognito untuk mengontrol siapa yang dapat mengakses API Anda di Amazon API Gateway.
Untuk menggunakan kumpulan pengguna Amazon Cognito dengan API Anda, Anda harus terlebih dahulu membuat otorisasi COGNITO_USER_POOLS jenis tersebut dan kemudian mengonfigurasi metode API untuk menggunakan otorisasi tersebut. Setelah API diterapkan, klien harus terlebih dahulu memasukkan pengguna ke kumpulan pengguna, mendapatkan identitas atau token akses untuk pengguna, dan kemudian memanggil metode API dengan salah satu token, yang biasanya diatur ke Authorization header permintaan. Panggilan API hanya berhasil jika token yang diperlukan disediakan dan token yang disediakan valid, jika tidak, klien tidak berwenang untuk melakukan panggilan karena klien tidak memiliki kredensi yang dapat diotorisasi.
Token identitas digunakan untuk mengotorisasi panggilan API berdasarkan klaim identitas pengguna yang masuk. Token akses digunakan untuk mengotorisasi panggilan API berdasarkan cakupan kustom sumber daya yang dilindungi akses tertentu. Untuk informasi selengkapnya, lihat Menggunakan Token dengan Kumpulan Pengguna dan Server Sumber Daya dan Cakupan Khusus.
Untuk membuat dan mengonfigurasi kumpulan pengguna Amazon Cognito untuk API, Anda melakukan tugas berikut:
-
Gunakan konsol Amazon Cognito, CLI/SDK, atau API untuk membuat kumpulan pengguna—atau gunakan yang dimiliki oleh akun lain. AWS
-
Gunakan konsol API Gateway, CLI/SDK, atau API untuk membuat otorisasi API Gateway dengan kumpulan pengguna yang dipilih.
-
Gunakan konsol API Gateway, CLI/SDK, atau API untuk mengaktifkan otorisasi pada metode API yang dipilih.
Untuk memanggil metode API apa pun dengan kumpulan pengguna diaktifkan, klien API Anda melakukan tugas berikut:
-
Gunakan Amazon Cognito CLI/SDK atau API untuk menandatangani pengguna ke kumpulan pengguna yang dipilih, dan mendapatkan token identitas atau token akses. Untuk mempelajari lebih lanjut tentang menggunakan SDK, lihat Contoh kode untuk Amazon Cognito AWS menggunakan SDK.
-
Gunakan kerangka kerja khusus klien untuk memanggil API Gateway API yang diterapkan dan menyediakan token yang sesuai di header.
Authorization
Sebagai pengembang API, Anda harus memberikan ID kumpulan pengguna, ID klien, dan mungkin rahasia klien terkait yang didefinisikan sebagai bagian dari kumpulan pengguna.
catatan
Untuk mengizinkan pengguna masuk menggunakan kredensi Amazon Cognito dan juga mendapatkan kredensi sementara untuk digunakan dengan izin peran IAM, gunakan Identitas Federasi Amazon Cognito. Untuk setiap metode HTTP titik akhir sumber daya API, tetapkan jenis otorisasi, kategoriMethod Execution, ke. AWS_IAM
Di bagian ini, kami menjelaskan cara membuat kumpulan pengguna, cara mengintegrasikan API Gateway API dengan kumpulan pengguna, dan cara menjalankan API yang terintegrasi dengan kumpulan pengguna.
Topik
Dapatkan izin untuk membuat otorisasi kumpulan pengguna Amazon Cognito untuk REST API
Integrasikan REST API dengan kumpulan pengguna Amazon Cognito
Panggil REST API yang terintegrasi dengan kumpulan pengguna Amazon Cognito
Konfigurasikan otorisasi Amazon Cognito lintas akun untuk REST API menggunakan konsol API Gateway
Buat otorisasi Amazon Cognito untuk REST API menggunakan AWS CloudFormation
