Exportar atribuições de função do usuário

Exporte um relatório de todas as funções e atribuições de função em produtos UiPath usando a API Check Access Export no Automation Suite.

Exporta um relatório contendo todas as funções e atribuições de funções associadas a qualquer produto da UiPath®.

Coleção do Postman

Para usar a API de exportação de acesso a verificação, baixe e importe a coleção Postman em seu aplicativo Postman.

Observação:

Ao usar a coleção do Postman, você pode encontrar erros quando a resposta for maior que 50 MB. Essa configuração no Postman pode ser alterada (nas versões Desktop e Web) navegando até Configurações, selecionando Geral e definindo o Tamanho máximo da resposta como zero MB.

Ponto de Extremidade da API

GET https://{yourDomain}/<yourorgname>/pap_/api/userroleassignments/export

Escopos

Requer todos os escopos no nível da plataforma.

Cabeçalhos de solicitação.

--header 'Authorization: Bearer {access_token}'\

Observação:

Para obter o {access_token}, certifique - se de se autenticar por meio de um dos métodos descritos em Métodos de autenticação.

Parâmetros de Consulta

Parâmetro de consulta	Tipo de dados	Description
exportoutputtype	String	Obrigatório. Especifique um dos dois formatos de arquivo disponíveis: .json ou .csv
expandgroupmemberships	String	Obrigatório. true - permite expandir as associações ao grupo do AAD na resposta. false ou ausente - os membros do AAD que fazem parte de grupos locais não são visíveis no relatório.

Resposta

200 OK

O relatório de funções de usuário e atribuições de função é baixado para sua máquina, no formato .json ou .csv .

Exemplo de solicitação

curl --location -- request GET 'https://{yourDomain}/acmeorg/pap_/api/userroleassignments/export?exportoutputtype=json' \
--header 'Authorization: Bearer {your token}

O seguinte corpo de resposta representa uma recuperação bem-sucedida de função de usuário e atribuição de função:

[
    {
        "Id": "34ecc3f3-a582-4cad-9889-120d7a3ffd62",
        "RoleUniqueName": "DOCUMENTUNDERSTANDING.DU VIEWER",
        "RoleDescription": "Can view all the entities but has not rights to edit or delete them.",
        "SecurityPrincipalId": "cdc34b5b-77d2-4ae1-9744-209d21ce557d",
        "RoleAssignmentType": "BuiltIn",
        "RoleType": "BUILTIN",
        "Scope": "/",
        "OrganizationId": "feb0dd79-85b6-483b-b297-0e49a1aa5b7d",
        "TenantId": null,
        "CreatedBy": "7f36fcc2-b822-430b-ae30-5ecfbacac186",
        "CreatedOn": "2023-03-30T08:30:04.9346766+00:00"
    },
...
]

A tabela a seguir descreve os campos de cabeçalho do arquivo exportado:

Campo	Description
Id	O identificador exclusivo da atribuição de função.
RoleName	O nome da função conforme exibido na interface. Por exemplo, Folder Administrator
RoleId	O identificador exclusivo da função.
RoleDescription	A descrição da função, conforme exibida na interface. Por exemplo, Folder Administrator
RoleType	O tipo da função, conforme definido pelo usuário ou o sistema: - Personalizado: função definida por um usuário. - Integrado: função presente por padrão no portal de administração.
RoleAssignmentType	O tipo de atribuição da função quando foi criada, que pode ser uma das duas opções a seguir: - Personalizado: atribuição feita pelo usuário. - Integrado: atribuição feita por padrão no portal de administração.
Scope	O escopo é um nível específico na hierarquia organizacional que serve como limite para certas ações, permissões e objetos. Um escopo pode ser uma das seguintes opções hierárquicas, representados como IDs: - Organização - Tenant - Serviço - Pasta
ScopeWithDisplayNames	O escopo é um nível específico na hierarquia organizacional que serve como limite para certas ações, permissões e objetos. Um escopo pode ser uma das seguintes opções hierárquicas: - Organização - Tenant - Serviço - Pasta
ServiceName	O nome do serviço da UiPath ao qual a função pertence.
SecurityPrincipalId	O identificador exclusivo da identidade de um usuário, grupo etc.
SecurityPrincipalType	O tipo de identidade de um usuário, grupo ou robô.
SecurityPrincipalEmail	O e-mail do usuário Este campo fica em branco caso a identidade não seja um usuário.
SecurityPrincipalDisplayName	O nome da identidade. Este campo fica em branco no caso de usuários do diretório.
InheritedFromGroupName	O nome do grupo do qual a atribuição de função é herdada.
InheritedFromGroupId	Identificador do grupo do qual a atribuição de função é herdada.
TenantName	O nome do tenant em que a atribuição é feita. Este campo fica em branco no caso de atribuições no nível da organização.
OrganizationName	O nome da organização em que a atribuição é feita.
OrganizationId	O identificador da organização em que a atribuição é feita.
TenantId	O identificador do tenant em que a atribuição é feita. Este campo fica em branco no caso de atribuições no nível da organização.
CreatedBy	O identificador exclusivo do usuário que cria a atribuição.
CreatedByDisplayName	O nome do usuário que cria a atribuição.
CreatedOn	O carimbo de data/hora de quando a função foi atribuída.
FolderName	O nome da pasta associada à atribuição.
FolderKey	O identificador exclusivo da pasta associada à atribuição.
ProjectId	O ID do projeto (por exemplo, Document Understanding ou IXP) associado à atribuição.