本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

AWS CodeStar 通知與的身分識別與存取管理 AWS CodeConnections

AWS Identity and Access Management (IAM) 可協助系統管理員安全地控制 AWS 資源存取權。 AWS 服務 IAM管理員控制誰可以驗證（登錄）和授權（有權限）使用 AWS CodeStar 通知和 AWS CodeConnections 資源。IAM是您 AWS 服務 可以免費使用的。

物件

您使用 AWS Identity and Access Management (IAM) 的方式會有所不同，具體取決於您在 AWS CodeStar 通知和中執行的工作 AWS CodeConnections。

服務使用者 — 如果您使用 AWS CodeStar 通知和 AWS CodeConnections 服務來完成工作，則管理員會為您提供所需的認證和權限。當您使用更多 AWS CodeStar 通知和 AWS CodeConnections 功能來完成工作時，您可能需要其他權限。了解存取許可的管理方式可協助您向管理員請求正確的許可。如果您無法存取「 AWS CodeStar 通知」中的功能 AWS CodeConnections，請參閱疑難排解 AWS CodeStar 通知以及 AWS CodeConnections身分識別與。

服務管理員 — 如果您負責公司的 AWS CodeStar 通知和 AWS CodeConnections 資源，您可能擁有 AWS CodeStar 通知和的完整存取權 AWS CodeConnections。您的工作就是決定您的服務使用者應存取哪些 AWS CodeStar 通知、 AWS CodeConnections 功能和資源。然後，您必須向IAM管理員提交請求，才能變更服務使用者的權限。檢閱此頁面上的資訊，以瞭解的基本概念IAM。若要深入瞭解貴公司如何IAM搭配 AWS CodeStar 通知使用 AWS CodeConnections，請參閱開發人員工具控制台中的功能如何使用 IAM。

IAM系統管理員 — 如果您是IAM系統管理員，您可能想要瞭解如何撰寫原則來管理「通知」和「 AWS CodeStar 通知」存取權的詳細資料 AWS CodeConnections。若要檢視您可以在中使用的「 AWS CodeStar 通知」和「 AWS CodeConnections 身分型原則」範例IAM，請參閱。 身分型政策範例

使用身分驗證

驗證是您 AWS 使用身分認證登入的方式。您必須以IAM使用者身分或假設IAM角色來驗證 (登入 AWS)。 AWS 帳戶根使用者

您可以使用透過 AWS 身分識別來源提供的認證，以聯合身分識別身分登入。 AWS IAM Identity Center (IAM身分識別中心) 使用者、貴公司的單一登入驗證，以及您的 Google 或 Facebook 認證都是聯合身分識別的範例。當您以同盟身分登入時，您的管理員先前會使用IAM角色設定聯合身分識別。當您使 AWS 用同盟存取時，您會間接擔任角色。

根據您的使用者類型，您可以登入 AWS Management Console 或 AWS 存取入口網站。如需有關登入的詳細資訊 AWS，請參閱《AWS 登入 使用指南》 AWS 帳戶中的如何登入您的。

如果您 AWS 以程式設計方式存取，請 AWS 提供軟體開發套件 (SDK) 和命令列介面 (CLI)，以使用您的認證以密碼編譯方式簽署您的要求。如果您不使用 AWS 工具，則必須自行簽署要求。如需使用建議的方法自行簽署要求的詳細資訊，請參閱使用IAM者指南中的簽署 AWS API要求。

無論您使用何種身分驗證方法，您可能都需要提供額外的安全性資訊。例如， AWS 建議您使用多重要素驗證 (MFA) 來增加帳戶的安全性。若要深入瞭解，請參閱使用AWS IAM Identity Center 者指南中的多重要素驗證和使用多重要素驗證 (MFA) AWS的使用IAM者指南。

AWS 帳戶根使用者

當您建立時 AWS 帳戶，您會從一個登入身分開始，該身分可完整存取該帳戶中的所有資源 AWS 服務 和資源。此身分稱為 AWS 帳戶 root 使用者，可透過使用您用來建立帳戶的電子郵件地址和密碼登入來存取。強烈建議您不要以根使用者處理日常任務。保護您的根使用者憑證，並將其用來執行只能由根使用者執行的任務。如需需要您以 root 使用者身分登入的完整工作清單，請參閱《使用指南》中的〈需要 root 使用者認證的IAM工作〉。

IAM 使用者和群組

IAM使用者是您內部的身分，具 AWS 帳戶 有單一人員或應用程式的特定權限。在可能的情況下，我們建議您仰賴臨時登入資料，而不要建立具有長期認證 (例如密碼和存取金鑰) 的IAM使用者。不過，如果您的特定使用案例需要使用IAM者的長期認證，建議您輪換存取金鑰。如需詳細資訊，請參閱《使用指南》中的「IAM定期輪換存取金鑰」以瞭解需要長期認證的使用案例。

IAM群組是指定IAM使用者集合的身分識別。您無法以群組身分簽署。您可以使用群組來一次為多名使用者指定許可。群組可讓管理大量使用者許可的程序變得更為容易。例如，您可以擁有一個名為的群組，IAMAdmins並授與該群組管理IAM資源的權限。

使用者與角色不同。使用者只會與單一人員或應用程式建立關聯，但角色的目的是在由任何需要它的人員取得。使用者擁有永久的長期憑證，但角色僅提供暫時憑證。要了解更多信息，請參閱《IAM用戶指南》中的創建用戶（而不是角色）的IAM時間。

IAM 角色

IAM角色是您 AWS 帳戶 中具有特定權限的身份。它類似於用IAM戶，但不與特定人員相關聯。您可以 AWS Management Console 透過切換角色來暫時擔任中的角色。IAM您可以透過呼叫 AWS CLI 或 AWS API作業或使用自訂來擔任角色URL。如需有關使用角色方法的詳細資訊，請參閱《使用指南》中的IAM〈使用IAM角色〉。

IAM具有臨時認證的角色在下列情況下很有用：

要了解是否使用IAM角色還是用IAM戶，請參閱《用戶指南》中的「IAM創建IAM角色的時機（而不是用戶）」。

使用政策管理存取權

您可以透 AWS 過建立原則並將其附加至 AWS 身分識別或資源來控制中的存取。原則是一個物件 AWS ，當與身分識別或資源相關聯時，會定義其權限。 AWS 當主參與者 (使用者、root 使用者或角色工作階段) 提出要求時，評估這些原則。政策中的許可決定是否允許或拒絕請求。大多數原則會 AWS 以JSON文件的形式儲存在中。如需有關JSON原則文件結構和內容的詳細資訊，請參閱《IAM使用指南》中的策略概觀。JSON

管理員可以使用 AWS JSON策略來指定誰可以存取什麼內容。也就是說，哪個主體在什麼條件下可以對什麼資源執行哪些動作。

預設情況下，使用者和角色沒有許可。若要授與使用者對所需資源執行動作的權限，IAM管理員可以建立IAM策略。然後，系統管理員可以將IAM原則新增至角色，使用者可以擔任這些角色。

IAM原則會定義動作的權限，不論您用來執行作業的方法為何。例如，假設您有一個允許 iam:GetRole 動作的政策。具有該原則的使用者可以從 AWS Management Console AWS CLI、或取得角色資訊 AWS API。

身分型政策

以身分識別為基礎的原則是您可以附加至身分識別 (例如使用者、使用IAM者群組或角色) 的JSON權限原則文件。這些政策可控制身分在何種條件下能對哪些資源執行哪些動作。若要瞭解如何建立以身分識別為基礎的策略，請參閱《IAM使用指南》中的〈建立IAM策略〉。

身分型政策可進一步分類成內嵌政策或受管政策。內嵌政策會直接內嵌到單一使用者、群組或角色。受管理的策略是獨立策略，您可以將其附加到您的 AWS 帳戶. 受管政策包括 AWS 受管政策和客戶管理的策略。若要了解如何在受管策略或內嵌策略之間進行選擇，請參閱《IAM使用手冊》中的「在受管策略和內嵌策略之間進行選擇」。

AWS CodeConnections 權限參考

下表列出每個 AWS CodeConnections API作業、您可以授與權限的對應動作，以及用於授與權限ARN的資源格式。根據允許的動作範圍，將其分組到表格中API。 AWS CodeConnections APIs撰寫可附加至身分識別 (以IAM身分識別為基礎的原則) 的權限原則時，請參閱此指令。

當您建立許可政策時，您需要在政策的 Action 欄位中指定動作。您可以在策略Resource欄位中將資源值指定為ARN包含或不含萬用字元 (*)。

若要在連線政策中表達條件，請使用此處所述和 條件索引鍵 中列出的條件索引鍵。您也可以使用 AWS寬度條件鍵。若要取得完整的 AWS寬按鍵清單，請參閱《IAM使用者指南》中的可用金鑰。

若要指定動作，請使用codeconnections前置詞，後面接著API作業名稱 (例如，codeconnections:ListConnections或codeconnections:CreateConnection。

使用萬用字元

若要指定多個動作或資源，請在ARN. 例如，codeconnections:*指定所有 AWS CodeConnections 動作，並codeconnections:Get*指定以該字開頭的所有 AWS CodeConnections 動作Get。以下範例授予對所有以 MyConnection 為名稱開頭之資源的存取權。

arn:aws:codeconnections:us-west-2:account-ID:connection/*

您只能搭配萬用字元使用 connection 下表中列出的資源。您無法搭配使用萬用字元 region 或 account-id 的費用。若要取得有關萬用字元的更多資訊，請參閱IAM使用指南中的IAM識別

管理連線的許可

被指定用來檢視、建立 AWS CLI 或SDK刪除連線的角色或使用者應具有下列權限的權限。

codeconnections:CreateConnection
codeconnections:DeleteConnection
codeconnections:GetConnection
codeconnections:ListConnections

使用捲軸查看資料表的其餘部分。

這些操作支援下列條件金鑰：

管理主機的許可

被指定用來檢視、建立 AWS CLI 或SDK刪除主機的角色或使用者應具有下列權限的權限。

codeconnections:CreateHost
codeconnections:DeleteHost
codeconnections:GetHost
codeconnections:ListHosts

使用捲軸查看資料表的其餘部分。

這些操作支援下列條件金鑰：

完成連線的許可

指定要管理在主控台中連線的角色或使用者，應具備完成主控台中的連線及建立安裝所需的許可，包括授權供應商進行交握，以及建立供連線使用的安裝。除了上述許可之外，也請使用下列許可。

執行以瀏覽器為基礎的交握時，主控台會使用下列IAM作業。ListInstallationTargets、、GetInstallationUrlStartOAuthHandshakeUpdateConnectionInstallation、和GetIndividualAccessToken是IAM原則權限。它們不是API行動。

codeconnections:GetIndividualAccessToken
codeconnections:GetInstallationUrl
codeconnections:ListInstallationTargets
codeconnections:StartOAuthHandshake
codeconnections:UpdateConnectionInstallation

以此為基礎，需要下列許可才能在主控台中使用、建立、更新或刪除連線。

codeconnections:CreateConnection
codeconnections:DeleteConnection
codeconnections:GetConnection
codeconnections:ListConnections
codeconnections:UseConnection
codeconnections:ListInstallationTargets
codeconnections:GetInstallationUrl
codeconnections:StartOAuthHandshake
codeconnections:UpdateConnectionInstallation
codeconnections:GetIndividualAccessToken

使用捲軸查看資料表的其餘部分。

這些作業支援下列條件索引鍵。

設定主機的許可

指定管理在主控台中連線的角色或使用者，應具備在主控台中設定主機所需的許可，包括授權供應商進行交握，以及安裝主機應用程式。除了上述主機許可之外，也請使用下列許可。

執行以瀏覽器為基礎的主機註冊時，主控台會使用下列IAM作業。 RegisterAppCode並且StartAppRegistrationHandshake是IAM策略權限。它們不是API行動。

codeconnections:RegisterAppCode
codeconnections:StartAppRegistrationHandshake

以此為基礎，需要下列許可才能在主控台中使用、建立、更新或刪除需要主機的連線 (例如已安裝的供應商類型)。

codeconnections:CreateConnection
codeconnections:DeleteConnection
codeconnections:GetConnection
codeconnections:ListConnections
codeconnections:UseConnection
codeconnections:ListInstallationTargets
codeconnections:GetInstallationUrl
codeconnections:StartOAuthHandshake
codeconnections:UpdateConnectionInstallation
codeconnections:GetIndividualAccessToken
codeconnections:RegisterAppCode
codeconnections:StartAppRegistrationHandshake

使用捲軸查看資料表的其餘部分。

這些作業支援下列條件索引鍵。

將連線傳遞至服務

將連線傳遞至服務時 (例如，在管線定義中ARN提供建立或更新管線的連線時)，使用者必須擁有該codeconnections:PassConnection權限。

使用捲軸查看資料表的其餘部分。

此操作也支援下列條件金鑰：

使用連線

當類似的服務 CodePipeline 使用連線時，服務角色必須具有指定連線的codeconnections:UseConnection權限。

若要在主控台中管理連線，使用者政策必須具有 codeconnections:UseConnection 許可。

使用捲軸查看資料表的其餘部分。

此操作也支援下列條件金鑰：

某些功能的必要條件金鑰可能隨著時間而變更。除非您的存取控制需求需要不同的許可，否則建議您使用 codeconnections:UseConnection 來控制對連線的存取。

支援的 ProviderAction 存取權類型

當 AWS 服務使用連接時，會導致對源代碼提供者進行API調用。例如，服務可能會藉由呼叫. https://api.bitbucket.org/2.0/repositories/username API

ProviderAction條件鍵允許您限制可以在提供者APIs上調用的內容。由於API路徑可能是動態產生的，而且路徑因提供者而異，因此ProviderAction值會對應至抽象動作名稱，而不是URL的API. 不論連線的供應商類型為何，這可讓您撰寫具有相同效果的政策。

以下是針對每個支援的 ProviderAction 值授予的存取類型。以下是IAM策略權限。它們不是API行動。

使用捲軸查看資料表的其餘部分。

標記連線資源的支援許可

標記連線資源時，會使用下列IAM作業。

codeconnections:ListTagsForResource
codeconnections:TagResource
codeconnections:UntagResource

使用捲軸查看資料表的其餘部分。

將連線傳遞到儲存庫連結

在同步配置中提供儲存庫連結時，使用者必須擁有存放庫連結 /resource 的codeconnections:PassRepository權限。ARN

使用捲軸查看資料表的其餘部分。

此操作也支援下列條件金鑰：

儲存庫連結的可支援條件金鑰

下列條件金鑰支援儲存庫連結和同步組態資源的操作：

在主控台中使用通知和連線

通知體驗內建於 CodeBuild、、和主控 CodePipeline台 CodeCommit CodeDeploy，以及 「設定」 導覽列本身的「開發人員工具」主控台中。若要存取主控台中的通知，您必須套用這些服務相關的其中一個受管政策，或者您必須擁有至少一組許可。這些權限必須允許您列出並檢視有關 AWS 帳戶中 AWS CodeStar 通知和 AWS CodeConnections 資源的詳細資料。如果您建立的以身分識別為基礎的原則比所需的最低權限更嚴格，則控制台將無法如預期用於具有該原則的實體 (IAM使用者或角色) 運作。如需有關授與 AWS CodeBuild、、和存取權的詳細資訊 AWS CodeCommit AWS CodeDeploy AWS CodePipeline，包括這些主控台的存取權，請參閱下列主題：

AWS CodeStar 通知沒有任何 AWS 受管理的策略。若要提供通知功能的存取權，您必須針對上述其中一項服務套用其中一項受管政策，或者，您必須建立具有您要授予使用者或實體之許可層級的政策，然後將這些政策連接到需要這些許可的使用者、群組或角色。如需更多資訊和範例，請參閱下列內容：

AWS CodeConnections 沒有任何 AWS 受管理的策略。您可以針對存取權使用許可和許可組合，如 完成連線的許可 中詳述的許可權限。

如需詳細資訊，請參閱下列內容：

您不需要為只對 AWS CLI 或撥打電話的使用者允許主控台權限 AWS API。相反地，只允許存取與您嘗試執行之API作業相符的動作。

允許使用者檢視他們自己的許可

此範例顯示如何建立原則，讓使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": "*"
        }
    ]
}