View a markdown version of this page

Bagaimana AWS Systems Manager bekerja dengan IAM - AWS Systems Manager
Systems Manager kebijakan berbasis identitasSystems Manager kebijakan berbasis sumber dayaOtorisasi berdasarkan Systems Manager tagSystems Manager Peran IAM

• AWS Systems Manager CloudWatch Dasbor tidak akan lagi tersedia setelah 30 April 2026. Pelanggan dapat terus menggunakan CloudWatch konsol Amazon untuk melihat, membuat, dan mengelola dasbor Amazon CloudWatch mereka, seperti yang mereka lakukan hari ini. Untuk informasi selengkapnya, lihat dokumentasi CloudWatch Dasbor Amazon.

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

Bagaimana AWS Systems Manager bekerja dengan IAM

Sebelum Anda menggunakan AWS Identity and Access Management (IAM) untuk mengelola akses ke AWS Systems Manager, Anda harus memahami fitur IAM apa yang tersedia untuk digunakan. Systems Manager Untuk mendapatkan tampilan tingkat tinggi tentang bagaimana Systems Manager dan lainnya Layanan AWS bekerja dengan IAM, lihat Layanan AWS itu bekerja dengan IAM di Panduan Pengguna IAM.

Systems Manager kebijakan berbasis identitas

Dengan kebijakan berbasis identitas IAM, Anda dapat menentukan tindakan dan sumber daya yang diizinkan atau ditolak, dan juga ketentuan di mana tindakan tersebut diperbolehkan atau ditolak. Systems Manager mendukung tindakan, sumber daya, dan kunci kondisi tertentu. Untuk mempelajari semua elemen yang Anda gunakan dalam kebijakan JSON, lihat Referensi elemen kebijakan IAM JSON dalam Panduan Pengguna IAM.

Tindakan

Administrator dapat menggunakan kebijakan AWS JSON untuk menentukan siapa yang memiliki akses ke apa. Yaitu, di mana utama dapat melakukan tindakan pada sumber daya, dan dalam kondisi apa.

Elemen Action dari kebijakan JSON menjelaskan tindakan yang dapat Anda gunakan untuk mengizinkan atau menolak akses dalam sebuah kebijakan. Sertakan tindakan dalam kebijakan untuk memberikan izin untuk melakukan operasi terkait.

Tindakan kebijakan di Systems Manager menggunakan prefiks berikut sebelum tindakan: ssm:. Misalnya, untuk memberi seseorang izin untuk membuat Systems Manager parameter (parameter SSM) dengan operasi Systems Manager PutParameter API, Anda menyertakan ssm:PutParameter tindakan tersebut dalam kebijakan mereka. Pernyataan kebijakan harus menyertakan elemen Action atau NotAction. Systems Manager menentukan set tindakan sendiri yang menjelaskan tugas yang dapat Anda lakukan dengan layanan ini.

Untuk menetapkan beberapa tindakan dalam satu pernyataan, pisahkan tindakan-tindakan tersebut menggunakan koma seperti berikut:

"Action": [
      "ssm:action1",
      "ssm:action2"
]
catatan

Alat-alat berikut ini AWS Systems Manager menggunakan awalan yang berbeda sebelum tindakan.

  • AWS AppConfig menggunakan awalan appconfig: sebelum tindakan.

  • Incident Manager menggunakan awalan ssm-incidents: atau ssm-contacts: sebelum tindakan.

  • Systems Manager GUI Connect menggunakan awalan ssm-guiconnect: sebelum tindakan.

  • Quick Setupmenggunakan awalan ssm-quicksetup: sebelum tindakan.

Anda dapat menentukan beberapa tindakan menggunakan wildcard (*). Sebagai contoh, untuk menentukan semua tindakan yang dimulai dengan kata Describe, sertakan tindakan berikut:

"Action": "ssm:Describe*"

Untuk melihat daftar tindakan Systems Manager, lihat Tindakan yang Ditentukan oleh AWS Systems Manager dalam Referensi Otorisasi Layanan.

Sumber daya

Administrator dapat menggunakan kebijakan AWS JSON untuk menentukan siapa yang memiliki akses ke apa. Yaitu, di mana utama dapat melakukan tindakan pada sumber daya, dan dalam kondisi apa.

Elemen kebijakan JSON Resource menentukan objek yang menjadi target penerapan tindakan. Praktik terbaiknya, tentukan sumber daya menggunakan Amazon Resource Name (ARN). Untuk tindakan yang tidak mendukung izin di tingkat sumber daya, gunakan wildcard (*) untuk menunjukkan bahwa pernyataan tersebut berlaku untuk semua sumber daya.

"Resource": "*"

Misalnya, sumber daya jendela Systems Manager pemeliharaan memiliki format ARN berikut.

arn:aws:ssm:region:account-id:maintenancewindow/window-id

Untuk menentukan jendela pemeliharaan MW-0C50858D01Contoh dalam pernyataan Anda di Wilayah AS Timur (Ohio), Anda akan menggunakan ARN yang mirip dengan berikut ini.

"Resource": "arn:aws:ssm:us-east-2:123456789012:maintenancewindow/mw-0c50858d01EXAMPLE"

Untuk menentukan semua windowa pemeliharaan milik akun tertentu, gunakan wildcard (*).

"Resource": "arn:aws:ssm:region:123456789012:maintenancewindow/*"

Untuk operasi Parameter Store API, Anda dapat menyediakan atau membatasi akses ke semua parameter dalam satu tingkat hierarki dengan menggunakan nama hierarkis dan kebijakan AWS Identity and Access Management (IAM) sebagai berikut.

"Resource": "arn:aws:ssm:region:123456789012:parameter/Dev/ERP/Oracle/*"

Beberapa tindakan Systems Manager, seperti tindakan untuk membuat sumber daya, tidak dapat dilakukan pada sumber daya tertentu. Dalam kasus tersebut, Anda harus menggunakan wildcard (*).

"Resource": "*"

Beberapa operasi Systems Manager API menerima beberapa sumber daya. Untuk menentukan beberapa tindakan dalam satu pernyataan, pisahkan ARN dengan koma seperti berikut.

"Resource": [
      "resource1",
      "resource2"
catatan

Sebagian besar Layanan AWS memperlakukan titik dua (:) atau garis miring ke depan (/) sebagai karakter yang sama di ARN. Namun, Systems Manager membutuhkan kecocokan yang tepat dalam pola dan aturan sumber daya. Saat membuat pola peristiwa, pastikan untuk menggunakan karakter ARN yang benar sehingga cocok dengan ARN sumber daya.

Tabel di bawah ini menjelaskan format ARN untuk jenis sumber daya yang didukung olehSystems Manager.

catatan

Perhatikan pengecualian berikut untuk format ARN.

  • Alat-alat berikut ini AWS Systems Manager menggunakan awalan yang berbeda sebelum tindakan.

    • AWS AppConfig menggunakan awalan appconfig: sebelum tindakan.

    • Incident Manager menggunakan awalan ssm-incidents: atau ssm-contacts: sebelum tindakan.

    • Systems Manager GUI Connect menggunakan awalan ssm-guiconnect sebelum tindakan.

  • Dokumen dan sumber definisi otomatisasi yang dimiliki oleh Amazon, dan parameter publik yang disediakan oleh Amazon dan sumber pihak ketiga, tidak menyertakan ID akun dalam format ARN mereka. Contoh:

    • Dokumen SSM: AWS-RunPatchBaseline

      arn:aws:ssm:us-east-2::document/AWS-RunPatchBaseline

    • Runbook AWS-ConfigureMaintenanceWindows otomatisasi:

      arn:aws:ssm:us-east-2::automation-definition/AWS-ConfigureMaintenanceWindows

    • Parameter publik/aws/service/bottlerocket/aws-ecs-1-nvidia/x86_64/1.13.4/image_version:

      arn:aws:ssm:us-east-2::parameter/aws/service/bottlerocket/aws-ecs-1-nvidia/x86_64/1.13.4/image_version

    Untuk informasi selengkapnya tentang ketiga jenis sumber daya ini, lihat topik berikut:

  • Quick Setupmenggunakan awalan ssm-quicksetup: sebelum tindakan.

Tipe sumber daya Format ARN
Aplikasi (AWS AppConfig) arn:aws:appconfig: ::aplikasi/ region account-id application-id
Asosiasi arn:aws:ssm: ::asosiasi/ region account-id association-id
Eksekusi otomatisasi arn:aws:ssm: ::otomasi-eksekusi/regionaccount-idautomation-execution-id
Definisi otomatisasi (dengan versi subsumber daya)

arn:aws:ssm: ::definisi-otomasi/: 1 region account-id automation-definition-id version-id

Konfigurasi profil (AWS AppConfig) arn:aws:appconfig: ::aplikasi//konfigurationprofile/ region account-id application-id configurationprofile-id
Kontak (Manajer Insiden)

arn: aws:ssm-kontak: ::kontak/ region account-id contact-alias
Strategi penyebaran (AWS AppConfig) arn:aws:appconfig: ::deploymentstrategy/ region account-id deploymentstrategy-id
Dokumen

arn:aws:ssm: ::dokumen/ region account-id document-name
Lingkungan (AWS AppConfig) arn: aws:appconfig: ::aplikasi//lingkungan/ region account-id application-id environment-id
Insiden

arn:aws:ssm-incidents: ::insida-catat//regionaccount-idresponse-plan-nameincident-id
Periode pemeliharaan

arn:aws:ssm: ::jendela pemeliharaan/ region account-id window-id
Node terkelola

arn:aws:ssm: ::instance-terkelola/ region account-id managed-node-id
Inventaris node terkelola arn:aws:ssm: ::inventaris-instansi terkelola/ region account-id managed-node-id
OpsItem arn:aws:ssm: ::opsitem/ region account-id OpsItem-id
Parameter

Parameter satu tingkat:

  • arn:aws:ssm: ::parameter//regionaccount-idparameter-name

Parameter bernama dengan konstruksi hierarkis:

  • arn:aws:ssm: ::parameter/////region2 account-id parameter-name-root level-2 level-3 level-4 level-5

Garis dasar patch

arn:aws:ssm: ::patchbaseline/ region account-id patch-baseline-id

Rencana respon

arn:aws:ssm-incidents: ::rencana-respon/ region account-id response-plan-name
Sesi

arn:aws:ssm: ::sessi/ 3 region account-id session-id

Semua sumber daya Systems Manager

arn:aws:ssm:*

Semua Systems Manager sumber daya yang dimiliki oleh yang ditentukan Akun AWS dalam yang ditentukan Wilayah AWS

arn:aws:ssm::: * region account-id
catatan

Sumber daya definisi otomatisasi tidak digunakan lagi. Perbarui kebijakan IAM Anda untuk menyertakan izin ssm:StartAutomationExecution atau ssm:StartChangeRequestExecution mengaktifkan document dan automation-execution sumber daya. Untuk melihat praktik terbaik dan contoh pengaturan izin IAM, lihat panduan pengguna contoh kebijakan berbasis identitas kami.

1 Untuk definisi otomatisasi, Systems Manager mendukung sumber daya tingkat kedua, ID versi. Di AWS, sumber daya tingkat kedua ini dikenal sebagai sub sumber daya. Menentukan subresource versi untuk sumber daya definisi otomatisasi memungkinkan Anda menyediakan akses ke versi tertentu dari definisi otomatisasi. Misalnya, Anda mungkin ingin memastikan bahwa hanya versi terbaru dari definisi otomatisasi yang digunakan dalam manajemen node Anda.

2 Untuk mengatur dan mengelola parameter, Anda dapat membuat nama untuk parameter dengan konstruksi hierarkis. Dengan konstruksi hirarkis, nama parameter dapat mencakup jalur yang Anda tentukan dengan menggunakan garis miring ke depan. Anda dapat menyebutkan sumber daya parameter maksimum lima belas tingkat. Kami menyarankan Anda membuat hierarki yang mencerminkan struktur hierarkis yang ada di lingkungan Anda. Untuk informasi selengkapnya, lihat Membuat Penyimpanan Parameter parameter dalam Manajer Sistem.

3 Dalam kebanyakan kasus, ID sesi dibuat menggunakan ID pengguna akun yang memulai sesi, ditambah akhiran alfanumerik. Contoh:

arn:aws:us-east-2:111122223333:session/JohnDoe-1a2b3c4sEXAMPLE

Namun, jika ID pengguna tidak tersedia, ARN dibangun dengan cara ini sebagai gantinya:

arn:aws:us-east-2:111122223333:session/session-1a2b3c4sEXAMPLE

Untuk informasi selengkapnya tentang format ARN, lihat Amazon Resource Name (ARN) di Referensi Umum Amazon Web Services.

Untuk daftar jenis Systems Manager sumber daya dan ARN-nya, lihat Sumber Daya yang Ditet apkan oleh AWS Systems Manager dalam Refer ensi O torisasi Layanan. Untuk mempelajari dengan tindakan mana Anda dapat menentukan ARN setiap sumber daya, lihat Tindakan yang ditentukan oleh AWS Systems Manager.

Kunci kondisi untuk Manajer Sistem

Administrator dapat menggunakan kebijakan AWS JSON untuk menentukan siapa yang memiliki akses ke apa. Yaitu, principal dapat melakukan tindakan pada suatu sumber daya, dan dalam suatu syarat.

Elemen Condition menentukan ketika pernyataan dieksekusi berdasarkan kriteria yang ditetapkan. Anda dapat membuat ekspresi bersyarat yang menggunakan operator kondisi, misalnya sama dengan atau kurang dari, untuk mencocokkan kondisi dalam kebijakan dengan nilai-nilai yang diminta. Untuk melihat semua kunci kondisi AWS global, lihat kunci konteks kondisi AWS global di Panduan Pengguna IAM.

Untuk melihat daftar kunci syarat Systems Manager, lihat Kunci Syarat untuk AWS Systems Manager dalam Referensi Otorisasi Layanan. Untuk mempelajari tindakan dan sumber daya mana yang dapat Anda gunakan kunci syarat, lihat Tindakan yang Ditentukan oleh AWS Systems Manager.

Untuk informasi tentang penggunaan kunci kondisi ssm:resourceTag/*, lihat topik berikut:

Untuk informasi tentang menggunakan kunci ssm:Recursivessm:Policies,, dan ssm:Overwrite kondisi, lihatMencegah akses ke Penyimpanan Parameter Operasi API.

Contoh

Untuk melihat contoh Systems Manager kebijakan berbasis identitas, lihat AWS Systems Manager contoh kebijakan berbasis identitas.

Systems Manager kebijakan berbasis sumber daya

Lain Layanan AWS nya, seperti Amazon Simple Storage Service (Amazon S3), mendukung kebijakan izin berbasis sumber daya. Misalnya, Anda dapat melampirkan kebijakan izin ke bucket S3 untuk mengelola izin akses ke bucket tersebut.

Systems Manager tidak mendukung kebijakan berbasis sumber daya.

Otorisasi berdasarkan Systems Manager tag

Anda dapat melampirkan tanda di sumber daya Systems Manager atau meneruskan tanda dalam permintaan ke Systems Manager. Untuk mengontrol akses berdasarkan tag, Anda memberikan informasi tag di elemen kondisi kebijakan menggunakan kunci kondisi ssm:resourceTag/key-name, aws:ResourceTag/key-name, aws:RequestTag/key-name, atau aws:TagKeys. Anda dapat menambahkan tag ke jenis sumber daya berikut saat Anda membuat atau memperbaruinya:

  • Dokumen

  • Node terkelola

  • Periode pemeliharaan

  • Parameter

  • Garis dasar patch

  • OpsItem

Untuk melihat contoh kebijakan berbasis identitas untuk membatasi akses ke sumber daya berdasarkan tag pada sumber daya tersebut, lihat Melihat Systems Manager dokumen berdasarkan tag.

Systems Manager Peran IAM

Peran IAM adalah entitas di dalam Anda Akun AWS yang memiliki izin tertentu.

Menggunakan kredenSIAL sementara dengan Systems Manager

Anda dapat menggunakan kredensial sementara untuk masuk dengan gabungan, menjalankan IAM role, atau menjalankan peran lintas akun. Anda mendapatkan kredentif keamanan sementara dengan memanggil operasi API AWS Security Token Service (AWS STS) seperti AssumeRole atau GetFederationToken.

Systems Manager mendukung penggunaan kredensial sementara.

Service-linked peran

Service-linked peran memungkinkan Layanan AWS untuk mengakses sumber daya di layanan lain untuk menyelesaikan tindakan atas nama Anda. Service-linked peran terdaftar di akun IAM Anda dan dimiliki oleh layanan. Administrator dapat melihat tetapi tidak dapat mengedit izin untuk peran yang terkait dengan layanan.

Systems Manager mendukung peran terkait layanan Untuk informasi selengkapnya tentang cara membuat atau mengelola peran terkait layanan Systems Manager, lihat Menggunakan peran terkait layanan untuk Systems Manager.

Peran layanan

Fitur ini memungkinkan layanan untuk menerima peran layanan atas nama Anda. Peran ini memungkinkan layanan mengakses sumber daya di layanan lain untuk menyelesaikan tindakan atas nama Anda. Peran layanan ditampilkan dalam akun IAM Anda dan dimiliki oleh akun tersebut. Ini berarti bahwa administrator dapat mengubah izin untuk peran ini. Namun, melakukannya mungkin merusak fungsi layanan.

Systems Manager mendukung peran layanan

Memilih peran IAM di Systems Manager

Systems ManagerUntuk berinteraksi dengan node terkelola Anda, Anda harus memilih peran untuk mengiz Systems Manager inkan akses node atas nama Anda. Jika sebelumnya Anda telah membuat peran layanan atau peran terkait layanan, maka Systems Manager memberi Anda daftar peran untuk dipilih. Penting untuk memilih peran yang memungkinkan akses untuk memulai dan menghentikan node yang dikelola.

Untuk mengakses instans EC2, Anda harus mengonfigurasi izin instans. Untuk selengkapnya, lihat Meng onfigurasi izin instans yang diperlukan untuk Manajer Sistem.

Untuk mengakses node non-EC2 dalam hybrid dan multicloud, peran yang Anda Akun AWS butuhkan adalah peran layanan IAM. Untuk selengkapnya, lihat Membuat peran layanan IAM yang diperlukan untuk Manajer Sistem di lingkungan hybrid dan multicloud.

Alur kerja otomatisasi dapat dimulai di bawah konteks peran layanan (atau peran asumsi). Hal ini mengizinkan layanan untuk kemudian melakukan tindakan atas nama Anda. Jika Anda tidak menentukan peran asumsi, otomatisasi menggunakan konteks pengguna yang dipanggil eksekusi. Namun, situasi tertentu mengharuskan Anda menentukan peran layanan untuk otomatisasi. Untuk informasi selengkapnya, lihat Mengonfigurasi akses peran layanan (peran asumsi) untuk otomatisasi.

AWS Systems Manager kebijakan terkelola

AWS mengatasi banyak kasus penggunaan umum dengan menyediakan kebijakan IAM mandiri yang dibuat dan dikelola oleh AWS. Kebijakan terkelola AWS ini memberikan izin yang diperlukan untuk kasus penggunaan umum sehingga Anda tidak perlu menyelidiki izin mana yang diperlukan. (Anda juga dapat membuat kebijakan IAM kustom Anda sendiri untuk mengizinkan izin untuk Systems Manager tindakan dan sumber daya.)

Untuk informasi selengkapnya tentang kebijakan terkelola untuk Manajer Sistem, lihat AWS kebijakan yang dikelola untuk AWS Systems Manager

Untuk informasi umum tentang kebijakan terkelola, lihat AWS kebijakan terkelola di Panduan Pengguna IAM.