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

# Accès basé sur les rôles

## Rôles des applications

Lorsque l'authentification des applications est activée, vous pouvez définir le rôle auquel un utilisateur doit appartenir pour accéder au tableau de bord. Les rôles sont configurés sur la page ***Paramètres*** \ ***Sécurité*** ou dans le fichier de configuration `roles.ps1`.

<figure><img src="/files/GB6RzrDjLkpjejuElKm4" alt=""><figcaption><p>Sécurité de l'application</p></figcaption></figure>

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

![](/files/UrRGBPU95MSYrtmCRWGX)

## 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 ayant le 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 applications et des pages, vous pouvez également vérifier les rôles auxquels un utilisateur appartient en utilisant la variable `$Roles` disponible dans les applications. 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
    }
}
```


---

# 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:

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

The question should be specific, self-contained, and written in natural language.
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.
