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 la maschera dei dati PII nei bundle proxy e nei flussi condivisi

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

Metodo di mascheramento

Il mascheramento dei dati PII viene applicato utilizzando espressioni XPath per scegliere come target elementi specifici all'interno delle configurazioni dei criteri nei bundle 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 hanno automaticamente come target i campi PII comuni. Queste maschere vengono applicate automaticamente durante la procedura di caricamento.

Elenco delle maschere predefinite:

Gestire maschere personalizzate

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

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

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

Tutte le richieste e le risposte riuscite per la creazione, la sostituzione, l'ottenimento, 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 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 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. Aggiungere XPaths all'elenco (POST append)

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

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. Eliminare 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 XPath personalizzato (DELETE)

Utilizza il metodo DELETE per rimuovere completamente l'elenco XPath personalizzato. In questo modo 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

Aggiornamento dei bundle mascherati

Quando modifichi la configurazione personalizzata di mascheramento dei dati PII, 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, invia una richiesta di assistenza per avviare la rielaborazione necessaria.