O controle de acesso baseado em atributos está disponível em uma versão limitada para clientes de assistência médica com base nos EUA. Esse recurso estará disponível para todos os clientes da Real-time Customer Data Platform assim que for totalmente lançado.
O /products
O endpoint na API de controle de acesso baseada em atributos permite gerenciar programaticamente produtos, bem como categorias de permissão e conjuntos de permissões associados a produtos em sua organização.
O endpoint da API usado neste guia faz parte da API de controle de acesso baseada em atributos. Antes de continuar, reveja o guia de introdução para links para a documentação relacionada, um guia para ler as chamadas de API de exemplo neste documento e informações importantes sobre os cabeçalhos necessários para fazer chamadas com êxito para qualquer API do Experience Platform.
Você pode recuperar uma lista de produtos autorizados fazendo uma solicitação do GET para o /products
endpoint .
Formato da API
GET /products/
Solicitação
A solicitação a seguir recupera uma lista de produtos autorizados pertencentes à sua organização.
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}' \
Resposta
Uma resposta bem-sucedida retorna uma lista de produtos autorizados pertencentes à sua organização.
{
"products": [
{
"id": "{ID}",
"name": "Adobe Experience Platform",
"serviceCode": "{SERVICE_CODE}"
}
]
}
Propriedade | Descrição |
---|---|
id |
A ID correspondente do produto consultado. |
name |
O nome do produto consultado. |
serviceCode |
O código de serviço correspondente do produto consultado. |
Você pode pesquisar categorias de permissão para um determinado produto, fazendo uma solicitação do GET para a variável /products/{PRODUCT_ID}/categories
endpoint ao especificar a ID do produto.
Formato da API
GET /products/{PRODUCT_ID}/categories
Parâmetro | Descrição |
---|---|
A ID do produto associada às categorias de permissão que você deseja pesquisar. |
Solicitação
A solicitação a seguir recupera categorias de permissão associadas 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}' \
Resposta
Uma resposta bem-sucedida retorna as categorias de permissão associadas à ID de produto que você consultou.
{
"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"
}
]
}
Propriedade | Descrição |
---|---|
category |
As categorias de permissão disponíveis na ID de produto consultada. |
name |
O nome da categoria de permissão. |
Você pode procurar conjuntos de permissões para um determinado produto, fazendo uma solicitação do GET para a /products/{PRODUCT_ID}/permission-sets
endpoint ao especificar a ID do produto.
Formato da API
GET /products/{PRODUCT_ID}/permission-sets
Parâmetro | Descrição |
---|---|
A ID do produto associada aos conjuntos de permissões que você deseja pesquisar. |
Solicitação
A solicitação a seguir recupera conjuntos de permissões associados 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}' \
Resposta
Uma resposta bem-sucedida retorna os conjuntos de permissões associados à ID do produto que você consultou.
{
"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"
]
}
]
},
]
}
Propriedade | Descrição |
---|---|
permission-sets |
Os conjuntos de permissões representam um grupo de permissões que um administrador pode aplicar a uma função. Um administrador pode atribuir conjuntos de permissões a uma função, em vez de atribuir permissões individuais. Isso permite criar funções personalizadas a partir de uma função predefinida que contém um grupo de permissões. |
id |
A ID correspondente do conjunto de permissões consultado. |
name |
O nome correspondente do conjunto de permissões consultado. |
category |
A categoria de permissão disponível. |
permissions |
As permissões incluem a capacidade de exibir e/ou usar recursos da plataforma, como criar sandboxes, definir esquemas e gerenciar conjuntos de dados. |
permissions.resource |
O ativo ou objeto que um assunto pode ou não acessar. Os recursos podem ser arquivos, aplicativos, servidores ou até mesmo APIs. |
permissions.actions |
A ação que um assunto tem permissão para fazer contra um recurso consultado. Os valores possíveis incluem: view , read , create , edit e delete |