Estensione Prevenzione della perdita di dati Google Cloud

Maschera con stelle

In questo esempio viene utilizzata l'azione deidentifyWithMask per mascherare i tipi di testo specificati con un carattere specificato nel criterio, in questo caso il carattere *.

Il seguente criterio di AssegnaMessage imposta la variabile request.content a scopo illustrativo. In genere, recupera i contenuti della richiesta dalla richiesta del client.

<?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>

Il seguente criterio ExtensionsCallout recupera il valore della variabile request.content e lo passa a un'estensione Cloud DLP (qui, chiamata example-dlp). Questa estensione è stata configurata per mascherare i valori in base ai infoTypes URL e EMAIL_ADDRESS.

<?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>

Il seguente criterio AttributionMessage consente di recuperare l'output dell'estensione da visualizzare nello strumento Trace.

<?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>

Di seguito è riportato un esempio di output da questo codice.

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

Maschera con nome

In questo esempio viene utilizzata l'azione deidentifyWithType per mascherare i tipi di testo specificati con il nome infoType stesso. Ad esempio, l'indirizzo email gladys@example.com verrà sostituito con EMAIL_ADDRESS.

Il seguente criterio di AssegnaMessage imposta la variabile request.content a scopo illustrativo. In genere, recupera i contenuti della richiesta dalla richiesta del client.

<?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>

Il seguente criterio ExtensionsCallout recupera il valore della variabile request.content e lo passa a un'estensione Cloud DLP (qui, chiamata example-dlp). Questa estensione è stata configurata per mascherare i valori in base ai infoTypes URL e EMAIL_ADDRESS.

<?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>

Il seguente criterio AttributionMessage consente di recuperare l'output dell'estensione da visualizzare nello strumento Trace.

<?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>

Di seguito è riportato un esempio di output da questo codice.

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

Sintassi

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

Esempio

Nell'esempio seguente, l'input da mascherare è un indirizzo email archiviato in una variabile di flusso input.email.address. Per supportare questo esempio specifico, l'estensione deve essere stata configurata in modo da supportare l'infoType EMAIL_ADDRESS. Per un elenco di infoType, consulta la sezione Riferimento per i rilevatori di InfoType.

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

L'output per questo esempio sarebbe il seguente:

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

Sintassi

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

Esempio

Nell'esempio seguente, l'input da anonimizzare è il corpo della richiesta riportato dalla variabile di flusso request.content.

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

L'output di questo esempio sarebbe il contenuto della richiesta anonimizzato.

Sintassi

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

Esempio

Nell'esempio seguente, l'input da mascherare è un indirizzo email archiviato in una variabile di flusso input.email.address. Per supportare questo esempio specifico, l'estensione deve essere stata configurata in modo da supportare l'infoType EMAIL_ADDRESS. Per un elenco di infoType, consulta la sezione Riferimento per i rilevatori di InfoType.

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

L'output per questo esempio sarebbe il seguente:

{"text":"EMAIL_ADDRESS"}