Guía de inicio rápido: usa la herramienta de línea de comandos

En esta página, se muestra cómo realizar tareas básicas en la API de Cloud Data Loss Prevention con una interfaz de línea de comandos.

Antes de comenzar

1. Accede a tu Cuenta de Google.

   Si todavía no tienes una cuenta, regístrate para obtener una nueva.

2. En GCP Console, ve a la página Administrar recursos y selecciona o crea un proyecto.

   Nota: Si no planeas conservar los recursos de GCP que crees en esta guía de inicio rápido, crea un proyecto nuevo. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con el proyecto y la guía de inicio rápido.

   Ir a la página Administrar recursos

3. Asegúrate de tener habilitada la facturación para tu proyecto.

   Aprende a habilitar la facturación

4. Habilita las DLP API necesarias.

   Habilita las API

5. Configura la autenticación:

   1. En GCP Console, ve a la página Crear clave de la cuenta de servicio.

      Ir a la página Crear clave de la cuenta de servicio
   2. Desde la lista desplegable de la Cuenta de servicio, selecciona Nueva cuenta de servicio.
   3. En el campo Nombre de cuenta de servicio, ingresa un nombre.

   4. En la lista desplegable Función, selecciona Proyecto > Propietario.

      Nota: El campo Función autoriza tu cuenta de servicio para acceder a los recursos. Puedes ver y cambiar este campo luego con GCP Console. Si desarrollas una aplicación de producción, especifica permisos más detallados que Proyecto > Propietario. Para obtener más información, consulta Cómo otorgar funciones a las cuentas de servicio.
   5. Haz clic en Crear. Se descargará un archivo JSON a tu computadora que contiene tus descargas de claves.

6. Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS con la ruta de acceso al archivo JSON que contiene la clave de tu cuenta de servicio. Esta variable solo se aplica a tu sesión actual de shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable.

   Ejemplo: Linux o macOS

   Reemplaza [PATH] con la ruta de acceso al archivo JSON que contiene la clave de tu cuenta de servicio.

   export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

   Por ejemplo:

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   Ejemplo: Windows

   Reemplaza [PATH] con la ruta de acceso al archivo JSON que contiene la clave de tu cuenta de servicio y [FILE_NAME] con el nombre del archivo.

   Con PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

   Por ejemplo:

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\[FILE_NAME].json"

   Con el símbolo del sistema:

   set GOOGLE_APPLICATION_CREDENTIALS=[PATH]

7. Descargar Node.js y NPM para instalar.

Permisos

La inspección de contenido requiere el permiso serviceusage.services.use para el proyecto especificado en parent. Las funciones roles/editor, roles/owner y roles.dlp.user contienen los permisos necesarios o puedes definir tu propia función personalizada.

Sigue estos pasos para otorgarle a tu usuario la función dlp.admin a nivel de proyecto:

IU web

1. Abre la página de Cloud Identity and Access Management en Google Cloud Platform Console.

   Abrir la página IAM

2. Si aún no se seleccionó un proyecto, haz clic en Seleccionar un proyecto.

3. Selecciona tu proyecto y haz clic en Abrir.

4. En la página de Cloud Identity and Access Management, haz clic en Agregar.

5. En el cuadro de diálogo Agregar miembros, haz lo siguiente:

   • Para Miembros, escribe el correo electrónico del usuario: [e-mail].
   • Para Funciones, haz clic en Seleccionar una función y elige Cloud DLP > Usuario de DLP.

6. Haz clic en Agregar.

Línea de comandos

1. Para agregar una sola vinculación a la política de Cloud IAM del proyecto, escribe el siguiente comando. Reemplaza [PROJECT_ID] por el ID del proyecto.

   gcloud projects add-iam-policy-binding [PROJECT_ID] --member group:[e-mail] --role roles/dlp.user

2. El comando escribe la política actualizada en la ventana de la consola:

bindings:
- members:
  - group:[e-mail]
    role: roles/dlp.user

Configura una aplicación de CLI en Cloud DLP

1. Clona o descarga un archivo ZIP del repositorio de muestras de Node.js.

2. Abre una herramienta de línea de comandos y navega hasta la carpeta de origen del repositorio.

3. Ejecuta npm install para instalar las dependencias de la aplicación.

4. Si aún no lo hiciste, crea la variable de entorno GCLOUD_PROJECT y configúrala con el ID del proyecto de Google Cloud Platform que configuraste para usar con Cloud DLP.

Inspecciona una string en busca de información sensible

En esta sección, se muestra cómo pedirle al servicio que analice texto de muestra con el comando inspect string.

1. Abre la herramienta de línea de comandos y navega hasta la carpeta samples del repositorio de muestras de Node.js.

2. Ejecuta el siguiente comando:

   node inspect.js string "My email address is [e-mail]."

Deberías recibir el siguiente resultado:

{
  "results":[
    {
      "findings":[
        {
          "quote":"[e-mail]",
          "infoType":"EMAIL_ADDRESS",
          "likelihood":"VERY_LIKELY",
          "location":{
            "byteRange":{
              "start":"20",
              "end":"35"
            },
            "codepointRange":{
              "start":"20",
              "end":"35"
            }
          }
        }
      ]
    }
  ]
}

¡Felicitaciones! Enviaste tu primera solicitud a la API de Cloud Data Loss Prevention.

Pasos siguientes

• Lee las guías prácticas para comenzar a inspeccionar imágenes y texto, y ocultar datos sensibles del texto.
• Lee los conceptos para entender mejor la inspección, la redacción, los infotipos y la probabilidad.
• Lee la referencia de la API de Service y la referencia de API de la biblioteca cliente de Node.js.