s3aclp - Online di Cloud

PROGRAM:

NAMA

s3acl - Menampilkan atau memanipulasi ACL dari bucket dan item AWS S3

RINGKASAN

s3acl [opsi] [[bucket|bucket/key] ...]

Pilihan:
--akses-key ID Kunci Akses AWS
--kunci-rahasia Kunci Akses Rahasia AWS
--get Keluarkan ACL ke STDOUT
--xml dalam bentuk XML mentah alih-alih bentuk yang diuraikan
--set Ubah ACL
--clear hapus semua hibah dari ACL
--tambahkan hibah, hibah,... tambahkan hibah ke ACL
--del grant,grant,... menghapus hibah yang cocok dari ACL
--xml menerapkan XML ACL dari STDIN ke item
--acl-short cannedacl menerapkan ACL "kalengan" ke item
Lingkungan Hidup:
AWS_ACCESS_KEY_ID
AWS_ACCESS_KEY_SECRET

PILIHAN

--membantu Cetak pesan bantuan singkat dan keluar.

--pria Mencetak halaman manual dan keluar.

--bertele-tele
Output apa yang sedang dilakukan seperti yang dilakukan.

--kunci akses dan --kunci rahasia
Tentukan "AWS Access Key Identifiers" untuk akun AWS. --kunci akses adalah
"ID Kunci Akses", dan --kunci rahasia adalah "Kunci Akses Rahasia". Ini adalah
efektif "nama pengguna" dan "kata sandi" ke akun AWS, dan harus disimpan
rahasia.

Kunci akses HARUS ditentukan, baik melalui parameter baris perintah ini, atau
melalui AWS_ACCESS_KEY_ID dan AWS_ACCESS_KEY_SECRET variabel lingkungan.

Menentukan mereka pada baris perintah menimpa variabel lingkungan.

--aman
Menggunakan SSL/TLS HTTPS untuk berkomunikasi dengan layanan AWS, bukan HTTP.

--Dapatkan Ambil dan tampilkan ACL untuk setiap ember atau item yang ditentukan.

--xml Saat digunakan dengan --Dapatkan opsi, output ke stdout XML mentah, alih-alih diuraikan
format. XML mentah ini didokumentasikan dalam "Panduan Pengembang Amazon S3".

Jika lebih dari satu ember atau item ditentukan, XML ACL untuk masing-masing akan menjadi output,
digabungkan bersama. Ini mungkin tidak terlalu berguna.

Output XML mentah dapat digunakan sebagai input untuk --mengatur pilihan, seperti:

s3acl --dapatkan --xml bucketA | s3acl --set --xml bucketB bucketC

Ini tidak berfungsi saat menentukan lebih dari satu ember atau item ke --Dapatkan
pilihan, karena penggabungan beberapa XML ACL bukan XML ACL yang valid.

--mengatur Alih-alih menampilkan ACL, modifikasilah. Sebuah ACL dapat dimodifikasi dengan menggunakan
--jernih, --Menambahkan, dan -del, atau dengan menggunakan --xml, atau dengan menggunakan --acl pendek.

--jernih Menghapus semua hibah dari ACL. Ini termasuk akses oleh pemilik
ember atau barang. Hal ini dilakukan sebelum --Menambahkan or -del opsi diterapkan, tidak
peduli opsi pesanan apa yang ditentukan pada baris perintah.

Biasanya disertai dengan --Menambahkan opsi untuk menambahkan beberapa hibah kembali ke sekarang
ACL kosong.

-del Hapus hibah yang cocok dari ACL. Hal ini dilakukan sebelum --Menambahkan pilihannya adalah
diterapkan, apa pun opsi pesanan yang ditentukan pada baris perintah.

Hibah ditentukan dalam bentuk yang diuraikan, dan kemudian digabungkan dengan koma tanpa no
spasi.

Ada ekstensi untuk format hibah yang diuraikan. Jika penerima hibah ditentukan sebagai
"APAPUN", maka cocok dengan setiap dan semua penerima di ACL. Jika izinnya adalah
ditentukan sebagai "APAPUN", maka cocok dengan izin apa pun. Dengan demikian

s3acl --set --del APA PUN: BACA mybucket

menghapus semua hibah yang memberikan izin BACA, dan

s3acl --set --del someuserid: ANY mybucket

menghapus semua hibah kepada pengguna someuserid

s3acl --set -del APAPUN: APAPUN mybucket

melakukan hal yang sama dengan

s3acl --set --hapus mybucket

Karena keterbatasan semantik API S3, tidak mungkin untuk menghapus
penerima hibah melalui alamat email, hanya dengan ID kanonik.

--Menambahkan Tambahkan hibah yang ditentukan ke ACL. Hibah ditentukan dalam bentuk yang diuraikan, dan
kemudian digabungkan dengan koma tanpa spasi.

Dimungkinkan untuk menambahkan hibah yang sama ke ember atau item lebih dari sekali. Ini adalah
perilaku mengejutkan dari layanan S3.

--xml Saat digunakan dengan --mengatur, dan alih-alih menggunakan <--clear>, <--del>, dan --Menambahkan, Baca sebuah
mentah XML ACL dari STDIN, dan kemudian menerapkannya ke setiap ember atau item yang diberikan. Ini akan
sepenuhnya menimpa ACL yang ada untuk setiap ember atau item yang diberikan.

--acl pendek
Alih-alih menggunakan <--clear>, <--del>, dan --Menambahkan, atau menggunakan <--xml>, terapkan "kalengan
ACL" untuk setiap ember atau item yang diberikan. Ini akan sepenuhnya menimpa yang ada
ACL untuk setiap ember atau item yang diberikan.

ACL kalengan berikut saat ini ditentukan oleh S3:

swasta Pemilik mendapatkan "FULL_CONTROL". Tidak ada orang lain yang memiliki hak akses. Ini adalah
default untuk bucket dan item yang baru dibuat.

baca umum
Pemilik mendapatkan "FULL_CONTROL". Kepala sekolah anonim diberikan "BACA"
mengakses.

publik-baca-tulis
Pemilik mendapatkan "FULL_CONTROL".

Prinsipal anonim diberikan akses "BACA" dan "TULIS". Ini adalah sebuah
kebijakan yang berguna untuk diterapkan ke ember, jika Anda bermaksud untuk pengguna anonim
untuk PUT objek ke dalam ember.

terautentikasi-baca
Pemilik mendapatkan "FULL_CONTROL" . Setiap prinsipal yang diautentikasi sebagai terdaftar
Pengguna Amazon S3 diberikan akses "BACA".

ember or ember/kunci
Satu atau beberapa nama bucket atau nama bucket dan kunci, menentukan item. Sebanyak
mungkin akan diproses.

Jika hanya nama bucket yang diberikan, ACL untuk bucket tersebut akan diambil atau dimodifikasi.

Jika nama ember dan kunci, dipisahkan oleh garis miring, diberikan, ACL untuk kunci itu
dalam ember itu diambil atau diubah.

Jika nama bucket dimulai dengan satu atau lebih tanda hubung, mungkin akan disalahartikan sebagai
opsi baris perintah. Jika ini masalahnya, pisahkan opsi baris perintah dari
nama ember atau ember/kunci dengan dua tanda hubung, seperti:

s3acl --get -- --bucketname/nama kunci

LINGKUNGAN VARIABEL

AWS_ACCESS_KEY_ID dan AWS_ACCESS_KEY_SECRET
Tentukan "AWS Access Key Identifiers" untuk akun AWS. AWS_ACCESS_KEY_ID
berisi "ID Kunci Akses", dan AWS_ACCESS_KEY_SECRET berisi "Rahasia
Kunci Akses". Ini secara efektif adalah "nama pengguna" dan "kata sandi" untuk AWS
layanan, dan harus dijaga kerahasiaannya.

Kunci akses HARUS ditentukan, baik melalui variabel lingkungan ini, atau melalui
itu --kunci akses dan --kunci rahasia parameter baris perintah.

Jika parameter baris perintah diatur, mereka menimpa variabel lingkungan ini.

KONFIGURASI FILE

Opsi konfigurasi akan dibaca dari file "~ / .S3-alat" jika itu ada. The
formatnya sama dengan opsi baris perintah dengan satu opsi per baris. Misalnya,
file dapat berisi:

--kunci akses
--kunci rahasia
--aman

File konfigurasi contoh ini akan menentukan kunci akses AWS dan yang aman
koneksi menggunakan HTTPS harus digunakan untuk semua komunikasi.

DESKRIPSI

Mengambil dan mengeluarkan Access Control List (ACL) bucket dan item dalam bucket di
Amazon Simple Storage Service (S3).

Kepala sekolah
(Sebagian besar teks berikut diambil dari "Panduan Pengembang Amazon S3 (Versi API .)
2006-03-01)".)

Setiap bucket dan item memiliki Access Control List (ACL). Saat permintaan dibuat, S3
menentukan prinsipal yang membuat permintaan, dan kemudian memeriksa daftar kontrol akses untuk
melihat apakah kepala sekolah itu berwenang untuk membuat permintaan. Jika ACL berisi entri
memberi wewenang kepada prinsipal untuk membuat permintaan ini, permintaan diizinkan untuk dilanjutkan,
jika tidak, kesalahan dikembalikan.

Prinsipal mungkin seseorang dengan akun AWS S3 yang telah masuk, atau "diautentikasi".
Prinsipal mungkin adalah pencipta dan pemilik ember atau item. Atau kepala sekolah
mungkin beberapa browser web anonim di internet.

ACL is urutan of hibah. A memberikan is 1 penerima beasiswa dan 1 izin.
Daftar kontrol akses adalah urutan hibah. Ini mungkin berisi hingga 100 hibah. Sebuah hibah
terdiri dari satu penerima hibah, yang merupakan deskripsi kepala sekolah yang akan diizinkan
akses, dan satu izin, yang merupakan deskripsi tentang apa yang boleh dilakukan oleh kepala sekolah itu
dengan ember atau barang itu.

Pengguna Penerima beasiswa
Penerima hibah pengguna harus terdaftar sebagai pelanggan Amazon.com, tetapi tidak harus
terdaftar sebagai pelanggan AWS.

Ketika ACL dibaca, penerima hibah pengguna akan ditampilkan dalam format kanonik, yang
terdiri dari 64 karakter hex. Pengecualian adalah jika penerima hibah adalah pemiliknya. Amazon
masih menyimpan dan mengembalikan penerima hibah dalam bentuk kanonik, tetapi alat ini menampilkannya sebagai
"PEMILIK".

Kelompok Penerima beasiswa
Satu-satunya grup yang tersedia adalah grup yang telah ditentukan sebelumnya oleh S3. Dalam rilis S3 saat ini, Anda
tidak dapat membuat grup Anda sendiri. Saat ini ada dua grup yang telah ditentukan sebelumnya.

Yang pertama diwakili oleh string "WORLD" oleh alat ini. Semua kepala sekolah, apakah mereka
anonim atau diautentikasi, dianggap sebagai bagian dari grup ini.

Yang kedua diwakili oleh string "USERS" oleh alat ini. Setiap non-anonim
kepala sekolah dianggap sebagai bagian dari kelompok. Perhatikan bahwa izin yang diberikan berdasarkan ini
hibah tidak mengalahkan pertimbangan kontrol akses lainnya. Misalnya, jika pengguna adalah
terdaftar di AWS, mereka mungkin menjadi bagian dari grup ini, tetapi jika mereka belum berlangganan
S3, mereka tetap tidak akan diberikan akses.

Ada juga grup semu khusus dengan string "ANY". Ini digunakan oleh -del
opsi untuk mencocokkan dengan item ACL untuk dipilih untuk dihapus.

Jika Amazon memperbarui S3 untuk menentukan grup tambahan apa pun sebelum alat ini diperbarui, mereka
akan direpresentasikan sebagai URI yang dikelilingi oleh kurung sudut.

pemilik
Setiap ember dan item di S3 memiliki atribut pemilik yang terkait dengannya. Pemilik pengguna
yang membuat ember atau item. Satu-satunya cara untuk mengubah pemilik ember adalah dengan menghapus
ember dan buat lagi dengan identitas pengguna yang berbeda. Satu-satunya cara untuk mengubah
pemilik suatu barang akan menimpa barang tersebut dengan menggunakan identitas yang berbeda.

Pemilik ember atau item tunduk pada kebijakan kontrol akses ember itu atau
item sama seperti orang lain, dengan dua pengecualian penting: Pemilik sumber daya selalu
memiliki kemampuan untuk membaca dan menulis ACL sumber daya itu, apa pun yang terkait
kata ACL. Misalnya, sebagai pemilik item, Anda dapat menghapus diri sendiri dari
daftar kontrol akses terkait, dan menemukan bahwa Anda tidak dapat lagi membaca data item dan
metadata. Namun, karena menjadi pemilik, Anda selalu memiliki hak untuk memberikan kembali
sendiri izin untuk itu. Kebijakan ini mencegah situasi di mana item menjadi
"terdampar," tanpa ada yang bisa mengubah atau bahkan menghapusnya.

izin
Izin dalam hibah menjelaskan jenis akses yang akan diberikan kepada masing-masing
penerima beasiswa. Izin berikut didukung:

BACA Ketika diterapkan ke ember, ini memberikan izin untuk membuat daftar ember. Saat diterapkan
ke item, ini memberikan izin untuk membaca data item dan/atau metadata.

MENULIS Saat diterapkan ke ember, ini memberikan izin untuk membuat, menimpa, dan menghapus
item apa pun di ember. Izin ini tidak didukung untuk item (sudah dipesan
untuk penggunaan di masa depan).

BACA_ACP
Memberikan izin untuk membaca kebijakan kontrol akses (ACL dan pemilik) untuk
ember atau item yang berlaku. Pemilik ember atau barang selalu memiliki ini
izin secara implisit.

TULIS_ACP
Memberikan izin untuk menimpa ACP untuk bucket atau item yang berlaku. NS
pemilik ember atau item selalu memiliki izin ini secara implisit. Perhatikan bahwa
memberikan izin ini sama dengan memberikan FULL_CONTROL, karena pemberiannya
penerima sekarang dapat membuat perubahan apa pun pada ACP yang dia suka!

KONTROL PENUH
Izin ini adalah singkatan dari gabungan READ, WRITE, READ_ACP, dan
izin WRITE_ACP. Itu tidak memberikan hak tambahan, dan hanya disediakan
untuk kenyamanan. Mungkin tidak bijaksana untuk memberikan izin ini kepada DUNIA.

APAPUN Ini sebenarnya bukan izin, tetapi digunakan oleh -del pilihan. Ini cocok dengan apa pun
izin untuk memilih hibah untuk dihapus.

Default ACL
Jika tidak ada ACL yang disediakan pada saat ember dibuat atau item ditulis, maka default
ACL dibuat. ACL default untuk sumber daya baru terdiri dari hibah tunggal yang memberikan
pemilik sumber daya (yaitu prinsipal yang membuat permintaan untuk membuat ember atau
untuk menulis item) izin FULL_CONTROL. Perhatikan bahwa jika Anda menimpa item yang ada,
ACL untuk item yang ada selalu ditimpa juga, dan default kembali ke
OWNER:FULL_CONTROL jika tidak ada ACL eksplisit yang disediakan.

Mentah XML ACL dibentuk
Format XML ACL didokumentasikan dalam "Panduan Pengembang Amazon S3".

Diurai ACL dibentuk
Alat ini mem-parsing format XML ACL mentah menjadi bentuk yang lebih mudah dibaca.

ACL yang diurai terdiri dari beberapa baris. Komentar adalah baris yang dimulai dengan hash
karakter. Baris yang bukan komentar adalah hibah.

Untuk ember, komentar memberikan nama ember, dan string pengguna kanonik Amazon untuk
pemilik.

Untuk item, komentar memberikan nama bucket, kunci item, dan pengguna kanonik Amazon
tali untuk pemiliknya.

Hibah adalah string penerima dan string izin, dipisahkan dengan karakter titik dua. A
penerima hibah dapat berupa salah satu string "OWNER", "WORLD", atau "USERS", atau URI yang dibungkus sudut
tanda kurung, atau alamat email pengguna Amazon, atau string pengguna kanonik Amazon, yang
adalah 64 karakter hex. Izin adalah salah satu string "READ", "WRITE", "READ_ACP",
"WRITE_ACP", atau "FULL_CONTROL".

$ ./s3getaccl contoh
# ember: contoh
# owner: 5a1568e09392dad4b4ceb54f29f0a64d651a531350d6f720fbd2367eed995f08
PEMILIK:FULL_CONTROL
a00490decea9d0ad76e5ef8b450b3efa63861adccfb9197cfb42f837eb222df2:WRITE
PENGGUNA: BACA
DUNIA: BACA
$ ./s3getacl contoh/barang
# ember: contoh
# barang: barang
# owner: 5a1568e09392dad4b4ceb54f29f0a64d651a531350d6f720fbd2367eed995f08
PEMILIK:FULL_CONTROL
$_

Gunakan s3aclp online menggunakan layanan onworks.net