> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/fr/securite/enterprise-security/permissions.md).

# Permissions

Gérez les permissions précises de PowerShell Universal, y compris l'accès aux scripts d'automatisation délimité par dossier pour les équipes déléguées.

Les permissions fournissent une autorisation précise pour les ressources de PowerShell Universal. Les rôles intégrés ont des ensembles de permissions en lecture seule. Les rôles personnalisés et les identités individuelles peuvent recevoir des permissions supplémentaires. Les permissions sont stockées dans la base de données, et non dans les fichiers de configuration `.universal`.

## Identificateurs de permission

Un identificateur de permission combine une portée, un type de ressource et un type d'accès.

```
apis/read
automation.scripts/*
```

Utilisez `*` pour inclure tous les types d'accès ou tous les descendants d'une portée. Les permissions de ressources globales demeurent compatibles avec les ressources délimitées correspondantes et les autorisent.

## Gérer les permissions

Gérez les permissions des identités sous **Secure > Permissions**. Les permissions attribuées directement à une identité se combinent à celles provenant de ses rôles attribués.

Pour gérer les permissions d'un rôle, ouvrez **Secure > Roles**, sélectionnez le rôle, puis sélectionnez son icône de verrou **Permissions**. Des dialogues de permissions propres aux ressources sont aussi offerts depuis les pages de ressources prises en charge.

## Permissions de scripts au niveau du dossier

Utilisez les permissions de scripts d'automatisation délimitées par dossier pour déléguer une partie de la bibliothèque de scripts sans accorder un accès à tous les scripts. Une permission de dossier s'applique à ce dossier et à ses dossiers imbriqués, tout en préservant les limites des dossiers. Par exemple, une permission pour `Delegated` n'accorde pas un accès à `Delegated_Private`.

### Créer une permission de dossier

1. Créez ou sélectionnez un rôle personnalisé sous **Secure > Roles**.
2. Ouvrez **Build > Scripts** et sélectionnez la vue **Folder**.
3. Sélectionnez le dossier cible, puis sélectionnez l'icône de verrou **Permissions** dans la barre d'outils du dossier.
4. Créez une permission pour l'identité ou le rôle. La ressource est délimitée d'avance au dossier sélectionné, par exemple `automation.scripts.Delegated/*`.
5. Sélectionnez l'accès requis et enregistrez.

Utilisez **All** pour accorder les accès Read, Create, Update et Delete aux scripts du dossier et de tous les dossiers imbriqués. Vous pouvez plutôt accorder ces permissions individuellement :

| Accès  | Permet                                                                                                        |
| ------ | ------------------------------------------------------------------------------------------------------------- |
| Read   | La visualisation des scripts dans le dossier autorisé.                                                        |
| Create | La création de scripts et le téléversement de fichiers `.ps1` dans le dossier.                                |
| Update | La modification, le renommage et le déplacement de scripts lorsque tous les chemins concernés sont autorisés. |
| Delete | La suppression des scripts dans le dossier.                                                                   |
| All    | Read, Create, Update et Delete dans le dossier et ses descendants.                                            |

Un utilisateur délégué a aussi besoin d'un accès **View** à `automation.scripts` pour ouvrir la page Scripts. Cette permission au niveau de la page n'accorde pas un accès à tous les scripts ; les permissions Read délimitées par dossier déterminent quels scripts l'utilisateur voit.

### Déplacements et renommages

Le déplacement ou le renommage d'un script exige une autorisation Update pour le chemin source existant et pour le chemin de destination. Par exemple, un utilisateur qui a un accès Update à `Delegated` mais pas à `Restricted` ne peut pas déplacer un script de `Delegated` vers `Restricted`. Accordez un accès Update aux deux dossiers lorsque l'utilisateur doit déplacer des scripts entre eux.

PowerShell Universal valide et canonicalise les chemins de scripts avant d'évaluer les permissions. Les chemins enracinés, les chemins qualifiés par lecteur et les traversées de chemin sont rejetés.

## Exemple : dossier de scripts délégué

Le rôle suivant peut ouvrir la page Scripts et gérer entièrement les scripts sous `Delegated`, y compris les dossiers imbriqués.

```powershell
New-PSURole -Name 'Script Folder Team' -Permission @(
    'automation.scripts/view',
    'automation.scripts.Delegated/*'
)
```

## Permissions des rôles par défaut

* **Administrator** : `*` (accès complet).
* **Operator** : accès complet aux portées API, automation, apps, platform et settings.
* **Execute** : accès en lecture et en exécution aux API, à l'automatisation et aux applis ; accès en lecture à la plateforme et aux paramètres.
* **Reader** : accès en lecture aux API, aux applis et à l'automatisation.
* **API Editor** et **API Reader** : accès complet ou en lecture seule à l'API.
* **App Editor** et **App Reader** : accès complet ou en lecture seule aux applis.

## API

Utilisez `New-PSURole`, `Get-PSURole` et `Set-PSURole` pour gérer les permissions des rôles via l'API de gestion de PowerShell Universal.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/powershell-universal/fr/securite/enterprise-security/permissions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
