Gérer le masquage des informations permettant d'identifier personnellement les utilisateurs dans les bundles de flux partagés et de proxy

Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X.

Gérer le masquage des informations permettant d'identifier personnellement l'utilisateur dans les groupes de proxys et les bundles de flux partagés

Lors du processus de synchronisation, l'intégration du connecteur de hub d'API importe vos groupes de proxys d'API dans le hub d'API. Ces bundles peuvent contenir des données sensibles ou des informations permettant d'identifier personnellement l'utilisateur dans les configurations des règles. Cette fonctionnalité vous permet de masquer les champs d'informations permettant d'identifier personnellement l'utilisateur avant l'importation des bundles dans le hub d'API.

Approche de masquage

Le masquage des informations permettant d'identifier personnellement l'utilisateur est appliqué à l'aide d'expressions XPath pour cibler des éléments spécifiques dans les configurations de règles des bundles de flux partagés et de proxy au format XML, mais pas à d'autres éléments XML généraux du bundle. Cette fonctionnalité est divisée en deux parties :

Masques par défaut

Apigee Edge inclut une liste prédéfinie et intégrée d'expressions XPath qui ciblent automatiquement les champs d'informations permettant d'identifier personnellement l'utilisateur courants. Ces masques sont appliqués automatiquement lors du processus d'importation.

Liste des masques par défaut :

Gérer les masques personnalisés

Une API dédiée vous permet d'envoyer une liste personnalisée d'expressions XPath pour masquer les champs spécifiques que vous identifiez comme contenant des informations permettant d'identifier personnellement les utilisateurs. Vous êtes ainsi sûr de répondre à vos besoins uniques en matière de confidentialité des données.

Vous pouvez gérer les masques de données à caractère personnel personnalisés de votre organisation à l'aide du point de terminaison de l'API de gestion Edge /v1/organizations/<var>ORG_NAME/uapim/proxymasks. Vous devez disposer du rôle orgadmin pour effectuer ces opérations.

L'API fonctionne sur une seule liste d'expressions XPath nommée proxymasks pour une organisation donnée.

Toutes les requêtes et réponses réussies pour créer, remplacer, obtenir, ajouter ou supprimer des éléments de la liste XPath utilisent le schéma JSON suivant :

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

1. Créer ou remplacer la liste XPath personnalisée (PUT)

Utilisez la méthode PUT pour créer une liste personnalisée ou remplacer complètement le contenu d'une liste existante. Tous les XPath existants sont écrasés.

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

Une fois la mise à jour terminée, une réponse 201 Created ou 200K s'affiche avec le message suivant : Success response (201 Created or 200 OK)

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

2. Récupérer la liste XPath personnalisée (GET)

Utilisez la méthode GET pour récupérer la liste actuelle des expressions XPath personnalisées.

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

Une fois la récupération terminée, une réponse 200K s'affiche avec le message suivant : Success response (200 OK):

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

3. Ajouter des XPaths à la liste (ajout POST)

Utilisez la méthode POST pour ajouter une ou plusieurs expressions XPath à la liste existante sans écraser le contenu actuel.

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

Une fois l'ajout terminé, une réponse 200K s'affiche avec le message suivant : Success response (200 OK):

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

4. Supprimer des XPath spécifiques de la liste (POST deleteItems)

Utilisez la méthode POST pour supprimer des expressions XPath spécifiques de la liste existante. La demande doit contenir les chaînes XPath exactes à supprimer.

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

Une fois la suppression terminée, une réponse 200K s'affiche avec le message suivant : Success response (200 OK):

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

5. Supprimer l'intégralité de la liste XPath personnalisée (DELETE)

Utilisez la méthode DELETE pour supprimer complètement la liste XPath personnalisée. Seuls les masques personnalisés seront supprimés. Les masques par défaut seront toujours appliqués.

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

Une fois la suppression terminée, une réponse 204 "No Content" (Aucun contenu) s'affiche avec le message suivant : Success response (204 No Content):

HTTP/1.1 204 No Content

Mettre à jour les bundles masqués

Lorsque vous modifiez votre configuration de masquage des informations permettant d'identifier personnellement (IPI) personnalisée, les bundles de proxy d'API qui ont été importés précédemment avec une ancienne configuration de masquage doivent être retraités avec les masques les plus récents. Pour mettre à jour les bundles avec les derniers paramètres de masquage, veuillez envoyer une demande d'assistance afin de lancer le retraitement nécessaire.