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. Sign in to your Google Account.

   If you don't already have one, sign up for a new account.

2. In the GCP Console, go to the Manage resources page and select or create a project.

   Note: If you don't plan to keep the resources you create in this procedure, create a new project instead of selecting an existing project. After you finish following these steps, you can delete the project, removing all resources associated with the project.

   Go to the Manage resources page

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. Set up authentication:

   1. In the GCP Console, go to the Create service account key page.

      Go to the Create Service Account Key page
   2. From the Service account list, select New service account.
   3. In the Service account name field, enter a name.

   4. From the Role list, select Project > Owner.

      Note: The Role field authorizes your service account to access resources. You can view and change this field later by using the GCP Console. If you are developing a production app, specify more granular permissions than Project > Owner. For more information, see granting roles to service accounts.
   5. Click Create. A JSON file that contains your key downloads to your computer.

6. Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the file path of the JSON file that contains your service account key. This variable only applies to your current shell session, so if you open a new session, set the variable again.

   Example: Linux or macOS

   Replace [PATH] with the file path of the JSON file that contains your service account key.

   export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

   For example:

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

   Example: Windows

   Replace [PATH] with the file path of the JSON file that contains your service account key, and [FILE_NAME] with the filename.

   With PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

   For example:

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

   With command prompt:

   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.