이 페이지에서는 최소 권한 원칙을 준수하면서 Harbor-as-a-Service 레지스트리에서 액세스 제어를 관리하는 방법을 설명합니다. Google Distributed Cloud (GDC) 오프라인 조직 IAM 관리자는 Harbor-as-a-Service API를 사용하도록 인증 및 승인할 수 있는 사용자를 제어합니다. Harbor 인스턴스에서 API 및 액세스를 승인하려면 각 Harbor 프로젝트에서 Harbor의 기본 제공 역할 기반 액세스 제어를 사용하세요. 자세한 내용은 https://goharbor.io/docs/2.8.0/administration/managing-users/를 참고하세요.
Harbor-as-a-Service API 액세스 구성
모든 GDC Harbor-as-a-Service API에는 요청을 수행하는 주 구성원에게 API 리소스를 사용하는 데 필요한 권한이 있어야 합니다. 주 구성원에게 리소스에 대한 사전 정의된 역할을 부여하는 정책을 설정하여 주 구성원에게 권한을 부여합니다.
사전 정의된 Harbor-as-a-Service 역할
Harbor-as-a-Service는 관련 API 리소스에 대한 액세스 권한을 부여하고 다른 리소스에 대한 무단 액세스를 방지하는 사전 정의된 역할을 제공합니다.
Harbor 인스턴스 리소스를 관리하고 Harbor 프로젝트 리소스를 만드는 데 다음 사전 정의된 역할을 사용하세요.
Harbor 인스턴스 뷰어: Harbor 인스턴스를 보고 가져옵니다. 조직 IAM 관리자에게 Harbor 인스턴스 뷰어(harbor-instance-viewer) 역할을 부여해 달라고 요청하세요.
Harbor 인스턴스 관리자: Harbor 인스턴스를 만들고 관리하며 Harbor 인스턴스에서 Harbor 프로젝트를 만듭니다. 조직 IAM 관리자에게 Harbor 인스턴스 관리자 (harbor-instance-admin) 역할을 부여해 달라고 요청하세요.
Harbor 프로젝트 생성자: Harbor 인스턴스에서 Harbor 프로젝트를 만듭니다.
조직 IAM 관리자에게 Harbor 프로젝트 생성자(harbor-project-creator) 역할을 부여해 달라고 요청하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eGDC Organization IAM Administrators manage access to Harbor-as-a-Service APIs, controlling who can be authenticated and authorized.\u003c/p\u003e\n"],["\u003cp\u003eHarbor-as-a-Service uses predefined roles like Harbor Instance Viewer, Harbor Instance Admin, and Harbor Project Creator to manage access to API resources.\u003c/p\u003e\n"],["\u003cp\u003eWithin a Harbor instance, access is managed using Harbor's built-in role-based access control within each project.\u003c/p\u003e\n"],["\u003cp\u003eThe creator of a Harbor project is automatically assigned the \u003ccode\u003eProjectAdmin\u003c/code\u003e role, which allows them to manage other users' roles.\u003c/p\u003e\n"]]],[],null,["# Configure access control\n\nThis page describes how to manage access control in the Harbor-as-a-Service\nregistry while adhering to the principles of least privilege. Google Distributed Cloud (GDC) air-gapped Organization IAM Administrators control who can be\nauthenticated and authorized to use Harbor-as-a-Service APIs. For authorizing\nAPIs and access in a Harbor instance, use\nHarbor's built-in role-based access control\nin each Harbor project. For more information, see \u003chttps://goharbor.io/docs/2.8.0/administration/managing-users/\u003e.\n\nConfigure access for Harbor-as-a-Service APIs\n---------------------------------------------\n\nEvery GDC Harbor-as-a-Service API requires that the principal making the\nrequest has the required permissions to use the API resource. Permissions are\ngiven to principals by setting policies that grant the principal a predefined\nrole on the resource.\n\n### Predefined Harbor-as-a-Service roles\n\nHarbor-as-a-Service provides predefined roles that grant access to related API\nresources and prevent unauthorized access to other resources.\n\nUse the following predefined roles for managing the Harbor Instance resources\nand creating Harbor Project resources:\n\n- Harbor Instance Viewer: views and gets the Harbor instance. Ask your Organization IAM Admin to grant you the Harbor Instance Viewer (`harbor-instance-viewer`) role.\n- Harbor Instance Admin: creates and manages the Harbor instance, and creates Harbor projects in the Harbor instance. Ask your Organization IAM Admin to grant you the Harbor Instance Admin (`harbor-instance-admin`) role.\n- Harbor Project Creator: creates Harbor projects in the Harbor instance. Ask your Organization IAM Admin to grant you the Harbor Project Creator (`harbor-project-creator`) role.\n\nConfigure access for APIs and within a Harbor instance\n------------------------------------------------------\n\nWithin a Harbor instance, use Harbor's built-in role-based access control in\neach Harbor project to control who is authorized to use the APIs and access\nresources in the Harbor project. For more information, see\n\u003chttps://goharbor.io/docs/2.8.0/administration/managing-users/\u003e.\n\nThe user that creates the Harbor project is automatically assigned the\n`ProjectAdmin` role for the Harbor project. The `ProjectAdmin` user can assign\nroles for the Harbor project to other users. For all of the available roles, see\n\u003chttps://goharbor.io/docs/2.8.0/administration/managing-users/user-permissions-by-role/\u003e."]]
