翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS HealthImaging のアイデンティティベースのポリシーの例
デフォルトでは、ユーザーおよびロールには、HealthImaging リソースを作成または変更するアクセス許可はありません。IAM 管理者は、リソースで必要なアクションを実行するための権限をユーザーに付与する IAM ポリシーを作成できます。
これらのサンプルの JSON ポリシードキュメントを使用して IAM アイデンティティベースのポリシーを作成する方法については、「*IAM ユーザーガイド*」の「[IAM ポリシーを作成する (コンソール)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html)」を参照してください。
各リソースタイプの ARNs*「サービス認可リファレンス*」の「[Awesome AWS のアクション、リソース、および条件キー](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awskeymanagementservice.html)」を参照してください。
**Topics**
+ [ポリシーに関するベストプラクティス](#security_iam_service-with-iam-policy-best-practices)
+ [HealthImaging コンソールの使用](#security_iam_id-based-policy-examples-console)
+ [自分の権限の表示をユーザーに許可する](#security_iam_id-based-policy-examples-view-own-permissions)
+ [Study Instance UID と Series Instance UID に基づくアクセス許可の付与](#security_iam_id-based-policy-examples-study-series-uid)
## ポリシーに関するベストプラクティス
ID ベースのポリシーは、ユーザーのアカウントで誰かが HealthImaging リソースを作成、アクセス、または削除できるどうかを決定します。これらのアクションでは、 AWS アカウントに費用が発生する場合があります。アイデンティティベースポリシーを作成したり編集したりする際には、以下のガイドラインと推奨事項に従ってください:
+ ** AWS 管理ポリシーを開始し、最小特権のアクセス許可に移行** – ユーザーとワークロードにアクセス許可の付与を開始するには、多くの一般的なユースケースにアクセス許可を付与する*AWS 管理ポリシー*を使用します。これらは で使用できます AWS アカウント。ユースケースに固有の AWS カスタマー管理ポリシーを定義することで、アクセス許可をさらに減らすことをお勧めします。詳細については、*IAM ユーザーガイド* の [AWS マネージドポリシー](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) または [ジョブ機能のAWS マネージドポリシー](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html) を参照してください。
+ **最小特権を適用する** – IAM ポリシーでアクセス許可を設定する場合は、タスクの実行に必要な許可のみを付与します。これを行うには、特定の条件下で特定のリソースに対して実行できるアクションを定義します。これは、最小特権アクセス許可とも呼ばれています。IAM を使用して許可を適用する方法の詳細については、*IAM ユーザーガイド* の [IAM でのポリシーとアクセス許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) を参照してください。
+ **IAM ポリシーで条件を使用してアクセスをさらに制限する** - ポリシーに条件を追加して、アクションやリソースへのアクセスを制限できます。たとえば、ポリシー条件を記述して、すべてのリクエストを SSL を使用して送信するように指定できます。条件を使用して、サービスアクションが などの特定の を通じて使用されている場合に AWS のサービス、サービスアクションへのアクセスを許可することもできます CloudFormation。詳細については、*IAM ユーザーガイド* の [IAM JSON ポリシー要素:条件](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) を参照してください。
+ **IAM アクセスアナライザー を使用して IAM ポリシーを検証し、安全で機能的な権限を確保する** - IAM アクセスアナライザー は、新規および既存のポリシーを検証して、ポリシーが IAM ポリシー言語 (JSON) および IAM のベストプラクティスに準拠するようにします。IAM アクセスアナライザーは 100 を超えるポリシーチェックと実用的な推奨事項を提供し、安全で機能的なポリシーの作成をサポートします。詳細については、*IAM ユーザーガイド* の [IAM Access Analyzer でポリシーを検証する](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html) を参照してください。
+ **多要素認証 (MFA) を要求する** – で IAM ユーザーまたはルートユーザーを必要とするシナリオがある場合は AWS アカウント、MFA をオンにしてセキュリティを強化します。API オペレーションが呼び出されるときに MFA を必須にするには、ポリシーに MFA 条件を追加します。詳細については、*IAM ユーザーガイド* の [MFA を使用した安全な API アクセス](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html) を参照してください。
IAM でのベストプラクティスの詳細については、*IAM ユーザーガイド* の [IAM でのセキュリティのベストプラクティス](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) を参照してください。
## HealthImaging コンソールの使用
AWS HealthImaging コンソールにアクセスするには、一連の最小限のアクセス許可が必要です。これらのアクセス許可により、 の HealthImaging リソースの詳細を一覧表示および表示できます AWS アカウント。最小限必要な許可よりも制限が厳しいアイデンティティベースのポリシーを作成すると、そのポリシーを持つエンティティ (ユーザーまたはロール) に対してコンソールが意図したとおりに機能しません。
AWS CLI または AWS API のみを呼び出すユーザーには、最小限のコンソールアクセス許可を付与する必要はありません。代わりに、実行しようとしている API オペレーションに一致するアクションのみへのアクセスが許可されます。
ユーザーとロールが引き続き HealthImaging コンソールを使用できるようにするには、エンティティに HealthImaging `ConsoleAccess`または `ReadOnly` AWS マネージドポリシーもアタッチします。詳細については、 IAM ユーザーガイド の「[ユーザーへの許可の追加](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)」を参照してください。
## 自分の権限の表示をユーザーに許可する
この例では、ユーザーアイデンティティにアタッチされたインラインおよびマネージドポリシーの表示を IAM ユーザーに許可するポリシーの作成方法を示します。このポリシーには、コンソールで、または AWS CLI または AWS API を使用してプログラムでこのアクションを実行するアクセス許可が含まれています。
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ViewOwnUserInfo",
"Effect": "Allow",
"Action": [
"iam:GetUserPolicy",
"iam:ListGroupsForUser",
"iam:ListAttachedUserPolicies",
"iam:ListUserPolicies",
"iam:GetUser"
],
"Resource": ["arn:aws:iam::*:user/${aws:username}"]
},
{
"Sid": "NavigateInConsole",
"Effect": "Allow",
"Action": [
"iam:GetGroupPolicy",
"iam:GetPolicyVersion",
"iam:GetPolicy",
"iam:ListAttachedGroupPolicies",
"iam:ListGroupPolicies",
"iam:ListPolicyVersions",
"iam:ListPolicies",
"iam:ListUsers"
],
"Resource": "*"
}
]
}
```
## Study Instance UID と Series Instance UID に基づくアクセス許可の付与
HealthImaging DICOMWeb APIs治験インスタンス UID とシリーズインスタンス UID に基づいて画像セットへのアクセス許可の付与をサポートします。`StudyInstanceUID` および 条件コンテキストキーで`SeriesInstanceUID`条件ステートメントを追加することで、アクセスを制限する IAM ポリシーを定義できます。
必須パラメータ`StudyInstanceUID`として を使用する HealthImaging DICOMWeb APIs`StudyInstanceUID`キーに基づいてアクセスを制限する IAM ポリシーをサポートします。同様に、必須パラメータ`SeriesInstanceUID`として を使用する HealthImaging DICOMWeb APIs、 `SeriesInstanceUID`キーでポリシーをサポートします。
**`StudyInstanceUID`および`SeriesInstanceUID`コンテキストキーを使用した IAM ポリシーをサポートする HealthImaging APIs **
| 名前 | `StudyInstanceUID` 条件のサポート | `SeriesInstanceUID` 条件のサポート |
| --- | --- | --- |
| GetDICOMInstance | はい | はい |
| GetDICOMInstanceFrames | はい | はい |
| GetDICOMInstanceMetadata | はい | はい |
| GetDICOMSeriesMetadata | はい | はい |
| GetDICOMBulkdata | はい | はい |
| SearchDICOMSeries | あり | なし |
| SearchDICOMInstances | はい | はい |
| StoreDICOMStudy | あり | なし |
**注記**
このコンテキストキーをサポートしない HealthImaging API は、 `StudyInstanceUID`または コンテキストキーを含むポリシーで呼び出されたときに`SeriesInstanceUID`コンテキストキーが指定されなかった場合と同様に機能します。
### 例 1: StudyInstanceUID に基づいてアクセス権を付与する
特定の DICOM 検査にのみアクセスを許可するには、 の条件を指定するポリシーをロールにアタッチします`StudyInstanceUID`。
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "Statement1",
"Effect": "Allow",
"Action": [
"medical-imaging:SearchDICOMSeries"
],
"Resource": [
"arn:aws:medical-imaging:us-west-2:account-id:datastore/your-datastore-id"
],
"Condition": {
"StringEquals": {
"medical-imaging:StudyInstanceUID": "your study instance UID"
}
}
}
]
}
```
このロールが 経由で引き受けられると`sts assume-role`、呼び出し元はロールポリシーで指定された条件に一致するイメージセットにのみアクセスする権限が与えられます。それ以外の場合、呼び出しは`AccessDenied`エラーをスローして拒否されます。この場合、呼び出し元には、指定された を持つすべてのイメージセットへのアクセス権が付与されます`StudyInstanceUID`。
ポリシーでは、ワイルドカード一致や複数の一致など、すべての IAM 文字列条件演算子を使用できます。
ワイルドカードマッチングのポリシーの例:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "Statement1",
"Effect": "Allow",
"Action": [
"medical-imaging:SearchDICOMSeries"
],
"Resource": [
"arn:aws:medical-imaging:us-west-2:account-id:datastore/your-datastore-id"
],
"Condition": {
"StringLike": {
"medical-imaging:StudyInstanceUID": "123.456.789*"
}
}
}
]
}
```
複数の一致のポリシーの例:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "Statement1",
"Effect": "Allow",
"Action": [
"medical-imaging:SearchDICOMSeries"
],
"Resource": [
"arn:aws:medical-imaging:us-west-2:account-id:datastore/your-datastore-id"
],
"Condition": {
"StringEquals": {
"medical-imaging:StudyInstanceUID": [
"123.456.789",
"1.2.3.4.5.6"
]
}
}
}
]
}
```
### 例 2: SeriesInstanceUID に基づいてアクセスを許可する
DICOM シリーズに対応する特定のイメージセットにのみアクセスを許可するには、 の条件を指定するポリシーをロールにアタッチします`SeriesInstanceUID`。
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "Statement1",
"Effect": "Allow",
"Action": [
"medical-imaging:SearchDICOMInstances"
],
"Resource": [
"arn:aws:medical-imaging:us-west-2:account-id:datastore/your-datastore-id"
],
"Condition": {
"StringEquals": {
"medical-imaging:SeriesInstanceUID": [
"123.456.789",
"1.2.3.4.5.6"
]
}
}
}
]
}
```
### 例 3: StudyInstanceUIDsと SeriesInstanceUIDsに基づいてアクセスを許可する
特定の DICOM スタディとシリーズの画像セットにのみアクセスを許可するには、 `StudyInstanceUID`と の両方の条件を指定するポリシーをロールにアタッチします`SeriesInstanceUID`。
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "Statement1",
"Effect": "Allow",
"Action": [
"medical-imaging:SearchDICOMInstances"
],
"Resource": [
"arn:aws:medical-imaging:us-west-2:account-id:datastore/your-datastore-id"
],
"Condition": {
"StringEquals": {
"medical-imaging:StudyInstanceUID": ["123.456.789"],
"medical-imaging:SeriesInstanceUID": ["1.2.3.4.5.6"]
}
}
}
]
}
```