Endpoint prodotti

NOTE
Se viene passato un token utente, l’utente del token deve avere un ruolo "amministratore organizzazione" per l’organizzazione richiesta.

L'endpoint /products nell'API di controllo degli accessi basata su attributi consente di gestire in modo programmatico prodotti, categorie di autorizzazioni e set di autorizzazioni associati ai prodotti dell'organizzazione.

Introduzione

L’endpoint API utilizzato in questa guida fa parte dell’API di controllo degli accessi basata su attributi. Prima di continuare, consulta la guida introduttiva per i collegamenti alla documentazione correlata, una guida alla lettura delle chiamate API di esempio in questo documento e per le informazioni importanti sulle intestazioni necessarie per effettuare correttamente le chiamate a qualsiasi API di Experience Platform.

Recuperare un elenco di prodotti autorizzati list

È possibile recuperare un elenco di prodotti autorizzati effettuando una richiesta GET all'endpoint /products.

Formato API

GET /products/

Richiesta

La richiesta seguente recupera un elenco di prodotti autorizzati appartenenti alla tua organizzazione.

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}' \

Risposta

In caso di esito positivo, la risposta restituisce un elenco di prodotti autorizzati appartenenti alla tua organizzazione.

{
  "products": [
    {
      "id": "{ID}",
      "name": "Adobe Experience Platform",
      "serviceCode": "{SERVICE_CODE}"
    }
  ]
}
Proprietà
Descrizione
id
ID corrispondente del prodotto oggetto di query.
name
Nome del prodotto oggetto della query.
serviceCode
Il codice del servizio corrispondente del prodotto oggetto della query.

Cercare categorie di autorizzazioni per ID prodotto

Per cercare le categorie di autorizzazione per un determinato prodotto, è possibile effettuare una richiesta di GET all'endpoint /products/{PRODUCT_ID}/categories specificando l'ID prodotto.

Formato API

GET /products/{PRODUCT_ID}/categories
Parametro
Descrizione
ID del prodotto associato alle categorie di autorizzazioni che desideri cercare.

Richiesta

La richiesta seguente recupera le categorie di autorizzazione associate a {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}' \

Risposta

In caso di esito positivo, la risposta restituisce le categorie di autorizzazione associate all’ID prodotto oggetto della query.

{
  "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"
    }
  ]
}
Proprietà
Descrizione
category
Le categorie di autorizzazione disponibili all’interno dell’ID prodotto oggetto della query.
name
Nome della categoria di autorizzazioni.

Cercare i set di autorizzazioni per ID prodotto

Per cercare i set di autorizzazioni per un determinato prodotto, è possibile effettuare una richiesta di GET all'endpoint /products/{PRODUCT_ID}/permission-sets specificando l'ID prodotto.

Formato API

GET /products/{PRODUCT_ID}/permission-sets
Parametro
Descrizione
ID del prodotto associato ai set di autorizzazioni che desideri cercare.

Richiesta

La richiesta seguente recupera i set di autorizzazioni associati a {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}' \

Risposta

In caso di esito positivo, la risposta restituisce i set di autorizzazioni associati all’ID prodotto oggetto della query.

{
  "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"
                  ]
              }
          ]
      },
  ]
}
Proprietà
Descrizione
permission-sets
I set di autorizzazioni rappresentano un gruppo di autorizzazioni che un amministratore può applicare a un ruolo. Un amministratore può assegnare set di autorizzazioni a un ruolo, invece di assegnare singole autorizzazioni. In questo modo è possibile creare ruoli personalizzati da un ruolo predefinito contenente un gruppo di autorizzazioni.
id
ID corrispondente del set di autorizzazioni sottoposto a query.
name
Nome corrispondente del set di autorizzazioni sottoposto a query.
category
La categoria di autorizzazioni disponibile.
permissions
Le autorizzazioni includono la possibilità di visualizzare e/o utilizzare le funzioni di Platform, ad esempio la creazione di sandbox, la definizione di schemi e la gestione di set di dati.
permissions.resource
La risorsa o l'oggetto a cui un soggetto può o non può accedere. Le risorse possono essere file, applicazioni, server o anche API.
permissions.actions
Azione consentita a un oggetto per una risorsa su cui è stata eseguita una query. I valori possibili includono: view, read, create, edit e delete
recommendation-more-help
631fcab2-5cb1-46ef-ba66-fe098ac723e0