Las vistas seguras parametrizadas proporcionan seguridad de los datos y control de acceso a las filas para las aplicaciones. Filtran los resultados de las consultas en función de la identidad del usuario de la aplicación.
En este instructivo, se describe cómo configurar vistas seguras parametrizadas en Cloud SQL, configurar roles y privilegios de la base de datos para restringir el acceso a las tablas base y verificar la seguridad de los datos. Los ejemplos que se proporcionan en este documento son solo para fines de demostración.
¿Qué son las vistas seguras parametrizadas?
Como práctica recomendada general, tu aplicación debe ejecutarse con una cuenta de servicio con el acceso mínimo requerido a tu base de datos. Por ejemplo, si tu aplicación no debe escribir en tu base de datos, debe usar un rol con acceso de solo lectura. Debes configurar estos controles de acceso a nivel de la base de datos.
Cuando tu aplicación necesita una seguridad más detallada que la que permite el acceso estándar a nivel de la base de datos, puedes usar vistas seguras parametrizadas para asegurarte de que los usuarios solo vean sus datos autorizados. Las vistas seguras parametrizadas proporcionan seguridad de los datos dinámica y control de acceso a las filas adecuado para aplicaciones SaaS de varios usuarios sin necesidad de roles de base de datos separados para cada usuario final de la aplicación.
El uso de vistas seguras parametrizadas proporciona tres beneficios principales:
- Seguridad de los datos dinámica y control de acceso a las filas: Filtra las consultas con identificadores de usuarios finales para que los usuarios accedan solo a sus datos autorizados, independientemente de la fraseología de la consulta.
- Administración de roles más sencilla: Usa un solo rol de base de datos compartido para todos los usuarios de la aplicación en lugar de administrar roles de base de datos separados para cada persona.
Objetivos
- Crea vistas seguras parametrizadas con parámetros de vista con nombre.
- Crea el rol de base de datos que usa la aplicación para conectarse a la base de datos y acceder a las vistas seguras parametrizadas.
- Otorga los permisos del rol nuevo a las vistas seguras parametrizadas y revoca el acceso a las tablas base.
- Conéctate con el rol nuevo y verifica que no se pueda acceder a las tablas restringidas.
- Ejecuta consultas en las vistas seguras parametrizadas con la función
execute_parameterized_query()o con la API de QueryData.
Costos
En este documento, usarás los siguientes componentes facturables de Google Cloud:
Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios.
Es posible que los usuarios Google Cloud nuevos decumplan con los requisitos para acceder a una prueba gratuita.
Para evitar la facturación continua, borra los recursos que creaste cuando termines las tareas de este documento. Para obtener más información, consulta Cómo realizar una limpieza.
Antes de comenzar
Antes de crear vistas seguras parametrizadas, completa los siguientes requisitos previos.
Habilita la facturación y las APIs requeridas
En la Google Cloud consola de, selecciona un proyecto.
Asegúrate de tener habilitada la facturación para tu Google Cloud proyecto.
Habilita las API de Cloud necesarias para crear y conectarte a Cloud SQL.
En el paso Confirmar proyecto, haz clic en Siguiente para confirmar el nombre del proyecto al que realizarás cambios.
En el paso Habilitar APIs, haz clic en Habilitar para habilitar lo siguiente:
- API de Cloud SQL para PostgreSQL
- API de Knowledge Catalog
Crea una base de datos y conéctate a ella
Prepara el entorno
Para prepararte para ejecutar consultas en una vista segura parametrizada, configura la base de datos, los roles de la base de datos, la extensión parameterized_views y el esquema de la aplicación.
Habilita la marca de la base de datos
Habilita la marca de base de datoscloudsql.enable_parameterized_views, que carga las bibliotecas de extensión requeridas. Para obtener más información, consulta Configura las marcas de base de datos de una instancia.
Configura la base de datos
- Crea una base de datos llamada
databasepara los datos de la aplicación y las vistas seguras parametrizadas. Para obtener más información, consulta Crea una base de datos.
Crea roles de base de datos, la extensión y el esquema de la aplicación
En la Google Cloud consola de, ve a la página de Cloud SQL.
Elige una instancia de la lista.
En el menú de navegación, haz clic en Cloud SQL Studio.
Accede a Studio con la autenticación de la cuenta de administrador.
Haz clic en Autenticar. En el panel Explorador muestra una lista de los objetos de tu base de datos.
Haz clic en Nueva pestaña del editor de SQL o Nueva pestaña para abrir una pestaña nueva.
Para usar vistas parametrizadas, crea la extensión
parameterized_viewsen tu base de datos:-- Requires parameterized_views.enabled set to true CREATE EXTENSION parameterized_views;Cuando se crea la extensión, la base de datos también crea un esquema llamado
parameterized_viewspara que las APIs se incluyan en el espacio de nombres de ese esquema y no entren en conflicto con las APIs existentes.Accede como un usuario con privilegios de superusuario, como el usuario
postgresintegrado.Crea un rol de base de datos nuevo para ejecutar consultas en vistas seguras parametrizadas. Este es un rol de Cloud SQL que usa la aplicación para conectarse y acceder a la base de datos para ejecutar consultas con acceso limitado a funciones u objetos públicos al conjunto mínimo requerido.
CREATE ROLE psv_user WITH LOGIN PASSWORD '...';Para obtener más información, consulta
CREATE USER.Conéctate como el usuario administrativo.
SET role TO postgres;Crea el esquema que contiene las tablas.
CREATE SCHEMA store;Crea las tablas e inserta datos.
CREATE TABLE store.checked_items(bag_id INT,timestamp TIMESTAMP, loc_code CHAR(3), scan_type CHAR(1), location TEXT, customer_id INT); INSERT INTO store.checked_items (bag_id, timestamp, loc_code, scan_type, location, customer_id) VALUES (101, '2023-10-26 10:00:00', 'ABC', 'I', 'Warehouse A', 123), (102, '2023-10-26 10:15:30', 'DEF', 'O', 'Loading Dock B', 456), (103, '2023-10-26 10:30:45', 'GHI', 'I', 'Conveyor Belt 1', 789), (104, '2023-10-26 11:00:00', 'JKL', 'O', 'Shipping Area C', 101), (105, '2023-10-26 11:45:15', 'MNO', 'I', 'Sorting Station D', 202), (106, '2023-10-26 12:00:00', 'PQR', 'O', 'Truck Bay E', 303);
Crea vistas seguras parametrizadas y configura privilegios de acceso
Para crear vistas seguras parametrizadas y configurar los privilegios de acceso adecuados para la tabla base y las vistas, sigue estos pasos:
En la Google Cloud consola de, ve a la página de Cloud SQL.
Elige una instancia de la lista.
En el menú de navegación, haz clic en Cloud SQL Studio.
Accede a Studio y conéctate a la
databasecomopostgres.Haz clic en Autenticar. En el panel Explorador muestra una lista de los objetos de tu base de datos.
Haz clic en Nueva pestaña del editor de SQL o Nueva pestaña para abrir una pestaña nueva.
Para proporcionar acceso limitado a la vista, crea una vista parametrizada:
CREATE VIEW store.secure_checked_items WITH (security_barrier) AS SELECT bag_id, timestamp, location FROM store.checked_items t WHERE customer_id = $@app_end_userid;Otorga acceso a la vista.
GRANT SELECT ON store.secure_checked_items TO psv_user;Para acceder a la vista, otorga acceso al esquema.
GRANT USAGE ON SCHEMA store TO psv_user;Revoca el acceso directo a la tabla base.
REVOKE ALL PRIVILEGES ON store.checked_items FROM psv_user;Nota: El propietario de la vista parametrizada debe tener privilegios
SELECTen las tablas base. Además, el usuario de la vista parametrizada debe tenerUSAGEen el esquema de la vista ySELECTen la vista. Por ejemplo, el usuariopostgreses propietario de la vista parametrizada, por lo que tiene privilegiosSELECTen las tablas base, mientras que elpsv_userdebe tenerUSAGEen el esquemastoreySELECTen la vista.Accede como administrador
postgresy otorga el rolpsv_usera un usuario autenticado con IAM:GRANT psv_user TO "IAM_USER_EMAIL";Reemplaza
IAM_USER_EMAILpor tu dirección de correo electrónico de usuario de IAM.
Verifica la seguridad de los datos
Para verificar que las vistas seguras parametrizadas restrinjan el acceso a las vistas designadas, accede a la base de datos como el usuario autenticado con IAM. En Cloud SQL, los usuarios de IAM heredan los permisos de los roles de base de datos que se les asignaron.
Accede a la base de datos como el usuario autenticado con IAM.
Verifica que no se pueda acceder a la tabla base.
SELECT * FROM store.checked_items; ERROR: permission denied for table checked_itemsAccede a las vistas seguras parametrizadas con la función
execute_parameterized_query:SELECT * FROM parameterized_views.execute_parameterized_query( query => 'SELECT * from store.secure_checked_items', param_names => ARRAY ['app_end_userid'], param_values => ARRAY ['303'] );Consulta las vistas seguras parametrizadas con la sintaxis de SQL y la solicitud
QueryDatacon parámetros PSV.curl -X POST \ "https://geminidataanalytics.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION:queryData" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d '{ "prompt": "Show me the checked items.", "context": { "datasource_references": { "cloud_sql_reference": { "database_reference": { "engine": "POSTGRESQL", "project_id": "PROJECT_ID", "region": "REGION", "instance_id": "INSTANCE_ID", "database_id": "DATABASE_ID" } } }, "parameterized_secure_view_parameters": { "parameters": { "app_end_userid": "303" } } }, "generation_options": { "generate_query_result": true, "generate_natural_language_answer": true, "generate_explanation": true } }'Reemplaza los siguientes valores:
PROJECT_ID: Es el ID del Google Cloud proyecto de.REGION: Es la región en la que se encuentra tu instancia de Cloud SQL para PostgreSQL.INSTANCE_ID: Es el ID de tu instancia de Cloud SQL para PostgreSQL.DATABASE_ID: Es el ID de tu base de datos de Cloud SQL para PostgreSQL.
Limpia
Borra el clúster
Cuando borras el clúster que creaste en la sección Antes de comenzar, también borras todos los objetos que creaste.
En la Google Cloud consola de, ve a la página de Cloud SQL.
Elige una instancia de la lista.
Haz clic en Borrar.
Ingresa el nombre de la instancia y haz clic en Borrar para confirmar que quieres borrar la instancia.
¿Qué sigue?
Obtén información sobre las vistas seguras parametrizadas.
Aprende a usar vistas seguras parametrizadas.