Menggunakan peran yang terhubung dengan layanan untuk Notifikasi CodeStar AWS - Konsol Alat Developer

Menggunakan peran yang terhubung dengan layanan untuk Notifikasi CodeStar AWS

Notifikasi CodeStar AWS menggunakan AWS Identity and Access Management (IAM) peran yang terhubung dengan layanan. Peran tertaut layanan adalah tipe IAM role unik yang tertaut langsung ke Notifikasi CodeStar AWS. Peran yang terhubung dengan layanan ditentukan sebelumnya oleh Notifikasi CodeStar AWS dan mencakup semua izin yang diperlukan layanan untuk menghubungi layanan AWS lainnya atas nama Anda. Peran ini dibuat untuk Anda saat pertama kali Anda membuat aturan notifikasi. Anda tidak perlu membuat peran.

Peran terkait layanan memudahkan pengaturan Notifikasi CodeStar AWS menjadi lebih mudah karena Anda tidak perlu menambahkan izin yang diperlukan secara manual. AWS Notifikasi CodeStar menentukan izin peran terkait layanan, kecuali jika ditentukan berbeda, hanya Notifikasi CodeStar AWS yang dapat mengasumsikan perannya. Izin yang ditentukan mencakup kebijakan kepercayaan dan kebijakan izin, serta bahwa kebijakan izin tidak dapat dilampirkan ke entitas IAM lainnya.

Untuk menghapus peran tertaut layanan, Anda harus menghapus sumber daya terkaitnya terlebih dahulu. Ini melindungi sumber daya Notifikasi CodeStar AWS karena Anda tidak dapat secara tidak sengaja menghapus izin untuk mengakses sumber daya.

Untuk informasi tentang layanan lain yang mendukung peran yang terhubung dengan layanan, lihat Layanan AWS yang Bekerja dengan IAM.

Izin peran terkait layanan untuk Notifikasi CodeStar AWS

Notifikasi CodeStar AWS menggunakan peran terkait layanan AWSServiceRoleForCodeStarNotifications untuk mengambil informasi tentang peristiwa yang terjadi di toolchain Anda dan mengirim notifikasi ke target yang Anda tentukan.

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

  • codestar-notifications.amazonaws.com

Kebijakan izin peran memungkinkan Notifikasi CodeStar AWS untuk menyelesaikan tindakan berikut pada sumber daya yang ditentukan:

  • Tindakan: PutRule pada CloudWatch Event rules that are named awscodestar-notifications-*

  • Tindakan: DescribeRule pada CloudWatch Event rules that are named awscodestar-notifications-*

  • Tindakan: PutTargets pada CloudWatch Event rules that are named awscodestar-notifications-*

  • Tindakan: CreateTopic ke create Amazon SNS topics for use with AWS CodeStar Notifications with the prefix CodeStarNotifications-

  • Tindakan: CreateTopic ke create Amazon SNS topics for use with AWS CodeStar Notifications with the prefix CodeStarNotifications-

  • Tindakan: GetCommentsForPullRequests pada all comments on all pull requests in all CodeCommit repositories in the AWS account

  • Tindakan: GetCommentsForComparedCommit pada all comments on all commits in all CodeCommit repositories in the AWS account

  • Tindakan: GetDifferences pada all commits in all CodeCommit repositories in the AWS account

  • Tindakan: GetCommentsForComparedCommit pada all comments on all commits in all CodeCommit repositories in the AWS account

  • Tindakan: GetDifferences pada all commits in all CodeCommit repositories in the AWS account

  • Tindakan: DescribeSlackChannelConfigurations pada all AWS Chatbot clients in the AWS account

  • Tindakan: UpdateSlackChannelConfiguration pada all AWS Chatbot clients in the AWS account

  • Tindakan: ListActionExecutions pada all actions in all pipelines in the AWS account

  • Tindakan: GetFile pada all files in all CodeCommit repositories in the AWS account unless otherwise tagged

Anda dapat melihat tindakan ini dalam pernyataan kebijakan untuk peran terkait layanan AWSServiceRoleForCodeStarNotifications.

{ "Version": "2012-10-17", "Statement": [ { "Action": [ "events:PutTargets", "events:PutRule", "events:DescribeRule" ], "Resource": "arn:aws:events:*:*:rule/awscodestarnotifications-*", "Effect": "Allow" }, { "Action": [ "sns:CreateTopic" ], "Resource": "arn:aws:sns:*:*:CodeStarNotifications-*", "Effect": "Allow" }, { "Action": [ "codecommit:GetCommentsForPullRequest", "codecommit:GetCommentsForComparedCommit", "codecommit:GetDifferences", "chatbot:DescribeSlackChannelConfigurations", "chatbot:UpdateSlackChannelConfiguration", "codepipeline:ListActionExecutions" ], "Resource": "*", "Effect": "Allow" }, { "Action": [ "codecommit:GetFile" ], "Resource": "*", "Condition": { "StringNotEquals": { "aws:ResourceTag/ExcludeFileContentFromNotifications": "true" } }, "Effect": "Allow" } ] }

Anda harus mengonfigurasikan izin untuk mengizinkan entitas IAM (seperti pengguna, grup, atau peran) untuk membuat, menyunting, atau menghapus peran terhubung dengan layanan. Untuk informasi selengkapnya, lihat Izin Peran yang Terhubung dengan Layanan di Panduan Pengguna IAM.

Membuat peran yang terkait dengan layanan untuk Notifikasi CodeStar AWS

Anda tidak perlu membuat peran terkait layanan secara manual. Anda dapat menggunakan konsol Alat Developer atau API CreateNotificationRule dari AWS CLI atau SDK untuk membuat aturan notifikasi. Anda juga bisa langsung memanggil API secara langsung. Apa pun metode yang Anda gunakan, peran terkait layanan dibuat untuk Anda.

Jika Anda menghapus peran terkait layanan ini, lalu ingin membuatnya lagi, Anda dapat menggunakan proses yang sama untuk membuat ulang peran tersebut di akun Anda. Anda dapat menggunakan konsol Alat Developer atau API CreateNotificationRule dari AWS CLI atau SDK untuk membuat aturan notifikasi. Anda juga bisa langsung memanggil API secara langsung. Apa pun metode yang Anda gunakan, peran terkait layanan dibuat untuk Anda.

Mengedit peran terkait layanan untuk Notifikasi CodeStar AWS

Setelah membuat peran terkait layanan, Anda tidak dapat mengubah namanya karena berbagai entitas mungkin mereferensikan peran tersebut. Namun, Anda dapat menggunakan IAM untuk mengedit deskripsi peran. Untuk informasi selengkapnya, lihat Mengedit Peran yang Terhubung dengan Layanan di Panduan Pengguna IAM.

Menghapus peran terkait layanan untuk Notifikasi CodeStar AWS

Jika Anda tidak perlu lagi menggunakan fitur atau layanan yang memerlukan peran terkait layanan, kami menyarankan Anda menghapus peran itu. Dengan begitu, Anda tidak memiliki entitas yang tidak digunakan yang tidak dipantau atau dipelihara secara aktif. Anda harus membersihkan sumber daya peran yang terhubung dengan layanan sebelum menghapusnya. Untuk Notifkasi AWS CodeStar, ini berarti menghapus semua aturan notifikasi yang menggunakan peran layanan di akun AWS Anda.

catatan

Jika layanan Notifikasi CodeStar AWS menggunakan peran tersebut ketika Anda mencoba menghapus sumber daya, penghapusan mungkin gagal. Jika hal itu terjadi, tunggu beberapa menit dan coba lagi.

Untuk menghapus sumber daya Notifikasi CodeStar AWS yang digunakan oleh AWSServiceRoleForCodeStarNotifications

  1. Buka konsol Alat Developer AWS di https://console.aws.amazon.com/codesuite/settings/notifications.

    catatan

    Aturan notifikasi berlaku untuk Wilayah AWS di mana mereka diciptakan. Jika Anda memiliki aturan notifikasi di lebih dari satu Wilayah AWS, gunakan pemilih Wilayah untuk mengubah Wilayah AWS.

  2. Pilih semua aturan notifikasi yang muncul dalam daftar, dan kemudian pilih Hapus.

  3. Ulangi langkah-langkah ini di semua Wilayah AWS tempat Anda membuat aturan notifikasi.

Menggunakan IAM untuk menghapus peran yang terkait layanan

Gunakan konsol IAM, AWS CLI, atau API AWS Identity and Access Management untuk menghapus peran terkait layanan AWSServiceRoleForCodeStarNotifications. Untuk informasi selengkapnya, lihat Menghapus Peran Tertaut Layanan dalam Panduan Pengguna IAM.

Wilayah yang didukung untuk peran yang terhubung dengan layanan Notifikasi CodeStar AWS

Notifikasi CodeStar AWS mendukung penggunaan peran terkait layanan di semua Wilayah AWS tempat layanan tersedia. Untuk informasi selengkapnya, lihat AWS Wilayah dan Titik Akhir dan Notifikasi AWS CodeStar.