Point d’entrée Produits

NOTE
Si un jeton utilisateur est transmis, l’utilisateur du jeton doit disposer d’un rôle "d’administrateur org" pour l’organisation demandée.

La variable /products Le point de terminaison de l’API de contrôle d’accès basé sur les attributs vous permet de gérer par programmation les produits, ainsi que les catégories d’autorisations et les jeux d’autorisations associés aux produits de votre entreprise.

Prise en main

Le point de terminaison API utilisé dans ce guide fait partie de l’API de contrôle d’accès basé sur les attributs. Avant de continuer, consultez le guide de prise en main pour obtenir des liens vers la documentation associée, un guide de lecture des exemples d’appels API dans ce document et des informations importantes sur les en-têtes requis pour réussir des appels vers n’importe quelle API d’Experience Platform.

Récupération d’une liste de produits autorisés list

Vous pouvez récupérer une liste des produits autorisés en adressant une demande de GET à la variable /products point de terminaison .

Format d’API

GET /products/

Requête

La requête suivante récupère une liste des produits autorisés appartenant à votre organisation.

curl -X GET \
  https://platform.adobe.io/data/foundation/access-control/administration/products \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

Réponse

Une réponse réussie renvoie une liste des produits autorisés appartenant à votre organisation.

{
  "products": [
    {
      "id": "{ID}",
      "name": "Adobe Experience Platform",
      "serviceCode": "{SERVICE_CODE}"
    }
  ]
}
Propriété
Description
id
Identifiant correspondant au produit interrogé.
name
Nom du produit interrogé.
serviceCode
Code de service correspondant au produit interrogé.

Rechercher des catégories d’autorisations par ID de produit

Vous pouvez rechercher des catégories d’autorisations pour un produit donné en adressant une requête de GET au /products/{PRODUCT_ID}/categories point de terminaison lors de la spécification de votre ID de produit.

Format d’API

GET /products/{PRODUCT_ID}/categories
Paramètre
Description
Identifiant du produit associé aux catégories d’autorisations que vous souhaitez rechercher.

Requête

La requête suivante récupère les catégories d’autorisations associées à {PRODUCT_ID}.

curl -X GET \
  https://platform.adobe.io/data/foundation/access-control/administration/products/{PRODUCT_ID}/categories \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

Réponse

Une réponse réussie renvoie les catégories d’autorisations associées à l’ID de produit que vous avez interrogé.

{
  "categories": [
    {
        "name": "Profile Management"
    },
    {
        "name": "Data Ingestion"
    },
    {
        "name": "Sandbox Administration"
    },
    {
        "name": "Query Service"
    },
    {
        "name": "Data Management"
    },
    {
        "name": "Identity Management"
    },
    {
        "name": "Data Modeling"
    },
    {
        "name": "Data Science Workspace"
    },
    {
        "name": "Dashboards"
    },
    {
        "name": "Alerts"
    },
    {
        "name": "Data Governance"
    }
  ]
}
Propriété
Description
category
Catégories d’autorisations disponibles dans l’ID de produit interrogé.
name
Nom de la catégorie d’autorisations.

Recherche de jeux d’autorisations par ID de produit

Vous pouvez rechercher des jeux d’autorisations pour un produit donné en adressant une demande de GET à la fonction /products/{PRODUCT_ID}/permission-sets point de terminaison lors de la spécification de votre ID de produit.

Format d’API

GET /products/{PRODUCT_ID}/permission-sets
Paramètre
Description
L’identifiant du produit associé aux jeux d’autorisations que vous souhaitez rechercher.

Requête

La requête suivante récupère les jeux d’autorisations associés à {PRODUCT_ID}.

curl -X GET \
  https://platform.adobe.io/data/foundation/access-control/administration/products/{PRODUCT_ID}/permission-sets \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

Réponse

Une réponse réussie renvoie les jeux d’autorisations associés à l’ID de produit que vous avez interrogé.

{
  "permission-sets": [
      {
          "id": "manage-schemas",
          "name": "Manage Schemas",
          "category": "Data Modeling",
          "permissions": [
              {
                  "resource": "schemas",
                  "actions": [
                      "read",
                      "write",
                      "delete"
                  ]
              },
              {
                  "resource": "schema-fields",
                  "actions": [
                      "read",
                      "write",
                      "delete"
                  ]
              },
              {
                  "resource": "sandboxes",
                  "actions": [
                      "view"
                  ]
              }
          ]
      },
      {
          "id": "view-schemas",
          "name": "View Schemas",
          "category": "Data Modeling",
          "permissions": [
              {
                  "resource": "schemas",
                  "actions": [
                      "read"
                  ]
              },
              {
                  "resource": "schema-fields",
                  "actions": [
                      "read"
                  ]
              },
              {
                  "resource": "sandboxes",
                  "actions": [
                      "view"
                  ]
              }
          ]
      },
  ]
}
Propriété
Description
permission-sets
Les jeux d’autorisations représentent un groupe d’autorisations qu’un administrateur peut appliquer à un rôle. Un administrateur peut attribuer des jeux d’autorisations à un rôle au lieu d’affecter des autorisations individuelles. Vous pouvez ainsi créer des rôles personnalisés à partir d’un rôle prédéfini contenant un groupe d’autorisations.
id
Identifiant correspondant au jeu d’autorisations interrogé.
name
Nom correspondant du jeu d’autorisations interrogé.
category
La catégorie d’autorisation disponible.
permissions
Les autorisations incluent la possibilité d’afficher ou d’utiliser les fonctionnalités Platform, telles que la création de sandbox, la définition de schémas et la gestion des jeux de données.
permissions.resource
Ressource ou objet auquel un sujet peut ou ne peut pas accéder. Les ressources peuvent être des fichiers, des applications, des serveurs ou même des API.
permissions.actions
Action autorisée d’un sujet par rapport à une ressource interrogée. Les valeurs possibles sont les suivantes : view, read, create, edit, et delete
recommendation-more-help
631fcab2-5cb1-46ef-ba66-fe098ac723e0