Exporter les attributions de rôles utilisateur

Exportez un rapport de tous les rôles et attributions de rôles dans les produits UiPath à l'aide de l'API d'exportation Vérifier l'accès dans Automation Suite.

Exporte un rapport contenant tous les rôles et toutes les attributions de rôles associés à n’importe quel produit UiPath®.

Collection Postman

Pour utiliser l’API d’exportation Vérifier l’accès, téléchargez et importez la collection Postman dans votre application Postman.

Remarque :

Lorsque vous utilisez la collection Postman, vous pouvez rencontrer des erreurs lorsque la réponse est supérieure à 50 Mo. Ce paramètre sur Postman peut être modifié (dans les versions Desktop et Web) en accédant à Paramètres, puis en sélectionnant Général, puis en définissant la Taille maximale de la réponse sur zéro Mo.

Point de terminaison de l’API

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

Étendues

Nécessite toutes les étendues au niveau de la plate-forme.

En-têtes de requête.

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

Remarque :

Pour obtenir le {access_token}, assurez-vous de vous authentifier via l'une des méthodes décrites dans Méthodes d'authentification.

Paramètres de requête

Paramètre de requête	Type de données	Description
exportoutputtype	string	Requis. Spécifiez l'un des deux formats de fichier disponibles : .json ou .csv
expandgroupmemberships	string	Requis. true - permet d'étendre les appartenances au groupe AAD dans la réponse. false ou manquant - Les membres AAD qui font partie des groupes locaux ne sont pas visibles dans le rapport.

Réponses

200 OK

Le rapport sur les rôles d'utilisateur et les téléchargements d'attribution de rôles sur votre machine, au format .json ou .csv .

Exemple de requête

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

Le corps de la réponse suivante représente une récupération réussie du rôle de l'utilisateur et de l'affectation des rôles :

[
    {
        "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"
    },
...
]

Le tableau suivant décrit les champs d'en-tête du fichier exporté :

Champ	Description
Id	L’identifiant unique de l’attribution de rôle.
RoleName	Le nom du rôle tel qu'il s'affiche dans l'interface. Par exemple, Administrateur de dossiers
RoleId	L’identificateur unique du rôle.
RoleDescription	La description du rôle, telle qu'elle s'affiche dans l'interface. Par exemple, Administrateur de dossiers
RoleType	Le type de rôle, tel que défini par l'utilisateur ou le système : - Personnalisé: rôle défini par un utilisateur. - Intégré: rôle présent par défaut dans le portail d'administration.
RoleAssignmentType	Le type d'affectation du rôle lors de sa création, qui peut être l'une des deux options suivantes : - Personnalisé: attribution effectuée par l’utilisateur. - Intégré: attribution effectuée par défaut dans le portail d'administration.
Scope	L’étendue est un niveau spécifique de la hiérarchie organisationnelle qui sert de limite pour certaines actions, autorisations et objets. Une étendue peut être l'une des options hiérarchiques suivantes, représentées sous forme d'ID : - Organisation - Locataire - Service - Dossier
ScopeWithDisplayNames	L’étendue est un niveau spécifique de la hiérarchie organisationnelle qui sert de limite pour certaines actions, autorisations et objets. Une étendue peut être l'une des options hiérarchiques suivantes : - Organisation - Locataire - Service - Dossier
ServiceName	Le nom du service UiPath auquel appartient le rôle.
SecurityPrincipalId	L’identifiant unique de l’identité d’un utilisateur, d’un groupe, etc.
SecurityPrincipalType	Le type d'identité d'un utilisateur, d'un groupe ou d'un robot.
SecurityPrincipalEmail	L'e-mail de l'utilisateur. Ce champ est vide lorsque l'identité ne correspond pas à un utilisateur.
SecurityPrincipalDisplayName	Nom de l'identité. Ce champ est vide en cas d'utilisateurs d'annuaire.
InheritedFromGroupName	Le nom du groupe à partir duquel l'attribution de rôle est héritée.
InheritedFromGroupId	L'identifiant du groupe à partir duquel l'attribution de rôle est héritée.
TenantName	Le nom du locataire où l'affectation est effectuée. Ce champ est vide en cas d'affectations au niveau de l'organisation.
OrganizationName	Le nom de l'organisation où l'affectation est effectuée.
OrganizationId	L'identifiant de l'organisation où l'affectation est effectuée.
TenantId	L'identifiant du locataire où l'affectation est effectuée. Ce champ est vide en cas d'affectations au niveau de l'organisation.
CreatedBy	L'identifiant unique de l'utilisateur qui crée l'affectation.
CreatedByDisplayName	Nom de l’utilisateur qui crée l’affectation.
CreatedOn	L’horodatage auquel le rôle est attribué.
FolderName	Le nom du dossier associé à l’affectation.
FolderKey	L'identifiant unique du dossier associé à l'affectation.
ProjectId	L'ID du projet associé à l' Document Understanding .