翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon での のQLDB仕組み IAM
IAM を使用して へのアクセスを管理する前にQLDB、 で使用できるIAM機能について説明しますQLDB。
重要
サポート終了通知: 既存のお客様は、07/31/2025 のサポート終了QLDBまで Amazon を使用できます。詳細については、「Amazon QLDB 台帳を Amazon Aurora Postgre に移行するSQL
| IAM 機能 | QLDB サポート |
|---|---|
|
あり |
|
|
なし |
|
|
あり |
|
|
Yes |
|
|
はい |
|
|
なし |
|
|
はい |
|
|
あり |
|
|
いいえ |
|
|
あり |
|
|
なし |
QLDB および他の がほとんどのIAM機能で AWS のサービス どのように機能するかの概要を確認するには、 IAM ユーザーガイドの AWS のサービス で が機能するIAMを参照してください。
QLDB のアイデンティティベースのポリシー
アイデンティティベースのポリシーのサポート: あり
ID ベースのポリシーは、IAMユーザー、ユーザーのグループ、ロールなどの ID にアタッチできるJSONアクセス許可ポリシードキュメントです。これらのポリシーは、ユーザーとロールが実行できるアクション、リソース、および条件をコントロールします。ID ベースのポリシーを作成する方法については、IAM「 ユーザーガイド」の「カスタマーマネージドポリシーを使用したカスタムIAMアクセス許可の定義」を参照してください。
IAM ID ベースのポリシーでは、許可または拒否されたアクションとリソース、およびアクションが許可または拒否される条件を指定できます。プリンシパルは、それが添付されているユーザーまたはロールに適用されるため、アイデンティティベースのポリシーでは指定できません。JSON ポリシーで使用できるすべての要素については、 IAM ユーザーガイドのIAMJSON「ポリシー要素リファレンス」を参照してください。
QLDB のアイデンティティベースのポリシーの例
QLDB ID ベースのポリシーの例を表示するには、「」を参照してくださいAmazon のアイデンティティベースのポリシーの例 QLDB。
QLDB 内のリソースベースのポリシー
リソースベースのポリシーのサポート: なし
リソースベースのポリシーは、リソースにアタッチするJSONポリシードキュメントです。リソースベースのポリシーの例としては、IAMロール信頼ポリシーと Amazon S3 バケットポリシー があります。リソースベースのポリシーをサポートするサービスでは、サービス管理者はポリシーを使用して特定のリソースへのアクセスをコントロールできます。ポリシーがアタッチされているリソースの場合、指定されたプリンシパルがそのリソースに対して実行できるアクションと条件は、ポリシーによって定義されます。リソースベースのポリシーでは、プリンシパルを指定する必要があります。プリンシパルには、アカウント、ユーザー、ロール、フェデレーティッドユーザー、 を含めることができます AWS のサービス。
クロスアカウントアクセスを有効にするには、リソースベースのポリシーのプリンシパルとして、別のアカウントのアカウントまたはIAMエンティティ全体を指定できます。リソースベースのポリシーにクロスアカウントのプリンシパルを追加しても、信頼関係は半分しか確立されない点に注意してください。プリンシパルとリソースが異なる にある場合 AWS アカウント、信頼されたアカウントのIAM管理者は、プリンシパルエンティティ (ユーザーまたはロール) にリソースへのアクセス許可も付与する必要があります。IAM 管理者は、アイデンティティベースのポリシーをエンティティにアタッチすることで権限を付与します。ただし、リソースベースのポリシーで、同じアカウントのプリンシパルへのアクセス権が付与されている場合は、アイデンティティベースのポリシーをさらに付与する必要はありません。詳細については、「 ユーザーガイド」の「 のクロスアカウントリソースアクセスIAM」を参照してください。 IAM
QLDB のポリシーアクション
ポリシーアクションのサポート: あり
管理者はポリシーを使用して AWS JSON、誰が何にアクセスできるかを指定できます。つまり、どのプリンシパルがどのリソースに対してどのような条件下でアクションを実行できるかということです。
JSON ポリシーの Action要素は、ポリシー内のアクセスを許可または拒否するために使用できるアクションについて説明します。ポリシーアクションは通常、関連付けられた AWS APIオペレーションと同じ名前を持ちます。一致するAPIオペレーションがないアクセス許可のみのアクションなど、いくつかの例外があります。また、ポリシーに複数のアクションが必要なオペレーションもあります。これらの追加アクションは、依存アクションと呼ばれます。
このアクションは、関連付けられたオペレーションを実行するための権限を付与するポリシーで使用されます。
QLDB アクションのリストを表示するには、「サービス認可リファレンス」の「Amazon によって定義されたアクションQLDB」を参照してください。
のポリシーアクションは、アクションの前に次のプレフィックスQLDBを使用します。
qldb
単一のステートメントで複数のアクションを指定するには、アクションをカンマで区切ります。
"Action": [ "qldb:action1", "qldb:action2" ]
ワイルドカード (*) を使用して複数アクションを指定できます。例えば、Describe という単語で始まるすべてのアクションを指定するには、次のアクションを含めます。
"Action": "qldb:Describe*"
台帳で PartiQL ステートメントを実行してQLDBトランザクションデータ API ( QLDBセッション) を操作するには、次のようにSendCommandアクションへのアクセス許可を付与する必要があります。
"Action": "qldb:SendCommand"
STANDARD アクセス許可モードの台帳の場合は、「PartiQL アクセス許可のリファレンス」を参照して、各 PartiQL コマンドに必要な追加のアクセス許可を確認してください。
QLDB ID ベースのポリシーの例を表示するには、「」を参照してくださいAmazon のアイデンティティベースのポリシーの例 QLDB。
のポリシーリソース QLDB
ポリシーリソースのサポート: あり
管理者はポリシーを使用して AWS JSON、誰が何にアクセスできるかを指定できます。つまり、どのプリンシパルがどのリソースに対してどのような条件下でアクションを実行できるかということです。
Resource JSON ポリシー要素は、アクションが適用されるオブジェクトを指定します。ステートメントには、Resource または NotResource 要素を含める必要があります。ベストプラクティスとして、Amazon リソースネーム (ARN) を使用してリソースを指定します。これは、リソースレベルの許可と呼ばれる特定のリソースタイプをサポートするアクションに対して実行できます。
オペレーションのリスト化など、リソースレベルの権限をサポートしないアクションの場合は、ステートメントがすべてのリソースに適用されることを示すために、ワイルドカード (*) を使用します。
"Resource": "*"
QLDB リソースタイプとその のリストを確認するにはARNs、「 サービス認可リファレンス」の「Amazon によって定義されるリソースQLDB」を参照してください。各リソースARNの を指定できるアクションについては、「Amazon で定義されているアクションQLDB」を参照してください。
ではQLDB、プライマリリソースは台帳 です。QLDB は、テーブルとストリーム という追加のリソースタイプもサポートしています。ただし、既存の台帳のコンテキストでのみ、テーブルやストリームを作成できます。
QLDB テーブルは、台帳のジャーナルからのドキュメントリビジョンの順序付けられていないコレクションをマテリアライズドビューです。台帳のSTANDARDアクセス許可モードでは、このテーブルリソースで PartiQL ステートメントを実行するアクセス許可を付与するIAMポリシーを作成する必要があります。テーブルリソースに対するアクセス許可を使用すると、テーブルの現在の状態にアクセスするステートメントを実行できます。組み込みの history() 関数を使用してテーブルのリビジョン履歴のクエリを実行することもできます。詳細については、「Amazon での標準アクセス許可モードの開始方法 QLDB」を参照してください。
注記
CREATE TABLE ステートメントは、一意の ID と指定されたテーブル名を持つテーブルを作成します。指定するテーブル名は、すべてのアクティブなテーブルの中で一意である必要があります。ただし、 QLDB ではテーブルを非アクティブ化できるため、同じテーブル名を共有する複数の非アクティブなテーブルが存在する可能性があります。したがって、テーブルリソースは、ユーザー定義のテーブル名ではなく、システムに割り当てられた一意の ID ARNsを指します。
各台帳では、システム定義のカタログリソースも提供され、このリソースでクエリを実行して台帳内のすべてのテーブルとインデックスを一覧表示できます。QLDB データオブジェクトモデルの詳細については、「」を参照してくださいAmazon の主要な概念と用語 QLDB。
次の表に示すように、これらのリソースには一意の がARNs関連付けられています。
| リソースタイプ | 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}
|
例えば、 ステートメントでmyExampleLedgerリソースを指定するには、次の を使用しますARN。
"Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger"
1 つのステートメントで複数のリソースを指定するには、 をカンマARNsで区切ります。
"Resource": [ "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger1", "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger2" ]
QLDB ID ベースのポリシーの例を表示するには、「」を参照してくださいAmazon のアイデンティティベースのポリシーの例 QLDB。
QLDB 向けのポリシー条件キー
サービス固有のポリシー条件キーのサポート: あり
管理者はポリシーを使用して AWS JSON、誰が何にアクセスできるかを指定できます。つまり、どのプリンシパルが、どのリソースに対してどのような条件下でアクションを実行できるかということです。
Condition 要素 (または Condition ブロック) を使用すると、ステートメントが有効な条件を指定できます。Condition 要素はオプションです。イコールや未満などの条件演算子を使用して条件式を作成することで、ポリシーの条件とリクエスト内の値を一致させることができます。
1 つのステートメントに複数の Condition 要素を指定する場合、または 1 つの Condition 要素に複数のキーを指定する場合、 AWS では AND 論理演算子を使用してそれらを評価します。1 つの条件キーに複数の値を指定すると、 は論理ORオペレーションを使用して条件 AWS を評価します。ステートメントの権限が付与される前にすべての条件が満たされる必要があります。
条件を指定する際にプレースホルダー変数も使用できます。例えば、リソースにIAMユーザー名がタグ付けされている場合にのみ、リソースにアクセスするアクセス許可をIAMユーザーに付与できます。詳細については、「 ユーザーガイド」のIAM「ポリシー要素: 変数とタグ」を参照してください。 IAM
AWS は、グローバル条件キーとサービス固有の条件キーをサポートしています。すべての AWS グローバル条件キーを表示するには、 ユーザーガイドのAWS 「グローバル条件コンテキストキー」を参照してください。 IAM
QLDB 条件キーのリストを確認するには、「サービス認可リファレンス」の「Amazon の条件キーQLDB」を参照してください。 条件キーを使用できるアクションとリソースについては、「Amazon で定義されているアクションQLDB」を参照してください。
PartiQLDropIndex アクションおよび PartiQLDropTable アクションは、qldb:Purge 条件キーをサポートします。この条件キーは PartiQL DROP ステートメントで指定された purge の値でアクセスをフィルタします。ただし、 QLDB は現在、 purge = true DROP INDEXステートメントと purge = falseDROP TABLEステートメントでのみ をサポートしています。その他のQLDBアクションでは、一部のグローバル条件キーがサポートされています。
QLDB ID ベースのポリシーの例を表示するには、「」を参照してくださいAmazon のアイデンティティベースのポリシーの例 QLDB。
のアクセスコントロールリスト (ACLs) QLDB
をサポートACLs： なし
アクセスコントロールリスト (ACLs) は、どのプリンシパル (アカウントメンバー、ユーザー、またはロール) がリソースにアクセスするアクセス許可を持っているかを制御します。ACLs はリソースベースのポリシーに似ていますが、JSONポリシードキュメント形式は使用しません。
を使用した属性ベースのアクセスコントロール (ABAC) QLDB
サポート ABAC (ポリシーのタグ): はい
属性ベースのアクセスコントロール (ABAC) は、属性に基づいてアクセス許可を定義する認可戦略です。では AWS、これらの属性はタグ と呼ばれます。タグは、IAMエンティティ (ユーザーまたはロール) および多くの AWS リソースにアタッチできます。エンティティとリソースのタグ付けは、 の最初のステップですABAC。次に、プリンシパルのタグがアクセスしようとしているリソースのタグと一致する場合に、オペレーションを許可するABACポリシーを設計します。
ABAC は、急速に成長している環境や、ポリシー管理が煩雑になる状況で役立ちます。
タグに基づいてアクセスを管理するには、aws:ResourceTag/、key-nameaws:RequestTag/、または key-nameaws:TagKeys の条件キーを使用して、ポリシーの 条件要素でタグ情報を提供します。
サービスがすべてのリソースタイプに対して 3 つの条件キーすべてをサポートする場合、そのサービスの値はありです。サービスが一部のリソースタイプに対してのみ 3 つの条件キーのすべてをサポートする場合、値は「部分的」になります。
の詳細についてはABAC、「 ユーザーガイド」のABAC「認可によるアクセス許可の定義」を参照してください。 IAM のセットアップ手順を含むチュートリアルを表示するにはABAC、 IAM ユーザーガイドの「属性ベースのアクセスコントロールを使用する (ABAC）」を参照してください。
QLDB リソースのタグ付けの詳細については、「」を参照してくださいAmazon QLDBリソースのタグ付け。
リソースのタグに基づいてリソースへのアクセスを制限するためのアイデンティティベースポリシーの例を表示するには、「タグに基づくQLDB台帳の更新」を参照してください。
QLDB での一時的な認証情報の使用
一時的な認証情報のサポート: あり
一部の AWS のサービス は、一時的な認証情報を使用してサインインすると機能しません。一時的な認証情報 AWS のサービス を使用する方法など、詳細については、 IAM ユーザーガイドのAWS のサービス 「 を使用する方法IAM」を参照してください。
ユーザー名とパスワード以外の AWS Management Console 方法で にサインインする場合は、一時的な認証情報を使用します。例えば、会社のシングルサインオン (SSO) リンク AWS を使用して にアクセスすると、そのプロセスによって一時的な認証情報が自動的に作成されます。また、ユーザーとしてコンソールにサインインしてからロールを切り替える場合も、一時的な認証情報が自動的に作成されます。ロールの切り替えの詳細については、 IAM ユーザーガイドの「ユーザーからIAMロールへの切り替え (コンソール）」を参照してください。
AWS CLI または を使用して、一時的な認証情報を手動で作成できます AWS API。その後、これらの一時的な認証情報を使用して にアクセスできます AWS。長期的なアクセスキーを使用する代わりに、一時的な認証情報を動的に生成 AWS することをお勧めします。詳細については、「」の「一時的なセキュリティ認証情報IAM」を参照してください。
QLDB のクロスサービスプリンシパル権限
転送アクセスセッションをサポート (FAS): いいえ
ユーザーIAMまたはロールを使用して でアクションを実行する場合 AWS、プリンシパルと見なされます。一部のサービスを使用する際に、アクションを実行することで、別のサービスの別のアクションがトリガーされることがあります。FAS は、 を呼び出すプリンシパルのアクセス許可を AWS のサービス、ダウンストリームサービス AWS のサービス へのリクエストリクエストと組み合わせて使用します。FAS リクエストは、サービスが他の AWS のサービス または リソースとのやり取りを完了する必要があるリクエストを受け取った場合にのみ行われます。この場合、両方のアクションを実行するための権限が必要です。FAS リクエストを行う際のポリシーの詳細については、「アクセスセッションの転送」を参照してください。
QLDB のサービスロール
サービスロールのサポート: あり
サービスロールは、ユーザーに代わってアクションを実行するためにサービスが引き受けるIAMロールです。IAM 管理者は、 内からサービスロールを作成、変更、削除できますIAM。詳細については、「 ユーザーガイド」の「アクセス許可を に委任するロールを作成する AWS のサービス」を参照してください。 IAM
警告
サービスロールのアクセス許可を変更すると、QLDB機能が壊れる可能性があります。QLDB がガイダンスを提供する場合にのみ、サービスロールを編集します。
QLDB は、次のセクションで説明するように、 ExportJournalToS3および StreamJournalToKinesisAPIオペレーションのサービスロールをサポートします。
でIAMロールを選択する QLDB
でジャーナルブロックをエクスポートまたはストリーミングするときはQLDB、 がユーザーに代わって特定の宛先QLDBにオブジェクトを書き込むためのロールを選択する必要があります。サービスロールを以前に作成している場合、 QLDBは選択するロールのリストを提供します。エクスポート用に指定した Simple Storage Service (Amazon S3) バケットに書き込むか、ストリーム用に指定した Amazon Kinesis Data Streams リソースに書き込むためのアクセスを許可するロールを選択することが重要です。詳細については、でのジャーナルエクスポートアクセス許可 QLDB または QLDB のストリームアクセス許可 を参照してください。
注記
ジャーナルのエクスポートまたはストリームをリクエストQLDBするときにロールを に渡すには、IAMロールリソースに対してiam:PassRoleアクションを実行するアクセス許可が必要です。これは、QLDB台帳リソースまたはQLDBストリームサブリソースqldb:ExportJournalToS3で実行するアクセス許可に加えてqldb:StreamJournalToKinesis行われます。
のサービスにリンクされたロール QLDB
サービスにリンクされたロールのサポート: なし
サービスにリンクされたロールは、 にリンクされたサービスロールの一種です AWS のサービス。サービスは、ユーザーに代わってアクションを実行するロールを引き受けることができます。サービスにリンクされたロールは に表示され AWS アカウント 、 サービスによって所有されます。IAM 管理者はサービスにリンクされたロールのアクセス許可を表示できますが、編集することはできません。
サービスにリンクされたロールの作成または管理の詳細については、AWS のサービス IAM「」を参照してください。表の「サービスリンクロール」列に Yes と記載されたサービスを見つけます。サービスにリンクされたロールに関するドキュメントをサービスで表示するには、[はい] リンクを選択します。
