Configura los controles de acceso para las fuentes de datos personalizadas

En esta página, se describe cómo aplicar el control de acceso a la fuente de datos (también conocido como LCA) para las apps de búsqueda que creas con Cloud Storage o BigQuery.

Descripción general

El control de acceso para las fuentes de datos en Gemini Enterprise limita los datos que los usuarios pueden ver en los resultados de la app de búsqueda. Google usa el proveedor de identidad para identificar al usuario final que realiza una búsqueda y determinar si tiene acceso a los documentos que se muestran como resultados.

Por ejemplo, supongamos que los empleados de una empresa buscan en los documentos de BigQuery con la app de búsqueda. Sin embargo, es necesario cerciorarse de que no puedan ver contenido a través de la app al que no tienen permiso para acceder. Si se configuró un grupo de trabajadores en Google Cloud para el proveedor de identidad de la organización, entonces también se puede especificar ese grupo de trabajadores en Gemini Enterprise. Ahora, si un empleado usa la app, solo obtendrá resultados de búsqueda para los documentos a los que su cuenta ya tenga acceso en BigQuery.

Activar el control de acceso es un procedimiento que se realiza una sola vez. Para aplicar el control de acceso a una fuente de datos de BigQuery o Cloud Storage, sigue los pasos que se indican a continuación según el tipo de datos, como datos estructurados o no estructurados.

Datos no estructurados de Cloud Storage

Cuando configures un almacén de datos para datos no estructurados de Cloud Storage, también deberás subir metadatos de LCA y establecer el almacén de datos como controlado por acceso:

  1. Cuando prepares tus datos, incluye información de LCA en tus metadatos con el campo acl_info. Por ejemplo:

    {
   "id": "<your-id>",
   "jsonData": "<JSON string>",
   "content": {
     "mimeType": "<application/pdf or text/html>",
     "uri": "gs://<your-gcs-bucket>/directory/filename.pdf"
   },
   "acl_info": {
     "readers": [
       {
         "principals": [
           { "group_id": "group_1" },
           { "user_id": "user_1" }
         ]
       }
     ]
   }
 }

    Para obtener más información sobre los datos no estructurados con metadatos, consulta la sección Datos no estructurados de Prepara los datos para la transferencia.

  2. Cuando sigas los pasos para crear un almacén de datos en Crea un almacén de datos de origen, puedes habilitar el control de acceso haciendo lo siguiente en la consola o con la API:

    • Consola: Cuando crees un almacén de datos, selecciona Este almacén de datos contiene información de control de acceso durante la creación del almacén de datos.
    • API: Cuando crees un almacén de datos, incluye el campo "aclEnabled": "true" en tu carga útil de JSON.

  3. Cuando sigas los pasos para importar datos en Crea un almacén de datos de origen, asegúrate de hacer lo siguiente:

    • Sube tus metadatos con información de LCA desde el mismo bucket que tus datos no estructurados.
    • Si usas la API, establece GcsSource.dataSchema en document.

Datos estructurados de Cloud Storage

Cuando configures un almacén de datos para datos estructurados de Cloud Storage, también deberás subir metadatos de LCA y establecer el almacén de datos como controlado por acceso:

  1. Cuando prepares tus datos, incluye información de LCA en tus metadatos con el campo acl_info. Por ejemplo:

    {
   "id": "<your-id>",
   "jsonData": "<JSON string>",
   "acl_info": {
     "readers": [
       {
         "principals": [
           { "group_id": "group_1" },
           { "user_id": "user_1" }
         ]
       }
     ]
   }
 }

  2. Cuando sigas los pasos para crear un almacén de datos en Crea un almacén de datos propios store, puedes habilitar el control de acceso haciendo lo siguiente en la consola o con la API:

    • Consola: Cuando crees un almacén de datos, selecciona Este almacén de datos contiene información de control de acceso durante la creación del almacén de datos.
    • API: Cuando crees un almacén de datos, incluye el campo "aclEnabled": "true" en tu carga útil de JSON.

  3. Cuando sigas los pasos para importar datos en Crea un almacén de datos propios, asegúrate de hacer lo siguiente:

    • Sube tus metadatos con información de LCA desde el mismo bucket que tus datos estructurados.
    • Si usas la API, establece GcsSource.dataSchema en document.

Datos no estructurados de BigQuery

Cuando configures un almacén de datos para datos no estructurados de BigQuery, debes establecer el almacén de datos como controlado por acceso y proporcionar metadatos de LCA con un esquema predefinido para Gemini Enterprise:

  1. Cuando prepares tus datos, especifica el siguiente esquema. No uses un esquema personalizado.

    [
  {
    "name": "id",
    "mode": "REQUIRED",
    "type": "STRING",
    "fields": []
  },
  {
    "name": "jsonData",
    "mode": "NULLABLE",
    "type": "STRING",
    "fields": []
  },
  {
    "name": "content",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "mimeType",
        "type": "STRING",
        "mode": "NULLABLE"
      },
      {
        "name": "uri",
        "type": "STRING",
        "mode": "NULLABLE"
      }
    ]
  },
  {
    "name": "acl_info",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "readers",
        "type": "RECORD",
        "mode": "REPEATED",
        "fields": [
          {
            "name": "principals",
            "type": "RECORD",
            "mode": "REPEATED",
            "fields": [
              {
                "name": "user_id",
                "type": "STRING",
                "mode": "NULLABLE"
              },
              {
                "name": "group_id",
                "type": "STRING",
                "mode": "NULLABLE"
              }
            ]
          }
        ]
      }
    ]
  }
]

  2. Incluye tus metadatos de LCA como una columna en tu tabla de BigQuery.

  3. Cuando sigas los pasos en Crea un almacén de datos propios, habilita el control de acceso en la consola o con la API:

    • Consola: Cuando crees un almacén de datos, selecciona Este almacén de datos contiene información de control de acceso durante la creación del almacén de datos.
    • API: Cuando crees un almacén de datos, incluye el campo "aclEnabled": "true" en tu carga útil de JSON.

  4. Cuando sigas los pasos para importar datos en Crea un almacén de datos propios, si usas la API, establece BigQuerySource.dataSchema en document.

Datos estructurados de BigQuery

Cuando configures un almacén de datos para datos estructurados de BigQuery, debes establecer el almacén de datos como controlado por acceso y proporcionar metadatos de LCA con un esquema predefinido para Gemini Enterprise:

  1. Cuando prepares tus datos, especifica el siguiente esquema. No uses un esquema personalizado.

    [
  {
    "name": "id",
    "mode": "REQUIRED",
    "type": "STRING",
    "fields": []
  },
  {
    "name": "jsonData",
    "mode": "NULLABLE",
    "type": "STRING",
    "fields": []
  },
  {
    "name": "acl_info",
    "type": "RECORD",
    "mode": "NULLABLE",
    "fields": [
      {
        "name": "readers",
        "type": "RECORD",
        "mode": "REPEATED",
        "fields": [
          {
            "name": "principals",
            "type": "RECORD",
            "mode": "REPEATED",
            "fields": [
              {
                "name": "user_id",
                "type": "STRING",
                "mode": "NULLABLE"
              },
              {
                "name": "group_id",
                "type": "STRING",
                "mode": "NULLABLE"
              }
            ]
          }
        ]
      }
    ]
  }
]

  2. Incluye tus metadatos de LCA como una columna en tu tabla de BigQuery.

  3. Cuando sigas los pasos en Crea un almacén de datos propios, habilita el control de acceso en la consola o con la API:

    • Consola: Cuando crees un almacén de datos, selecciona Este almacén de datos contiene información de control de acceso durante la creación del almacén de datos.
    • API: Cuando crees un almacén de datos, incluye el campo "aclEnabled": "true" en tu carga útil de JSON.

  4. Cuando sigas los pasos para importar datos en Crea un almacén de datos de origen, asegúrate de hacer lo siguiente:

    • Si usas la consola, cuando especifiques el tipo de datos que subes, selecciona JSONL para datos estructurados con metadatos.
    • Si usas la API, establece BigQuerySource.dataSchema en document.