प्रॉक्सी और शेयर किए गए फ़्लो के बंडल में, व्यक्तिगत पहचान से जुड़ी जानकारी (पीआईआई) को मास्क करने की सुविधा मैनेज करना

आपको Apigee Edge का दस्तावेज़ दिख रहा है.
Apigee X के दस्तावेज़ पर जाएं. जानकारी

प्रॉक्सी और शेयर किए गए फ़्लो बंडल में, पीआईआई को मास्क करने की सुविधा मैनेज करना

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

मास्क करने का तरीका

पीआईआई मास्किंग को XPath एक्सप्रेशन का इस्तेमाल करके लागू किया जाता है. इससे, एक्सएमएल फ़ॉर्मैट वाले प्रॉक्सी और शेयरफ़्लो बंडलों में नीति कॉन्फ़िगरेशन के अंदर मौजूद खास एलिमेंट को टारगेट किया जाता है. हालांकि, बंडल में मौजूद अन्य सामान्य एक्सएमएल एलिमेंट को टारगेट नहीं किया जाता. इस सुविधा को दो हिस्सों में बांटा गया है:

डिफ़ॉल्ट मास्क

Apigee Edge में, XPath एक्सप्रेशन की पहले से तय की गई, इन-बिल्ट सूची शामिल होती है. यह सूची, सामान्य PII फ़ील्ड को अपने-आप टारगेट करती है. अपलोड करने की प्रोसेस के दौरान, ये मास्क अपने-आप लागू हो जाते हैं.

डिफ़ॉल्ट मास्क की सूची:

कस्टम मास्क मैनेज करना

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

/v1/organizations/<var>ORG_NAME/uapim/proxymasks Edge management API एंडपॉइंट का इस्तेमाल करके, अपने संगठन के कस्टम पीआईआई मास्क मैनेज किए जा सकते हैं. ये कार्रवाइयां करने के लिए, आपके पास orgadmin की भूमिका होनी चाहिए.

एपीआई, किसी संगठन के लिए proxymasks नाम वाले XPaths की एक सूची पर काम करता है.

XPath सूची में आइटम बनाने, बदलने, पाने, जोड़ने या मिटाने के लिए किए गए सभी अनुरोध और उनके जवाब, इस JSON स्कीमा का इस्तेमाल करते हैं:

{
  "xpaths": [
    "//Path/To/Element"
  ]
}

1. कस्टम XPath सूची बनाना या उसे बदलना (PUT)

नई कस्टम सूची बनाने या किसी मौजूदा सूची के कॉन्टेंट को पूरी तरह से बदलने के लिए, PUT तरीके का इस्तेमाल करें. मौजूदा XPath ओवरराइट हो जाते हैं.

curl -X PUT https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "xpaths": [
      "//StatisticsCollector/Statistics/Statistic[@name='caller']",
      "//AssignMessage/AssignVariable[Name='password']/Value"
    ]
  }'

अपडेट पूरा होने पर, 201 Created या 200K रिस्पॉन्स दिखता है. साथ ही, यह मैसेज दिखता है: Success response (201 Created or 200 OK)

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value"
  ]
}

2. कस्टम XPath सूची वापस पाना (GET)

कस्टम XPath एक्सप्रेशन की मौजूदा सूची को वापस पाने के लिए, GET तरीके का इस्तेमाल करें.

curl -X GET https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks \
  -H "Authorization: Bearer OAUTH_TOKEN"

डेटा वापस पाने की प्रोसेस पूरी होने पर, 200K रिस्पॉन्स दिखता है. इसमें यह मैसेज होता है:Success response (200 OK):

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value"
  ]
}

3. सूची में XPath जोड़ना (POST append)

POST तरीके का इस्तेमाल करके, मौजूदा कॉन्टेंट को बदले बिना, मौजूदा सूची में एक या उससे ज़्यादा XPath एक्सप्रेशन जोड़ें.

curl -X POST https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks/append \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "xpaths": [
      "//New/Appended/XPath"
    ]
  }'

डेटा जोड़ने की प्रोसेस पूरी होने पर, 200K रिस्पॉन्स दिखता है. इसमें यह मैसेज होता है: Success response (200 OK):

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value",
    "//New/Appended/XPath"
  ]
}

4. सूची से कुछ खास XPath मिटाना (POST deleteItems)

मौजूदा सूची से कुछ XPath एक्सप्रेशन हटाने के लिए, POST तरीके का इस्तेमाल करें. अनुरोध में, हटाए जाने वाले एक्सपाथ स्ट्रिंग शामिल होने चाहिए.

curl -X POST https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks/deleteItems \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "xpaths": [
      "//New/Appended/XPath"
    ]
  }'

मिटाने की प्रोसेस पूरी होने के बाद, 200K रिस्पॉन्स दिखता है. इसमें यह मैसेज होता है: Success response (200 OK):

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value"
  ]
}

5. पूरी कस्टम XPath सूची मिटाएं (DELETE)

कस्टम XPath सूची को हमेशा के लिए हटाने के लिए, DELETE तरीके का इस्तेमाल करें. इससे सिर्फ़ कस्टम मास्क हटेंगे. डिफ़ॉल्ट मास्क अब भी लागू रहेंगे.

curl -X DELETE https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks \
  -H "Authorization: Bearer OAUTH_TOKEN"

मिटाने की प्रोसेस पूरी होने के बाद, 204 No Content जवाब दिखता है. इसमें यह मैसेज होता है: Success response (204 No Content):

HTTP/1.1 204 No Content

मास्क किए गए बंडल अपडेट किए जा रहे हैं

कस्टम पीआईआई मास्किंग कॉन्फ़िगरेशन में बदलाव करने पर, एपीआई प्रॉक्सी बंडलों को फिर से प्रोसेस करना होगा. इन बंडलों को पहले, मास्किंग के पुराने कॉन्फ़िगरेशन के साथ अपलोड किया गया था. अब इन्हें मास्किंग के नए कॉन्फ़िगरेशन के साथ प्रोसेस करना होगा. मास्किंग की नई सेटिंग के साथ बंडल अपडेट करने के लिए, कृपया सहायता टिकट सबमिट करें, ताकि ज़रूरी रीप्रोसेसिंग शुरू की जा सके.