Referencia de transformación

En este tema, se describen las técnicas, o transformaciones, de desidentificación disponibles en Cloud DLP.

Tipos de técnicas de desidentificación

La elección de la transformación de desidentificación que desees usar depende del tipo de datos que deseas desidentificar y con qué propósito lo haces. Las técnicas de desidentificación que admite Cloud DLP se dividen en las siguientes categorías generales:

Ocultamiento: Borra de forma parcial o completa un valor sensible detectado.
Reemplazo: Reemplaza un valor sensible detectado por un valor subrogado especificado.
Enmascaramiento: Reemplaza una cantidad de caracteres de un valor sensible por un carácter subrogado especificado, como un hash (#) o un asterisco (*).
Asignación de tokens basada en criptografía: Encripta el valor original de los datos sensibles mediante el uso de una clave criptográfica. Cloud DLP admite varios tipos de asignación de tokens, incluidas las transformaciones que se pueden revertir o “reidentificar”.
Agrupamiento: “Generaliza” un valor sensible mediante su reemplazo por un rango de valores. Por ejemplo, reemplaza una edad específica por un rango de edades o reemplaza temperaturas por rangos que correspondan a “Caliente”, “Medio” y “Frío”.
Cambio de fechas: Cambia los valores sensibles de fecha por una cantidad de tiempo aleatoria.
Extracción de tiempo: Extrae o conserva partes específicas de valores de fecha y hora.

En el resto de este tema, se describe cada tipo diferente de transformación de desidentificación y se proporcionan ejemplos de su uso.

Métodos de transformación

En la siguiente tabla, se enumeran las transformaciones que proporciona Cloud DLP para desidentificar datos sensibles:

Transformación	Objeto	Descripción	Se puede revertir₁	Integridad referencial₂	Tipo de entrada
Ocultamiento	`RedactConfig`	Quita un valor y lo oculta.			Cualquiera
Reemplazo	`ReplaceValueConfig`	Reemplaza cada valor de entrada con un valor determinado.			Cualquiera
Reemplazo con Infotipo	`ReplaceWithInfoTypeConfig`	Reemplaza un valor de entrada con el nombre de su Infotipo.			Cualquiera
Enmascaramiento con caracteres	`CharacterMaskConfig`	Enmascara una string por completo o parcialmente mediante el reemplazo de un número determinado de caracteres con un carácter fijo especificado.			Cualquiera
Seudonimización mediante el reemplazo de un valor de entrada con un hash criptográfico	`CryptoHashConfig`	Reemplaza valores de entrada con una string hexadecimal de 32 bytes mediante una clave de encriptación de datos. Para obtener más información, consulta la documentación conceptual de seudonimización.		✔	Strings o números enteros
Seudonimización mediante el reemplazo por token de preservación de formato criptográfico	`CryptoReplaceFfxFpeConfig`	Reemplaza un valor de entrada con un token, o valor sustituto, de la misma longitud mediante la encriptación de preservación de formato (FPE) con el modo de operación FFX. Esto permite que la salida se use en sistemas con validación de formato en función de la longitud. Esto es útil para los sistemas heredados en los que se debe mantener la longitud de la string. Importante: Para las entradas que varían en su longitud o que tienen una longitud superior a 32 bytes, usa `CryptoDeterministicConfig`. Para mantener la seguridad, el Instituto Nacional de Normas y Tecnología recomienda usar los siguientes límites: radix^max_size <= 2^128. radix^min_len >= 100 Además de garantizar la integridad referencial, recomendamos el uso de CryptoDeterministicConfig para todos los casos prácticos que no requieran conservar el espacio y el tamaño del alfabeto de entrada. Para obtener más información, consulta la documentación conceptual de seudonimización.	✔	✔	Strings o números enteros con una cantidad limitada de caracteres y una longitud uniforme. El alfabeto debe estar compuesto al menos por 2 caracteres y no debe contener más de 95.
Seudonimización mediante el reemplazo por token criptográfico	`CryptoDeterministicConfig`	Reemplaza un valor de entrada por un token o un valor subrogado de la misma longitud mediante el uso de AES en modo de vector de inicialización sintética (AES-SIV). Este método de transformación, a diferencia de la asignación de token con preservación de formato, no tiene límites en los grupos de caracteres de string compatibles, genera tokens idénticos para cada instancia de un valor de entrada idéntico y usa subrogados para habilitar la reidentificación con la clave de encriptación original.	✔	✔	Cualquiera
Valores de bucket con base en rangos de tamaño fijos	`FixedSizeBucketingConfig`	Enmascara los valores de entrada y los reemplaza por depósitos, o rangos dentro de los cuales se encuentra el valor de entrada.			Cualquiera
Valores de bucket con base en rangos de tamaño personalizados	`BucketingConfig`	Valores de entrada de depósito con base en rangos configurables por el usuario y valores de reemplazo.			Cualquiera
Cambio de fechas	`DateShiftConfig`	Cambia las fechas por un número de días al azar, con la opción de ser coherente en el mismo contexto.		✔ Conserva la secuencia y la duración	Fechas y horarios
Extracción de datos de tiempo	`TimePartConfig`	Extrae o conserva una parte de los valores de `Date`, `Timestamp` y `TimeOfDay`.			Fechas y horarios

Pies de página

¹ Las transformaciones reversibles se pueden revertir para reidentificar los datos sensibles mediante el método content.reidentify.

² La integridad referencial permite que los registros mantengan su relación incluso mientras se desidentifican los datos. Por ejemplo, en caso de que se trate del mismo contexto y la misma clave criptográfica, los datos serán reemplazados por la misma forma ofuscada cada vez que se transforme, lo que permite que se conserven las conexiones entre los registros.

Ocultamiento

Si solo quieres quitar datos sensibles de tu contenido de entrada, Cloud DLP admite una transformación de ocultamiento (RedactConfig en la API de DLP).

Por ejemplo, supongamos que deseas realizar un ocultamiento simple de todos los Infotipos EMAIL_ADDRESS y que la siguiente string se envía a Cloud DLP:

My name is Alicia Abernathy, and my email address is aabernathy@example.com.

La string obtenida será la que se muestra a continuación:

My name is Alicia Abernathy, and my email address is .

En el siguiente ejemplo y código JSON en varios lenguajes, se muestra cómo formar la solicitud a la API y lo que muestra la API de Cloud DLP:

Protocolo

Entrada de JSON:

POST https://dlp.googleapis.com/v2/projects/[PROJECT_ID]/content:deidentify?key={YOUR_API_KEY}

{
  "item":{
    "value":"My name is Alicia Abernathy, and my email address is aabernathy@example.com."
  },
  "deidentifyConfig":{
    "infoTypeTransformations":{
      "transformations":[
        {
          "infoTypes":[
            {
              "name":"EMAIL_ADDRESS"
            }
          ],
          "primitiveTransformation":{
            "redactConfig":{

            }
          }
        }
      ]
    }
  },
  "inspectConfig":{
    "infoTypes":[
      {
        "name":"EMAIL_ADDRESS"
      }
    ]
  }
}

Salida de JSON:

{
  "item":{
    "value":"My name is Alicia Abernathy, and my email address is ."
  },
  "overview":{
    "transformedBytes":"22",
    "transformationSummaries":[
      {
        "infoType":{
          "name":"EMAIL_ADDRESS"
        },
        "transformation":{
          "redactConfig":{

          }
        },
        "results":[
          {
            "count":"1",
            "code":"SUCCESS"
          }
        ],
        "transformedBytes":"22"
      }
    ]
  }
}

Java

Si deseas obtener información para instalar y usar la biblioteca cliente de Cloud DLP, consulta las Bibliotecas cliente de Cloud DLP.

Valores originales	Valores transformados
`9/21/1976`	`1976`
`6/7/1945`	`1945`
`1/20/2009`	`2009`
`7/4/1776`	`1776`
`8/1/1984`	`1984`
`4/21/1982`	`1982`

Referencia de transformación

Tipos de técnicas de desidentificación

Métodos de transformación

Pies de página

Ocultamiento

Protocolo

Java

Python

Reemplazo

Reemplazo básico

Protocolo

Java

Node.js

Python

Reemplazo del Infotipo

Enmascaramiento

Protocolo

Java

Node.js

Python

Comienza a usarlo

PHP

C#

Transformaciones de asignación de tokens basada en criptografía

Hashing criptográfico

Encriptación de preservación de formato

Java

Python

PHP

C#

Java

Node.js

Python

Comienza a usarlo

PHP

C#

Encriptación determinista

Agrupamiento

Agrupamiento de tamaño fijo

Agrupamiento personalizable

Cambio de fechas

Java

Node.js

Python

Comienza a usarlo

PHP

C#

Extracción de tiempo