Gestire il mascheramento delle informazioni che consentono l'identificazione personale (PII) nei bundle proxy e sharedflow

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Gestire il mascheramento delle PII nei bundle di proxy e sharedflow

Nell'ambito della procedura di sincronizzazione, l'integrazione del connettore dell'hub API carica i bundle di proxy API nell'hub API. Questi bundle possono contenere dati sensibili o informazioni che consentono l'identificazione personale (PII) all'interno delle configurazioni delle policy. Questa funzionalità consente di mascherare i campi PII identificati prima che i bundle vengano caricati nell'hub API.

Approccio di mascheramento

Il mascheramento delle PII viene applicato utilizzando le espressioni XPath per indirizzare elementi specifici all'interno delle configurazioni delle policy nei bundle di proxy e sharedflow in formato XML, ma non ad altri elementi XML generali all'interno del bundle. Questa funzionalità è suddivisa in due parti:

Maschere predefinite

Apigee Edge include un elenco predefinito e integrato di espressioni XPath che indirizzano automaticamente i campi PII comuni. Queste maschere vengono applicate automaticamente durante la procedura di caricamento.

Elenco delle maschere predefinite:

Gestire le maschere personalizzate

Un'API dedicata consente di inviare un elenco personalizzato di espressioni XPath per mascherare campi specifici identificati come PII, garantendo che le tue esigenze di privacy dei dati uniche siano soddisfatte.

Puoi gestire le maschere PII personalizzate della tua organizzazione utilizzando l'endpoint dell'API di gestione Edge /v1/organizations/<var>ORG_NAME/uapim/proxymasks. Per eseguire queste operazioni, devi disporre del ruolo orgadmin.

L'API opera su un singolo elenco di XPath denominato proxymasks per una determinata organizzazione.

Tutte le richieste e le risposte riuscite per la creazione, la sostituzione, il recupero, l'aggiunta o l'eliminazione di elementi dall'elenco XPath utilizzano il seguente schema JSON:

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

1. Crea o sostituisci l'elenco di XPath personalizzato (PUT)

Utilizza il metodo PUT per creare un nuovo elenco personalizzato o sostituire completamente i contenuti di un elenco esistente. Gli XPath esistenti vengono sovrascritti.

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

Al termine dell'aggiornamento, viene visualizzata una risposta 201 Created o 200K con il seguente messaggio: Success response (201 Created or 200 OK)

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

2. Recupera l'elenco di XPath personalizzato (GET)

Utilizza il metodo GET per recuperare l'elenco corrente delle espressioni XPath personalizzate.

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

Al termine del recupero, viene visualizzata una risposta 200K con il seguente messaggio:Success response (200 OK):

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

3. Aggiungi XPath all'elenco (POST append)

Utilizza il metodo POST per aggiungere una o più espressioni XPath all'elenco esistente senza sovrascrivere i contenuti correnti.

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

Al termine dell'aggiunta, viene visualizzata una risposta 200K con il seguente messaggio: Success response (200 OK):

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

4. Elimina XPath specifici dall'elenco (POST deleteItems)

Utilizza il metodo POST per rimuovere espressioni XPath specifiche dall'elenco esistente. La richiesta deve contenere le stringhe XPath esatte da rimuovere.

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

Al termine dell'eliminazione, viene visualizzata una risposta 200K con il seguente messaggio: Success response (200 OK):

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

5. Elimina l'intero elenco di XPath personalizzato (DELETE)

Utilizza il metodo DELETE per rimuovere completamente l'elenco di XPath personalizzato. Verranno rimosse solo le maschere personalizzate ; le maschere predefinite verranno comunque applicate.

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

Al termine dell'eliminazione, viene visualizzata una risposta 204 No Content con il seguente messaggio: Success response (204 No Content):

HTTP/1.1 204 No Content

Aggiornare i bundle mascherati

Quando modifichi la configurazione di mascheramento delle PII personalizzata, i bundle di proxy API caricati in precedenza con una configurazione di maschera precedente devono essere rielaborati con le maschere più recenti. Per aggiornare i bundle con le impostazioni di mascheramento più recenti, presenta una richiesta di assistenza per avviare la rielaborazione necessaria.