> 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/applis/role-based-access.md).

# Accès basé sur les rôles

Restreignez les applis et les pages PowerShell Universal par rôle, et utilisez la variable Roles pour afficher conditionnellement des composants selon l'appartenance aux rôles de l'utilisateur.

## Rôles des applis

Lorsque l'authentification des applis est activée, vous pouvez définir le rôle dont un utilisateur doit faire partie pour accéder au tableau de bord. Les rôles sont configurés sous **Secure > Roles** ou à partir du fichier de configuration `roles.ps1`.

Si un utilisateur tente de visiter une appli à laquelle il n'a pas accès, une page Not Authorized lui sera présentée.

## Rôles des pages

Vous pouvez également afficher ou masquer des pages en fonction des rôles. Pour définir un rôle pour une page, utilisez le paramètre `-Role` de `New-UDPage`. Seuls les utilisateurs du rôle spécifié auront accès à cette page.

```powershell
New-UDPage -Role 'Administrators' -Content {
    New-UDTypography -Text 'Admins only'
}
```

## Variable $Roles

En plus des rôles des applis et des pages, vous pouvez aussi vérifier les rôles dont un utilisateur fait partie en utilisant la variable `$Roles` qui est disponible dans les applis. Cette variable contient un tableau des rôles attribués à l'utilisateur.

Par exemple, vous pourriez afficher le bouton `Restart-Computer` uniquement aux administrateurs.

```powershell
if ($Roles -contains "Administrator") {
    New-UDButton -Text 'Restart Server' -OnClick {
        Restart-Computer
    }
}
```

### Voir aussi

* [Devolutions Academy – Plan et authentification](https://academy.devolutions.net/student/activity/3542770-part-1-outline-and-authentication)


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/powershell-universal/fr/applis/role-based-access.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.