AWS CodeCommit 不再提供給新客戶。的現有客戶 AWS CodeCommit 可以繼續正常使用服務。進一步了解」

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

的 Identity and Access Management AWS CodeCommit

AWS Identity and Access Management (IAM) 是 AWS 服務 ，可協助管理員安全地控制對 AWS 資源的存取。IAM 管理員可控制誰可以進行身分驗證 （登入） 和授權 （具有許可），以使用 CodeCommit 資源。IAM 是您可以免費使用 AWS 服務 的 。

目標對象

使用方式 AWS Identity and Access Management (IAM) 會根據您的角色而有所不同：

使用身分驗證

身分驗證是您 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 使用者指南》中的需要根使用者憑證的任務。

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 受管政策。

存取控制清單 (ACL)

存取控制清單 (ACL) 可控制哪些主體 (帳戶成員、使用者或角色) 擁有存取某資源的許可。ACL 類似於資源型政策，但它們不使用 JSON 政策文件格式。

Amazon S3 AWS WAF和 Amazon VPC 是支援 ACLs的服務範例。如需進一步了解 ACL，請參閱 Amazon Simple Storage Service 開發人員指南中的存取控制清單 (ACL) 概觀。

其他政策類型

AWS 支援其他政策類型，可設定更多常見政策類型授予的最大許可：

多種政策類型

將多種政策類型套用到請求時，其結果形成的許可會更為複雜、更加難以理解。若要了解如何 AWS 決定是否在涉及多個政策類型時允許請求，請參閱《IAM 使用者指南》中的政策評估邏輯。

CodeCommit 資源型政策

CodeCommit 不支援以資源為基礎的政策。

以 CodeCommit 標籤為基礎的授權

您可以將標籤連接至 CodeCommit 資源，或在請求中將標籤傳遞至 CodeCommit。如需根據標籤控制存取，請使用 codecommit:ResourceTag/key-name、aws:RequestTag/key-name 或 aws:TagKeys 條件索引鍵，在政策的條件元素中，提供標籤資訊。如需標記 CodeCommit 資源的詳細資訊，請參閱 範例 5：在具有標籤的儲存庫上拒絕或允許動作。如需標記策略的詳細資訊，請參閱標記 AWS 資源。

CodeCommit 也支援以工作階段標籤為基礎的政策。如需詳細資訊，請參閱工作階段標籤。

使用標籤在 CodeCommit 中提供身分資訊

CodeCommit 支援使用工作階段標籤，這類標籤是您在擔任 IAM 角色、使用臨時憑證，或在 AWS Security Token Service (AWS STS) 中聯合使用者時所傳遞且為索引鍵值組的屬性。您也可以將這類標籤與 IAM 使用者建立關聯。您能夠使用這些標籤中提供的資訊，以利識別進行變更或導致事件發生的使用者。CodeCommit 包含 CodeCommit 事件中具有下列索引鍵名稱的標籤值：

如果提供此資訊，CodeCommit 會將此資訊包含在傳送至 Amazon EventBridge 和 Amazon CloudWatch Events 的事件中。如需詳細資訊，請參閱使用 Amazon EventBridge 和 Amazon CloudWatch Events 監控 CodeCommit 事件。

角色的政策必須包含設為 Allow 的 sts:TagSession 許可，才能夠使用工作階段標記。如果您是使用聯合身分存取，便可在設定時配置顯示名稱與電子郵件標籤資訊。例如，如果您使用的是 Azure Active Directory，則可提供下列宣告資訊：

您可以使用 AWS CLI 來傳遞 displayName和emailAddress使用 的工作階段標籤AssumeRole。例如，某位使用者想擔任名為 Developer 的角色，並將該角色與她的名字 Mary Major 建立關聯，則可使用類似如下的 assume-role 命令：

aws sts assume-role \
--role-arn arn:aws:iam::123456789012:role/Developer \
--role-session-name Mary-Major \
–-tags Key=displayName,Value="Mary Major" Key=emailAddress,Value="mary_major@example.com" \
--external-id Example987

如需詳細資訊，請參閱 AssumeRole。

您可以使用 AssumeRoleWithSAML 操作來傳回一組包含 displayName 和 emailAddress 標籤的暫時登入資料。您可以在存取 CodeCommit 儲存庫時使用這些標籤。這需要您的公司或群組已將您的第三方 SAML 解決方案與 整合 AWS。若是如此，您便可以將 SAML 屬性做為工作階段標籤傳遞。例如，如果您想將名為 Saanvi Sarkar 的使用者之顯示名稱和電子郵件身分屬性做為工作階段標籤傳遞：

<Attribute Name="https://aws.amazon.com/SAML/Attributes/PrincipalTag:displayName">
  <AttributeValue>Saanvi Sarkar</AttributeValue>
</Attribute>
<Attribute Name="https://aws.amazon.com/SAML/Attributes/PrincipalTag:emailAddress">
  <AttributeValue>saanvi_sarkar@example.com</AttributeValue>
</Attribute>

如需詳細資訊，請參閱使用 AssumeRoleWithSAML 傳遞工作階段標籤。

您可以使用 AssumeRoleWithIdentity 操作來傳回一組包含 displayName 和 emailAddress 標籤的暫時登入資料。您可以在存取 CodeCommit 儲存庫時使用這些標籤。如要從 OpenID Connect (OIDC) 傳遞工作階段標籤，您必須在 JSON Web 權杖 (JWT) 中包含工作階段標籤。例如，用於呼叫的解碼 JWP 字符AssumeRoleWithWebIdentity，其中包含名為 Li Juan 之使用者的 displayName和 emailAddress工作階段標籤：

{
    "sub": "lijuan",
    "aud": "ac_oic_client",
    "jti": "ZYUCeREXAMPLE",
    "iss": "https://xyz.com",
    "iat": 1566583294,
    "exp": 1566583354,
    "auth_time": 1566583292,
    "https://aws.amazon.com/tags": {
        "principal_tags": {
            "displayName": ["Li Juan"],
            "emailAddress": ["li_juan@example.com"],
        },
        "transitive_tag_keys": [
            "displayName",
            "emailAddress"
        ]
    }
}

如需詳細資訊，請參閱使用 AssumeRoleWithWebIdentity 傳遞工作階段標籤。

您可以使用 GetFederationToken 操作來傳回一組包含 displayName 和 emailAddress 標籤的暫時登入資料。您可以在存取 CodeCommit 儲存庫時使用這些標籤。例如，若要使用 AWS CLI 取得包含 displayName和 emailAddress標籤的聯合字符：

aws sts get-federation-token \
--name my-federated-user \
–-tags key=displayName,value="Nikhil Jayashankar" key=emailAddress,value=nikhil_jayashankar@example.com

如需詳細資訊，請參閱使用 GetFederationToken 傳遞工作階段標籤。

CodeCommit IAM 角色

IAM 角色是您 Amazon Web Services 帳戶中具備特定許可的實體。

搭配 CodeCommit 使用臨時登入資料

您可以搭配聯合使用暫時憑證、擔任 IAM 角色，或是擔任跨帳戶角色。您可以透過呼叫 AssumeRole 或 GetFederationToken 等 AWS STS API 操作來取得臨時安全登入資料。

CodeCommit 支援使用臨時登入資料。如需詳細資訊，請參閱使用輪換憑證連線至 AWS CodeCommit 儲存庫。

服務連結角色

服務連結角色可讓 AWS 服務存取其他服務中的資源，以代表您完成 動作。服務連結角色會顯示在您的 IAM 帳戶中，並由該服務所擁有。IAM 管理員可以檢視，但不能編輯服務連結角色的許可。

CodeCommit 不使用服務連結角色。

服務角色

此功能可讓服務代表您擔任服務角色。此角色可讓服務存取其他服務中的資源，以代表您完成動作。服務角色會出現在您的 IAM 帳戶中，且由該帳戶所擁有。這表示 IAM 管理員可以變更此角色的許可。不過，這樣可能會破壞此服務的功能。

CodeCommit 不使用服務角色。

AWS CodeCommit 身分型政策範例

根據預設，IAM 使用者和角色沒有建立或修改 CodeCommit 資源的許可。他們也無法使用 AWS 管理主控台 AWS CLI或 AWS API 執行任務。IAM 管理員必須建立 IAM 政策，授予使用者和角色在指定資源上執行特定 API 作業的所需許可。管理員接著必須將這些政策連接至需要這些許可的 IAM 使用者或群組。

如需政策的範例，請參閱下列主題：

若要了解如何使用這些範例 JSON 政策文件建立 IAM 身分型政策，請參閱 IAM 使用者指南中的在 JSON 索引標籤上建立政策。

政策最佳實務

身分型政策會判斷您帳戶中的某個人員是否可以建立、存取或刪除 CodeCommit 資源。這些動作可能會讓您的 AWS 帳戶產生費用。當您建立或編輯身分型政策時，請遵循下列準則及建議事項：

如需 IAM 中最佳實務的相關資訊，請參閱 IAM 使用者指南中的 IAM 安全最佳實務。

使用 CodeCommit 主控台

若要存取 AWS CodeCommit 主控台，您必須擁有一組最低的許可。這些許可必須允許您列出和檢視 Amazon Web Services 帳戶中 CodeCommit 資源的詳細資訊。如果您建立比最基本必要許可更嚴格的身分型政策，則對於具有該政策的實體 (IAM 使用者或角色) 而言，主控台就無法如預期運作。

為了確保這些實體仍然可以使用 CodeCommit 主控台，請將下列 AWS 受管政策連接至實體。如需更多資訊，請參閱 IAM 使用者指南中的新增許可到使用者：

如需詳細資訊，請參閱針對 CodeCommit 使用身分型政策 (IAM 政策）。

對於僅呼叫 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": "*"
        }
    ]
}

根據標籤檢視 CodeCommit 儲存庫

您可以在身分型政策中使用條件，根據標籤控制對 CodeCommit 資源的存取。如需示範作法的政策範例，請參閱範例 5：在具有標籤的儲存庫上拒絕或允許動作。

如需詳細資訊，請參閱《IAM 使用者指南》中的 IAM JSON 政策元素：條件。

對 AWS CodeCommit 身分和存取進行故障診斷

使用以下資訊來協助您診斷和修正使用 CodeCommit 和 IAM 時可能遇到的常見問題。

我無權在 CodeCommit 中執行動作

如果 AWS 管理主控台 告訴您無權執行 動作，則必須聯絡您的管理員尋求協助。您的管理員是為您提供簽署憑證的人員。

如需詳細資訊，請參閱使用 CodeCommit 主控台所需的許可

我未獲授權，不得執行 iam:PassRole

如果您收到錯誤，告知您無權執行 iam:PassRole動作，您的政策必須更新，以允許您將角色傳遞至 CodeCommit。

有些 AWS 服務 可讓您將現有角色傳遞給該服務，而不是建立新的服務角色或服務連結角色。如需執行此作業，您必須擁有將角色傳遞至該服務的許可。

當名為 的 IAM marymajor 使用者嘗試使用主控台在 CodeCommit 中執行動作時，會發生下列範例錯誤。但是，動作請求服務具備服務角色授予的許可。Mary 沒有將角色傳遞至該服務的許可。

User: arn:aws:iam::123456789012:user/marymajor is not authorized to perform: iam:PassRole

在這種情況下，Mary 的政策必須更新，允許她執行 iam:PassRole 動作。

如果您需要協助，請聯絡您的 AWS 管理員。您的管理員提供您的登入憑證。

我想要檢視我的存取金鑰

在您建立 IAM 使用者存取金鑰後，您可以隨時檢視您的存取金鑰 ID。但是，您無法再次檢視您的私密存取金鑰。若您遺失了密碼金鑰，您必須建立新的存取金鑰對。

存取金鑰包含兩個部分：存取金鑰 ID (例如 AKIAIOSFODNN7EXAMPLE) 和私密存取金鑰 (例如 wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY)。如同使用者名稱和密碼，您必須一起使用存取金鑰 ID 和私密存取金鑰來驗證您的請求。就如對您的使用者名稱和密碼一樣，安全地管理您的存取金鑰。

建立存取金鑰對時，您會收到提示，要求您將存取金鑰 ID 和私密存取金鑰儲存在安全位置。私密存取金鑰只會在您建立它的時候顯示一次。若您遺失了私密存取金鑰，您必須將新的存取金鑰新增到您的 IAM 使用者。您最多可以擁有兩個存取金鑰。若您已有兩個存取金鑰，您必須先刪除其中一個金鑰對，才能建立新的金鑰對。若要檢視說明，請參閱《IAM 使用者指南》中的管理存取金鑰。

我是管理員，想要允許其他人存取 CodeCommit

若要允許其他人存取 CodeCommit，您必須將許可授予需要存取的人員或應用程式。如果您使用 AWS IAM Identity Center 管理人員和應用程式，您可以將許可集指派給使用者或群組，以定義其存取層級。許可集會自動建立 IAM 政策，並將其指派給與該人員或應用程式相關聯的 IAM 角色。如需詳細資訊，請參閱AWS IAM Identity Center 《 使用者指南》中的許可集。

如果您不是使用 IAM Identity Center，則必須為需要存取的人員或應用程式建立 IAM 實體 （使用者或角色）。然後，您必須將政策連接到實體，以授予他們 CodeCommit 中的正確許可。授予許可後，請將登入資料提供給使用者或應用程式開發人員。他們將使用這些登入資料來存取 AWS。若要進一步了解如何建立 IAM 使用者、群組、政策和許可，請參閱《IAM 使用者指南》中的 IAM 身分和政策和許可。

我想要允許 Amazon Web Services 帳戶以外的人員存取我的 CodeCommit 資源

如需詳細資訊，請參閱使用 角色設定 AWS CodeCommit 儲存庫的跨帳戶存取權。