本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用 AWS Identity and Access Management 進行身分驗證
AWS Identity and Access Management (IAM) 是一種 AWS 服務 ,可協助管理員安全地控制對 AWS 資源的存取。IAM 管理員可控制誰可以進行身分驗證 (登入) 和授權 (具有許可) 來使用 Amazon Location 資源。IAM 是您可以免費使用 AWS 服務 的 。
主題
目標對象
使用方式 AWS Identity and Access Management (IAM) 會根據您的角色而有所不同:
-
服務使用者 - 如果您無法存取 功能,請向管理員請求許可 (請參閱 對 Amazon Location Service 身分和存取進行故障診斷)
-
服務管理員 - 判斷使用者存取權並提交許可請求 (請參閱 Amazon Location Service 如何與 IAM 搭配使用)
-
IAM 管理員 - 撰寫政策以管理存取 (請參閱 Amazon Location Service 的身分型政策範例)
使用身分驗證
身分驗證是您 AWS 使用身分憑證登入 的方式。您必須以 AWS 帳戶根使用者、IAM 使用者或擔任 IAM 角色身分進行身分驗證。
您可以使用身分來源的登入資料,例如 AWS IAM Identity Center (IAM Identity Center)、單一登入身分驗證或 Google/Facebook 登入資料,以聯合身分的形式登入。如需登入的詳細資訊,請參閱AWS 登入 《 使用者指南》中的如何登入您的 AWS 帳戶 。
對於程式設計存取, AWS 提供 SDK 和 CLI 以密碼編譯方式簽署請求。如需詳細資訊,請參閱《IAM 使用者指南》中的 AWS API 請求的簽章版本 4。
AWS 帳戶 根使用者
當您建立 時 AWS 帳戶,您會從一個名為 AWS 帳戶 theroot 使用者的登入身分開始,該身分具有對所有 AWS 服務 和 資源的完整存取權。強烈建議您不要將根使用者用於日常任務。如需需要根使用者憑證的任務,請參閱《IAM 使用者指南》中的需要根使用者憑證的任務。
聯合身分
最佳實務是要求人類使用者使用聯合身分提供者,以 AWS 服務 使用臨時憑證存取 。
聯合身分是來自您的企業目錄、Web 身分提供者的使用者,或使用來自身分來源的 AWS 服務 登入資料存取 Directory Service 的使用者。聯合身分會擔任提供臨時登入資料的角色。
對於集中式存取管理,我們建議使用 AWS IAM Identity Center。如需詳細資訊,請參閱 AWS IAM Identity Center 使用者指南中的什麼是 IAM Identity Center?。
IAM 使用者和群組
IAM 使用者是具有單一人員或應用程式特定許可的身分。我們建議您使用臨時憑證,而不是具有長期憑證的 IAM 使用者。如需詳細資訊,請參閱《IAM 使用者指南》中的要求人類使用者使用聯合身分提供者來 AWS 使用臨時憑證存取 。
IAM 群組會指定 IAM 使用者的集合,讓大量使用者更容易管理許可。如需詳細資訊,請參閱《IAM 使用者指南》中的 IAM 使用者使用案例。
IAM 角色
IAM 角色是具有特定許可的身分,可提供臨時登入資料。您可以透過從使用者切換到 IAM 角色 (主控台) 或呼叫 AWS CLI 或 AWS API 操作來擔任角色。如需詳細資訊,請參閱《IAM 使用者指南》中的擔任角色的方法。
IAM 角色適用於聯合身分使用者存取、臨時 IAM 使用者許可、跨帳戶存取、跨服務存取,以及在 Amazon EC2 上執行的應用程式。如需詳細資訊,請參閱 IAM 使用者指南中的 IAM 中的快帳戶資源存取。
使用政策管理存取權
您可以透過建立政策並將其連接到身分或資源 AWS 來控制 AWS 中的存取。政策定義與身分或資源相關聯的許可。當委託人提出請求時 AWS , 會評估這些政策。大多數政策會以 JSON 文件 AWS 的形式存放在 中。如需 JSON 政策文件的詳細資訊,請參閱《IAM 使用者指南》中的 JSON 政策概觀。
管理員使用 政策,透過定義哪些委託人可以對哪些資源執行動作,以及在哪些條件下,指定誰可以存取哪些內容。
預設情況下,使用者和角色沒有許可。IAM 管理員會建立 IAM 政策並將其新增至角色,然後使用者可以擔任該角色。無論用於執行操作的方法為何,IAM 政策都會定義許可。
身分型政策
身分型政策是您連接到身分 (使用者、群組或角色) 的 JSON 許可政策文件。這些政策可控制身分可執行的動作、資源,以及條件。如需了解如何建立身分型政策,請參閱 IAM 使用者指南中的透過客戶管理政策定義自訂 IAM 許可。
身分型政策可以是內嵌政策 (直接內嵌至單一身分) 或受管政策 (連接至多個身分的獨立政策)。若要了解如何在受管和內嵌政策之間進行選擇,請參閱《IAM 使用者指南》中的在受管政策和內嵌政策之間進行選擇。
資源型政策
資源型政策是連接到資源的 JSON 政策文件。範例包括 IAM 角色信任政策和 Amazon S3 儲存貯體政策。在支援資源型政策的服務中,服務管理員可以使用它們來控制對特定資源的存取權限。您必須在資源型政策中指定主體。
資源型原則是位於該服務中的內嵌原則。您無法在資源型政策中使用來自 IAM 的 AWS 受管政策。
其他政策類型
AWS 支援其他政策類型,可設定更多常見政策類型授予的最大許可:
-
許可界限 – 設定身分型政策可授予 IAM 實體的最大許可。如需詳細資訊,請參閱《 IAM 使用者指南》中的 IAM 實體許可界限。
-
服務控制政策 SCPs) – 指定組織或組織單位的最大許可 AWS Organizations。如需詳細資訊,請參閱《AWS Organizations 使用者指南》中的服務控制政策。
-
資源控制政策 RCPs) – 設定帳戶中資源的可用許可上限。如需詳細資訊,請參閱《AWS Organizations 使用者指南》中的資源控制政策 (RCP)。
-
工作階段政策 – 進階政策在為角色或聯合身分使用者建立臨時工作階段時作為參數傳遞。如需詳細資訊,請參閱 IAM 使用者指南中的工作階段政策。
多種政策類型
將多種政策類型套用到請求時,其結果形成的許可會更為複雜、更加難以理解。若要了解如何 AWS 決定是否在涉及多個政策類型時允許請求,請參閱《IAM 使用者指南》中的政策評估邏輯。
Amazon Location Service 如何與 IAM 搭配使用
在您使用 IAM 管理 Amazon Location 的存取權之前,請先了解哪些 IAM 功能可與 Amazon Location 搭配使用。
| IAM 功能 | Amazon Location 支援 |
|---|---|
|
是 |
|
|
否 |
|
|
是 |
|
|
是 |
|
|
是 |
|
|
否 |
|
|
是 |
|
|
是 |
|
|
否 |
|
|
否 |
|
|
否 |
若要全面了解 Amazon Location 和其他 AWS 服務如何與大多數 IAM 功能搭配使用,請參閱《IAM 使用者指南》中的AWS 與 IAM 搭配使用的 服務。
Amazon Location 的身分型政策
支援身分型政策:是
身分型政策是可以附加到身分 (例如 IAM 使用者、使用者群組或角色) 的 JSON 許可政策文件。這些政策可控制身分在何種條件下能對哪些資源執行哪些動作。如需了解如何建立身分型政策,請參閱 IAM 使用者指南中的透過客戶管理政策定義自訂 IAM 許可。
使用 IAM 身分型政策,您可以指定允許或拒絕的動作和資源,以及在何種條件下允許或拒絕動作。如要了解您在 JSON 政策中使用的所有元素,請參閱 IAM 使用者指南中的 IAM JSON 政策元素參考。
Amazon Location 的身分型政策範例
若要檢視 Amazon Location 身分型政策的範例,請參閱 Amazon Location Service 的身分型政策範例。
Amazon Location 內的資源型政策
支援資源型政策:否
資源型政策是附加到資源的 JSON 政策文件。資源型政策的最常見範例是 IAM 角色信任政策和 Amazon S3 儲存貯體政策。在支援資源型政策的服務中,服務管理員可以使用它們來控制對特定資源的存取權限。對於附加政策的資源,政策會定義指定的主體可以對該資源執行的動作以及在何種條件下執行的動作。您必須在資源型政策中指定主體。委託人可以包含帳戶、使用者、角色、聯合身分使用者或 AWS 服務。
如需啟用跨帳戶存取權,您可以在其他帳戶內指定所有帳戶或 IAM 實體作為資源型政策的主體。如需詳細資訊,請參閱 IAM 使用者指南中的 IAM 中的快帳戶資源存取。
Amazon Location 的政策動作
支援政策動作:是
管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說,哪個主體在什麼條件下可以對什麼資源執行哪些動作。
JSON 政策的 Action 元素描述您可以用來允許或拒絕政策中存取的動作。政策會使用動作來授予執行相關聯動作的許可。
若要查看 Amazon Location 動作清單,請參閱《服務授權參考》中的 Amazon Location Service 定義的動作。
Amazon Location 中的政策動作在動作之前使用下列字首:
geo
如需在單一陳述式中指定多個動作,請用逗號分隔。
"Action": [ "geo:action1", "geo:action2" ]
您也可以使用萬用字元 (*) 來指定多個動作。例如,若要指定開頭是 Get 文字的所有動作,請包含以下動作:
"Action": "geo:Get*"
若要檢視 Amazon Location 身分型政策的範例,請參閱 Amazon Location Service 的身分型政策範例。
Amazon Location 的政策資源
支援政策資源:是
管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說,哪個主體在什麼條件下可以對什麼資源執行哪些動作。
Resource JSON 政策元素可指定要套用動作的物件。最佳實務是使用其 Amazon Resource Name (ARN) 來指定資源。對於不支援資源層級許可的動作,請使用萬用字元 (*) 來表示陳述式適用於所有資源。
"Resource": "*"
若要查看 Amazon Location 資源類型及其 ARNs,請參閱《服務授權參考》中的 Amazon Location Service 定義的資源。若要了解您可以使用哪些動作指定每個資源的 ARN,請參閱 Amazon Location Service 定義的動作。
若要檢視 Amazon Location 身分型政策的範例,請參閱 Amazon Location Service 的身分型政策範例。
Amazon Location 的政策條件索引鍵
支援服務特定政策條件金鑰:是
管理員可以使用 AWS JSON 政策來指定誰可以存取內容。也就是說,哪個主體在什麼條件下可以對什麼資源執行哪些動作。
Condition 元素指定陳述式何時根據定義的條件執行。您可以建立使用條件運算子的條件運算式 (例如等於或小於),來比對政策中的條件和請求中的值。若要查看所有 AWS 全域條件索引鍵,請參閱《IAM 使用者指南》中的AWS 全域條件內容索引鍵。
若要查看 Amazon Location 條件金鑰清單,請參閱《服務授權參考》中的 Amazon Location Service 的條件金鑰。若要了解您可以使用條件金鑰的動作和資源,請參閱 Amazon Location Service 定義的動作。
Amazon Location 支援條件金鑰,可讓您允許或拒絕存取政策陳述式中的特定地理圍欄或裝置。下列條件索引鍵可供使用:
-
geo:GeofenceIds用於 Geofence 動作。類型為ArrayOfString。 -
geo:DeviceIds用於追蹤器動作。類型為ArrayOfString。
下列動作可與 IAM 政策geo:GeofenceIds中的 搭配使用:
-
BatchDeleteGeofences -
BatchPutGeofences -
GetGeofence -
PutGeofence
下列動作可與 IAM 政策geo:DeviceIds中的 搭配使用:
-
BatchDeleteDevicePositionHistory -
BatchGetDevicePosition -
BatchUpdateDevicePosition -
GetDevicePosition -
GetDevicePositionHistory
注意
您無法將這些條件索引鍵與 BatchEvaluateGeofences、 ListGeofences或 ListDevicePosition動作搭配使用。
若要檢視 Amazon Location 身分型政策的範例,請參閱 Amazon Location Service 的身分型政策範例。
Amazon Location 中的 ACLs
支援 ACL:否
存取控制清單 (ACL) 可控制哪些主體 (帳戶成員、使用者或角色) 擁有存取某資源的許可。ACL 類似於資源型政策,但它們不使用 JSON 政策文件格式。
ABAC 與 Amazon Location
支援 ABAC (政策中的標籤):是
屬性型存取控制 (ABAC) 是一種授權策略,可根據稱為標籤的屬性定義許可。您可以將標籤連接至 IAM 實體 AWS 和資源,然後設計 ABAC 政策,以便在委託人的標籤符合資源上的標籤時允許操作。
如需根據標籤控制存取,請使用 aws:ResourceTag/、key-nameaws:RequestTag/ 或 key-nameaws:TagKeys 條件索引鍵,在政策的條件元素中,提供標籤資訊。
如果服務支援每個資源類型的全部三個條件金鑰,則對該服務而言,值為 Yes。如果服務僅支援某些資源類型的全部三個條件金鑰,則值為 Partial。
如需 ABAC 的詳細資訊,請參閱 IAM 使用者指南中的使用 ABAC 授權定義許可。如要查看含有設定 ABAC 步驟的教學課程,請參閱 IAM 使用者指南中的使用屬性型存取控制 (ABAC)。
如需標記 Amazon Location 資源的詳細資訊,請參閱 如何使用標籤。
若要檢視身分型政策範例,以根據該資源上的標籤來限制存取資源,請參閱根據標籤控制資源存取。
搭配 Amazon Location 使用臨時登入資料
支援臨時憑證:是
暫時登入資料提供 AWS 資源的短期存取權,並在您使用聯合或切換角色時自動建立。 AWS 建議您動態產生暫時登入資料,而不是使用長期存取金鑰。如需詳細資訊,請參閱《IAM 使用者指南》中的 IAM 和與 IAM 搭配使用的臨時安全登入資料。 AWS 服務
Amazon Location 的跨服務主體許可
支援轉寄存取工作階段 (FAS):否
轉送存取工作階段 (FAS) 使用呼叫 的委託人許可 AWS 服務,並結合 AWS 服務 請求向下游服務提出請求。如需提出 FAS 請求時的政策詳細資訊,請參閱轉發存取工作階段。
Amazon Location 的服務角色
支援服務角色:否
服務角色是服務擔任的 IAM 角色,可代您執行動作。IAM 管理員可以從 IAM 內建立、修改和刪除服務角色。如需詳細資訊,請參閱 IAM 使用者指南中的建立角色以委派許可權給 AWS 服務。
警告
變更服務角色的許可可能會中斷 Amazon Location 功能。只有在 Amazon Location 提供指引時,才能編輯服務角色。
Amazon Location 的服務連結角色
支援服務連結角色:否
服務連結角色是連結至 的一種服務角色 AWS 服務。服務可以擔任代表您執行動作的角色。服務連結角色會出現在您的 中 AWS 帳戶 ,並由服務擁有。IAM 管理員可以檢視,但不能編輯服務連結角色的許可。
如需建立或管理服務連結角色的詳細資訊,請參閱可搭配 IAM 運作的AWS
服務。在表格中尋找服務,其中包含服務連結角色欄中的 Yes。選擇是連結,以檢視該服務的服務連結角色文件。
Amazon Location Service 如何與未經驗證的使用者搭配使用
許多使用 Amazon Location Service 的案例,包括在 Web 或行動應用程式中顯示地圖,都需要允許尚未使用 IAM 登入的使用者存取。對於這些未經驗證的案例,您有兩個選項。
-
使用 API 金鑰 – 若要授予未驗證使用者的存取權,您可以建立 API 金鑰,以授予 Amazon Location Service 資源的唯讀存取權。這在您不想驗證每個使用者的情況下非常有用。例如,Web 應用程式。如需 API 金鑰的詳細資訊,請參閱 使用 API 金鑰進行身分驗證。
-
使用 Amazon Cognito – API 金鑰的替代方案是使用 Amazon Cognito 授予匿名存取。Amazon Cognito 可讓您使用 IAM 政策建立更豐富的授權,以定義未經驗證的使用者可執行的操作。如需使用 Amazon Cognito 的詳細資訊,請參閱 在 Web 中使用 Amazon Cognito 身分集區。
如需提供存取權給未驗證使用者的概觀,請參閱 使用 Amazon Location Service 驗證。
Amazon Location Service 的身分型政策範例
根據預設,使用者和角色沒有建立或修改 Amazon Location 資源的許可。若要授予使用者對其所需資源執行動作的許可,IAM 管理員可以建立 IAM 政策。
如需了解如何使用這些範例 JSON 政策文件建立 IAM 身分型政策,請參閱 IAM 使用者指南中的建立 IAM 政策 (主控台)。
如需 Amazon Location 定義的動作和資源類型的詳細資訊,包括每種資源類型的 ARNs 格式,請參閱《服務授權參考》中的 Amazon Location Service 的動作、資源和條件金鑰。
主題
政策最佳實務
身分型政策會判斷您帳戶中的某個人員是否可以建立、存取或刪除 Amazon Location 資源。這些動作可能會讓您的 AWS 帳戶產生費用。當您建立或編輯身分型政策時,請遵循下列準則及建議事項:
-
開始使用 AWS 受管政策並邁向最低權限許可 – 若要開始將許可授予您的使用者和工作負載,請使用將許可授予許多常見使用案例的 AWS 受管政策。它們可在您的 中使用 AWS 帳戶。我們建議您定義特定於使用案例 AWS 的客戶受管政策,以進一步減少許可。如需更多資訊,請參閱 IAM 使用者指南中的 AWS 受管政策或任務職能的AWS 受管政策。
-
套用最低權限許可 – 設定 IAM 政策的許可時,請僅授予執行任務所需的許可。為實現此目的,您可以定義在特定條件下可以對特定資源採取的動作,這也稱為最低權限許可。如需使用 IAM 套用許可的更多相關資訊,請參閱 IAM 使用者指南中的 IAM 中的政策和許可。
-
使用 IAM 政策中的條件進一步限制存取權 – 您可以將條件新增至政策,以限制動作和資源的存取。例如,您可以撰寫政策條件,指定所有請求都必須使用 SSL 來傳送。如果透過特定 例如 使用服務動作 AWS 服務,您也可以使用條件來授予其存取權 CloudFormation。如需詳細資訊,請參閱 IAM 使用者指南中的 IAM JSON 政策元素:條件。
-
使用 IAM Access Analyzer 驗證 IAM 政策,確保許可安全且可正常運作 – IAM Access Analyzer 驗證新政策和現有政策,確保這些政策遵從 IAM 政策語言 (JSON) 和 IAM 最佳實務。IAM Access Analyzer 提供 100 多項政策檢查及切實可行的建議,可協助您撰寫安全且實用的政策。如需詳細資訊,請參閱 IAM 使用者指南中的使用 IAM Access Analyzer 驗證政策。
-
需要多重要素驗證 (MFA) – 如果您的案例需要 IAM 使用者或 中的根使用者 AWS 帳戶,請開啟 MFA 以提高安全性。如需在呼叫 API 操作時請求 MFA,請將 MFA 條件新增至您的政策。如需詳細資訊,請參閱 IAM 使用者指南中的透過 MFA 的安全 API 存取。
如需 IAM 中最佳實務的相關資訊,請參閱 IAM 使用者指南中的 IAM 安全最佳實務。
使用 Amazon Location 主控台
若要存取 Amazon Location Service 主控台,您必須擁有一組最低許可。這些許可必須允許您列出和檢視 中 Amazon Location 資源的詳細資訊 AWS 帳戶。如果您建立比最基本必要許可更嚴格的身分型政策,則對於具有該政策的實體 (使用者或角色) 而言,主控台就無法如預期運作。
對於僅呼叫 AWS CLI 或 AWS API 的使用者,您不需要允許最低主控台許可。反之,只需允許存取符合他們嘗試執行之 API 操作的動作就可以了。
為了確保使用者和角色可以使用 Amazon Location 主控台,請將下列政策連接到實體。如需詳細資訊,請參閱 IAM 使用者指南中的新增許可到使用者。
下列政策可讓您存取 Amazon Location Service 主控台,以建立、刪除、列出和檢視您 AWS 帳戶中 Amazon Location 資源的詳細資訊。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "GeoPowerUser", "Effect": "Allow", "Action": [ "geo:*", "geo-maps:*", "geo-places:*", "geo-routes:*" ], "Resource": "*" } ] }
或者,您可以授予唯讀許可,以促進唯讀存取。使用唯讀許可時,如果使用者嘗試寫入動作,例如建立或刪除資源,則會顯示錯誤訊息。例如,請參閱 追蹤器資源的唯讀政策
允許使用者檢視他們自己的許可
此範例會示範如何建立政策,允許 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": "*" } ] }
在政策中使用 Amazon Location Service 資源
Amazon Location Service 會針對 資源使用下列字首:
| 資源 | 資源字首 |
|---|---|
| 映射資源 | map |
| 放置資源 | place-index |
| 路由資源 | route-calculator |
| 追蹤資源 | tracker |
| Geofence 集合資源 | geofence-collection |
使用下列 ARN 語法:
arn:Partition:geo:Region:Account:ResourcePrefix/ResourceName
如需 ARNs 格式的詳細資訊,請參閱 Amazon Resource Name (ARNs) AWS 和服務命名空間。
範例
-
使用下列 ARN 來允許存取指定的映射資源。
"Resource": "arn:aws:geo:us-west-2:account-id:map/map-resource-name" -
若要指定存取屬於特定帳戶的所有
map資源,請使用萬用字元 (*):"Resource": "arn:aws:geo:us-west-2:account-id:map/*" -
某些 Amazon Location 動作無法在特定資源上執行,例如用於建立資源的動作。在這些情況下,您必須使用萬用字元 (*)。
"Resource": "*"
若要查看 Amazon Location 資源類型及其 ARNs,請參閱《服務授權參考》中的 Amazon Location Service 定義的資源。若要了解您可以使用哪些動作指定每個資源的 ARN,請參閱 Amazon Location Service 定義的動作。
更新裝置位置的許可
若要更新多個追蹤器的裝置位置,您需要授予使用者存取一或多個追蹤器資源的權限。您也想要允許使用者更新一批裝置位置。
在此範例中,除了授予 Tracker1 和 Tracker2 資源的存取權之外,下列政策還授予對 Tracker1 和 Tracker2 資源使用 geo:BatchUpdateDevicePosition動作的許可。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "UpdateDevicePositions", "Effect": "Allow", "Action": [ "geo:BatchUpdateDevicePosition" ], "Resource": [ "arn:aws:geo:us-west-2:account-id:tracker/Tracker1", "arn:aws:geo:us-west-2:account-id:tracker/Tracker2" ] } ] }
如果您想要將使用者限制為只能更新特定裝置的裝置位置,您可以為該裝置 ID 新增條件索引鍵。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "UpdateDevicePositions", "Effect": "Allow", "Action": [ "geo:BatchUpdateDevicePosition" ], "Resource": [ "arn:aws:geo:us-west-2:account-id:tracker/Tracker1", "arn:aws:geo:us-west-2:account-id:tracker/Tracker2" ], "Condition":{ "ForAllValues:StringLike":{ "geo:DeviceIds":[ "deviceId" ] } } } ] }
追蹤器資源的唯讀政策
若要為 AWS 帳戶中的所有追蹤器資源建立唯讀政策,您需要授予所有追蹤器資源的存取權。您也想要授予使用者存取 動作的許可,以允許他們取得多個裝置的裝置位置、從單一裝置取得裝置位置,以及取得位置歷史記錄。
在此範例中,下列政策會授予下列動作的許可:
-
geo:BatchGetDevicePosition擷取多個裝置的位置。 -
geo:GetDevicePosition擷取單一裝置的位置。 -
geo:GetDevicePositionHistory擷取裝置的位置歷史記錄。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "GetDevicePositions", "Effect": "Allow", "Action": [ "geo:BatchGetDevicePosition", "geo:GetDevicePosition", "geo:GetDevicePositionHistory" ], "Resource": "arn:aws:geo:us-west-2:account-id:tracker/*" } ] }
建立地理圍欄的政策
若要建立政策以允許使用者建立地理圍欄,您需要授予特定動作的存取權,以允許使用者在地理圍欄集合上建立一或多個地理圍欄。
以下政策授予對集合執行下列動作的許可:
-
geo:BatchPutGeofence以建立多個地理圍欄。 -
geo:PutGeofence以建立單一地理圍欄。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "CreateGeofences", "Effect": "Allow", "Action": [ "geo:BatchPutGeofence", "geo:PutGeofence" ], "Resource": "arn:aws:geo:us-west-2:account-id:geofence-collection/Collection" } ] }
地理圍欄的唯讀政策
若要為存放在您 AWS 帳戶中的地理圍欄集合中的地理圍欄建立唯讀政策,您需要授予存取從存放地理圍欄的地理圍欄集合讀取的動作。
以下政策授予對集合的下列動作的許可:
-
geo:ListGeofences列出指定地理圍欄集合中的地理圍欄。 -
geo:GetGeofence從地理圍欄集合擷取地理圍欄。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "GetGeofences", "Effect": "Allow", "Action": [ "geo:ListGeofences", "geo:GetGeofence" ], "Resource": "arn:aws:geo:us-west-2:account-id:geofence-collection/Collection" } ] }
轉譯映射資源的許可
若要授予足夠的許可來轉譯地圖,您需要授予對地圖圖磚、精靈、網格和樣式描述項的存取權:
-
geo:GetMapTile會擷取地圖圖磚,用來選擇性地轉譯地圖上的功能。 -
geo:GetMapSprites會擷取 PNG 精靈工作表及其內描述位移的對應 JSON 文件。 -
geo:GetMapGlyphs會擷取用於顯示文字的 Glyph。 -
geo:GetMapStyleDescriptor會擷取映射的樣式描述項,其中包含轉譯規則。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "GetTiles", "Effect": "Allow", "Action": [ "geo:GetMapTile", "geo:GetMapSprites", "geo:GetMapGlyphs", "geo:GetMapStyleDescriptor" ], "Resource": "arn:aws:geo:us-west-2:account-id:map/Map" } ] }
允許搜尋操作的許可
若要建立政策以允許搜尋操作,您必須先授予 AWS 帳戶中位置索引資源的存取權。您也會想要授予 動作的存取權,讓使用者透過地理編碼使用文字進行搜尋,並透過反向地理編碼使用位置進行搜尋。
在此範例中,除了授予 PlaceIndex 的存取權之外,下列政策也會授予下列動作的許可:
-
geo:SearchPlaceIndexForPosition可讓您搜尋指定位置附近的位置或興趣點。 -
geo:SearchPlaceIndexForText可讓您使用自由格式文字搜尋地址、名稱、城市或區域。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "Search", "Effect": "Allow", "Action": [ "geo:SearchPlaceIndexForPosition", "geo:SearchPlaceIndexForText" ], "Resource": "arn:aws:geo:us-west-2:account-id:place-index/PlaceIndex" } ] }
路由計算器的唯讀政策
您可以建立唯讀政策,以允許使用者存取路由計算器資源來計算路由。
在此範例中,除了授予對 ExampleCalculator 的存取權之外,下列政策還會授予下列操作的許可:
-
geo:CalculateRoute根據離開位置、目的地儲存庫和航點位置清單來計算路由。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "RoutesReadOnly", "Effect": "Allow", "Action": [ "geo:CalculateRoute" ], "Resource": "arn:aws:geo:us-west-2:accountID:route-calculator/ExampleCalculator" } ] }
根據條件索引鍵控制資源存取
當您建立 IAM 政策以授予使用地理圍欄或裝置位置的存取權時,您可以使用條件運算子來更精確地控制使用者可以存取的地理圍欄或裝置。您可以透過在政策的 Condition元素中包含地理圍欄 ID 或裝置 ID 來執行此操作。
下列範例政策示範如何建立政策,允許使用者更新特定裝置的裝置位置。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "UpdateDevicePositions", "Effect": "Allow", "Action": [ "geo:BatchUpdateDevicePosition" ], "Resource": [ "arn:aws:geo:us-west-2:account-id:tracker/Tracker" ], "Condition":{ "ForAllValues:StringLike":{ "geo:DeviceIds":[ "deviceId" ] } } } ] }
根據標籤控制資源存取
當您建立 IAM 政策以授予使用 Amazon Location 資源的存取權時,您可以使用屬性型存取控制,以更好地控制使用者可以修改、使用或刪除哪些資源。您可以在政策的 Condition元素中包含標籤資訊,以根據資源標籤來控制存取。
下列範例政策示範如何建立允許使用者建立地理圍欄的政策。這會將許可授予下列動作,以在名為 Collection 的地理系集合上建立一或多個地理系:
-
geo:BatchPutGeofence以建立多個地理圍欄。 -
geo:PutGeofence來建立單一地理圍欄。
不過,只有在集合標籤 Owner具有該使用者的使用者名稱值時,此政策才會使用 Condition元素來授予許可。
-
例如,如果名為 的使用者
richard-roe嘗試檢視 Amazon LocationCollection,則集合必須加上標籤Owner=richard-roe或owner=richard-roe。否則會拒絕使用者存取。注意
條件標籤鍵
Owner符合Owner和owner,因為條件索引鍵名稱不區分大小寫。如需詳細資訊,請參閱《IAM 使用者指南》中的 IAM JSON 政策元素:條件。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "CreateGeofencesIfOwner", "Effect": "Allow", "Action": [ "geo:BatchPutGeofence", "geo:PutGeofence" ], "Resource": "arn:aws:geo:us-west-2:account-id:geofence-collection/Collection", "Condition": { "StringEquals": {"geo:ResourceTag/Owner": "${aws:username}"} } } ] }
如需如何根據標籤定義存取 AWS 資源許可的教學課程,請參閱 AWS Identity and Access Management 使用者指南。
對 Amazon Location Service 身分和存取進行故障診斷
使用以下資訊來協助您診斷和修正使用 Amazon Location 和 IAM 時可能遇到的常見問題。
我無權在 Amazon Location 中執行動作
如果您收到錯誤,告知您未獲授權執行動作,您的政策必須更新,允許您執行動作。
下列範例錯誤會在mateojackson IAM 使用者嘗試使用主控台檢視一個虛構 資源的詳細資訊,但卻無虛構 my-example-widgetgeo: 許可時發生。GetWidget
User: arn:aws:iam::123456789012:user/mateojackson is not authorized to perform: geo:GetWidgeton resource:my-example-widget
在此情況下,必須更新 mateojackson 使用者的政策,允許使用 geo: 動作存取 GetWidget 資源。my-example-widget
如果您需要協助,請聯絡您的 AWS 管理員。您的管理員提供您的簽署憑證。
我未獲得執行 iam:PassRole 的授權
如果您收到錯誤,告知您無權執行 iam:PassRole動作,您的政策必須更新,以允許您將角色傳遞至 Amazon Location。
有些 AWS 服務 可讓您將現有角色傳遞給該服務,而不是建立新的服務角色或服務連結角色。如需執行此作業,您必須擁有將角色傳遞至該服務的許可。
當名為 的 IAM marymajor 使用者嘗試使用主控台在 Amazon Location 中執行動作時,會發生下列範例錯誤。但是,動作請求服務具備服務角色授予的許可。Mary 沒有將角色傳遞至該服務的許可。
User: arn:aws:iam::123456789012:user/marymajoris not authorized to perform: iam:PassRole
在這種情況下,Mary 的政策必須更新,允許她執行 iam:PassRole 動作。
如果您需要協助,請聯絡您的 AWS 管理員。您的管理員提供您的簽署憑證。
我想要允許 以外的人員 AWS 帳戶 存取我的 Amazon Location 資源
您可以建立一個角色,讓其他帳戶中的使用者或您組織外部的人員存取您的資源。您可以指定要允許哪些信任物件取得該角色。針對支援基於資源的政策或存取控制清單 (ACL) 的服務,您可以使用那些政策來授予人員存取您的資源的許可。
如需進一步了解,請參閱以下內容:
-
若要了解 Amazon Location 是否支援這些功能,請參閱 Amazon Location Service 如何與 IAM 搭配使用。
-
若要了解如何在您擁有 AWS 帳戶 的 資源之間提供存取權,請參閱《IAM 使用者指南》中的在您擁有 AWS 帳戶 的另一個 中為 IAM 使用者提供存取權。
-
若要了解如何將資源的存取權提供給第三方 AWS 帳戶,請參閱《IAM 使用者指南》中的將存取權提供給第三方 AWS 帳戶 擁有。
-
如需了解如何透過聯合身分提供存取權,請參閱 IAM 使用者指南中的將存取權提供給在外部進行身分驗證的使用者 (聯合身分)。
-
如需了解使用角色和資源型政策進行跨帳戶存取之間的差異,請參閱《IAM 使用者指南》中的 IAM 中的跨帳戶資源存取。