Configuring a `GDCHRestrictedService` organization policy lets you control
access to Vertex AI Workbench in Google Distributed Cloud (GDC) air-gapped. When
applied, this policy blocks the APIs that it references so that only
non-restricted organizations or projects can create and update JupyterLab notebooks.
You can limit Vertex AI Workbench to specific projects or restrict access
across your entire organization during testing.

For more information about organization policies, see
[Configure organization policies](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/platform/pa-user/org-policy).

## Before you begin

- To get the permissions you need to grant or restrict access to
  Vertex AI Workbench for an organization or a project, ask your
  IAM Org Admin to grant you the GDC Restricted
  Service Policy Admin (`gdchrestrictedservice-policy-admin`) cluster role. This role is not bound to a namespace.
  For more information about this role, see [Prepare IAM permissions](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/application/ao-user/vertex-ai-ao-permissions).

- Define the path to your management API server kubeconfig:

      export KUBECONFIG=MANAGEMENT_API_SERVER_KUBECONFIG

## Create restrictions

The following sections describe how to create, update, delete, and view restrictions for specific services within your project namespaces.

### Create or update restrictions

- To create or update restrictions for your organization, run:

      kubectl --kubeconfig=${KUBECONFIG} apply -f  - <<EOF
      apiVersion: constraints.gatekeeper.sh/v1beta1
      kind: GDCHRestrictedService
      metadata:
        name: NAME
      spec:
        match:
          scope: "Namespaced"
          namespaces: PROJECT_NAMESPACE
          kinds:
          - apiGroups:
            - "aiplatform.gdc.goog"
            kinds:
            - Notebook
      EOF

### Delete a restriction

- To delete restrictions, run:

      kubectl delete GDCHRestrictedService NAME 

### Describe a restriction

- To describe restrictions, run:

      kubectl describe GDCHRestrictedService NAME 

## Restrict access to Vertex AI Workbench for your organization

To restrict access to Vertex AI Workbench for your organization, edit the
`GDCHRestrictedService` policy type by adding the `aiplatform.gdc.goog` API
group and the `Notebook` kind to the `kinds` field of the policy.

The following example shows how the `kinds` field looks in the
`GDCHRestrictedService` policy type when you restrict access to
Vertex AI Workbench for your entire organization:

    apiVersion: constraints.gatekeeper.sh/v1beta1
    kind: GDCHRestrictedService
    metadata:
      name: restrict-notebook-for-organization
    spec:
      match:
        scope: "Namespaced"
        kinds:
        - apiGroups:
          - "aiplatform.gdc.goog"
          kinds:
          - Notebook

    # [...]

To restore an organization's access to Vertex AI Workbench, see
[Grant access to Vertex AI Workbench for your organization](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/application/ao-user/vertex-ai-workbench-access#restore-org-access).

## Restrict access to Vertex AI Workbench for a project

To restrict access to Vertex AI Workbench for a project, edit the
`GDCHRestrictedService` policy type by adding the `aiplatform.gdc.goog` API
group and the `Notebook` kind to the `kinds` field of the policy for the project
namespace.

The difference with [restricting access for an organization](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/application/ao-user/vertex-ai-workbench-access#restrict-org-access)
is that you must specify the namespace that the policy should impact. Add the
`namespaces` field to the policy with your project namespace.

The following example shows how the `kinds` field looks in the
`GDCHRestrictedService` policy type when you restrict access to
Vertex AI Workbench for a project:

    apiVersion: constraints.gatekeeper.sh/v1beta1
    kind: GDCHRestrictedService
    metadata:
      name: restrict-notebook-for-organization
    spec:
      match:
        scope: "Namespaced"
        namespaces: [PROJECT_NAMESPACE]
        kinds:
        - apiGroups:
          - "aiplatform.gdc.goog"
          kinds:
          - Notebook

    # [...]

Replace `PROJECT_NAMESPACE` with the namespace of the project
where you want to restrict access to Vertex AI Workbench.

## Grant access to Vertex AI Workbench for your organization

By default, Distributed Cloud organizations have access to
Vertex AI Workbench. However, if you
[restricted access to Vertex AI Workbench for your organization](https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/application/ao-user/vertex-ai-workbench-access#restrict-org-access),
you can grant access again.

Follow these steps to grant access to Vertex AI Workbench for all the
projects in your organization:

1. Identify the `GDCHRestrictedService` policy type in your organization.

2. Find the `aiplatform.gdc.goog` API group and the `Notebook` kind in the
   policy.

3. If the `aiplatform.gdc.goog` API group and the `Notebook` kind are the only
   content in the `kinds` field of the policy, delete the
   `GDCHRestrictedService` resource.

4. If the `GDCHRestrictedService` policy contains other restricted services,
   remove the `aiplatform.gdc.goog` API group and the `Notebook` kind from the
   `kinds` field and save the changes to the policy.

> [!NOTE]
> **Note:** The `kinds` field must always contain a value.