> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/fr/pam/deploy-operate/rds-licensing.md).

# Licences Remote Desktop Services

Comment mettre sous licence Remote Desktop Services, de Microsoft, sur l'hôte de publication Windows, et réinitialiser la période de grâce de 120 jours à titre temporaire.

## De quoi il s'agit et quand l'utiliser

Les applications publiées (RemoteApp) et les sessions web ne s'exécutent pas sur le serveur du PAM. Elles s'exécutent sur un **hôte de publication Windows** distinct, qui utilise le rôle **Remote Desktop Session Host** (RDSH) de Windows Server pour tenir plusieurs sessions utilisateur à la fois. Ce rôle fait partie des **Remote Desktop Services** (RDS) de Microsoft. RDS fait l'objet d'une licence Microsoft, distincte de DataDike PAM : chaque utilisateur ou appareil qui se connecte à l'hôte a besoin d'une **licence d'accès client** (CAL) RDS, délivrée par un **serveur de licences Bureau à distance**.

Tant que l'hôte ne trouve pas de serveur de licences, Windows accorde une **période de grâce de 120 jours**. À son terme, l'hôte refuse les sessions distantes, et toutes les applications publiées et sessions web qui en dépendent s'arrêtent avec lui.

Consulter cette page lors de la préparation d'un hôte de publication, et chaque fois que l'hôte signale que sa période de grâce arrive à échéance.

La page décrit aussi la réinitialisation de la période de grâce. C'est une mesure temporaire, qui rétablit les 120 jours le temps de mettre en place les licences ; elle ne met pas l'hôte sous licence.

## Avant de commencer

* L'hôte de publication : Windows Server. Le rôle **Remote Desktop Session Host** est installé par la solution lors du déploiement de l'hôte.
* Un serveur qui jouera le rôle de **serveur de licences**. Il peut s'agir de l'hôte de publication lui-même ou d'un autre Windows Server du même réseau.
* Des **CAL RDS** achetées auprès de Microsoft ou d'un revendeur Microsoft, du type prévu par le contrat : **par utilisateur** ou **par appareil**. La version des CAL doit être égale ou postérieure à la version de Windows Server de l'hôte de publication.
* Un compte **administrateur local** sur les deux serveurs. Pour des CAL par utilisateur, les serveurs doivent appartenir à un domaine Active Directory.
* Une connectivité réseau de l'hôte de publication vers le serveur de licences.

## Étapes

### Consulter la période de grâce

1. Sur l'hôte de publication, ouvrir le **Diagnostic des licences des services Bureau à distance** (*RD Licensing Diagnoser*, `lsdiag.msc`). Il indique si l'hôte est encore en période de grâce, et si un serveur de licences et un mode de licence sont configurés.

Prévoir les licences bien avant que le décompte n'atteigne zéro.

### Installer le serveur de licences

1. Sur le serveur choisi, ouvrir **Gestionnaire de serveur › Ajouter des rôles et fonctionnalités** (*Server Manager › Add Roles and Features*), sélectionner **Remote Desktop Services** et ajouter le service de rôle **Remote Desktop Licensing**. En PowerShell, l'équivalent est :

   ```powershell
   Install-WindowsFeature RDS-Licensing -IncludeManagementTools
   ```
2. Ouvrir le **Gestionnaire de licences des services Bureau à distance** (*Remote Desktop Licensing Manager*, `licmgr.exe`), faire un clic droit sur le serveur et choisir **Activer le serveur** (*Activate Server*). Suivre l'assistant ; la connexion automatique est la méthode la plus simple lorsque le serveur accède à internet.
3. Dans un domaine, faire un clic droit sur le serveur, choisir **Vérifier la configuration** (*Review Configuration*) et ajouter le serveur au groupe **Terminal Server License Servers** si l'assistant le propose.

### Installer les CAL

1. Dans le Gestionnaire de licences, faire un clic droit sur le serveur et choisir **Installer des licences** (*Install Licenses*).
2. Sélectionner le programme de licences du contrat, saisir les données du contrat demandées par l'assistant, puis choisir la version du produit et le type de CAL, **par utilisateur** ou **par appareil**, avec la quantité achetée.

### Faire pointer l'hôte de publication vers le serveur de licences

L'hôte de publication a besoin de deux réglages : le serveur de licences à utiliser et le mode de licence. Le mode doit correspondre au type de CAL installé.

**Depuis la console**, lors du déploiement de l'hôte. Dans **Ajouter une machine d'accès virtuel**, l'étape **Automatisation** regroupe les options de déploiement RDS :

1. Activer **Licence RDS existante**.
2. Dans **Serveur de licences RDS**, saisir le nom ou l'adresse du serveur de licences.
3. Dans **Mode de licences RDS**, choisir le mode qui correspond aux CAL installées. La valeur par défaut est par appareil.

Le déploiement écrit les deux réglages dans la stratégie Bureau à distance de l'hôte. Si **Licence RDS existante** est désactivée, le déploiement ne définit pas les licences et l'hôte fonctionne sur la période de grâce de 120 jours.

**Par stratégie de groupe** (locale ou de domaine), sous **Computer Configuration › Administrative Templates › Windows Components › Remote Desktop Services › Remote Desktop Session Host › Licensing** :

1. Activer **Use the specified Remote Desktop license servers** et saisir le nom du serveur de licences.
2. Activer **Set the Remote Desktop licensing mode** et choisir **Per User** ou **Per Device**.
3. Appliquer la stratégie avec `gpupdate /force`.

**Par PowerShell**, sur l'hôte de publication :

```powershell
$ts = Get-WmiObject -Namespace root\cimv2\terminalservices -Class Win32_TerminalServiceSetting
$ts.ChangeMode(4)                                            # 4 = Per User, 2 = Per Device
$ts.SetSpecifiedLicenseServerList("licserver.example.local")
```

Les noms de stratégie ci-dessus sont ceux d'un Windows Server en anglais.

## Ce qui doit s'afficher

L'hôte de publication indique le serveur de licences et le mode de licence définis, sans avertissement de licence. Les utilisateurs continuent d'ouvrir des applications publiées et des sessions web par DataDike PAM, et le serveur de licences délivre ou comptabilise une CAL pour chaque utilisateur ou appareil qui se connecte.

## Comment vérifier que cela a fonctionné

1. Sur l'hôte de publication, ouvrir le **Diagnostic des licences des services Bureau à distance** (*RD Licensing Diagnoser*, `lsdiag.msc`). Il doit afficher le mode de licence défini, le serveur de licences, et aucun problème.
2. Ouvrir une application publiée ou une session web par DataDike PAM en tant qu'utilisateur ordinaire.
3. Dans le Gestionnaire de licences, confirmer que les CAL apparaissent comme délivrées : les CAL par appareil sont délivrées à l'appareil qui s'est connecté, les CAL par utilisateur sont comptabilisées pour l'utilisateur.
4. Noter la date, le type de CAL et la quantité installée.

## Réinitialiser la période de grâce

{% hint style="warning" %}
Réinitialiser la période de grâce **ne met pas l'hôte sous licence**. C'est une mesure temporaire, qui relance le décompte de 120 jours le temps de mettre en place les licences décrites ci-dessus. Les CAL RDS doivent être achetées et installées selon les conditions de Microsoft.
{% endhint %}

La réinitialisation est une modification directe du registre Windows sur l'hôte de publication, suivie d'un redémarrage du serveur.

### Avant de réinitialiser

* Un compte **administrateur local** sur l'hôte de publication.
* Une **sauvegarde du registre** ou un **instantané** du serveur. La procédure modifie `HKLM` directement, et la suppression qui la conclut est irréversible.
* Une **fenêtre de maintenance**. Le redémarrage ferme toutes les sessions actives sur l'hôte, y compris les applications publiées et les sessions web relayées par DataDike PAM.
* Un accès à la **console du serveur lui-même**, en local ou par l'hyperviseur. Exécuter cette procédure à travers une connexion RDP est déconseillé.

### Trouver l'entrée de la période de grâce

1. Sur l'hôte de publication, appuyer sur **Win + R**, taper `regedit` et appuyer sur **Entrée**. Lorsque le Contrôle de compte d'utilisateur le demande, cliquer sur **Oui** pour l'exécuter en tant qu'administrateur.
2. Dans le volet gauche de la fenêtre **Éditeur du Registre**, aller à :

   ```
   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\RCM\GracePeriod
   ```
3. Dans la clé **GracePeriod**, repérer l'entrée de type `REG_BINARY` dont le nom commence par `L$RTMTIMEBOMB`. C'est normalement la seule entrée de la clé.

Par défaut, les autorisations de cette entrée ne permettent ni de la modifier ni de la supprimer. Il faut d'abord les changer.

### Donner le contrôle total au groupe Administrateurs

1. Dans le volet gauche, faire un clic droit sur le dossier **GracePeriod** et choisir **Autorisations** (*Permissions*).
2. Sélectionner le groupe **Administrateurs**, cocher **Contrôle total** (*Full Control*) et cliquer sur **OK**.

Si Windows affiche une erreur à l'application de l'autorisation, prendre d'abord possession de la clé, comme décrit ci-après. Sinon, passer directement à *Supprimer l'entrée et redémarrer l'hôte*.

### Prendre possession de la clé (uniquement si l'autorisation n'a pas pu être modifiée)

1. Faire un clic droit sur le dossier **GracePeriod** et choisir de nouveau **Autorisations**, si la fenêtre a été fermée.
2. Cliquer sur **Avancé** (*Advanced*).
3. En haut de la fenêtre **Paramètres de sécurité avancés**, cliquer sur **Modifier** (*Change*), à côté du nom du propriétaire actuel.
4. Dans le champ vide, taper `Administrators` et cliquer sur **Vérifier les noms** (*Check Names*). Confirmer que le groupe local des administrateurs a été reconnu, puis cliquer sur **OK**.
5. Cocher **Remplacer le propriétaire des sous-conteneurs et des objets** (*Replace owner on subcontainers and objects*) et cliquer sur **OK**.
6. Cliquer de nouveau sur **OK** pour fermer la fenêtre des autorisations, puis donner le **Contrôle total** au groupe Administrateurs comme dans la section précédente.

### Supprimer l'entrée et redémarrer l'hôte

1. Faire un clic droit sur l'entrée `L$RTMTIMEBOMB…`, choisir **Supprimer** (*Delete*) et confirmer par **Oui** (*Yes*).
2. Appuyer sur **F5** et confirmer que l'entrée n'apparaît plus sous **GracePeriod**.
3. Fermer la fenêtre **Éditeur du Registre**.
4. Redémarrer l'hôte de publication. Le redémarrage ferme toutes les sessions actives sur lui. La période de grâce revient à 120 jours au redémarrage du serveur.

{% hint style="danger" %}
La suppression est irréversible. Avant de confirmer, s'assurer que l'entrée sélectionnée est bien `L$RTMTIMEBOMB…` dans **GracePeriod**.
{% endhint %}

### Vérifier la réinitialisation

1. Ouvrir le **RD Licensing Diagnoser** (`lsdiag.msc`), ou lire le nombre de jours restants depuis une invite PowerShell élevée sur l'hôte. L'un comme l'autre doit afficher 120 jours :

   ```powershell
   (Invoke-WmiMethod -Path (Get-WmiObject -Namespace root\cimv2\terminalservices -Class Win32_TerminalServiceSetting).__PATH -Name GetGracePeriodDays).DaysLeft
   ```
2. Ouvrir une application publiée ou une session web par DataDike PAM, et confirmer qu'elle se connecte.
3. Noter la date de la réinitialisation, et la date à laquelle les licences doivent être en place.

## Erreurs courantes

| Symptôme                                                                                                                    | Cause                                                                                                                                    | Solution                                                                                   |
| --------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| Les utilisateurs sont déconnectés avec un message indiquant qu'aucun serveur de licences Bureau à distance n'est disponible | La période de grâce a expiré et l'hôte n'a pas de serveur de licences                                                                    | Installer et activer un serveur de licences avec des CAL, et y faire pointer l'hôte        |
| **RD Licensing Diagnoser** indique que le mode de licence n'est pas configuré                                               | Le mode n'a jamais été défini sur l'hôte de publication, par exemple parce qu'il a été déployé avec **Licence RDS existante** désactivée | Définir **Per User** ou **Per Device** par stratégie ou par PowerShell                     |
| **RD Licensing Diagnoser** indique que le serveur de licences n'est pas disponible                                          | Nom de serveur erroné, ou réseau bloqué entre les deux serveurs                                                                          | Vérifier le nom dans la stratégie, la résolution de noms et le pare-feu entre les serveurs |
| Des CAL sont installées mais aucune n'est délivrée                                                                          | Le mode de licence ne correspond pas au type de CAL                                                                                      | Régler le mode sur le même type que les CAL installées                                     |
| Les CAL par utilisateur ne sont pas comptabilisées                                                                          | Les serveurs sont dans un groupe de travail                                                                                              | Utiliser des CAL par appareil, ou joindre les serveurs au domaine                          |
| Le serveur de licences ne peut pas installer de CAL                                                                         | Le serveur n'a pas été activé                                                                                                            | Lancer **Activer le serveur** avant **Installer des licences**                             |
| L'hôte refuse les CAL                                                                                                       | La version des CAL est antérieure à la version de Windows Server de l'hôte                                                               | Installer des CAL de la même version que l'hôte, ou postérieure                            |
| L'entrée `L$RTMTIMEBOMB` ne peut pas être supprimée                                                                         | Les autorisations de **GracePeriod** n'ont pas été modifiées                                                                             | Donner d'abord le **Contrôle total** au groupe Administrateurs sur la clé                  |
| L'application du **Contrôle total** échoue avec une erreur                                                                  | Le groupe Administrateurs n'est pas propriétaire de la clé                                                                               | Prendre possession de la clé, puis appliquer de nouveau le **Contrôle total**              |
| La période de grâce n'a pas changé après la réinitialisation                                                                | L'hôte n'a pas été redémarré, ou une autre entrée a été supprimée                                                                        | Redémarrer l'hôte et vérifier que l'entrée supprimée était bien `L$RTMTIMEBOMB`            |

## Référence des champs

| Réglage                       | Où                                                                                                                                              | Valeurs                                                                                                                                              |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Remote Desktop Licensing      | Service de rôle de Remote Desktop Services, sur le serveur de licences                                                                          | Installé et activé                                                                                                                                   |
| Type de CAL                   | Choisi à l'installation des CAL, selon le contrat                                                                                               | Par utilisateur, par appareil                                                                                                                        |
| Mode de licence               | **Mode de licences RDS** dans la console, stratégie **Set the Remote Desktop licensing mode**, ou `ChangeMode`                                  | Per User (`4`), Per Device (`2`). La valeur par défaut de la console est par appareil                                                                |
| Serveur de licences           | **Serveur de licences RDS** dans la console, stratégie **Use the specified Remote Desktop license servers**, ou `SetSpecifiedLicenseServerList` | Nom du serveur de licences                                                                                                                           |
| Période de grâce              | Windows, jusqu'à ce qu'un serveur de licences soit trouvé                                                                                       | 120 jours                                                                                                                                            |
| Entrée de la période de grâce | Clé de registre `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\RCM\GracePeriod`                                           | Entrée dont le nom commence par `L$RTMTIMEBOMB`, type `REG_BINARY`. La supprimer puis redémarrer l'hôte réinitialise la période de grâce à 120 jours |

## Pages associées

* [Prérequis système](https://wiki.datadike.com/fr/pam/deploy-operate/requirements.md)
* [Sessions RDP](https://wiki.datadike.com/fr/pam/administration/sessions/rdp.md)
* [Sessions web](https://wiki.datadike.com/fr/pam/administration/sessions/web.md)
* [Plateformes](https://wiki.datadike.com/fr/pam/administration/assets/platforms.md)
