Slutpunkt för produkter

NOTE
Om en användartoken skickas måste användaren av token ha rollen"org admin" för den begärda organisationen.

Med slutpunkten /products i det attributbaserade API:t för åtkomstkontroll kan du programmässigt hantera produkter samt behörighetskategorier och behörighetsgrupper som är kopplade till produkter i organisationen.

Komma igång

API-slutpunkten som används i den här guiden är en del av det attributbaserade API:t för åtkomstkontroll. Innan du fortsätter bör du läsa kom igång-guiden för att få länkar till relaterad dokumentation, en guide till hur du läser exempelanropen för API i det här dokumentet och viktig information om vilka huvuden som krävs för att kunna anropa ett Experience Platform-API.

Hämta en lista över berättigade produkter list

Du kan hämta en lista över berättigade produkter genom att göra en GET-förfrågan till slutpunkten /products.

API-format

GET /products/

Begäran

Följande begäran hämtar en lista över berättigade produkter som tillhör din 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}' \

Svar

Ett godkänt svar returnerar en lista över berättigade produkter som tillhör din organisation.

{
  "products": [
    {
      "id": "{ID}",
      "name": "Adobe Experience Platform",
      "serviceCode": "{SERVICE_CODE}"
    }
  ]
}
Egenskap
Beskrivning
id
Motsvarande ID för den efterfrågade produkten.
name
Namnet på den efterfrågade produkten.
serviceCode
Motsvarande servicekod för den efterfrågade produkten.

Sök behörighetskategorier efter produkt-ID

Du kan slå upp behörighetskategorier för en viss produkt genom att göra en GET-förfrågan till /products/{PRODUCT_ID}/categories-slutpunkten samtidigt som du anger ditt produkt-ID.

API-format

GET /products/{PRODUCT_ID}/categories
Parameter
Beskrivning
ID:t för den produkt som är associerad med de behörighetskategorier som du vill söka efter.

Begäran

Följande begäran hämtar behörighetskategorier som är associerade med {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}' \

Svar

Ett godkänt svar returnerar de behörighetskategorier som är associerade med det produkt-ID du har frågat.

{
  "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"
    }
  ]
}
Egenskap
Beskrivning
category
Behörighetskategorierna som är tillgängliga inom det efterfrågade produkt-ID:t.
name
Namnet på behörighetsgruppen.

Söka efter behörighetsgrupper efter produkt-ID

Du kan söka efter behörighetsgrupper för en viss produkt genom att göra en GET-förfrågan till /products/{PRODUCT_ID}/permission-sets-slutpunkten samtidigt som du anger ditt produkt-ID.

API-format

GET /products/{PRODUCT_ID}/permission-sets
Parameter
Beskrivning
ID:t för den produkt som är associerad med de behörighetsgrupper som du vill söka efter.

Begäran

Följande begäran hämtar behörighetsgrupper som är associerade med {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}' \

Svar

Ett godkänt svar returnerar de behörighetsgrupper som är kopplade till det produkt-ID du frågade.

{
  "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"
                  ]
              }
          ]
      },
  ]
}
Egenskap
Beskrivning
permission-sets
Behörighetsuppsättningar representerar en grupp behörigheter som en administratör kan tillämpa på en roll. En administratör kan tilldela behörighetsgrupper till en roll i stället för att tilldela enskilda behörigheter. Detta gör att du kan skapa anpassade roller från en fördefinierad roll som innehåller en grupp behörigheter.
id
Motsvarande ID för den efterfrågade behörighetsgruppen.
name
Motsvarande namn för den efterfrågade behörighetsgruppen.
category
Den tillgängliga behörighetskategorin.
permissions
Behörigheter omfattar möjligheten att visa och/eller använda plattformsfunktioner, som att skapa sandlådor, definiera scheman och hantera datauppsättningar.
permissions.resource
Den tillgång eller det objekt som ett ämne kan eller inte kan komma åt. Resurser kan vara filer, program, servrar eller till och med API:er.
permissions.actions
Den åtgärd som ett ämne tillåts att göra mot en frågad resurs. Möjliga värden är: view, read, create, edit och delete
recommendation-more-help
631fcab2-5cb1-46ef-ba66-fe098ac723e0