翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon QLDB で IAM が機能する仕組み IAM を使用して QLDB へのアクセスを管理する前に、QLDB で利用できる IAM の機能について学びます。 **重要** サポート終了通知: 既存のお客様は、07/31/2025 のサポート終了まで Amazon QLDB を使用できます。詳細については、[「Amazon QLDB 台帳を Amazon Aurora PostgreSQL に移行する](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)」を参照してください。 **Amazon QLDB で使用できる IAM の機能** | IAM 機能 | QLDB のサポート | | --- | --- | | [アイデンティティベースポリシー](#security_iam_service-with-iam-id-based-policies) | はい | | [リソースベースのポリシー](#security_iam_service-with-iam-resource-based-policies) | いいえ | | [ポリシーアクション](#security_iam_service-with-iam-id-based-policies-actions) | はい | | [ポリシーリソース](#security_iam_service-with-iam-id-based-policies-resources) | あり | | [ポリシー条件キー](#security_iam_service-with-iam-id-based-policies-conditionkeys) | Yes | | [ACL](#security_iam_service-with-iam-acls) | いいえ | | [ABAC (ポリシー内のタグ)](#security_iam_service-with-iam-tags) | あり | | [一時的な認証情報](#security_iam_service-with-iam-roles-tempcreds) | はい | | [プリンシパル権限](#security_iam_service-with-iam-principal-permissions) | いいえ | | [サービスロール](#security_iam_service-with-iam-roles-service) | はい | | [サービスリンクロール](#security_iam_service-with-iam-roles-service-linked) | いいえ | QLDB およびその他の がほとんどの IAM 機能と AWS のサービス 連携する方法の概要を把握するには、「IAM *ユーザーガイド*」の[AWS のサービス 「IAM と連携する](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) 」を参照してください。 ## QLDB のアイデンティティベースのポリシー **アイデンティティベースのポリシーのサポート:** あり アイデンティティベースポリシーは、IAM ユーザーグループ、ユーザーのグループ、ロールなど、アイデンティティにアタッチできる JSON 許可ポリシードキュメントです。これらのポリシーは、ユーザーとロールが実行できるアクション、リソース、および条件をコントロールします。ID ベースのポリシーの作成方法については、「*IAM ユーザーガイド*」の「[カスタマー管理ポリシーでカスタム IAM アクセス許可を定義する](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)」を参照してください。 IAM アイデンティティベースのポリシーでは、許可または拒否するアクションとリソース、およびアクションを許可または拒否する条件を指定できます。プリンシパルは、それが添付されているユーザーまたはロールに適用されるため、アイデンティティベースのポリシーでは指定できません。JSON ポリシーで使用できるすべての要素について学ぶには、「*IAM ユーザーガイド*」の「[IAM JSON ポリシーの要素のリファレンス](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)」を参照してください。 ### QLDB のアイデンティティベースのポリシーの例 QLDB のアイデンティティベースのポリシーの例を表示するには、「[Amazon QLDB のアイデンティティベースのポリシー例](security_iam_id-based-policy-examples.md)」を参照してください。 ## QLDB 内のリソースベースのポリシー **リソースベースのポリシーのサポート:** なし リソースベースのポリシーは、リソースに添付する JSON ポリシードキュメントです。リソースベースのポリシーには例として、IAM *ロールの信頼ポリシー*や Amazon S3 *バケットポリシー*があげられます。リソースベースのポリシーをサポートするサービスでは、サービス管理者はポリシーを使用して特定のリソースへのアクセスを制御できます。ポリシーがアタッチされているリソースの場合、指定されたプリンシパルがそのリソースに対して実行できるアクションと条件は、ポリシーによって定義されます。リソースベースのポリシーでは、[プリンシパルを指定する](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html)必要があります。プリンシパルには、アカウント、ユーザー、ロール、フェデレーティッドユーザー、または を含めることができます AWS のサービス。 クロスアカウントアクセスを有効にするには、アカウント全体、または別のアカウントの IAM エンティティをリソースベースのポリシーのプリンシパルとして指定します。リソースベースのポリシーにクロスアカウントのプリンシパルを追加しても、信頼関係は半分しか確立されない点に注意してください。プリンシパルとリソースが異なる場合 AWS アカウント、信頼されたアカウントの IAM 管理者は、プリンシパルエンティティ (ユーザーまたはロール) にリソースへのアクセス許可も付与する必要があります。IAM 管理者は、アイデンティティベースのポリシーをエンティティにアタッチすることで権限を付与します。ただし、リソースベースのポリシーで、同じアカウントのプリンシパルへのアクセス権が付与されている場合は、アイデンティティベースのポリシーをさらに付与する必要はありません。詳細については、「*IAM ユーザーガイド*」の「[IAM でのクロスアカウントリソースアクセス](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)」を参照してください。 ## QLDB のポリシーアクション **ポリシーアクションのサポート:**あり 管理者は JSON AWS ポリシーを使用して、誰が何にアクセスできるかを指定できます。つまり、どの**プリンシパル**がどの**リソース**に対してどのような**条件下で****アクション**を実行できるかということです。 JSON ポリシーの `Action` 要素にはポリシー内のアクセスを許可または拒否するために使用できるアクションが記述されます。ポリシーアクションの名前は通常、関連付けられた AWS API オペレーションと同じです。一致する API オペレーションのない*許可のみのアクション*など、いくつかの例外があります。また、ポリシーに複数のアクションが必要なオペレーションもあります。これらの追加アクションは*依存アクション*と呼ばれます。 このアクションは関連付けられたオペレーションを実行するためのアクセス許可を付与するポリシーで使用されます。 QLDB アクションのリストを確認するには、*「サービス認可リファレンス*」の[「Amazon QLDB で定義されるアクション](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-actions-as-permissions)」を参照してください。 QLDB のポリシーアクションは、アクションの前に以下のプレフィックスを使用します。 ``` qldb ``` 単一のステートメントで複数のアクションを指定するには、アクションをカンマで区切ります。 ``` "Action": [ "qldb:action1", "qldb:action2" ] ``` ワイルドカード (\$1) を使用して複数アクションを指定できます。例えば、`Describe` という単語で始まるすべてのアクションを指定するには次のアクションを含めます。 ``` "Action": "qldb:Describe*" ``` 台帳で [PartiQL](ql-reference.md) ステートメントを実行して QLDB トランザクションデータ API (QLDB セッション) と対話するには、次のように `SendCommand` アクションにアクセス許可を付与する必要があります。** ``` "Action": "qldb:SendCommand" ``` `STANDARD` アクセス許可モードの台帳の場合は、「[PartiQL アクセス許可のリファレンス](getting-started-standard-mode.md#security_iam_partiql-reference)」を参照して、各 PartiQL コマンドに必要な追加のアクセス許可を確認してください。 QLDB のアイデンティティベースのポリシーの例を表示するには、「[Amazon QLDB のアイデンティティベースのポリシー例](security_iam_id-based-policy-examples.md)」を参照してください。 ## QLDB のポリシーリソース **ポリシーリソースのサポート:** あり 管理者は JSON AWS ポリシーを使用して、誰が何にアクセスできるかを指定できます。つまり、どの**プリンシパル**がどの**リソース**に対してどのような**条件**下で**アクション**を実行できるかということです。 `Resource` JSON ポリシー要素はアクションが適用されるオブジェクトを指定します。ステートメントには`Resource` または `NotResource` 要素を含める必要があります。ベストプラクティスとして、[Amazon リソースネーム (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) を使用してリソースを指定します。これは、*リソースレベルの許可*と呼ばれる特定のリソースタイプをサポートするアクションに対して実行できます。 オペレーションのリスト化など、リソースレベルの権限をサポートしないアクションの場合は、ステートメントがすべてのリソースに適用されることを示すために、ワイルドカード (\$1) を使用します。 ``` "Resource": "*" ``` QLDB リソースタイプとその ARNs[「Amazon QLDB で定義されるリソース](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-resources-for-iam-policies)」を参照してください。 **どのアクションで各リソースの ARN を指定できるかについては、「[Amazon QLDB で定義されるアクション](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-actions-as-permissions)」を参照してください。 QLDB では、プライマリリソースは台帳です。**QLDB では、追加のリソースタイプ (テーブルおよびストリーム) もサポートしています。****ただし、既存の台帳のコンテキストでのみ、テーブルやストリームを作成できます。 QLDB テーブルは、台帳のジャーナルからの順序付けられていないドキュメントリビジョンのコレクションのマテリアライズドビューです。`STANDARD` アクセス許可モードの台帳では、このテーブルリソースで PartiQL ステートメントを実行するために、アクセス許可を付与する IAM ポリシーを作成する必要があります。テーブルリソースに対するアクセス許可を使用すると、テーブルの現在の状態にアクセスするステートメントを実行できます。組み込みの `history()` 関数を使用してテーブルのリビジョン履歴のクエリを実行することもできます。詳細については[Amazon QLDB の標準アクセス許可モードの開始方法](getting-started-standard-mode.md)を参照してください。 **注記** `CREATE TABLE` ステートメントは、一意の ID と指定されたテーブル名を持つテーブルを作成します。指定するテーブル名は、すべてのアクティブなテーブルの中で一意である必要があります。ただし、QLDB ではテーブルを非アクティブ化できるため、同じテーブル名を共有する非アクティブなテーブルが複数存在する可能性があります。したがって、テーブルリソース ARN は、ユーザー定義のテーブル名ではなく、システムによって割り当てられた一意の ID を参照します。 各台帳では、システム定義のカタログリソースも提供され、このリソースでクエリを実行して台帳内のすべてのテーブルとインデックスを一覧表示できます。QLDB データオブジェクトモデルの詳細については、「[Amazon QLDB の重要な概念と用語](ledger-structure.md)」を参照してください。 このリソースには、次の表に示すように、一意の ARN が関連付けられています。 **** | リソースタイプ | ARN | | --- | --- | | ledger | arn:\$1\$1Partition\$1:qldb:\$1\$1Region\$1:\$1\$1Account\$1:ledger/\$1\$1LedgerName\$1 | | table | arn:\$1\$1Partition\$1:qldb:\$1\$1Region\$1:\$1\$1Account\$1:ledger/\$1\$1LedgerName\$1/table/\$1\$1TableId\$1 | | catalog | arn:\$1\$1Partition\$1:qldb:\$1\$1Region\$1:\$1\$1Account\$1:ledger/\$1\$1LedgerName\$1/information\$1schema/user\$1tables | | stream | arn:\$1\$1Partition\$1:qldb:\$1\$1Region\$1:\$1\$1Account\$1:stream/\$1\$1LedgerName\$1/\$1\$1StreamId\$1 | 例えば、ステートメントで `myExampleLedger` リソースを指定するには、次の ARN を使用します。 ``` "Resource": "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger" ``` 複数リソースを単一ステートメントで指定するには、ARN をカンマで区切ります。 ``` "Resource": [ "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger1", "arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger2" ] ``` QLDB のアイデンティティベースのポリシーの例を表示するには、「[Amazon QLDB のアイデンティティベースのポリシー例](security_iam_id-based-policy-examples.md)」を参照してください。 ## QLDB のポリシー条件キー **サービス固有のポリシー条件キーのサポート:** あり 管理者は JSON AWS ポリシーを使用して、誰が何にアクセスできるかを指定できます。つまり、どの**プリンシパル**がどの**リソース**に対してどのような**条件**下で**アクション**を実行できるかということです。 `Condition` 要素 (または `Condition` *ブロック*) を使用すると、ステートメントが有効な条件を指定できます。`Condition` 要素はオプションです。イコールや未満などの [条件演算子](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html) を使用して条件式を作成して、ポリシーの条件とリクエスト内の値を一致させることができます。 1 つのステートメントに複数の `Condition` 要素を指定する場合、または 1 つの `Condition` 要素に複数のキーを指定する場合、 AWS では `AND` 論理演算子を使用してそれらを評価します。1 つの条件キーに複数の値を指定すると、 は論理`OR`オペレーションを使用して条件 AWS を評価します。ステートメントの権限が付与される前にすべての条件が満たされる必要があります。 条件を指定する際にプレースホルダー変数も使用できます。例えば IAM ユーザーに、IAM ユーザー名がタグ付けされている場合のみリソースにアクセスできる権限を付与することができます。詳細については、「*IAM ユーザーガイド*」の「[‬IAM ポリシーの要素: 変数およびタグ‭](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_variables.html)」‬を参照してください。 AWS は、グローバル条件キーとサービス固有の条件キーをサポートしています。すべての AWS グローバル条件キーを確認するには、*「IAM ユーザーガイド*」の[AWS 「グローバル条件コンテキストキー](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)」を参照してください。 QLDB 条件キーのリストを確認するには、*「サービス認可リファレンス*[」の「Amazon QLDB の条件キー](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-policy-keys)」を参照してください。条件キーを使用できるアクションとリソースについては、「[Amazon QLDB で定義されるアクション](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonqldb.html#amazonqldb-actions-as-permissions)」を参照してください。 `PartiQLDropIndex` アクションおよび `PartiQLDropTable` アクションは、`qldb:Purge` 条件キーをサポートします。この条件キーは PartiQL `DROP` ステートメントで指定された `purge` の値でアクセスをフィルタします。ただし、QLDB で現在サポートされているのは `purge = true` for `DROP INDEX` ステートメントと `purge = false` for `DROP TABLE` ステートメントのみです。他の QLDB アクションでは、いくつかのグローバルコンディションキーがサポートされています。 QLDB のアイデンティティベースのポリシーの例を表示するには、「[Amazon QLDB のアイデンティティベースのポリシー例](security_iam_id-based-policy-examples.md)」を参照してください。 ## QLDB のアクセスコントロールリスト (ACL) **ACL のサポート:** なし アクセスコントロールリスト (ACL) は、どのプリンシパル (アカウントメンバー、ユーザー、またはロール) がリソースにアクセスするための許可を持つかを制御します。ACL はリソースベースのポリシーに似ていますが、JSON ポリシードキュメント形式は使用しません。 ## QLDB での属性ベースのアクセスコントロール (ABAC) **ABAC (ポリシー内のタグ) のサポート:** あり 属性ベースのアクセス制御 (ABAC) は、属性に基づいてアクセス許可を定義する認可戦略です。では AWS、これらの属性は*タグ*と呼ばれます。タグは、IAM エンティティ (ユーザーまたはロール) および多くの AWS リソースにアタッチできます。エンティティとリソースのタグ付けは、ABAC の最初の手順です。その後、プリンシパルのタグがアクセスしようとしているリソースのタグと一致した場合にオペレーションを許可するように ABAC ポリシーをします。 ABAC は、急成長する環境やポリシー管理が煩雑になる状況で役立ちます。 タグに基づいてアクセスを管理するには、`aws:ResourceTag/key-name`、`aws:RequestTag/key-name`、または `aws:TagKeys` の条件キーを使用して、ポリシーの [条件要素](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)でタグ情報を提供します。 サービスがすべてのリソースタイプに対して 3 つの条件キーすべてをサポートする場合、そのサービスの値は**あり**です。サービスが一部のリソースタイプに対してのみ 3 つの条件キーのすべてをサポートする場合、値は「**部分的**」になります。 ABAC の詳細については、「*IAM ユーザーガイド*」の「[ABAC 認可でアクセス許可を定義する](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)」を参照してください。ABAC をセットアップする手順を説明するチュートリアルについては、「*IAM ユーザーガイド*」の「[属性ベースのアクセスコントロール (ABAC) を使用する](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html)」を参照してください。 QLDB リソースのタグ付けの詳細については、「[Amazon QLDB リソースのタグ付け](tagging.md)」を参照してください。 リソースのタグに基づいてリソースへのアクセスを制限するためのアイデンティティベースポリシーの例を表示するには、「[タグに基づく QLDB 台帳の更新](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-update-ledger-tags)」を参照してください。 ## QLDB での一時的な認証情報の使用 **一時的な認証情報のサポート:** あり 一部の AWS のサービス は、一時的な認証情報を使用してサインインすると機能しません。一時的な認証情報と AWS のサービス 連携する などの詳細については、[AWS のサービス IAM ユーザーガイドの「IAM と連携する](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) 」を参照してください。 ** ユーザー名とパスワード以外の AWS マネジメントコンソール 方法で にサインインする場合は、一時的な認証情報を使用します。たとえば、会社のシングルサインオン (SSO) リンク AWS を使用して にアクセスすると、そのプロセスによって一時的な認証情報が自動的に作成されます。また、ユーザーとしてコンソールにサインインしてからロールを切り替える場合も、一時的な認証情報が自動的に作成されます。ロールの切り替えに関する詳細については、「*IAM ユーザーガイド*」の「[ユーザーから IAM ロールに切り替える (コンソール)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-console.html)」を参照してください。 一時的な認証情報は、 AWS CLI または AWS API を使用して手動で作成できます。その後、これらの一時的な認証情報を使用してアクセスすることができます AWS。長期的なアクセスキーを使用する代わりに、一時的な認証情報を動的に生成 AWS することをお勧めします。詳細については、「[IAM の一時的セキュリティ認証情報](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)」を参照してください。 ## QLDB のクロスサービスプリンシパル許可 **転送アクセスセッション (FAS) のサポート:** なし IAM ユーザーまたはロールを使用して でアクションを実行すると AWS、プリンシパルと見なされます。一部のサービスを使用する際に、アクションを実行することで、別のサービスの別のアクションがトリガーされることがあります。FAS は、 を呼び出すプリンシパルのアクセス許可を AWS のサービス、ダウンストリームサービス AWS のサービス へのリクエストをリクエストする と組み合わせて使用します。FAS リクエストは、サービスが他の AWS のサービス またはリソースとのやり取りを完了する必要があるリクエストを受け取った場合にのみ行われます。この場合、両方のアクションを実行するためのアクセス許可が必要です。FAS リクエストを行う際のポリシーの詳細については、「[転送アクセスセッション](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html)」を参照してください。 ## QLDB のサービスロール **サービスロールのサポート:** あり サービスロールとは、サービスがユーザーに代わってアクションを実行するために引き受ける [IAM ロール](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)です。IAM 管理者は、IAM 内からサービスロールを作成、変更、削除できます。詳細については、「*IAM ユーザーガイド*」の「[AWS のサービスに許可を委任するロールを作成する](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html)」を参照してください。 **警告** サービスロールの許可を変更すると、QLDB の機能が破損する可能性があります。QLDB が指示する場合以外は、サービスロールを編集しないでください。 次のセクションで説明するように、QLDB は `ExportJournalToS3` および `StreamJournalToKinesis` API オペレーションのサービスロールをサポートしています。 ### QLDB で IAM ロールを選択 QLDB でジャーナルブロックをエクスポートまたはストリーミングする場合、ユーザーに代わって特定の宛先にオブジェクトを書き込むことを QLDB に許可するロールを選択する必要があります。以前に作成したサービスロールがある場合、QLDB により、選択できるロールのリストが表示されます。エクスポート用に指定した Simple Storage Service (Amazon S3) バケットに書き込むか、ストリーム用に指定した Amazon Kinesis Data Streams リソースに書き込むためのアクセスを許可するロールを選択することが重要です。詳細については、[QLDB のジャーナルエクスポート権限](export-journal.perms.md)または[QLDB のストリーミング許可](streams.perms.md)を参照してください。 **注記** ジャーナルエクスポートまたはストリームをリクエストするときに QLDB にロールを渡すには、IAM ロールリソースで `iam:PassRole` アクションを実行するためのアクセス許可が必要です。これは、QLDB 台帳リソースでの `qldb:ExportJournalToS3` の実行、または QLDB ストリームサブリソースでの `qldb:StreamJournalToKinesis` の実行に対するアクセス許可に追加されます。 ## QLDB のサービスリンクロール **サービスにリンクされたロールのサポート:** なし サービスにリンクされたロールは、 にリンクされたサービスロールの一種です AWS のサービス。サービスは、ユーザーに代わってアクションを実行するロールを引き受けることができます。サービスにリンクされたロールは に表示され AWS アカウント 、サービスによって所有されます。IAM 管理者は、サービスリンクロールの権限を表示できますが、編集することはできません。 サービスリンクロールの作成または管理の詳細については、「[IAM と提携するAWS のサービス](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)」を参照してください。表の中から、[**Service-linked role (サービスリンクロール)**] 列に `Yes` と記載されたサービスを見つけます。サービスにリンクされたロールに関するドキュメントをサービスで表示するには、**[はい]** リンクを選択します。