Bagaimana Amazon QLDB bekerja dengan IAM

Sebelum Anda menggunakan IAM untuk mengelola akses ke QLDB, pelajari fitur IAM apa yang tersedia untuk digunakan dengan QLDB.

Fitur IAM yang dapat Anda gunakan dengan Amazon QLDB
Fitur IAM	Dukungan QLDB
Kebijakan berbasis identitas	Ya
Kebijakan berbasis sumber daya	Tidak
Tindakan kebijakan	Ya
Sumber daya kebijakan	Ya
Kunci kondisi kebijakan	Ya
ACL	Tidak
ABAC (tanda dalam kebijakan)	Ya
Kredensial sementara	Ya
Izin prinsipal	Tidak
Peran layanan	Ya
Peran terkait layanan	Tidak

Untuk mendapatkan tampilan tingkat tinggi tentang bagaimana QLDB dan Layanan AWS lainnya bekerja dengan sebagian besar fitur IAM, Layanan AWS lihat yang bekerja dengan IAM di Panduan Pengguna IAM.

Kebijakan berbasis identitas untuk QLDB

Mendukung kebijakan berbasis identitas

Ya

Kebijakan berbasis identitas adalah dokumen kebijakan izin JSON yang dapat Anda lampirkan ke sebuah identitas, seperti pengguna IAM, grup pengguna IAM, atau peran IAM. Kebijakan ini mengontrol jenis tindakan yang dapat dilakukan oleh pengguna dan peran, di sumber daya mana, dan berdasarkan kondisi seperti apa. Untuk mempelajari cara membuat kebijakan berbasis identitas, lihat Membuat kebijakan IAM dalam Panduan Pengguna IAM.

Dengan kebijakan berbasis identitas IAM, Anda dapat menentukan secara spesifik apakah tindakan dan sumber daya diizinkan atau ditolak, serta kondisi yang menjadi dasar dikabulkan atau ditolaknya tindakan tersebut. Anda tidak dapat menentukan secara spesifik prinsipal dalam sebuah kebijakan berbasis identitas karena prinsipal berlaku bagi pengguna atau peran yang melekat kepadanya. Untuk mempelajari semua elemen yang dapat Anda gunakan dalam kebijakan JSON, lihat Referensi elemen kebijakan JSON IAM dalam Panduan Pengguna IAM.

Contoh kebijakan berbasis identitas untuk QLDB

Untuk melihat contoh kebijakan berbasis identitas QLDB, lihat. Contoh kebijakan berbasis identitas untuk Amazon QLDB

Kebijakan berbasis sumber daya dalam QLDB

Mendukung kebijakan berbasis sumber daya

Tidak

Kebijakan berbasis sumber daya adalah dokumen kebijakan JSON yang Anda lampirkan ke sumber daya. Contoh kebijakan berbasis sumber daya adalah kebijakan kepercayaan peran IAM dan kebijakan bucket Amazon S3. Dalam layanan yang mendukung kebijakan berbasis sumber daya, administrator layanan dapat menggunakannya untuk mengontrol akses ke sumber daya tertentu. Untuk sumber daya tempat kebijakan dilampirkan, kebijakan menentukan tindakan apa yang dapat dilakukan oleh prinsipal tertentu pada sumber daya tersebut dan dalam kondisi apa. Anda harus menentukan prinsipal dalam kebijakan berbasis sumber daya. Prinsipal dapat mencakup akun, pengguna, peran, pengguna federasi, atau. Layanan AWS

Untuk mengaktifkan akses lintas akun, Anda dapat menentukan secara spesifik seluruh akun atau entitas IAM di akun lain sebagai prinsipal dalam kebijakan berbasis sumber daya. Menambahkan prinsipal akun silang ke kebijakan berbasis sumber daya hanya setengah dari membangun hubungan kepercayaan. Ketika prinsipal dan sumber daya berbeda Akun AWS, administrator IAM di akun tepercaya juga harus memberikan izin entitas utama (pengguna atau peran) untuk mengakses sumber daya. Mereka memberikan izin dengan melampirkan kebijakan berbasis identitas kepada entitas. Namun, jika kebijakan berbasis sumber daya memberikan akses ke prinsipal dalam akun yang sama, tidak diperlukan kebijakan berbasis identitas tambahan. Untuk informasi selengkapnya, lihat Bagaimana peran IAM berbeda dari kebijakan berbasis sumber daya dalam Panduan Pengguna IAM.

Tindakan kebijakan untuk QLDB

Mendukung tindakan kebijakan

Ya

Administrator dapat menggunakan kebijakan AWS JSON untuk menentukan siapa yang memiliki akses ke apa. Artinya, prinsipal manakah yang dapat melakukan tindakan pada sumber daya apa, dan dengan kondisi apa.

Elemen Action dari kebijakan JSON menjelaskan tindakan yang dapat Anda gunakan untuk mengizinkan atau menolak akses dalam sebuah kebijakan. Tindakan kebijakan biasanya memiliki nama yang sama dengan operasi AWS API terkait. Ada beberapa pengecualian, misalnya tindakan hanya izin yang tidak memiliki operasi API yang cocok. Ada juga beberapa operasi yang memerlukan beberapa tindakan dalam suatu kebijakan. Tindakan tambahan ini disebut tindakan dependen.

Menyertakan tindakan dalam kebijakan untuk memberikan izin untuk melakukan operasi terkait.

Untuk melihat daftar tindakan QLDB, lihat Tindakan yang ditentukan oleh Amazon QLDB di Referensi Otorisasi Layanan.

Tindakan kebijakan di QLDB menggunakan awalan berikut sebelum tindakan:

qldb

Untuk menetapkan secara spesifik beberapa tindakan dalam satu pernyataan, pisahkan tindakan tersebut dengan koma.

"Action": [
      "qldb:action1",
      "qldb:action2"
]

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

"Action": "qldb:Describe*"

Untuk berinteraksi dengan API data transaksional QLDB (Sesi QLDB) dengan menjalankan pernyataan PartiQL pada buku besar, Anda harus memberikan izin untuk tindakan sebagai berikut. SendCommand

"Action": "qldb:SendCommand"

Untuk buku besar dalam mode STANDARD izin, lihat untuk izin tambahan yang diperlukan Referensi izin PartiQL untuk setiap perintah PartiQL.

Untuk melihat contoh kebijakan berbasis identitas QLDB, lihat. Contoh kebijakan berbasis identitas untuk Amazon QLDB

Sumber daya kebijakan untuk QLDB

Mendukung sumber daya kebijakan

Ya

Administrator dapat menggunakan kebijakan AWS JSON untuk menentukan siapa yang memiliki akses ke apa. Artinya, prinsipal manakah yang dapat melakukan tindakan pada sumber daya apa, dan dengan kondisi apa.

Elemen kebijakan JSON Resource menentukan objek yang menjadi target penerapan tindakan. Pernyataan harus menyertakan elemen Resource atau NotResource. Praktik terbaiknya, tentukan sumber daya menggunakan Amazon Resource Name (ARN). Anda dapat melakukan ini untuk tindakan yang mendukung jenis sumber daya tertentu, yang dikenal sebagai izin tingkat sumber daya.

Untuk tindakan yang tidak mendukung izin di tingkat sumber daya, misalnya operasi pencantuman, gunakan wildcard (*) untuk menunjukkan bahwa pernyataan tersebut berlaku untuk semua sumber daya.

"Resource": "*"

Untuk melihat daftar jenis sumber daya QLDB dan ARNnya, lihat Sumber daya yang ditentukan oleh Amazon QLDB di Referensi Otorisasi Layanan. Untuk mempelajari tindakan mana yang dapat Anda tentukan ARN dari setiap sumber daya, lihat Tindakan yang ditentukan oleh Amazon QLDB.

Di QLDB, sumber daya utama adalah buku besar. QLDB juga mendukung jenis sumber daya tambahan: tabel dan aliran. Namun, Anda dapat membuat tabel dan aliran hanya dalam konteks buku besar yang ada.

Tabel QLDB adalah pandangan terwujud dari koleksi revisi dokumen yang tidak teratur dari jurnal buku besar. Dalam mode STANDARD izin buku besar, Anda harus membuat kebijakan IAM yang memberikan izin untuk menjalankan pernyataan PartiQL pada sumber daya tabel ini. Dengan izin pada sumber daya tabel, Anda dapat menjalankan pernyataan yang mengakses status tabel saat ini. Anda juga dapat menanyakan riwayat revisi tabel dengan menggunakan history() fungsi bawaan. Untuk mempelajari selengkapnya, lihat Memulai dengan mode izin standar di Amazon QLDB.

catatan

CREATE TABLEPernyataan membuat tabel dengan ID unik dan nama tabel yang disediakan. Nama tabel yang disediakan harus unik di antara semua tabel aktif. Namun, QLDB memungkinkan Anda menonaktifkan tabel, jadi mungkin ada beberapa tabel tidak aktif yang berbagi nama tabel yang sama. Oleh karena itu, ARN sumber daya tabel merujuk ke ID unik yang ditetapkan sistem daripada nama tabel yang ditentukan pengguna.

Setiap buku besar juga menyediakan sumber daya katalog yang ditentukan sistem yang dapat Anda kueri untuk mencantumkan semua tabel dan indeks dalam buku besar. Untuk informasi selengkapnya tentang model objek data QLDB, lihat. Konsep inti dan terminologi di Amazon QLDB

Sumber daya ini memiliki ARN unik yang terkait dengannya, seperti yang ditunjukkan pada tabel berikut.

Jenis Sumber Daya	ARN
ledger	arn:${Partition}:qldb:${Region}:${Account}:ledger/${LedgerName}
table	arn:${Partition}:qldb:${Region}:${Account}:ledger/${LedgerName}/table/${TableId}
catalog	arn:${Partition}:qldb:${Region}:${Account}:ledger/${LedgerName}/information_schema/user_tables
stream	arn:${Partition}:qldb:${Region}:${Account}:stream/${LedgerName}/${StreamId}

Misalnya, untuk menentukan myExampleLedger sumber daya dalam pernyataan Anda, gunakan ARN berikut.

"Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger"

Untuk menentukan beberapa sumber daya dalam satu pernyataan, pisahkan ARN dengan koma.

"Resource": [
      "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger1",
      "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger2"
]

Untuk melihat contoh kebijakan berbasis identitas QLDB, lihat. Contoh kebijakan berbasis identitas untuk Amazon QLDB

Kunci kondisi kebijakan untuk QLDB

Mendukung kunci kondisi kebijakan khusus layanan

Ya

Administrator dapat menggunakan kebijakan AWS JSON untuk menentukan siapa yang memiliki akses ke apa. Artinya, prinsipal manakah yang dapat melakukan tindakan pada sumber daya apa, dan dengan kondisi apa.

Elemen Condition (atau blok Condition) akan memungkinkan Anda menentukan kondisi yang menjadi dasar suatu pernyataan berlaku. Elemen Condition bersifat opsional. 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.

Jika Anda menentukan beberapa elemen Condition dalam sebuah pernyataan, atau beberapa kunci dalam elemen Condition tunggal, maka AWS akan mengevaluasinya menggunakan operasi AND logis. Jika Anda menentukan beberapa nilai untuk satu kunci kondisi, AWS mengevaluasi kondisi menggunakan OR operasi logis. Semua kondisi harus dipenuhi sebelum izin pernyataan diberikan.

Anda juga dapat menggunakan variabel placeholder saat menentukan kondisi. Sebagai contoh, Anda dapat memberikan izin kepada pengguna IAM untuk mengakses sumber daya hanya jika izin tersebut mempunyai tag yang sesuai dengan nama pengguna IAM mereka. Untuk informasi selengkapnya, lihat Elemen kebijakan IAM: variabel dan tag dalam Panduan Pengguna IAM.

AWS mendukung kunci kondisi global dan kunci kondisi khusus layanan. Untuk melihat semua kunci kondisi AWS global, lihat kunci konteks kondisi AWS global di Panduan Pengguna IAM.

Untuk melihat daftar kunci kondisi QLDB, lihat Kunci kondisi untuk Amazon QLDB di Referensi Otorisasi Layanan. Untuk mempelajari tindakan dan sumber daya yang dapat Anda gunakan kunci kondisi, lihat Tindakan yang ditentukan oleh Amazon QLDB.

PartiQLDropTableTindakan PartiQLDropIndex dan mendukung kunci qldb:Purge kondisi. Kunci kondisi ini menyaring akses dengan nilai purge yang ditentukan dalam pernyataan PartiQLDROP. Namun, QLDB saat ini purge = true hanya mendukung DROP INDEX untuk pernyataan, purge = false dan untuk pernyataan. DROP TABLE Tindakan QLDB lainnya mendukung beberapa kunci kondisi global.

Untuk melihat contoh kebijakan berbasis identitas QLDB, lihat. Contoh kebijakan berbasis identitas untuk Amazon QLDB

Daftar kontrol akses (ACL) di QLDB

Mendukung ACL

Tidak

Daftar kontrol akses (ACL) mengendalikan pengguna utama mana (anggota akun, pengguna, atau peran) yang memiliki izin untuk mengakses sumber daya. ACL serupa dengan kebijakan berbasis sumber daya, meskipun kebijakan tersebut tidak menggunakan format dokumen kebijakan JSON.

Kontrol akses berbasis atribut (ABAC) dengan QLDB

Mendukung ABAC (tanda dalam kebijakan)

Ya

Kontrol akses berbasis atribut (ABAC) adalah strategi otorisasi yang menentukan izin berdasarkan atribut. Dalam AWS, atribut ini disebut tag. Anda dapat melampirkan tag ke entitas IAM (pengguna atau peran) dan ke banyak AWS sumber daya. Penandaan ke entitas dan sumber daya adalah langkah pertama dari ABAC. Kemudian rancanglah kebijakan ABAC untuk mengizinkan operasi ketika tag milik prinsipal cocok dengan tag yang ada di sumber daya yang ingin diakses.

ABAC sangat berguna di lingkungan yang berkembang dengan cepat dan berguna di situasi saat manajemen kebijakan menjadi rumit.

Untuk mengendalikan akses berdasarkan tag, berikan informasi tentang tag di elemen kondisi dari kebijakan menggunakan kunci kondisi aws:ResourceTag/key-name, aws:RequestTag/key-name, atau aws:TagKeys.

Jika sebuah layanan mendukung ketiga kunci kondisi untuk setiap jenis sumber daya, nilainya adalah Ya untuk layanan tersebut. Jika suatu layanan mendukung ketiga kunci kondisi untuk hanya beberapa jenis sumber daya, nilainya adalah Parsial.

Untuk informasi selengkapnya tentang ABAC, lihat Apa itu ABAC? dalam Panduan Pengguna IAM. Untuk melihat tutorial yang menguraikan langkah-langkah pengaturan ABAC, lihat Menggunakan kontrol akses berbasis atribut (ABAC) dalam Panduan Pengguna IAM.

Untuk informasi selengkapnya tentang menandai sumber daya QLDB, lihat. Pemberian tag pada sumber daya Amazon QLDB

Untuk melihat contoh kebijakan berbasis identitas untuk membatasi akses ke sumber daya berdasarkan tag pada sumber daya tersebut, lihat Memperbarui buku besar QLDB berdasarkan tag.

Menggunakan kredensyal Sementara dengan QLDB

Mendukung penggunaan kredensial sementara

Ya

Beberapa Layanan AWS tidak berfungsi saat Anda masuk menggunakan kredensil sementara. Untuk informasi tambahan, termasuk yang Layanan AWS bekerja dengan kredensyal sementara, lihat Layanan AWS yang bekerja dengan IAM di Panduan Pengguna IAM.

Anda menggunakan kredensi sementara jika Anda masuk AWS Management Console menggunakan metode apa pun kecuali nama pengguna dan kata sandi. Misalnya, ketika Anda mengakses AWS menggunakan tautan masuk tunggal (SSO) perusahaan Anda, proses tersebut secara otomatis membuat kredensil sementara. Anda juga akan secara otomatis membuat kredensial sementara ketika Anda masuk ke konsol sebagai seorang pengguna lalu beralih peran. Untuk informasi selengkapnya tentang peralihan peran, lihat Peralihan peran (konsol) dalam Panduan Pengguna IAM.

Anda dapat membuat kredensyal sementara secara manual menggunakan API AWS CLI atau AWS . Anda kemudian dapat menggunakan kredensi sementara tersebut untuk mengakses. AWS AWS merekomendasikan agar Anda secara dinamis menghasilkan kredensi sementara alih-alih menggunakan kunci akses jangka panjang. Untuk informasi selengkapnya, lihat Kredensial keamanan sementara di IAM.

Izin utama lintas layanan untuk QLDB

Mendukung sesi akses maju (FAS)

Tidak

Saat Anda menggunakan pengguna atau peran IAM untuk melakukan tindakan AWS, Anda dianggap sebagai prinsipal. Ketika Anda menggunakan beberapa layanan, Anda mungkin melakukan sebuah tindakan yang kemudian menginisiasi tindakan lain di layanan yang berbeda. FAS menggunakan izin dari pemanggilan utama Layanan AWS, dikombinasikan dengan permintaan Layanan AWS untuk membuat permintaan ke layanan hilir. Permintaan FAS hanya dibuat ketika layanan menerima permintaan yang memerlukan interaksi dengan orang lain Layanan AWS atau sumber daya untuk menyelesaikannya. Dalam hal ini, Anda harus memiliki izin untuk melakukan kedua tindakan tersebut. Untuk detail kebijakan ketika mengajukan permintaan FAS, lihat Sesi akses maju.

Peran layanan untuk QLDB

Mendukung peran layanan

Ya

Peran layanan adalah peran IAM yang diambil oleh sebuah layanan untuk melakukan tindakan atas nama Anda. Administrator IAM dapat membuat, mengubah, dan menghapus peran layanan dari dalam IAM. Untuk informasi selengkapnya, lihat Membuat sebuah peran untuk mendelegasikan izin ke Layanan AWS dalam Panduan pengguna IAM.

Awas

Mengubah izin untuk peran layanan dapat merusak fungsionalitas QLDB. Edit peran layanan hanya jika QLDB memberikan panduan untuk melakukannya.

QLDB mendukung peran layanan untuk operasi StreamJournalToKinesis dan API, seperti yang dijelaskan di ExportJournalToS3 bagian berikut.

Memilih peran IAM di QLDB

Saat Anda mengekspor atau mengalirkan blok jurnal di QLDB, Anda harus memilih peran untuk mengizinkan QLDB menulis objek ke tujuan yang diberikan atas nama Anda. Jika sebelumnya Anda telah membuat peran layanan, QLDB memberi Anda daftar peran yang dapat dipilih. Penting untuk memilih peran yang memungkinkan akses untuk menulis ke bucket Amazon S3 yang ditentukan untuk ekspor, atau ke sumber daya Amazon Kinesis Data Streams yang ditentukan untuk aliran. Untuk informasi selengkapnya, lihat Izin ekspor jurnal di QLDB atau Izin streaming di QLDB.

catatan

Untuk meneruskan peran ke QLDB saat meminta ekspor atau streaming jurnal, Anda harus memiliki izin untuk melakukan iam:PassRole tindakan pada sumber daya peran IAM. Ini adalah tambahan untuk izin untuk melakukan qldb:ExportJournalToS3 pada sumber daya buku besar QLDB, atau qldb:StreamJournalToKinesis pada subsumber daya aliran QLDB.

Peran terkait layanan untuk QLDB

Mendukung peran terkait layanan

Tidak

Peran terkait layanan adalah jenis peran layanan yang ditautkan ke. Layanan AWS Layanan tersebut dapat menjalankan peran untuk melakukan tindakan atas nama Anda. Peran terkait layanan muncul di Anda Akun AWS dan dimiliki oleh layanan. Administrator IAM dapat melihat, tetapi tidak dapat mengedit izin untuk peran terkait layanan.

Untuk detail tentang membuat atau mengelola peran terkait layanan, lihat Layanan AWS bahwa bekerja dengan IAM. Cari layanan dalam tabel yang memiliki Yes di kolom Peran terkait layanan. Pilih tautan Ya untuk melihat dokumentasi peran terkait layanan untuk layanan tersebut.