Zarządzanie maskowaniem informacji umożliwiających identyfikację w pakietach proxy i wspólnych przepływów

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X. info

Zarządzanie maskowaniem informacji umożliwiających identyfikację osób w pakietach proxy i współdzielonych przepływów

W ramach procesu synchronizacji integracja łącznika centrum interfejsów API przesyła pakiety proxy interfejsu API do centrum interfejsów API. Te pakiety mogą zawierać dane wrażliwe lub informacje umożliwiające identyfikację osób w konfiguracjach zasad. Ta funkcja umożliwia maskowanie zidentyfikowanych pól zawierających informacje umożliwiające identyfikację osób, zanim pakiety zostaną przesłane do centrum interfejsów API.

Metoda maskowania

Maskowanie informacji umożliwiających identyfikację osób jest stosowane za pomocą wyrażeń XPath, które kierują na określone elementy w konfiguracjach zasad w pakietach proxy i współdzielonych przepływów w formacie XML, ale nie na inne ogólne elementy XML w pakiecie. Ta funkcja jest podzielona na 2 części:

Maski domyślne

Apigee Edge zawiera predefiniowaną, wbudowaną listę wyrażeń XPath, które automatycznie kierują na typowe pola zawierające informacje umożliwiające identyfikację osób. Maski te są stosowane automatycznie podczas przesyłania.

Lista masek domyślnych:

Zarządzanie maskami niestandardowymi

Specjalny interfejs API umożliwia przesyłanie dostosowanej listy wyrażeń XPath w celu maskowania określonych pól, które uznasz za zawierające informacje umożliwiające identyfikację osób, co zapewni spełnienie Twoich unikalnych potrzeb w zakresie ochrony prywatności danych.

Maskami niestandardowymi informacji umożliwiających identyfikację osób w organizacji możesz zarządzać za pomocą punktu końcowego interfejsu Edge Management API /v1/organizations/<var>ORG_NAME/uapim/proxymasks. Aby wykonywać te operacje, musisz mieć rolę orgadmin.

Interfejs API działa na pojedynczej liście XPath o nazwie proxymasks dla danej organizacji.

Wszystkie żądania i odpowiedzi o powodzeniu dotyczące tworzenia, zastępowania, pobierania, dołączania lub usuwania elementów z listy XPath używają tego schematu JSON:

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

1. Tworzenie lub zastępowanie niestandardowej listy XPath (PUT)

Użyj metody PUT, aby utworzyć nową listę niestandardową lub całkowicie zastąpić zawartość istniejącej listy. Wszystkie dotychczasowe wyrażenia XPath zostaną zastąpione.

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

Po zakończeniu aktualizacji wyświetli się odpowiedź 201 Created lub 200K z tym komunikatem: Success response (201 Created or 200 OK)

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

2. Pobieranie niestandardowej listy XPath (GET)

Użyj metody GET, aby pobrać bieżącą listę niestandardowych wyrażeń XPath.

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

Po zakończeniu pobierania wyświetli się odpowiedź 200K z tym komunikatem:Success response (200 OK):

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

3. Dołączanie wyrażeń XPath do listy (POST append)

Użyj metody POST, aby dołączyć co najmniej 1 wyrażenie XPath do istniejącej listy bez zastępowania bieżącej zawartości.

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

Po zakończeniu dołączania wyświetli się odpowiedź 200K z tym komunikatem: Success response (200 OK):

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

4. Usuwanie określonych wyrażeń XPath z listy (POST deleteItems)

Użyj metody POST, aby usunąć określone wyrażenia XPath z istniejącej listy. Żądanie musi zawierać dokładne ciągi znaków XPath do usunięcia.

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

Po zakończeniu usuwania wyświetli się odpowiedź 200K z tym komunikatem: Success response (200 OK):

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

5. Usuwanie całej niestandardowej listy XPath (DELETE)

Użyj metody DELETE, aby całkowicie usunąć niestandardową listę XPath. Spowoduje to usunięcie tylko masek niestandardowych ; maski domyślne będą nadal stosowane.

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

Po zakończeniu usuwania wyświetli się odpowiedź 204 No Content z tym komunikatem: Success response (204 No Content):

HTTP/1.1 204 No Content

Aktualizowanie zamaskowanych pakietów

Gdy zmodyfikujesz konfigurację maskowania niestandardowego informacji umożliwiających identyfikację osób, pakiety proxy interfejsu API, które zostały wcześniej przesłane ze starszą konfiguracją maski, muszą zostać ponownie przetworzone z użyciem najnowszych masek. Aby zaktualizować pakiety za pomocą najnowszych ustawień maskowania, otwórz zgłoszenie do zespołu pomocy, aby rozpocząć niezbędne ponowne przetwarzanie.