> 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

Créez une politique de paquets avec l’éditeur de politique de Devolutions UniGetUI, et laissez les utilisateurs standards installer les applis que vous approuvez, sans droits d’administrateur ni invit

Les utilisateurs standards ne peuvent pas exécuter la plupart des installateurs sous Windows. Avec Devolutions Agent, ils n'en ont pas besoin : Devolutions 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 avec sa fonctionnalité UniGetUI Package Broker.
{% endhint %}

## Comment ça fonctionne

1. Un utilisateur clique sur ***Installer***, ***Mettre à jour*** ou ***Désinstaller*** dans Devolutions UniGetUI.
2. Au lieu d'afficher une invite UAC, Devolutions UniGetUI envoie la requête au broker de paquets de Devolutions Agent.
3. Avant de l’envoyer, Devolutions UniGetUI vérifie la requête par rapport à ce que l’agent accepte, par exemple les options d’installation, l’architecture et l’élévation. Une requête que l’agent refuserait n’est pas envoyée : l’opération échoue avec ***Le broker de paquets ne peut pas accepter cette requête*** et la liste des options à changer.
4. L’agent vérifie que la requête provient d’un Devolutions UniGetUI signé et non modifié, puis la compare à la politique de paquets que vous avez définie : quelles applis, sources, opérations et versions sont autorisées.
5. Si la politique l’autorise, l’agent exécute l’opération et Devolutions UniGetUI montre sa progression et sa sortie comme d’habitude. Sinon, l’opération échoue avec ***Operation denied by policy***, la raison que vous avez écrite dans la règle et l’ID de la règle.

**Refus par défaut.** Si l'agent n'est pas installé, ne fonctionne pas ou est injoignable, l'opération échoue. Devolutions UniGetUI ne se rabat jamais sur une invite UAC. Et si un utilisateur désactive le broker dans Devolutions 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 Devolutions UniGetUI ne fait que détecter sur l’ordinateur (source ***PC local***) ne lui sont pas envoyées. Une opération qui passe par le broker et ne se termine pas dans un délai d’une heure est signalée comme échouée, même si elle s’exécute peut-être encore dans l’agent.

## Configurer le broker

{% stepper %}
{% step %}

### Installer Devolutions Agent avec le broker de paquets

Le broker de paquets est la fonctionnalité ***UniGetUI Package Broker*** de l’installateur de Devolutions Agent. Elle est désactivée par défaut.

1. Sélectionnez ***UniGetUI Package Broker*** dans l’installateur de Devolutions Agent, ou ajoutez `F.PackageBroker` à `ADDLOCAL` lors d’une installation en mode silencieux. `ADDLOCAL` n’installe que les fonctionnalités qu’il liste :

```powershell
msiexec /i DevolutionsAgent.msi /qn ADDLOCAL=F.Agent,F.Updater,F.Session,F.PackageBroker
```

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

La fonctionnalité définit `PackageBroker.Enabled` à `true` dans `%ProgramData%\Devolutions\Agent\agent.json`. L’agent lit sa politique dans `%ProgramData%\Devolutions\PackageBroker\package-broker-policy.json`, sauf si `PackageBroker.PolicyPath` dans `agent.json` pointe vers un autre fichier. Tant qu’aucune politique valide n’existe, l’agent refuse chaque opération de paquet.
{% endstep %}

{% step %}

### Installer Devolutions UniGetUI pour tous les utilisateurs

[Installez Devolutions UniGetUI pour tous les utilisateurs](https://docs.devolutions.net/unigetui/fr/pour-les-equipes-des-ti/organization/deploy.md) (`/ALLUSERS`), dans `C:\Program Files\UniGetUI`. L’agent n’accepte les requêtes que d’un Devolutions UniGetUI signé que les utilisateurs standards ne peuvent pas modifier, et créer ou modifier la politique de paquets depuis Devolutions UniGetUI exige aussi cette installation.
{% endstep %}

{% step %}

### Activer le broker dans Devolutions 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 maintenant, les opérations d’installation, de mise à jour et de désinstallation passent par l’agent. Tant qu’aucune politique de paquets valide n’est installée, elles échouent avec ***Les opérations de paquets sont en pause***.

Pour l’activer pour vos utilisateurs depuis un script, exécutez `UniGetUI.exe --enable-setting UseAgentBroker` dans la session de chaque utilisateur. Dans l’[interface de terminal](https://github.com/Devolutions/RDM/tree/master/docs-products/translations/fr/unigetui/reference/terminal-ui.md), l’option est ***Déléguer les opérations sur les paquets à Devolutions Agent***.
{% endstep %}
{% endstepper %}

## Créer et modifier la politique de paquets

La politique de paquets indique ce que les utilisateurs peuvent installer, mettre à jour et désinstaller. Vous la créez et la modifiez dans Devolutions UniGetUI, avec l’éditeur de politique du broker de paquets.

1. Allez dans ***Paramètres*** – ***Droits d'administrateur et autres paramètres dangereux***.
2. Cliquez sur ***Inspect active package broker policy***.
3. Si ***State*** indique qu’aucun fichier de politique n’existe, cliquez sur ***Create***. Pour modifier la politique active, cliquez sur ***Edit***.
4. Remplacez le ***Policy ID*** (`new-policy` dans une nouvelle politique) par le vôtre, par exemple `contoso-workstations`.
5. Remplacez l’***Éditeur*** (`Your organization`) par le nom de votre organisation.
6. Au besoin, entrez une ***Support URL*** où les utilisateurs peuvent demander une exception. Pour ajouter une description, sélectionnez ***Description*** et tapez-la.
7. Sous ***Enforcement***, développez ***Advanced*** et laissez ***Default decision*** sur ***Deny***, pour que tout ce que vous n’autorisez pas explicitement soit bloqué.
8. Cliquez sur ***Add rule*** pour chaque groupe d’applis que vous voulez autoriser. Une nouvelle règle est une règle ***Deny*** désactivée.
9. Dans chaque règle, réglez ***Decision*** sur ***Allow*** et choisissez ses critères de correspondance.
10. Sélectionnez la case à cocher dans l’en-tête de la règle pour activer la règle.
11. Cliquez sur ***Enregistrer*** et approuvez l'invite d'administrateur de Windows.

Le ***Policy ID*** ne peut pas être changé quand vous modifiez une politique. Pour recommencer avec un autre ID, cliquez sur ***Replace identity*** au lieu de ***Edit***.

Pour modifier une règle plus tard, ouvrez l’éditeur avec ***Edit***. Chaque règle a les boutons ***Duplicate***, ***Move up***, ***Move down*** et ***Delete***. Pour examiner ou modifier toute la politique en JSON, cliquez sur ***Raw JSON*** en haut de l’éditeur, et sur ***Structured*** pour revenir aux champs guidés.

{% hint style="info" %}
Premier déploiement? Sous ***Enforcement*** – ***Advanced***, 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 %}

Vous pouvez aussi déployer le fichier de politique avec votre outil habituel au lieu de l’enregistrer depuis chaque ordinateur : créez-le une fois dans l’éditeur, copiez le résultat de la section ***Canonical policy JSON*** de la page d’inspection, puis copiez le fichier dans le chemin de la politique de chaque ordinateur. L’agent recharge le fichier quand il change. Il n’accepte qu’un fichier et un dossier dans lesquels seuls SYSTEM et le groupe Administrators peuvent écrire, et traite tout autre fichier comme non valide.

### Ce qu'une politique peut contrôler

Chaque règle est réglée sur ***Allow*** ou ***Deny*** et s’applique aux requêtes qui lui correspondent. Les règles sont évaluées dans l’ordre : la première règle activée qui correspond décide, et ***Move up*** et ***Move down*** changent l’ordre. Quand aucune règle activée ne correspond, la ***Default decision*** s’applique. 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>Identifiants de paquets</strong></td><td>Identifiants exacts (<code>Mozilla.Firefox</code>) ou motifs d’identifiants avec <code>*</code> et <code>?</code> (<code>Contoso.*</code>).</td></tr><tr><td><strong>Noms de sources</strong></td><td>Seulement la source <code>winget</code>, ou votre flux Chocolatey interne. Offert quand exactement un gestionnaire de paquets qui prend en charge les sources 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 de paquets</strong></td><td>Versions exactes, ou une plage avec une version minimale et une version maximale, avec ou sans préversions. Les critères de version ne s’appliquent pas aux désinstallations.</td></tr><tr><td><strong>Portées, architectures, privilège d’exécution</strong></td><td>Installations pour l’utilisateur ou la machine ; paquets x86, x64, Arm64 ou neutres ; requêtes standard ou élevées.</td></tr><tr><td><strong>Caractéristiques de la requête</strong></td><td>Installations interactives, vérifications de hachage ignorées, préversions, paramètres personnalisés, emplacement d’installation personnalisé, commandes avant/après, arrêt des applis en cours d’exécution, désinstallation de la version précédente. Chacun est <em><strong>Sans importance</strong></em>, <em><strong>Oui</strong></em> ou <em><strong>Non</strong></em>.</td></tr></tbody></table>

Quand un détail de la requête est inconnu, par exemple une version que le gestionnaire de paquets choisit pendant l’installation, les règles Deny correspondent à la requête et les règles Allow ne correspondent pas.

Sur une règle ***Allow***, développez ***Additional safety limits*** et sélectionnez ***Add safety limits to this Allow rule*** pour restreindre ce qu’une requête correspondante peut faire, par exemple pour interdire les paramètres personnalisés ou pour n’accepter que certains dossiers d’installation.

{% 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.

## 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***.

## 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 Devolutions 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 ou un chemin défini dans la configuration de l’agent.</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 Devolutions 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>

Sous les règles, ***Canonical policy JSON*** montre la politique exactement comme l’agent la lit. Cliquez sur ***Copy to clipboard*** pour la copier, par exemple pour l’envoyer à l’assistance.

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 et l’ID de la règle sont affichés. Demandez à votre administrateur.</td></tr><tr><td><strong>Le broker de paquets ne peut pas accepter cette requête</strong></td><td>Devolutions UniGetUI n’a pas envoyé la requête, parce que l’agent refuserait certaines de ses options. Les options sont listées. Changez les options d’installation du paquet, ou choisissez un autre paquet ou une autre source.</td></tr><tr><td><strong>Le broker de paquets a rejeté la requête</strong></td><td>L’agent n’a pas accepté l’une des options de l’opération. Les détails sont affichés. Changez les options d’installation du paquet.</td></tr><tr><td><strong>Les opérations de paquets sont en pause</strong></td><td>Aucune politique de paquets valide n’est installée. Demandez à votre administrateur.</td></tr><tr><td><strong>Devolutions Agent a refusé cette opération</strong></td><td>L’agent n’autorise pas l’opération pour le moment, par exemple parce que la politique est en dehors de sa période <em><strong>Valid from</strong></em> et <em><strong>Valid until</strong></em>. Demandez à votre administrateur.</td></tr><tr><td><strong>UniGetUI n’est pas autorisé à utiliser Devolutions Agent</strong></td><td>L’agent n’accepte que des copies signées et non modifiées de Devolutions UniGetUI. Installez une version officielle pour tous les utilisateurs.</td></tr><tr><td><strong>Des droits d’administrateur sont requis</strong></td><td>L’agent n’accepte cette requête que d’un administrateur qui l’exécute avec des droits élevés.</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>Devolutions Agent est occupé</strong></td><td>L’agent traite trop de requêtes. Réessayez dans un moment.</td></tr><tr><td><strong>La requête est trop volumineuse</strong></td><td>Les arguments ou commandes personnalisés de l’opération sont trop longs. Raccourcissez-les.</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, ou a renvoyé une réponse inattendue. Réessayez dans un moment.</td></tr><tr><td><strong>Le module entre en conflit avec des commandes installées</strong></td><td>Un module Windows PowerShell nécessite l’option <code>-AllowClobber</code>, qui ne peut pas être utilisée par l’entremise de l’agent. Demandez à votre administrateur.</td></tr><tr><td><strong>Operation failed via broker</strong></td><td>L’agent a accepté la requête, mais l’opération a échoué ou ne s’est pas terminée à temps. 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, ou sa fonctionnalité ***UniGetUI Package Broker*** n’est pas installée. Voir [Une mise à jour ou une installation échoue](https://docs.devolutions.net/unigetui/fr/aide/troubleshooting/update-or-install-fails.md).
* Chaque opération échoue avec ***UniGetUI n’est pas autorisé à utiliser Devolutions Agent*** : Devolutions UniGetUI est installé pour l’utilisateur actuel seulement, ou ce n’est pas une version officielle. [Réinstallez-le pour tous les utilisateurs](https://docs.devolutions.net/unigetui/fr/pour-les-equipes-des-ti/organization/deploy.md).
* Vous ne pouvez pas cliquer sur ***Create*** ou ***Edit*** : lisez le champ ***Reason***. Habituellement, Devolutions 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](https://docs.devolutions.net/unigetui/fr/aide/troubleshooting/send-logs-to-support.md).

## Ensuite

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


---

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