> 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/unigetui/fr/pour-les-equipes-des-ti/organization/devolutions-agent.md).

# Installer des applis approuvées sans droits d'administrateur

Laissez les utilisateurs standards installer et mettre à jour les applis que vous approuvez, sans droits d'administrateur ni invites UAC, en déléguant les opérations à Devolutions Agent.

Les utilisateurs standards ne peuvent pas exécuter la plupart des installateurs sous Windows. Avec Devolutions Agent, ils n'en ont pas besoin : UniGetUI remet l'opération à l'agent, qui la vérifie selon **votre politique** et l'exécute avec les droits nécessaires. Les utilisateurs obtiennent les applis qu'ils ont le droit d'avoir, et rien d'autre.

{% hint style="info" %}
Windows seulement. Exige Devolutions Agent.
{% endhint %}

## Comment ça fonctionne

1. Un utilisateur clique sur ***Installer***, ***Mettre à jour*** ou ***Désinstaller*** dans UniGetUI.
2. Au lieu d'afficher une invite UAC, UniGetUI envoie la requête au broker de paquets de Devolutions Agent.
3. L'agent compare la requête à la politique que vous avez définie : quelles applis, sources, opérations et versions sont autorisées.
4. Si la politique l'autorise, l'agent exécute l'opération et UniGetUI montre sa progression et sa sortie comme d'habitude. Sinon, l'opération échoue avec ***Operation denied by policy*** et la raison que vous avez écrite dans la règle.

**Refus par défaut.** Si l'agent n'est pas installé, ne fonctionne pas ou est injoignable, l'opération échoue. UniGetUI ne se rabat jamais sur une invite UAC. Et si un utilisateur désactive le broker dans UniGetUI, il revient à des invites UAC qu'il ne peut pas approuver sans identifiants d'administrateur, donc il n'y gagne rien.

Les opérations de WinGet, Chocolatey, Scoop, Windows PowerShell, PowerShell 7, pip, npm, Bun, Cargo, .NET Tool et vcpkg peuvent passer par l'agent. Les applis que UniGetUI ne fait que détecter sur l'ordinateur (source ***PC local***) ne lui sont pas envoyées.

{% stepper %}
{% step %}

### Installer et activer le broker dans Devolutions Agent

Installez Devolutions Agent sur les ordinateurs. Voir [Déployer Devolutions Agent en mode silencieux](https://docs.devolutions.net/resources/fr/devolutions-agent/deploy-devolutions-agent-silently).

{% hint style="warning" %}
**Documentation à venir.** Les étapes pour activer le broker de paquets dans Devolutions Agent, et pour définir où l'agent lit son fichier de politique et si UniGetUI peut le modifier, ne sont pas encore documentées. Contactez l'assistance Devolutions si vous en avez besoin maintenant.
{% endhint %}

Installez aussi [UniGetUI pour tous les utilisateurs](/unigetui/fr/pour-les-equipes-des-ti/organization/deploy.md) (`/ALLUSERS`). C'est exigé pour créer ou modifier la politique depuis UniGetUI.
{% endstep %}

{% step %}

### Activer le broker dans UniGetUI

1. Allez dans ***Paramètres*** – ***Droits d'administrateur et autres paramètres dangereux***.
2. Activez ***Déléguer les opérations sur les paquets au broker Devolutions Agent***.

À partir de là, les opérations d'installation, de mise à jour et de désinstallation passent par l'agent.
{% endstep %}

{% step %}

### Créer la politique

1. Sur la même page de paramètres, cliquez sur ***Inspect active package broker policy***.
2. Si ***State*** indique qu'aucune politique n'existe, cliquez sur ***Create***. Pour modifier une politique existante, cliquez sur ***Edit***.
3. Entrez un ***Policy ID*** (par exemple `contoso-workstations`) et un ***Éditeur***. Ajoutez au besoin une ***Description*** et une ***Support URL*** où les utilisateurs peuvent demander une exception.
4. Laissez ***Default decision*** sur ***Deny***, pour que tout ce que vous n'autorisez pas explicitement soit bloqué.
5. Cliquez sur ***Add rule*** pour chaque groupe d'applis que vous voulez autoriser (voir plus bas).
6. Cliquez sur ***Enregistrer*** et approuvez l'invite d'administrateur de Windows.

{% hint style="info" %}
Premier déploiement? Réglez ***Audit mode*** sur ***Oui***. L'agent journalise ce qu'il refuserait, mais laisse tout passer. Quand les journaux sont corrects, remettez-le à ***Non***.
{% endhint %}
{% endstep %}

{% step %}

### Vérifier que ça fonctionne

Installez une appli autorisée et une interdite depuis un compte d'utilisateur standard. La première doit s'installer sans aucune invite ; la seconde doit échouer avec ***Operation denied by policy***.
{% endstep %}
{% endstepper %}

## Ce qu'une politique peut contrôler

Chaque règle ***Allow*** ou ***Deny*** les requêtes qui correspondent. Les règles sont évaluées dans l'ordre ; utilisez ***Move up*** et ***Move down*** pour le changer. Laissez un critère vide pour tout correspondre.

<table><thead><tr><th width="220">CONTRÔLE</th><th>EXEMPLES</th></tr></thead><tbody><tr><td><strong>Packages</strong></td><td>ID exacts (<code>Mozilla.Firefox</code>) ou motifs (<code>Contoso.*</code>).</td></tr><tr><td><strong>Sources</strong></td><td>Seulement la source <code>winget</code>, ou votre flux Chocolatey interne. Offert quand un seul gestionnaire de paquets est sélectionné.</td></tr><tr><td><strong>Opérations</strong></td><td>Autoriser les mises à jour pour tout, mais les installations seulement pour une courte liste.</td></tr><tr><td><strong>Versions</strong></td><td>Versions exactes, ou une plage avec une version minimale et une version maximale, avec ou sans préversions.</td></tr><tr><td><strong>Scope, architecture, privilege</strong></td><td>Installations pour l'utilisateur ou la machine ; x86, x64, Arm64 ; requêtes standard ou élevées.</td></tr><tr><td><strong>Request options</strong></td><td>Installations interactives, vérifications de hachage ignorées, paramètres personnalisés, emplacement d'installation personnalisé, commandes avant/après, et plus.</td></tr></tbody></table>

Sur une règle ***Allow***, sélectionnez ***Add safety limits to this Allow rule*** pour restreindre ce qu'une requête correspondante peut faire, par exemple interdire les paramètres personnalisés ou un emplacement d'installation personnalisé.

{% hint style="danger" %}
Ignorer les vérifications de hachage, les paramètres personnalisés et les commandes avant/après peut exécuter du code arbitraire avec des droits élevés. Laissez-les désactivés dans vos règles Allow, à moins d'avoir examiné un besoin précis.
{% endhint %}

Vous pouvez aussi limiter quand toute la politique s'applique avec ***Valid from*** et ***Valid until***. En dehors de cette période, l'agent refuse les opérations de paquets.

## Inspecter la politique active

N'importe qui peut vérifier ce qui est appliqué sur un ordinateur, ce qui aide quand un utilisateur signale une appli refusée.

1. Allez dans ***Paramètres*** – ***Droits d'administrateur et autres paramètres dangereux***.
2. Cliquez sur ***Inspect active package broker policy***.
3. Passez en revue la section ***Package broker policy***, puis les règles. Cliquez sur ***Refresh*** après un changement de politique.

<table><thead><tr><th width="260">CHAMP</th><th>CE QUE ÇA VOUS DIT</th></tr></thead><tbody><tr><td><strong>State</strong></td><td>Si une politique valide est en vigueur, absente ou non valide. Une politique non valide doit être corrigée ou remplacée par un administrateur, en dehors de UniGetUI.</td></tr><tr><td><strong>Configured path</strong> / <strong>Path source</strong></td><td>Où l'agent lit le fichier de politique, et si c'est son emplacement par défaut.</td></tr><tr><td><strong>Agent write capability</strong></td><td>Si l'agent permet de modifier la politique : <strong>Writable</strong>, <strong>Read-only</strong> ou <strong>Unsupported</strong>.</td></tr><tr><td><strong>Policy changes from this app</strong> / <strong>Reason</strong></td><td>Si vous pouvez modifier la politique depuis ce UniGetUI, et pourquoi pas. La modification exige l'autorisation de l'agent et une installation pour tous les utilisateurs.</td></tr><tr><td><strong>Elevation required</strong></td><td>Si l'enregistrement demande l'approbation d'un administrateur Windows.</td></tr></tbody></table>

Si la page affiche ***Devolutions Agent is unavailable***, vérifiez que l'agent est installé et que son service fonctionne, puis cliquez sur ***Refresh***.

## Ce que les utilisateurs voient

Pour les utilisateurs, rien ne change : ils installent et mettent à jour les applis comme d'habitude, sans invites UAC. Quand quelque chose ne va pas, l'opération échoue avec un de ces messages :

<table><thead><tr><th width="280">MESSAGE</th><th>QUOI FAIRE</th></tr></thead><tbody><tr><td><strong>Operation denied by policy</strong></td><td>La politique n'autorise pas cette appli, cette source, cette opération ou cette version. La raison de la règle est affichée. Demandez à votre administrateur.</td></tr><tr><td><strong>Agent broker unavailable</strong></td><td>Devolutions Agent n'est pas installé ou ne fonctionne pas.</td></tr><tr><td><strong>Operation unsupported by broker</strong></td><td>L'agent ne prend pas en charge cette opération ou cette option.</td></tr><tr><td><strong>Broker communication error</strong></td><td>L'agent n'a pas répondu à temps. L'opération est peut-être encore en cours.</td></tr><tr><td><strong>Operation failed via broker</strong></td><td>L'agent a accepté la requête, mais l'installation a échoué. Ouvrez la sortie de l'opération pour les détails.</td></tr></tbody></table>

## Si ça ne fonctionne pas

* Chaque opération échoue avec ***Agent broker unavailable*** : le service de l'agent est arrêté ou absent. Voir [Une mise à jour ou une installation échoue](/unigetui/fr/aide/troubleshooting/update-or-install-fails.md).
* Vous ne pouvez pas cliquer sur ***Create*** ou ***Edit*** : lisez le champ ***Reason***. Habituellement, UniGetUI n'est pas installé pour tous les utilisateurs, ou l'agent n'autorise pas les changements de politique.
* Un utilisateur a besoin d'assistance : [Envoyer les journaux à l'assistance](/unigetui/fr/aide/troubleshooting/send-logs-to-support.md).

## Ensuite

* [Verrouiller les paramètres risqués](/unigetui/fr/pour-les-equipes-des-ti/organization/restrict-settings.md)
* [Uniformiser les postes de travail](/unigetui/fr/pour-les-equipes-des-ti/organization/standard-workstations.md)
* [Documentation de Devolutions Agent](https://docs.devolutions.net/resources/fr/devolutions-agent)


---

# 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/unigetui/fr/pour-les-equipes-des-ti/organization/devolutions-agent.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.
