Google Cloud डेटा लीक होने की रोकथाम का एक्सटेंशन

यहां Apigee Edge के दस्तावेज़ देखे जा रहे हैं.
पर जाएं Apigee X दस्तावेज़. info

वर्शन: 1.5.3

इस एक्सटेंशन का इस्तेमाल करके, कॉन्टेंट और इमेज में मौजूद संवेदनशील डेटा को छिपाया जा सकता है. उदाहरण के लिए, क्रेडिट कार्ड नंबर, नाम, और सोशल सिक्योरिटी नंबर को छिपाया जा सकता है.

ज़रूरी शर्तें

इस कॉन्टेंट में, इस एक्सटेंशन को कॉन्फ़िगर करने और इस्तेमाल करने के बारे में जानकारी दी गई है. ExtensionCallout नीति का इस्तेमाल करके, एपीआई प्रॉक्सी से एक्सटेंशन का इस्तेमाल करने से पहले, आपको ये काम करने होंगे:

1. अपने प्रोजेक्ट के लिए, Google Cloud DLP API चालू करें.

2. अनुमति दें कि एक्सटेंशन के लिए, ऐक्सेस का वह लेवल तय करें जो आपको चाहिए.

3. सेवा खाते के लिए कुंजी जनरेट करने के लिए, GCP कंसोल का इस्तेमाल करें.

4. कॉन्फ़िगरेशन रेफ़रंस का इस्तेमाल करके, एक्सटेंशन को जोड़ने और कॉन्फ़िगर करने के दौरान, जनरेट हुई कुंजी की JSON फ़ाइल के कॉन्टेंट का इस्तेमाल करें.

Cloud Data Loss Prevention (DLP) के बारे में जानकारी

Cloud Data Loss Prevention (DLP) एक एपीआई है. इसका इस्तेमाल, टेक्स्ट, इमेज, और अन्य डेटा की जांच करके, संवेदनशील डेटा की पहचान करने और उसे मैनेज करने के लिए किया जाता है.

ज़्यादा जानकारी के लिए, डीएलपी की खास जानकारी देखें. इस एक्सटेंशन से जुड़े एपीआई के बारे में जानने के लिए, Cloud Data Loss Prevention (DLP) API देखें.

सैंपल

यहां दिए गए उदाहरणों से पता चलता है कि ExtensionCallout नीति का इस्तेमाल करके, Cloud DLP एक्सटेंशन की कार्रवाइयों के लिए सहायता कैसे कॉन्फ़िगर की जाती है.

इस सैंपल कोड को आज़माना आसान बनाने के लिए, इन उदाहरणों में AssignMessage नीति का इस्तेमाल किया गया है. इससे फ़्लो वैरिएबल की वैल्यू सेट की जाती हैं. साथ ही, Trace टूल में दिखाने के लिए, एक्सटेंशन के जवाब की वैल्यू भी वापस पाई जाती हैं.

<?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]."}

कार्रवाइयां

deidentifyWithMask

text में मौजूद संवेदनशील डेटा की पहचान हटाएं और डेटा को mask वर्ण से मास्क करें. यह कार्रवाई, एक्सटेंशन के कॉन्फ़िगरेशन में मौजूद infoTypes प्रॉपर्टी में तय किए गए text के उन हिस्सों को मास्क करती है.

संवेदनशील डेटा को मास्क करने से, वर्णों की जगह कोई सिंबल आ जाता है. जैसे, तारा (*) या हैश (#). एक्सटेंशन के कॉन्फ़िगरेशन में, संवेदनशील डेटा के टाइप कॉन्फ़िगर किए जा सकते हैं.

<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":"*****************"}

अनुरोध के पैरामीटर

जवाब

इनपुट टेक्स्ट में, तय किए गए infoTypes की वैल्यू को तय किए गए वर्ण से बदल दिया जाता है. उदाहरण के लिए,

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

deidentifyWithTemplate

टेक्स्ट कॉन्टेंट में मौजूद संवेदनशील डेटा की पहचान हटाने के लिए, किसी टेंप्लेट का इस्तेमाल करें. इस टेंप्लेट में यह कॉन्फ़िगर किया जाता है कि किस टेक्स्ट की पहचान हटानी है और उसे कैसे मैनेज करना है.

टेंप्लेट, कॉन्फ़िगरेशन को अलग करने के लिए काम के होते हैं. जैसे, आप किस चीज़ की जांच करते हैं और उसकी पहचान कैसे हटाते हैं. साथ ही, ये टेंप्लेट, एपीआई कॉल को लागू करने के लिए भी काम के होते हैं. टेंप्लेट, कॉन्फ़िगरेशन को फिर से इस्तेमाल करने और उपयोगकर्ताओं और डेटा सेट के बीच एक जैसा कॉन्फ़िगरेशन बनाए रखने का तरीका देते हैं.

अपने टेंप्लेट में, उन infoTypes के बारे में बताएं जो पहचान हटाने के लिए कॉन्टेंट के बारे में बताते हैं. infoTypes की सूची देखने के लिए, InfoType detector reference देखें. पहचान हटाने की प्रोसेस में, टेंप्लेट में मौजूद infoTypes प्रॉपर्टी में तय किए गए टेक्स्ट के उन हिस्सों को मास्क किया जाता है.

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

अनुरोध के पैरामीटर

जवाब

इनपुट टेक्स्ट में, तय किए गए infoTypes की वैल्यू को infoType के नामों से बदल दिया जाता है.

deidentifyWithType

टेक्स्ट कॉन्टेंट में मौजूद संवेदनशील डेटा की पहचान हटाएं. साथ ही, मेल खाने वाली हर वैल्यू को infoType के नाम से बदलें. infoTypes की सूची देखने के लिए, InfoType detector reference देखें. यह कार्रवाई, एक्सटेंशन के कॉन्फ़िगरेशन में मौजूद infoTypes प्रॉपर्टी में तय किए गए text के उन हिस्सों को मास्क करती है.

यहां दिए गए उदाहरण में, सेवा से फ़ोन नंबर की पहचान की जाती है. इसके बाद, इसे infoType के नाम से बदल दिया जाता है.

• इनपुट टेक्स्ट:

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

• नतीजे का टेक्स्ट:

  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"}

अनुरोध के पैरामीटर

जवाब

इनपुट टेक्स्ट में, तय किए गए infoTypes की वैल्यू को infoType के नामों से बदल दिया जाता है. उदाहरण के लिए,

{"text":"EMAIL_ADDRESS"}

redactImage

उस टेक्स्ट को छिपाएं जो infoType की किसी कैटगरी में आता है. छिपाए गए कॉन्टेंट की पहचान की जाती है और उसे अपारदर्शी आयत से छिपा दिया जाता है. यह कार्रवाई, एक्सटेंशन के कॉन्फ़िगरेशन में मौजूद infoTypes प्रॉपर्टी में तय किए गए image_data के उन हिस्सों को मास्क करती है.

infoTypes की सूची देखने के लिए, InfoType detector reference देखें.

अनुरोध के पैरामीटर

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

जवाब

वह इमेज जिसमें टेक्स्ट को छिपाया गया है.

कॉन्फ़िगरेशन रेफ़रंस

एपीआई प्रॉक्सी में इस्तेमाल करने के लिए, इस एक्सटेंशन को कॉन्फ़िगर और डिप्लॉय करते समय, यहां दी गई जानकारी का इस्तेमाल करें. Apigee कंसोल का इस्तेमाल करके, एक्सटेंशन को कॉन्फ़िगर करने के लिए, एक्सटेंशन जोड़ना और कॉन्फ़िगर करना देखें.

एक्सटेंशन की सामान्य प्रॉपर्टी

हर प्रॉपर्टी के लिए नीचे दी गई प्रॉपर्टी मौजूद हैं.

इस एक्सटेंशन पैकेज की प्रॉपर्टी

इस एक्सटेंशन के लिए खास तौर पर तय की गई, यहां दी गई कॉन्फ़िगरेशन प्रॉपर्टी के लिए वैल्यू तय करें.