IAM으로 액세스 제어
이 페이지에서는 Identity and Access Management (IAM)를 사용하여 Colab Enterprise 리소스에 대한 액세스를 관리하는 방법을 설명합니다. 다른 Vertex AI 리소스에 대한 액세스를 관리하려면 IAM을 사용한 Vertex AI 액세스 제어를 참고하세요.
IAM으로 노트북 액세스 제어
프로젝트 수준 또는 노트북별로 Colab Enterprise 노트북 (IPYNB 파일)에 대한 액세스를 관리할 수 있습니다.
- 프로젝트 수준에서 노트북에 대한 액세스 권한을 부여하려면 주 구성원 (사용자, 그룹 또는 서비스 계정)에 역할을 하나 이상 할당합니다.
- 특정 노트북에 대한 액세스 권한을 부여하려면 노트북의 주 구성원에게 하나 이상의 역할을 할당합니다. 자세한 내용은 노트북 액세스 관리를 참고하세요.
다른 Google Cloud 서비스와 상호작용하는 코드 실행
노트북에 대한 액세스 권한은 노트북과 상호작용하는 것과 관련된 특정 권한으로 제한됩니다. 예를 들어 노트북을 만들거나, 노트북에 코드를 작성하거나, 노트북을 삭제할 수 있는 권한을 부여할 수 있습니다.
다른 Google Cloud 서비스와 상호작용하는 코드를 실행하려면 다음 방법 중 하나를 사용해야 합니다.
최종 사용자 인증 정보가 사용 설정된 런타임에서 코드를 실행합니다. 즉, 노트북은 노트북 사용자와 동일하게 Google Cloud 서비스에 액세스할 수 있습니다.
노트북이Google Cloud 서비스와 상호작용할 수 있도록 인증하고 승인하는 코드를 실행합니다.
자세한 내용은 Google Cloud와 상호작용하는 코드 실행을 참고하세요.
IAM 역할 유형
Colab Enterprise에서 사용할 수 있는 다양한 IAM 역할 유형이 있습니다.
사전 정의된 역할을 사용하면 프로젝트 수준에서 Colab Enterprise 리소스에 대한 관련 권한 집합을 부여할 수 있습니다.
기본 역할 (소유자, 편집자, 뷰어)은 프로젝트 수준에서 Colab Enterprise 리소스에 대한 액세스 제어를 제공하며 모든 Google Cloud서비스에 공통으로 적용됩니다.
커스텀 역할을 사용하면 특정 권한 집합을 선택하고, 해당 권한을 사용하여 고유한 역할을 만들고, 조직의 사용자에게 역할을 부여할 수 있습니다.
Colab Enterprise 프로젝트에서 이러한 역할을 추가, 업데이트 또는 삭제하려면 프로젝트, 폴더, 조직에 대한 액세스 관리 문서를 참고하세요.
Colab Enterprise의 사전 정의된 역할
Colab Enterprise는 Vertex AI의 일부이며 Colab Enterprise 리소스는 Vertex AI API를 통해 관리됩니다. 따라서 Vertex AI 역할을 통해 주 구성원에게 Colab Enterprise 리소스에 대한 액세스 권한을 부여할 수 있습니다.
다음 표에는 모든 Vertex AI 사전 정의 역할이 포함되어 있습니다.
일반적인 Colab Enterprise 작업에 사전 정의된 역할을 사용하려면 Colab Enterprise 관리자(
roles/aiplatform.colabEnterpriseAdmin
) 및 Colab Enterprise 사용자(roles/aiplatform.colabEnterpriseUser
)를 참고하세요.런타임 관리와 관련된 역할은 노트북 런타임 관리자(
roles/aiplatform.notebookRuntimeAdmin
) 및 노트북 런타임 사용자(roles/aiplatform.notebookRuntimeUser
)를 참고하세요.Vertex AI 관리자 (
roles/aiplatform.admin
), Vertex AI 사용자 (roles/aiplatform.user
), Vertex AI 뷰어 (roles/aiplatform.viewer
)에도 Colab Enterprise 권한이 포함됩니다.
Role | Permissions |
---|---|
Vertex AI Administrator( Grants full access to all resources in Vertex AI |
|
Colab Enterprise Admin( Admin role of using colab enterprise. |
|
Colab Enterprise User( User role of using colab enterprise. |
|
Vertex AI Feature Store EntityType owner( Provides full access to all permissions for a particular entity type resource. Lowest-level resources where you can grant this role:
|
|
Vertex AI Platform Express Admin Beta( Grants admin access to Vertex AI Express |
|
Vertex AI Platform Express User Beta( Grants user access to Vertex AI Express |
|
Vertex AI Feature Store Admin( Grants full access to all resources in Vertex AI Feature Store Lowest-level resources where you can grant this role:
|
|
Vertex AI Feature Store Data Viewer( This role provides permissions to read Feature data. Lowest-level resources where you can grant this role:
|
|
Vertex AI Feature Store Data Writer( This role provides permissions to read and write Feature data. Lowest-level resources where you can grant this role:
|
|
Vertex AI Feature Store Instance Creator( Administrator of Featurestore resources, but not the child resources under Featurestores. Lowest-level resources where you can grant this role:
|
|
Vertex AI Feature Store Resource Viewer( Viewer of all resources in Vertex AI Feature Store but cannot make changes. Lowest-level resources where you can grant this role:
|
|
Vertex AI Feature Store User Beta( Deprecated. Use featurestoreAdmin instead. |
|
Vertex AI Migration Service User( Grants access to use migration service in Vertex AI |
|
Notebook Executor User Beta( Grants users full access to schedules and notebook execution jobs. |
|
Notebook Runtime Admin( Grants full access to all runtime templates and runtimes in Notebook Service. |
|
Notebook Runtime User( Grants users permissions to create runtime resources using a runtime template and manage the runtime resources they created. |
|
Vertex AI Platform Provisioned Throughput Admin Beta( Grants access to use all resources related to Vertex AI Provisioned Throughput |
|
Vertex AI Tensorboard Web App User Beta( Grants access to the Vertex AI TensorBoard web app. |
|
Vertex AI User( Grants access to use all resource in Vertex AI |
|
Vertex AI Viewer( Grants access to view all resource in Vertex AI |
|
기본 역할
이전의 Google Cloud 기본 역할은 모든 Google Cloud 서비스에 공통적으로 적용됩니다. 이러한 역할은 소유자, 편집자, 뷰어입니다.
기본 역할은 Colab Enterprise뿐만 아니라 Google Cloud전반에 대한 권한을 제공합니다. 이러한 이유로 가능하면 Colab Enterprise 역할을 사용해야 합니다.
커스텀 역할
Colab Enterprise의 사전 정의된 IAM 역할이 필요에 맞지 않는 경우 커스텀 역할을 정의할 수 있습니다. 커스텀 역할을 사용하면 특정 권한 집합을 선택하고, 해당 권한을 사용하여 고유한 역할을 만들고, 조직의 사용자에게 역할을 부여할 수 있습니다. 자세한 내용은 IAM 맞춤 역할 이해를 참조하세요.
Colab Enterprise의 서비스 상담사
Colab Enterprise는 서비스 에이전트를 자동으로 생성하고 사용하여 사용자를 대신하여 리소스에 액세스합니다. 서비스 에이전트가 생성되면 서비스 에이전트에게 프로젝트에 대해 사전 정의된 역할이 부여됩니다.
다음 표에는 Colab Enterprise 서비스 상담사, 이메일 주소, 각 역할이 나와 있습니다.
이름 | 연결 대상: | 이메일 주소 | 역할 |
---|---|---|---|
Vertex AI 서비스 에이전트 | Vertex AI 기능 | service-PROJECT_NUMBER@gcp-sa-aiplatform.iam.gserviceaccount.com |
roles/aiplatform.serviceAgent |
Vertex AI Colab 서비스 에이전트 | Colab Enterprise에 작동하는 데 필요한 적절한 권한을 부여합니다. | service-PROJECT_NUMBER@gcp-sa-vertex-nb.iam.gserviceaccount.com |
roles/aiplatform.colabServiceAgent |
Vertex AI 노트북 서비스 에이전트 | 제한된 권한으로 사용자 프로젝트에서 노트북 관리형 리소스 실행 | service-PROJECT_NUMBER@gcp-sa-aiplatform-vm.iam.gserviceaccount.com |
roles/aiplatform.notebookServiceAgent |
Colab Enterprise 서비스 에이전트의 기본 역할을 삭제하면 Colab Enterprise에서 이러한 역할을 자동으로 재할당하여 서비스 기능이 중단되지 않도록 할 수 있습니다. Colab Enterprise 서비스를 사용 중지하려면 역할을 삭제하는 대신 관련 API를 사용 중지해야 합니다.
다음 단계
커스텀 IAM 역할 생성 및 관리 방법 알아보기
서비스 에이전트 자세히 알아보기