本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # Amazon Managed Service for Apache Flink 如何與 IAM 搭配使用 在 Amazon MSF 中，您會在下列不同內容中使用 IAM： + [應用程式許可](#security_iam_application_permissions)：控制應用程式對使用 IAM 身分驗證之外部資源的存取，例如 Amazon S3、Amazon Kinesis Data Streams 或 Amazon DynamoDB。 + [應用程式管理和生命週期控制許可](#security_iam_application_management)：控制 Amazon MSF API 動作的使用，例如 [CreateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_CreateApplication.html)、[StartApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_StartApplication.html) 和 [UpdateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_UpdateApplication.html)，以控制應用程式生命週期。如需您可以在 IAM 政策陳述式的 `Action`元素中指定之所有 Amazon MSF API 動作的完整清單，請參閱*《服務授權參考*》中的 [Amazon Kinesis Analytics V2 定義的動作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonkinesisanalyticsv2.html#amazonkinesisanalyticsv2-actions-as-permissions)。 **Topics** + [應用程式許可](#security_iam_application_permissions) + [應用程式管理和生命週期控制許可](#security_iam_application_management) + [Managed Service for Apache Flink 內的身分型政策](#security_iam_service-with-iam-id-based-policies) + [Managed Service for Apache Flink 內的資源型政策](#security_iam_service-with-iam-resource-based-policies) + [Managed Service for Apache Flink 中的存取控制清單 (ACL)](#security_iam_service-with-iam-acls) + [Managed Service for Apache Flink 的服務角色](#security_iam_service-with-iam-roles-service) + [適用於 Managed Service for Apache Flink 的服務連結角色](#security_iam_service-with-iam-roles-service-linked) ## 應用程式許可 您可以在應用程式組態中，使用指派給應用程式的 IAM 角色來控制 Amazon MSF 應用程式的 IAM 許可。此 IAM 角色決定應用程式存取其他服務的許可，例如使用 IAM 進行授權的 Amazon S3、Kinesis Data Streams 或 DynamoDB。 **警告** 變更服務角色的許可可能會中斷 Amazon MSF 功能。請確定您未移除應用程式從 Amazon S3 儲存貯體下載應用程式碼的許可，並將日誌傳送至 Amazon CloudWatch。 不支援使用[資源型政策](#security_iam_service-with-iam-resource-based-policies)將許可指派給應用程式。您無法在連接到要存取之資源的政策中，將 Amazon MSF 應用程式指定為主體。 **Topics** + [存取應用程式碼和應用程式日誌的許可](#security_iam_permissions_access_application_code) + [預防跨服務混淆代理人](#security_iam_cross_service_confused_deputy) ### 存取應用程式碼和應用程式日誌的許可 Amazon MSF 也會使用應用程式 IAM 角色來存取 Amazon S3 儲存貯體中上傳的應用程式碼，並將應用程式日誌寫入 Amazon CloudWatch Logs。 當您使用 建立或更新應用程式時 AWS 管理主控台，請選擇使用應用程式組態中的**必要政策建立/更新 IAM 角色 **，Amazon MSF 會自動建立和修改將必要許可指派給 Amazon S3 和 CloudWatch Logs 的 IAM 角色。 如果您手動建立 IAM 角色，或使用自動化工具建立和管理應用程式，則必須將下列許可新增至應用程式 IAM 角色。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "ReadCode", "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectVersion" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket/path-to-application-code" ] }, { "Sid": "ListCloudwatchLogGroups", "Effect": "Allow", "Action": [ "logs:DescribeLogGroups" ], "Resource": [ "arn:aws:logs:us-east-1:123456789012:log-group:*" ] }, { "Sid": "ListCloudwatchLogStreams", "Effect": "Allow", "Action": [ "logs:DescribeLogStreams" ], "Resource": [ "arn:aws:logs:us-east-1:123456789012:log-group:/aws/kinesis-analytics/application-name:log-stream:*" ] }, { "Sid": "PutCloudwatchLogs", "Effect": "Allow", "Action": [ "logs:PutLogEvents" ], "Resource": [ "arn:aws:logs:us-east-1:123456789012:log-group:/aws/kinesis-analytics/application-name:log-stream:kinesis-analytics-log-stream" ] } ] } ``` ------ ### 預防跨服務混淆代理人 當 Amazon MSF 應用程式呼叫不同的 時 AWS 服務，您可以提供更精細的存取許可。例如，如果 IAM 角色在多個應用程式之間重複使用，應用程式可能會存取不應存取的資源。這稱為[混淆代理人問題](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html)。如需存取的資源如何限制存取特定 Amazon MSF 應用程式的相關資訊，請參閱 [預防跨服務混淆代理人](iam-cross-service-confused-deputy-prevention.md)。 ## 應用程式管理和生命週期控制許可 管理應用程式及其生命週期的動作，例如 [CreateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_CreateApplication.html)、[StartApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_StartApplication.html) 和 [UpdateApplication](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_UpdateApplication.html)，是透過與執行動作之資源相關聯的身分型政策來控制，例如 IAM 使用者、IAM 群組或 AWS Lambda 呼叫 Amazon MSF API 等資源。 **注意** 基於回溯相容性原因，控制 Amazon MSF 應用程式生命週期的 API 和 SDK 稱為 Amazon Kinesis Analytics V2。 不支援使用連接至 Amazon MSF 應用程式的資源型政策來指派應用程式生命週期動作的許可。應用程式 IAM 角色不會用於控制對應用程式生命週期動作的存取。您不應將應用程式生命週期許可新增至應用程式角色。 下表列出您可以搭配 Amazon MSF 應用程式生命週期動作使用的 IAM 功能。 | IAM 功能 | Managed Service for Apache Flink 支援 | | --- | --- | | [身分型政策](#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) | 是 | | [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) | 否 | + 如需 Managed Service for Apache Flink 和其他 如何與大多數 IAM 功能 AWS 服務 搭配使用的高階檢視，請參閱《[AWS 服務 IAM 使用者指南》中的 與 IAM 搭配使用](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。 ** + 如需可在 IAM 許可政策中使用的服務特定資源、動作和條件內容金鑰的相關資訊，請參閱*服務授權參考*中的 [Amazon Kinesis Analytics V2 的動作、資源和條件金鑰](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonkinesisanalyticsv2.html)。 **Topics** + [政策動作](#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) + [ABAC](#security_iam_service-with-iam-tags) + [臨時憑證](#security_iam_service-with-iam-roles-tempcreds) + [主體許可](#security_iam_service-with-iam-principal-permissions) ### 應用程式生命週期政策動作 **支援政策動作：**是 管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說，哪個**主體**在什麼**條件**下可以對什麼**資源**執行哪些**動作**。 JSON 政策的 `Action` 元素描述您可以用來允許或拒絕政策中存取的動作。政策會使用動作來授予執行相關聯動作的許可。 Amazon MSF 中的政策動作在動作之前使用 `kinesisanalytics`字首。Amazon MSF APIs和 SDKs使用 `Amazon Kinesis Analytics V2`字首。 若要在單一陳述式中指定多個動作，請用逗號分隔。下列範例顯示指定 Amazon MSF 政策動作的語法。 ``` "Action" : [ "kinesisanalytics:action1", "kinesisanalytics:action2" ] ``` 您也可以使用萬用字元 (\$1) 指定多個動作。例如，如需指定開頭是 `Describe` 文字的所有動作，請包含以下動作： ``` "Action": "kinesisanalytics:Describe*" ``` 若要查看您可以在 IAM 政策陳述式的 `Action`元素中指定的所有 Amazon MSF API 動作的完整清單，請參閱 [Amazon Kinesis Analytics V2 定義的動作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonkinesisanalyticsv2.html#amazonkinesisanalyticsv2-actions-as-permissions)。 若要檢視 Amazon MSF 身分型政策的範例，請參閱 [身分型政策範例](security_iam_id-based-policy-examples.md)。 ### 應用程式生命週期政策資源 **支援政策資源：**是 管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說，哪個**主體**在什麼**條件**下可以對什麼**資源**執行哪些**動作**。 `Resource` JSON 政策元素可指定要套用動作的物件。最佳實務是使用其 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 來指定資源。若動作不支援資源層級許可，使用萬用字元 (\$1) 表示該陳述式適用於所有資源。 ``` "Resource": "*" ``` 會為每個**應用程式定義 Amazon MSF 應用程式**生命週期動作的許可。IAM 政策中的 `Resource` JSON 元素會定義適用許可的 Amazon MSF 應用程式。 您可以使用萬用字元指定應用程式 ARN 或一組應用程式，將許可指派給單一應用程式。下列範例顯示 `Resource`元素的語法。 ``` "Resouce" : "arn:partition:kinesisanalytics:Region:account:application/application-name ``` 您也可以指派許可，以使用萬用字元控制應用程式子集。例如，您可以指派許可來控制名稱開頭為特定字首的所有應用程式。 ``` "Resouce" : "arn:partition:kinesisanalytics:Region:account:application/application-name-prefix* ``` ### 應用程式生命週期政策條件索引鍵 **支援服務特定政策條件金鑰：**是 管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說，哪個**主體**在什麼**條件**下可以對什麼**資源**執行哪些**動作**。 `Condition` 元素會根據定義的條件，指定陳述式的執行時機。您可以建立使用[條件運算子](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)的條件運算式 (例如等於或小於)，來比對政策中的條件和請求中的值。若要查看所有 AWS 全域條件索引鍵，請參閱《*IAM 使用者指南*》中的[AWS 全域條件內容索引鍵](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)。 您可以使用條件金鑰來控制 Amazon MSF 應用程式生命週期動作的許可。若要查看 Managed Service for Apache Flink 條件索引鍵的清單，請參閱《服務授權參考》**中的 [Amazon Managed Service for Apache Flink 的條件索引鍵](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awskinesisanalytics.html#awskinesisanalytics-policy-keys)。若要了解您可以搭配哪些動作和資源使用條件金鑰，請參閱 [Amazon Managed Service for Apache Flink 定義的動作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awskinesisanalytics.html#awskinesisanalytics-actions-as-permissions)。 ### 屬性型存取控制 (ABAC)用於 Managed Service for Apache Flink **支援 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)中，提供標籤資訊。如果服務支援每個資源類型的全部三個條件金鑰，則對該服務而言，值為 **Yes**。如果服務僅支援某些資源類型的全部三個條件金鑰，則值為 **Partial**。 + 如需 ABAC 的詳細資訊，請參閱[使用 ABAC 授權根據屬性定義許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)。 + 若要檢視包含設定 ABAC 步驟的教學課程，請參閱 [IAM 教學課程：根據標籤定義存取 AWS 資源的許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html)。 ### 使用暫時登入資料 **支援臨時憑證：**是 Amazon MSF 應用程式生命週期動作支援臨時登入資料。 如果您 AWS 管理主控台 使用使用者名稱和密碼以外的任何方法登入 ，則會使用臨時登入資料。例如，當您 AWS 使用公司的單一登入 (SSO) 連結存取 時，該程序會自動建立臨時登入資料。當您以使用者身分登入主控台，然後切換角色時，也會自動建立臨時憑證。如需切換角色的詳細資訊，請參閱[從使用者切換到 IAM 角色 （主控台）](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-console.html)。 您可以使用 AWS CLI 或 AWS API 手動建立臨時登入資料。然後，您可以使用這些臨時登入資料來存取 AWS。我們建議您動態產生臨時憑證，而不是使用長期存取金鑰。如需詳細資訊，請參閱 [IAM 中的暫時性安全憑證](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)。 ### 跨服務主體許可 **支援轉寄存取工作階段 (FAS)：**是 Amazon MSF 應用程式生命週期動作支援跨服務主體許可。 當您使用 IAM 使用者或角色在 中執行動作時 AWS，您會被視為委託人。使用某些服務時，您可能會執行某個動作，進而在不同服務中啟動另一個動作。轉送存取工作階段 (FAS) 使用呼叫 的委託人許可 AWS 服務，結合 AWS 服務 請求向下游服務提出請求。只有當服務收到需要與其他 AWS 服務 或 資源互動才能完成的請求時，才會提出 FAS 請求。在此情況下，您必須具有執行這兩個動作的許可。如需提出 FAS 請求時的政策詳細資訊，請參閱[轉發存取工作階段](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html)。 ## Managed Service for Apache Flink 內的身分型政策 **支援身分型政策：**是 身分型政策是可以附加到身分 (例如 IAM 使用者、使用者群組或角色) 的 JSON 許可政策文件。這些政策可控制身分在何種條件下能對哪些資源執行哪些動作。如需了解如何建立身分型政策，請參閱《*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)。 ### Managed Service for Apache Flink 內的身分型政策範例 如需檢視 Managed Service for Apache Flink 身分型政策範例，請參閱 [Amazon Managed Service for Apache Flink 的身分型政策範例](security_iam_id-based-policy-examples.md)。 ## Managed Service for Apache Flink 內的資源型政策 Amazon Managed Service for Apache Flink 目前不支援資源型存取控制。 ## Managed Service for Apache Flink 中的存取控制清單 (ACL) **支援 ACL：**否 存取控制清單 (ACL) 可控制哪些主體 (帳戶成員、使用者或角色) 擁有存取某資源的許可。ACL 類似於資源型政策，但它們不使用 JSON 政策文件格式。 ## Managed Service for Apache Flink 的服務角色 **支援服務角色：**是 服務角色是服務擔任的 [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)。 **警告** 變更服務角色的許可有可能會中止 Managed Service for Apache Flink 的功能。僅當 Managed Service for Apache Flink 有提供相關指引時，才能編輯服務角色。 ## 適用於 Managed Service for Apache Flink 的服務連結角色 **支援服務連結角色：**是 服務連結角色是連結至 的一種服務角色 AWS 服務。服務可以擔任代表您執行動作的角色。服務連結角色會出現在您的 中 AWS 帳戶 ，並由服務擁有。IAM 管理員可以檢視，但不能編輯服務連結角色的許可。 如需建立或管理服務連結角色的詳細資訊，請參閱[可搭配 IAM 運作的AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。在資料表中尋找服務，其中包含**服務連結角色**欄中的 `Yes`。選擇**是**連結，以檢視該服務的服務連結角色文件。