Inspecciona texto sensible con Node.js

Inspecciona texto sensible con Node.js

Aprende a analizar una string de muestra en busca de información sensible con la API de Cloud Data Loss Prevention (API de DLP), Google Cloud CLI y Node.js.

---

Para seguir la guía paso a paso en esta tarea directamente en la consola de Google Cloud, haz clic en Guía:

Guiarme

---

Antes de comenzar

1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
2. Instala Google Cloud CLI.

3. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

   gcloud init

4. Crea o selecciona un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   • Crea un proyecto de Cloud:

     gcloud projects create PROJECT_ID

   • Selecciona el proyecto de Cloud que creaste:

     gcloud config set project PROJECT_ID

5. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.

6. Habilita la API de DLP:

   gcloud services enable dlp.googleapis.com

7. Crea credenciales de autenticación para tu Cuenta de Google:

   gcloud auth application-default login

8. Otorga roles a tu Cuenta de Google. Ejecuta el siguiente comando una vez para cada uno de los siguientes roles de IAM: roles/dlp.user

   gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE

   • Reemplaza PROJECT_ID con el ID del proyecto.
   • Reemplaza EMAIL_ADDRESS por tu dirección de correo electrónico.
   • Reemplaza ROLE por cada rol individual.
9. Instala Google Cloud CLI.

10. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

    gcloud init

11. Crea o selecciona un proyecto de Google Cloud.

    Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

    • Crea un proyecto de Cloud:

      gcloud projects create PROJECT_ID

    • Selecciona el proyecto de Cloud que creaste:

      gcloud config set project PROJECT_ID

12. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.

13. Habilita la API de DLP:

    gcloud services enable dlp.googleapis.com

14. Crea credenciales de autenticación para tu Cuenta de Google:

    gcloud auth application-default login

15. Otorga roles a tu Cuenta de Google. Ejecuta el siguiente comando una vez para cada uno de los siguientes roles de IAM: roles/dlp.user

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE

    • Reemplaza PROJECT_ID con el ID del proyecto.
    • Reemplaza EMAIL_ADDRESS por tu dirección de correo electrónico.
    • Reemplaza ROLE por cada rol individual.
16. Instala Node.js y NPM.

Configura una app de CLI en Cloud DLP

Para configurar una app de la CLI de Cloud DLP mediante Node.js, haz lo siguiente:

1. Clona la biblioteca cliente de DLP de Node.js:

    git clone https://github.com/googleapis/nodejs-dlp
   

2. Navega al directorio samples.

    cd nodejs-dlp/samples
   

3. Usa este comando para instalar las dependencias de la app:

    npm install
   

Inspecciona una string en busca de información sensible

Para analizar el texto de muestra con la API de DLP y la secuencia de comandos inspectString de Node.js, ejecuta el siguiente comando:

  node inspectString.js PROJECT_ID "My email address is [e-mail]."

El resultado es similar a este:

  Findings:
      Info type: EMAIL_ADDRESS
      Likelihood: LIKELY

Realiza una limpieza

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que se usaron en esta página, borra el proyecto de Cloud que tiene los recursos.

Borra el proyecto

Si creaste un proyecto nuevo para esta guía de inicio rápido, la forma más fácil de evitar cargos adicionales es borrar el proyecto.

Precaución: Borrar un proyecto tiene estas consecuencias:

• Se borra todo en el proyecto. Si utilizaste un proyecto existente para este instructivo, cuando lo borres, también borrarás cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los ID personalizados de proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URL que utilizan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto en lugar de borrar todo el proyecto.

Si planeas explorar varios instructivos y guías de inicio rápido, la reutilización de proyectos puede ayudarte a evitar exceder los límites de las cuotas del proyecto.

Borra un proyecto de Cloud:

gcloud projects delete PROJECT_ID

Revoca tus credenciales

1. Opcional: Revoca las credenciales de autenticación que creaste y borra el archivo local de credenciales.

   gcloud auth application-default revoke

2. Opcional: Revoca las credenciales de la CLI de gcloud.

   gcloud auth revoke

¿Qué sigue?

• Para comenzar con la inspección de imágenes y texto en busca de datos sensibles, consulta las guías prácticas.

• Para comprender mejor la inspección, el ocultamiento, los Infotipos y la probabilidad, consulta Conceptos.

• Obtén más información sobre la API de DLP.

• Obtén más información sobre el cliente Node.js de Cloud DLP.