Menggunakan peran terkait layanan untuk Amazon Cognito - Amazon Cognito

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

Menggunakan peran terkait layanan untuk Amazon Cognito

Amazon Cognito menggunakan AWS Identity and Access Management (IAM) peran terkait layanan. Peran terkait layanan adalah jenis IAM peran unik dengan kebijakan kepercayaan yang memungkinkan seseorang AWS layanan untuk mengambil peran tersebut. Peran terkait layanan telah ditentukan sebelumnya oleh Amazon Cognito dan menyertakan semua izin yang diperlukan layanan untuk memanggil layanan lain atas nama Anda. AWS

Peran tertaut layanan mempermudah pengaturan Amazon Cognito karena Anda tidak perlu menambahkan izin yang diperlukan secara manual. Amazon Cognito menentukan izin peran terkait layanan, dan kecuali ditentukan lain, hanya Amazon Cognito yang dapat menjalankan perannya. Izin yang ditetapkan mencakup kebijakan kepercayaan dan kebijakan izin, dan kebijakan izin tersebut tidak dapat dilampirkan ke entitas lain mana pun. IAM

Anda dapat menghapus peran yang terhubung dengan layanan hanya setelah menghapus sumber daya terkait terlebih dahulu. Ini melindungi sumber daya Amazon Cognito karena Anda tidak dapat secara tidak sengaja menghapus izin untuk mengakses sumber daya.

Untuk informasi tentang layanan lain yang mendukung peran terkait layanan, lihat AWS Layanan yang Bekerja dengan IAM dan cari layanan yang memiliki Ya di kolom Peran Tertaut Layanan. Pilih Ya bersama tautan untuk melihat dokumentasi peran tertaut layanan untuk layanan tersebut.

Izin peran terkait layanan untuk Amazon Cognito

Amazon Cognito menggunakan peran terkait layanan berikut:

  • AWSServiceRoleForAmazonCognitoIdpEmailService— Memungkinkan layanan kumpulan pengguna Amazon Cognito menggunakan SES identitas Amazon Anda untuk mengirim email.

  • AWSServiceRoleForAmazonCognitoIdp— Memungkinkan kumpulan pengguna Amazon Cognito untuk mempublikasikan peristiwa dan mengonfigurasi titik akhir untuk proyek Amazon Pinpoint Anda.

AWSServiceRoleForAmazonCognitoIdpEmailService

Peran terkait layanan AWSServiceRoleForAmazonCognitoIdpEmailService memercayakan layanan berikut untuk menjalankan peran tersebut:

  • email.cognito-idp.amazonaws.com

Kebijakan izin peran memungkinkan Amazon Cognito menyelesaikan tindakan berikut pada sumber daya yang ditentukan:

Tindakan yang Diizinkan untuk AWSServiceRoleForAmazonCognitoIdpEmailService:
  • Tindakan: ses:SendEmail dan ses:SendRawEmail

  • Sumber Daya: *

Kebijakan tersebut menolak kemampuan Amazon Cognito untuk menyelesaikan tindakan berikut pada sumber daya yang ditentukan:

Tindakan Ditolak
  • Tindakan: ses:List*

  • Sumber Daya: *

Dengan izin ini, Amazon Cognito dapat menggunakan alamat email terverifikasi Anda di SES Amazon hanya untuk mengirim email kepada pengguna Anda. Amazon Cognito mengirimkan email kepada pengguna Anda saat mereka melakukan tindakan tertentu di aplikasi klien untuk kolam pengguna, seperti mendaftar atau menyetel ulang kata sandi.

Anda harus mengonfigurasi izin untuk mengizinkan IAM entitas (seperti pengguna, grup, atau peran) membuat, mengedit, atau menghapus peran terkait layanan. Untuk informasi selengkapnya, lihat Izin peran terkait layanan di Panduan Pengguna. IAM

AWSServiceRoleForAmazonCognitoIdp

Peran AWSServiceRoleForAmazonCognitoIdp terkait layanan mempercayai layanan berikut untuk mengambil peran:

  • email.cognito-idp.amazonaws.com

Kebijakan izin peran memungkinkan Amazon Cognito menyelesaikan tindakan berikut pada sumber daya yang ditentukan:

Tindakan yang Diizinkan untuk AWSServiceRoleForAmazonCognitoIdp
  • Tindakan: cognito-idp:Describe

  • Sumber Daya: *

Dengan izin ini, Amazon Cognito dapat memanggil operasi Amazon Describe API Cognito untuk Anda.

catatan

Saat Anda mengintegrasikan Amazon Cognito dengan Amazon Pinpoint createUserPoolClient menggunakan updateUserPoolClient dan, izin sumber daya akan ditambahkan ke SLR kebijakan sebagai sebaris. Kebijakan inline akan memberikan izin mobiletargeting:UpdateEndpoint dan mobiletargeting:PutEvents. Izin ini memungkinkan Amazon Cognito mempublikasikan acara dan mengonfigurasi titik akhir untuk proyek Pinpoint yang Anda integrasikan dengan Cognito.

Membuat peran terkait layanan untuk Amazon Cognito

Anda tidak perlu membuat peran terkait layanan secara manual. Saat mengonfigurasi kumpulan pengguna untuk menggunakan SES konfigurasi Amazon untuk menangani pengiriman email di AWS Management Console,, atau Amazon Cognito AWS CLI, Amazon Cognito API akan membuat peran terkait layanan untuk Anda.

Jika Anda menghapus peran tertaut layanan ini, dan ingin membuatnya lagi, Anda dapat mengulangi proses yang sama untuk membuat kembali peran tersebut di akun Anda. Saat mengonfigurasi kumpulan pengguna untuk menggunakan SES konfigurasi Amazon untuk menangani pengiriman email, Amazon Cognito akan membuat peran terkait layanan untuk Anda lagi.

Sebelum Amazon Cognito dapat membuat peran ini, IAM izin yang Anda gunakan untuk menyiapkan kumpulan pengguna harus menyertakan tindakan. iam:CreateServiceLinkedRole Untuk informasi selengkapnya tentang memperbarui izinIAM, lihat Mengubah Izin untuk IAM Pengguna di Panduan IAM Pengguna.

Mengedit peran terkait layanan untuk Amazon Cognito

Anda tidak dapat mengedit AmazonCognitoIdp atau peran AmazonCognitoIdpEmailService terkait layanan di. AWS Identity and Access Management Setelah membuat peran terkait layanan, Anda tidak dapat mengubah nama peran karena berbagai entitas mungkin mereferensikan peran tersebut. Namun, Anda dapat mengedit deskripsi peran menggunakanIAM. Untuk informasi selengkapnya, lihat Mengedit peran terkait layanan di IAMPanduan Pengguna.

Menghapus peran terkait layanan untuk Amazon Cognito

Jika Anda tidak perlu lagi menggunakan fitur atau layanan yang memerlukan peran terkait layanan, kami merekomendasikan Anda menghapus peran tersebut. Jika Anda menghapus peran, Anda hanya mempertahankan entitas yang Amazon Cognito secara aktif memonitor atau memelihara. Sebelum dapat menghapus AmazonCognitoIdp atau peran yang AmazonCognitoIdpEmailService ditautkan dengan layanan, Anda harus melakukan salah satu hal berikut untuk setiap kumpulan pengguna yang menggunakan peran tersebut:

  • Hapus kolam pengguna.

  • Perbarui pengaturan email di kolam pengguna untuk menggunakan fungsionalitas email default. Pengaturan default tidak menggunakan peran terkait layanan.

Ingatlah untuk melakukan tindakan di masing-masing Wilayah AWS dengan kumpulan pengguna yang menggunakan peran tersebut.

catatan

Jika layanan Amazon Cognito menggunakan peran saat Anda mencoba untuk menghapus sumber daya, maka penghapusan tersebut kemungkinan gagal. Jika hal itu terjadi, tunggu beberapa menit dan coba lagi.

Untuk menghapus kolam pengguna Amazon Cognito
  1. Masuk ke AWS Management Console dan buka konsol Amazon Cognito di. https://console.aws.amazon.com/cognito

  2. Pilih Kelola Kolam Pengguna.

  3. Pada halaman Kolam Pengguna Anda, pilih kolam pengguna yang ingin Anda hapus.

  4. Pilih Hapus kolam.

  5. Di jendela Hapus kolam pengguna, ketik delete, dan pilih Hapus kolam.

Untuk memperbarui kumpulan pengguna Amazon Cognito untuk menggunakan fungsionalitas email default

  1. Masuk ke AWS Management Console dan buka konsol Amazon Cognito di. https://console.aws.amazon.com/cognito

  2. Pilih Kelola Kolam Pengguna.

  3. Pada halaman Kolam Pengguna Anda, pilih kolam pengguna yang ingin Anda perbarui.

  4. Di menu navigasi di sebelah kiri, pilih Kustomisasi pesan.

  5. Di bawah Apakah Anda ingin mengirim email melalui SES Konfigurasi Amazon Anda? , pilih Tidak - Gunakan Cognito (Default).

  6. Setelah selesai mengatur opsi akun email Anda, pilih Simpan perubahan.

Untuk menghapus peran terkait layanan secara manual menggunakan IAM

Gunakan IAM konsol, perangkat AWS CLI, atau AWS API untuk menghapus AmazonCognitoIdp atau peran AmazonCognitoIdpEmailService terkait layanan. Untuk informasi selengkapnya, lihat Menghapus peran terkait layanan di Panduan Pengguna. IAM

Wilayah yang Didukung untuk peran terkait layanan Amazon Cognito

Amazon Cognito mendukung peran terkait layanan di semua Wilayah AWS tempat layanan tersedia. Untuk informasi lebih lanjut, lihat Wilayah AWS dan Titik Akhir.