DocumentatieExperience PlatformHandleiding voor toegangsbeheer

Het eindpunt van producten

Last update: Wed Feb 28 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ontwikkelaar
NOTE
Als een gebruikerstoken wordt overgegaan, dan moet de gebruiker van het teken een "org admin"rol voor gevraagde org hebben.

De /products eindpunt in op attribuut-gebaseerde toegangsbeheer API staat u toe om producten evenals toestemmingscategorieën en toestemmingsreeksen programmatically te beheren verbonden aan producten in uw organisatie.

Aan de slag

Het API eindpunt dat in deze gids wordt gebruikt maakt deel uit van op attribuut-gebaseerde toegangsbeheer API. Controleer voordat je doorgaat de gids Aan de slag voor verbindingen aan verwante documentatie, een gids aan lezing de steekproefAPI vraag in dit document, en belangrijke informatie betreffende vereiste kopballen die nodig zijn om met succes vraag aan om het even welk Experience Platform API te maken.

Een lijst met producten met rechten ophalen list

U kunt een lijst met producten met rechten ophalen door een GET-aanvraag in te dienen bij de /products eindpunt.

API-indeling

GET /products/

Verzoek

In het volgende verzoek wordt een lijst opgehaald met producten die tot uw organisatie behoren.

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

Antwoord

Een succesvolle reactie keert een lijst van gerechtigde producten terug die tot uw organisatie behoren.

{
  "products": [
    {
      "id": "{ID}",
      "name": "Adobe Experience Platform",
      "serviceCode": "{SERVICE_CODE}"
    }
  ]
}
Eigenschap
Beschrijving
id
De bijbehorende id van het betrokken product.
name
De naam van het product waarop de vraag betrekking heeft.
serviceCode
De overeenkomstige dienstcode van het onderzochte product.

Machtigingscategorieën opzoeken op product-id

U kunt machtigingscategorieën voor een bepaald product opzoeken door een verzoek van de GET tot de /products/{PRODUCT_ID}/categories als u uw product-id opgeeft.

API-indeling

GET /products/{PRODUCT_ID}/categories
Parameter
Beschrijving
De id van het product die is gekoppeld aan de machtigingencategorieën die u wilt opzoeken.

Verzoek

Het volgende verzoek wint toestemmingscategorieën verbonden aan terug {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}' \

Antwoord

Een succesvolle reactie keert de toestemmingscategorieën verbonden aan productID terug u vroeg.

{
  "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"
    }
  ]
}
Eigenschap
Beschrijving
category
De machtigingscategorieën die beschikbaar zijn in de desbetreffende product-id.
name
De naam van de categorie met bevoegdheden.

Machtigingssets opzoeken op product-id

U kunt rechtensets opzoeken voor een bepaald product door een GET-aanvraag in te dienen bij de /products/{PRODUCT_ID}/permission-sets als u uw product-id opgeeft.

API-indeling

GET /products/{PRODUCT_ID}/permission-sets
Parameter
Beschrijving
De id van het product dat is gekoppeld aan de rechtensets die u wilt opzoeken.

Verzoek

Het volgende verzoek wint toestemmingsreeksen verbonden aan terug {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}' \

Antwoord

Een succesvolle reactie keert de toestemmingsreeksen verbonden aan productID terug u vroeg.

{
  "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"
                  ]
              }
          ]
      },
  ]
}
Eigenschap
Beschrijving
permission-sets
Machtigingssets vertegenwoordigen een groep machtigingen die een beheerder op een rol kan toepassen. Een beheerder kan rechtensets toewijzen aan een rol in plaats van individuele machtigingen toe te wijzen. Dit staat u toe om douanerollen van een vooraf bepaalde rol tot stand te brengen die een groep toestemmingen bevat.
id
De bijbehorende id van de set met bevoegdheden waarnaar wordt gevraagd.
name
De corresponderende naam van de desbetreffende rechtenset.
category
De beschikbare machtigingencategorie.
permissions
De toestemmingen omvatten de capaciteit om de eigenschappen van het Platform te bekijken en/of te gebruiken, zoals het creëren van zandbakken, het bepalen van schema's, en het beheren van datasets.
permissions.resource
Het element of object waartoe een onderwerp al dan niet toegang heeft. Bronnen kunnen bestanden, toepassingen, servers of zelfs API's zijn.
permissions.actions
De handeling die een onderwerp mag uitvoeren tegen een bron met vragen. Mogelijke waarden zijn: view, read, create, edit, en delete
recommendation-more-help
631fcab2-5cb1-46ef-ba66-fe098ac723e0