Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Berbagi SSM dokumen
Anda dapat berbagi AWS Systems Manager (SSM) dokumen secara pribadi atau publik dengan akun yang sama. Wilayah AWS Untuk membagikan dokumen secara pribadi, Anda mengubah izin dokumen dan mengizinkan individu tertentu untuk mengaksesnya sesuai dengan ID Akun AWS . Untuk membagikan SSM dokumen secara publik, Anda mengubah izin dokumen dan menentukan. All
Dokumen tidak dapat dibagikan secara publik dan pribadi secara bersamaan.
Awas
Gunakan SSM dokumen bersama hanya dari sumber tepercaya. Ketika menggunakan dokumen bersama, hati-hati meninjau konten dokumen sebelum menggunakannya sehingga Anda dapat memahami bagaimana hal itu akan mengubah konfigurasi instans Anda. Untuk informasi selengkapnya tentang praktik terbaik dokumen bersama, lihat Praktik terbaik untuk SSM dokumen bersama.
Batasan
Saat Anda mulai bekerja dengan SSM dokumen, waspadai batasan berikut.
-
Hanya pemilik yang dapat berbagi dokumen.
-
Anda harus berhenti berbagikan dokumen sebelum dapat menghapusnya. Untuk informasi selengkapnya, lihat Ubah izin untuk dokumen bersama SSM.
-
Anda dapat berbagi dokumen dengan maksimum 1000 Akun AWS. Anda dapat meminta peningkatan pada batas ini di Pusat AWS Support
. Untuk tipe Limit, pilih EC2Systems Manager dan jelaskan alasan permintaan Anda. -
Anda dapat membagikan maksimal lima SSM dokumen secara publik. Anda dapat meminta peningkatan pada batas ini di Pusat AWS Support
. Untuk tipe Limit, pilih EC2Systems Manager dan jelaskan alasan permintaan Anda. -
Dokumen dapat dibagikan dengan akun lain Wilayah AWS hanya dalam hal yang sama. Tidak mendukung berbagi Lintas Wilayah.
Untuk informasi selengkapnya tentang kuota layanan Systems Manager, lihat Service Quotas AWS Systems Manager.
Daftar Isi
Praktik terbaik untuk SSM dokumen bersama
Tinjau pedoman berikut sebelum Anda berbagi atau menggunakan dokumen bersama.
- Hapus informasi sensitif
-
Tinjau dokumen AWS Systems Manager (SSM) Anda dengan hati-hati dan hapus informasi sensitif apa pun. Misalnya, verifikasi bahwa dokumen tidak menyertakan AWS kredensional Anda. Jika Anda berbagi dokumen dengan individu tertentu, pengguna tersebut dapat melihat informasi dalam dokumen. Jika Anda berbagi dokumen secara publik, siapa pun dapat melihat informasi dalam dokumen.
- Memblokir berbagi dokumen untuk publik
-
Tinjau semua SSM dokumen yang dibagikan secara publik di akun Anda dan konfirmasikan apakah Anda ingin terus membagikannya. Untuk berhenti berbagi dokumen dengan publik, Anda harus mengubah pengaturan izin dokumen seperti yang dijelaskan di Ubah izin untuk dokumen bersama SSM bagian topik ini. Mengaktifkan setelan blokir berbagi publik tidak memengaruhi dokumen apa pun yang saat ini Anda bagikan dengan publik. Kecuali jika kasus penggunaan Anda mengharuskan Anda untuk berbagi dokumen dengan publik, sebaiknya aktifkan setelan blokir berbagi publik untuk SSM dokumen Anda di bagian Preferensi pada konsol Systems Manager Documents. Mengaktifkan pengaturan ini mencegah akses yang tidak diinginkan ke SSM dokumen Anda. Pengaturan blok berbagi publik adalah pengaturan tingkat akun yang dapat berbeda untuk masing-masing Wilayah AWS.
- Batasi Run Command tindakan menggunakan kebijakan IAM kepercayaan
-
Buat kebijakan restriktif AWS Identity and Access Management (IAM) untuk pengguna yang akan memiliki akses ke dokumen. IAMKebijakan menentukan SSM dokumen mana yang dapat dilihat pengguna di konsol Amazon Elastic Compute Cloud (AmazonEC2) atau dengan menelepon
ListDocuments
menggunakan AWS Command Line Interface (AWS CLI) atau AWS Tools for Windows PowerShell. Kebijakan ini juga membatasi tindakan yang dapat dilakukan pengguna dengan SSM dokumen. Anda dapat membuat kebijakan yang lebih ketat sehingga pengguna hanya dapat menggunakan dokumen tertentu. Untuk informasi selengkapnya, lihat Contoh kebijakan yang dikelola pelanggan. - Berhati-hatilah saat menggunakan SSM dokumen bersama
-
Tinjau isi setiap dokumen yang dibagikan dengan Anda, terutama dokumen publik, untuk memahami perintah yang akan dijalankan di instans Anda. Dokumen dapat dengan sengaja atau tidak sengaja memiliki dampak negatif setelah dijalankan. Jika dokumen referensi jaringan eksternal, meninjau sumber eksternal sebelum Anda menggunakan dokumen.
- Kirim perintah menggunakan hash dokumen
-
Ketika Anda berbagi dokumen, sistem menciptakan hash Sha-256 dan menetapkannya ke dokumen. Sistem ini juga menyimpan snapshot dari konten dokumen. Ketika Anda mengirim perintah menggunakan dokumen bersama, Anda dapat menentukan hash dalam perintah Anda untuk memastikan bahwa kondisi berikut ini benar:
-
Anda menjalankan perintah dari dokumen Systems Manager yang benar
-
Konten dokumen tidak berubah sejak dibagikan dengan Anda.
Jika hash tidak cocok dengan dokumen tertentu atau jika isi dari dokumen bersama telah berubah, perintah mengembalikan pengecualian
InvalidDocument
. Hash tidak dapat memverifikasi konten dokumen dari lokasi eksternal. -
Blokir berbagi publik untuk SSM dokumen
Sebelum Anda mulai, tinjau semua SSM dokumen yang dibagikan secara publik di Anda Akun AWS dan konfirmasikan apakah Anda ingin terus membagikannya. Untuk berhenti berbagi SSM dokumen dengan publik, Anda harus mengubah pengaturan izin dokumen seperti yang dijelaskan di Ubah izin untuk dokumen bersama SSM bagian topik ini. Mengaktifkan setelan blokir berbagi publik tidak memengaruhi SSM dokumen apa pun yang saat ini Anda bagikan dengan publik. Dengan mengaktifkan pengaturan blokir berbagi publik, Anda tidak akan dapat berbagi SSM dokumen tambahan apa pun dengan publik.
Kecuali jika kasus penggunaan Anda mengharuskan Anda untuk berbagi dokumen dengan publik, sebaiknya aktifkan pengaturan blokir berbagi publik untuk SSM dokumen Anda. Mengaktifkan pengaturan ini mencegah akses yang tidak diinginkan ke SSM dokumen Anda. Pengaturan blok berbagi publik adalah pengaturan tingkat akun yang dapat berbeda untuk masing-masing Wilayah AWS. Selesaikan tugas-tugas berikut untuk memblokir berbagi publik untuk SSM dokumen apa pun yang saat ini tidak Anda bagikan.
Memblokir berbagi publik (konsol)
Untuk memblokir berbagi SSM dokumen Anda secara publik
Buka AWS Systems Manager konsol di https://console.aws.amazon.com/systems-manager/
. Di panel navigasi, pilih Dokumen.
-
Pilih Preferensi, lalu pilih Edit di bagian Memblokir berbagi publik.
-
Pilih opsi kotak centang Memblokir berbagi publik, dan kemudian pilih Simpan.
Blokir berbagi publik (baris perintah)
Buka AWS Command Line Interface (AWS CLI) atau AWS Tools for Windows PowerShell di komputer lokal Anda dan jalankan perintah berikut untuk memblokir berbagi SSM dokumen Anda secara publik.
Konfirmasikan nilai pengaturan yang diperbarui menggunakan perintah berikut.
Membatasi akses untuk memblokir berbagi publik dengan IAM
Anda dapat membuat AWS Identity and Access Management (IAM) kebijakan yang membatasi pengguna untuk memodifikasi setelan blokir berbagi publik. Ini mencegah pengguna mengizinkan akses yang tidak diinginkan ke SSM dokumen Anda.
Berikut ini adalah contoh IAM kebijakan yang mencegah pengguna memperbarui setelan blokir berbagi publik. Untuk menggunakan contoh ini, Anda harus mengganti contoh ID akun Amazon Web Services dengan ID akun Anda sendiri.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Deny", "Action": "ssm:UpdateServiceSetting", "Resource": "arn:aws:ssm:*:
987654321098
:servicesetting/ssm/documents/console/public-sharing-permission" } ] }
Bagikan SSM dokumen
Anda dapat berbagi AWS Systems Manager (SSM) dokumen dengan menggunakan konsol Systems Manager. Saat berbagi dokumen dari konsol, hanya versi default dokumen yang dapat dibagikan. Anda juga dapat berbagi SSM dokumen secara terprogram dengan memanggil ModifyDocumentPermission
API operasi menggunakan AWS Command Line Interface
(AWS CLI), AWS Tools for Windows PowerShell, atau file. AWS SDK Sebelum Anda berbagi dokumen, dapatkan orang-orang yang ingin Anda bagikan. Akun AWS IDs Anda akan menentukan akun ini IDs ketika Anda membagikan dokumen.
Bagikan dokumen (konsol)
Buka AWS Systems Manager konsol di https://console.aws.amazon.com/systems-manager/
. Di panel navigasi, pilih Dokumen.
-
Dalam daftar dokumen, pilih dokumen yang ingin Anda bagikan, lalu pilih Tampilkan detail. Pada tab Izin, verifikasi bahwa Anda adalah pemilik dokumen. Hanya pemilik dokumen yang dapat berbagi dokumen.
-
Pilih Edit.
-
Untuk berbagi perintah secara publik, pilih publik lalu pilih Simpan. Untuk berbagi perintah secara pribadi, pilih Pribadi, masukkan ID Akun AWS , pilih Tambah izin, lalu pilih Simpan.
Berbagi dokumen (baris perintah)
Prosedur berikut mengharuskan Anda menentukan Wilayah AWS untuk sesi baris perintah Anda.
-
Buka AWS CLI atau AWS Tools for Windows PowerShell di komputer lokal Anda dan jalankan perintah berikut untuk menentukan kredensional Anda.
Dalam perintah berikut, ganti
region
dengan informasi Anda sendiri. Untuk daftar yang didukungregion
nilai, lihat kolom Region di titik akhir layanan Systems Manager di. Referensi Umum Amazon Web Services -
Gunakan perintah berikut untuk membuat daftar semua SSM dokumen yang tersedia untuk Anda. Daftar ini mencakup dokumen yang Anda buat dan dokumen yang dibagikan dengan Anda.
-
Gunakan perintah berikut untuk mendapatkan dokumen tertentu.
-
Gunakan perintah berikut untuk mendapatkan deskripsi dokumen.
-
Gunakan perintah berikut untuk menampilkan izin untuk dokumen.
-
Gunakan perintah berikut untuk mengubah izin untuk dokumen dan berbagi. Anda harus menjadi pemilik dokumen untuk mengedit izin. Secara opsional, Anda dapat menentukan versi dokumen yang ingin Anda bagikan menggunakan
--shared-document-version
parameter. Jika Anda tidak menentukan versi, sistem membagikanDefault
versi dokumen. Perintah contoh ini secara pribadi membagikan dokumen dengan individu tertentu, berdasarkan Akun AWS ID orang tersebut. -
Gunakan perintah berikut untuk berbagi dokumen secara publik.
Ubah izin untuk dokumen bersama SSM
Jika Anda berbagi perintah, pengguna dapat melihat dan menggunakan perintah itu sampai Anda menghapus akses ke AWS Systems Manager (SSM) dokumen atau menghapus SSM dokumen. Namun, Anda tidak dapat menghapus dokumen selama dokumen dibagikan. Anda harus berhenti membagikan terlebih dahulu dan kemudian menghapusnya.
Berhenti membagikan dokumen (konsol)
Berhenti membagikan dokumen
Buka AWS Systems Manager konsol di https://console.aws.amazon.com/systems-manager/
. Di panel navigasi, pilih Dokumen.
-
Dalam daftar dokumen, pilih dokumen yang ingin Anda hentikan berbagi, lalu pilih Detail. Di bagian Izin, verifikasi bahwa Anda adalah pemilik dokumen. Hanya pemilik dokumen yang dapat berhenti berbagi dokumen.
-
Pilih Edit.
-
Pilih X untuk menghapus Akun AWS ID yang seharusnya tidak lagi memiliki akses ke perintah, lalu pilih Simpan.
Berhenti berbagi dokumen (baris perintah)
Buka AWS CLI atau AWS Tools for Windows PowerShell di komputer lokal Anda dan jalankan perintah berikut untuk berhenti berbagi perintah.
Menggunakan SSM dokumen bersama
Saat Anda membagikan dokumen AWS Systems Manager (SSM), sistem akan menghasilkan Amazon Resource Name (ARN) dan menetapkannya ke perintah. Jika Anda memilih dan menjalankan dokumen bersama dari konsol Systems Manager, Anda tidak akan melihat dokumen tersebutARN. Namun, jika Anda ingin menjalankan SSM dokumen bersama menggunakan metode selain konsol Systems Manager, Anda harus menentukan lengkap ARN dokumen untuk parameter DocumentName
permintaan. Anda akan ditampilkan lengkap ARN untuk SSM dokumen ketika Anda menjalankan perintah untuk daftar dokumen.
catatan
Anda tidak diharuskan ARNs untuk menentukan dokumen AWS publik (dokumen yang dimulai denganAWS-*
) atau dokumen yang Anda miliki.
Gunakan SSM dokumen bersama (baris perintah)
Untuk daftar semua SSM dokumen publik
Untuk membuat daftar SSM dokumen pribadi yang telah dibagikan dengan Anda
Untuk mencantumkan semua SSM dokumen yang tersedia untuk Anda
Untuk mendapatkan informasi tentang SSM dokumen yang telah dibagikan dengan Anda
Untuk menjalankan SSM dokumen bersama