Estensione Prevenzione della perdita di dati Google Cloud

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info

Versione: 2.0.0

Utilizza questa estensione per oscurare i dati sensibili in contenuti e immagini. Ad esempio, potresti oscurare numeri di carte di credito, nomi e codici fiscali.

Prerequisiti

Questi contenuti forniscono un riferimento per la configurazione e l'utilizzo di questa estensione. Prima di utilizzare l'estensione da un proxy API utilizzando il criterio ExtensionCallout, devi:

1. Abilita l'API Google Cloud DLP per il tuo progetto.

2. Concedi l'autorizzazione per il livello di accesso che vuoi concedere all'estensione.

3. Utilizza la console Google Cloud per generare una chiave per l'account di servizio.

4. Utilizza i contenuti del file JSON della chiave risultante quando aggiungi e configuri l'estensione utilizzando il riferimento alla configurazione.

Informazioni su Cloud Data Loss Prevention (DLP)

Cloud Data Loss Prevention (DLP) è un'API per ispezionare testo, immagini e altri dati al fine di identificare e gestire i dati sensibili.

Per saperne di più, consulta la panoramica del DLP. Per informazioni sull'API esposta da questa estensione, consulta l'API Cloud Data Loss Prevention (DLP).

Esempi

Gli esempi riportati di seguito mostrano come configurare il supporto per le azioni di estensione di Cloud DLP utilizzando il criterio ExtensionCallout.

Per semplificare la prova di questo codice di esempio, questi esempi utilizzano un criterio AssignMessage per impostare i valori delle variabili di flusso e per recuperare i valori di risposta dell'estensione da visualizzare nello strumento di traccia.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Set-Variable">
    <DisplayName>Set Variable</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <AssignVariable>
        <Name>request.content</Name>
        <Value>Visit my site at https://example.com. Or contact me at gladys@example.com.</Value>
    </AssignVariable>
</AssignMessage>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Data-Loss-Extension-Callout">
    <DisplayName>Data Loss Prevention Extension Callout</DisplayName>
    <Connector>example-dlp</Connector>
    <Action>deidentifyWithMask</Action>
    <Input><![CDATA[{
        "text" : "{request.content}",
        "mask" : "*"
    }]]></Input>
    <Output>masked.output</Output>
</ConnectorCallout>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-DLP-Output">
    <DisplayName>Get DLP Output</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{masked.output}</Payload>
    </Set>
</AssignMessage>

{"text":"Visit my site at ******************* Or contact me at *****************."}

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Set-Variable">
    <DisplayName>Set Variable</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <AssignVariable>
        <Name>request.content</Name>
        <Value>Visit my site at https://example.com. Or contact me at gladys@example.com.</Value>
    </AssignVariable>
</AssignMessage>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Data-Loss-Extension-Callout">
    <DisplayName>Data Loss Prevention Extension Callout</DisplayName>
    <Connector>example-dlp</Connector>
    <Action>deidentifyWithType</Action>
    <Input><![CDATA[{
        "text" : "{request.content}"
    }]]></Input>
    <Output>masked.output</Output>
</ConnectorCallout>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-DLP-Output">
    <DisplayName>Get DLP Output</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{masked.output}</Payload>
    </Set>
</AssignMessage>

{"text":"Visit my site at [URL] Or contact me at [EMAIL_ADDRESS]."}

Azioni

deidentifyWithMask

Anonimizza i dati sensibili di text e mascherali con il carattere mask. Questa azione maschera le parti di text specificate dalla proprietà infoTypes nella configurazione dell'estensione.

Il mascheramento dei dati sensibili sostituisce i caratteri con un simbolo, ad esempio un asterisco (*) o un hash (#). I tipi di dati sensibili possono essere configurati nella configurazione dell'estensione.

<Action>deidentifyWithMask</Action>
<Input><![CDATA[{
  "text" : "text-to-deidentify",
  "mask" : "masking-character"
}]]></Input>

<Action>deidentifyWithMask</Action>
<Input><![CDATA[{
    "text" : "{input.email.address}",
    "mask" : "*"
}]]></Input>
<Output>masked.output</Output>

{"text":"*****************"}

Parametri di richiesta

Risposta

Il testo di input con i valori degli infoType specificati sostituiti con il carattere specificato. Ad esempio,

{"text":"*********"}

deidentifyWithTemplate

Anonimizza i dati sensibili nei contenuti di testo utilizzando un modello che configura il testo da anonimizzare e come gestirlo.

I modelli sono utili per disaccoppiare la configurazione, ad esempio gli elementi da ispezionare e come deidentificarli, dall'implementazione delle chiamate API. I modelli consentono di riutilizzare la configurazione e di garantire la coerenza tra utenti e set di dati.

Nel modello, dovrai specificare gli infoTypes che rappresentano i contenuti da anonimizzare. Per un elenco di infoType, consulta la Guida di riferimento per i rilevatori di infoType. L'anonimizzazione maschera le parti di testo specificate dalla proprietà infoTypes nel modello.

<Action>deidentifyWithTemplate</Action>
<Input><![CDATA[{
  "text" : "text-to-deidentify"
  "templateName" : "path-to-template"
}]]></Input>

<Action>deidentifyWithTemplate</Action>
<Input><![CDATA[{
    "text" : "{request.content}"
    "templateName" : "projects/[PROJECT_ID]/deidentifyTemplates/1231258663242"
}]]></Input>

Parametri di richiesta

Risposta

Il testo inserito con i valori degli infoType specificati sostituiti con i nomi degli infoType.

deidentifyWithType

Anonimizza i dati sensibili nei contenuti di testo, sostituendo ogni valore corrispondente con il nome dell'infoType. Per un elenco di infoType, consulta la Guida di riferimento per i rilevatori di infoType. Questa azione maschera le parti di text specificate dalla proprietà infoTypes nella configurazione dell'estensione.

Nell'esempio seguente, il numero di telefono viene riconosciuto dal servizio e poi sostituito con il nome dell'infoType stesso.

• Testo inserito:

  John Smith, 123 Main St, Seattle, WA 98122, 206-555-0123.

• Testo del risultato:

  John Smith, 123 Main St, Seattle, WA 98122, PHONE_NUMBER.

<Action>deidentifyWithType</Action>
<Input><![CDATA[{
  "text" : "text-to-deidentify"
}]]></Input>

<Action>deidentifyWithType</Action>
<Input><![CDATA[{
    "text" : "{input.email.address}"
}]]></Input>

{"text":"EMAIL_ADDRESS"}

Parametri di richiesta

Risposta

Il testo inserito con i valori degli infoType specificati sostituiti con i nomi degli infoType. Ad esempio,

{"text":"EMAIL_ADDRESS"}

redactImage

Oscura il testo che rientra in una delle categorie infoType. I contenuti oscurati vengono rilevati e coperti da un rettangolo opaco. Questa azione maschera le parti di image_data specificate dalla proprietà infoTypes nella configurazione dell'estensione.

Per un elenco di infoType, consulta la Guida di riferimento per i rilevatori di infoType.

Parametri di richiesta

<Action>redactImage</Action>
<Input><![CDATA[{
  "image_data" : "base64-encoded-image-to-analyze",
  "image_type" : "type-of-image"
}]]></Input>

Risposta

L'immagine con il testo oscurato.

Riferimento alla configurazione

Utilizza quanto segue quando configuri ed esegui il deployment di questa estensione per utilizzarla nei proxy API. Per la procedura di configurazione di un'estensione utilizzando la console Apigee, vedi Aggiunta e configurazione di un'estensione.

Proprietà comuni delle estensioni

Per ogni estensione sono presenti le seguenti proprietà.

Proprietà per questo pacchetto di estensioni

Specifica i valori per le seguenti proprietà di configurazione specifiche di questa estensione.