> 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/gateway/fr/knowledge-base/how-to-articles/use-windows-certificate-store-for-devolutions-gateway.md). # Utiliser le magasin de certificats Windows pour Devolutions Gateway Configurez Devolutions Gateway pour qu'il obtienne son certificat TLS à partir du magasin de certificats Windows plutôt que d'un fichier de certificat. {% hint style="warning" %} Si vos clients n'arrivent pas à se connecter à Devolutions Gateway, assurez-vous que le certificat contient toute la chaîne. Cette chaîne de certificats inclut tous les certificats intermédiaires. Par exemple : Autorité de certification racine – Autorité de certification sécurisée – Certificat XYZ acheté. {% endhint %} Il est possible d'utiliser le magasin de certificats Windows comme source de certificat TLS. Au lieu d'utiliser un fichier, stockez et gérez vos certificats avec Windows. Au moment d'écrire ces lignes, cette fonctionnalité n'est pas exposée dans l'interface graphique de la console de configuration de Devolutions Gateway. Pour la configurer, vous devez soit modifier directement le fichier gateway.json, soit utiliser le module Devolutions.PowerShell. Avec la nouvelle fonctionnalité, [quelques paramètres supplémentaires](https://github.com/Devolutions/devolutions-gateway#configuration) sont disponibles pour configurer la source du certificat. {% hint style="info" %} Si vous avez déjà défini une configuration `TlsCertificateFile` et/ou `TlsPrivateKeyFile`, il n'est pas nécessaire de la supprimer, car `TlsCertificateSource` indique à Devolutions Gateway où chercher le certificat. {% endhint %} * **TlsCertificateSource** (chaîne) : source du certificat TLS, les valeurs possibles sont indiquées ci-dessous. * **External** (par défaut) : récupérer un certificat stocké sur le système de fichiers. Voir les options `TlsCertificateFile`, `TlsPrivateKeyFile` et `TlsPrivateKeyPassword`. * **System** : récupérer le certificat géré par le magasin de certificats du système. Voir les options `TlsCertificateSubjectName`, `TlsCertificateStoreName` et `TlsCertificateStoreLocation`. * **TlsCertificateSubjectName** (chaîne) : nom du sujet du certificat pour TLS lorsque la source System est utilisée. * **TlsCertificateStoreName** (chaîne) : nom du magasin de certificats système à utiliser pour TLS (la valeur par défaut est My). * **TlsCertificateStoreLocation** (chaîne) : emplacement du magasin de certificats système à utiliser pour TLS, les valeurs possibles sont indiquées ci-dessous. * **CurrentUser** (par défaut) * **CurrentService** * **LocalMachine** ## Importation du certificat dans le magasin de certificats Windows D'abord, importez votre certificat dans le magasin de certificats Windows. Windows prend en charge les formats de certificat suivants : * Certificat X.509 - \*.cer, \*.crt * Échange d'informations personnelles - \*.pfx, \*.p12 * Magasin de certificats sérialisés Microsoft - \*.sst * Certificats PKCS #7 - \*.spc, \*.p7b {% hint style="info" %} Si vous utilisez la méthode `External` via `TlsCertificateSource`, Devolutions Gateway prend uniquement en charge le regroupement de la clé publique et de la clé privée dans un fichier PFX (PKCS#12). Sinon, vous devrez également définir le paramètre `TlsPrivateKeyFile`. {% endhint %} ### Convertir un certificat X.509 Devolutions Gateway exige une clé privée avec le certificat TLS; vous devrez donc peut-être combiner la clé publique avec sa clé privée. Voici deux méthodes : [Remote Desktop Manager](#using-remote-desktop-manager) et l'[utilitaire Windows intégré certutil](#using-the-windows-certutil-utility). #### Utiliser Remote Desktop Manager L'entrée ***Certificat X.509*** peut être utilisée pour importer ledit certificat et l'exporter dans plusieurs formats différents, y compris PFX. 1. Dans Remote Desktop Manager, cliquez sur ***Nouvelle entrée*** – ***Gestion des identifiants*** – ***Général*** – ***Certificat X.509***. 2. Sélectionnez le certificat et cliquez sur ***Ouvrir***. 3. Cliquez sur ***Suivant***. 4. Cliquez sur les points de suspension et sélectionnez la ***clé privée***. 5. Cliquez sur ***Ouvrir***.

La clé privée doit avoir l'extension .key.

6. Cliquez sur ***Terminer***. 7. Remplissez les informations, puis cliquez sur ***Ajouter***. 8. Sélectionnez l'entrée et cliquez sur ***Enregistrer le certificat sous*** (également disponible dans le menu contextuel du clic droit). 9. Dans le champ ***Format d'exportation***, choisissez ***Échange d'informations personnelles (pfx)***. 10. Choisissez l'emplacement où le fichier sera enregistré en cliquant sur les points de suspension. 11. Saisissez un mot de passe robuste, puis cliquez sur ***Exporter***. #### Utiliser l'utilitaire Windows `certutil` Utilisez l'utilitaire Windows intégré `certutil` pour combiner un fichier de certificat (`.crt` ou `.cer`) et sa clé privée (`.key`). Les deux fichiers doivent porter le même nom. `certutil -MergePFX file.crt file.pfx` ### Importation du certificat Après avoir obtenu le certificat et le fichier de clé privée du certificat, importez-le dans Windows. 1. Installez le certificat : * Si Windows détecte automatiquement le certificat, double-cliquez dessus et choisissez ***Installer le certificat...***; ou * Ouvrez `certmgr.msc` à l'emplacement de magasin voulu (`LocalMachine` ou `CurrentUser`), faites un clic droit sur l'emplacement souhaité (ex. : ***Personnel/Certificats***) et choisissez ***Toutes les tâches*** – ***Importer***. 2. Choisissez l'une des options suivantes et cliquez sur ***Suivant*** : * ***Sélectionner automatiquement le magasin de certificats selon le type de certificat***; ou * ***Placer tous les certificats dans le magasin suivant*** et cliquez sur ***Parcourir...*** pour choisir un dossier. 3. Terminez l'importation en cliquant sur ***Terminer***. ## Accorder au service Devolutions Gateway l'autorisation de lecture sur la clé privée du certificat Par défaut, Devolutions Gateway exécute son service à l'aide du compte Network Service. Pour utiliser un certificat du magasin de certificats local, assurez-vous que le compte Network Service dispose des autorisations de lecture sur la clé privée du certificat. 1. Ouvrez le magasin de certificats local et naviguez jusqu'au certificat. 2. Faites un clic droit sur le certificat et sélectionnez ***Toutes les tâches*** – ***Gérer les clés privées***. 3. Cliquez pour ajouter un nom d'utilisateur. 4. Écrivez « NETWORK SERVICE » dans le champ des noms d'objets, puis cliquez sur ***OK***. 5. Sélectionnez le nouveau nom d'utilisateur ***NETWORK SERVICE*** et autorisez la permission de ***lecture*** sur celui-ci. 6. Cliquez sur ***Appliquer***, puis sur ***OK***. ## Configuration du magasin de certificats Windows via gateway.json L'emplacement par défaut du fichier `gateway.json` est le répertoire **%ProgramData%\Devolutions\Gateway**. Assurez-vous que le fichier est un `.json` valide en le testant avec : ```powershell $Config = ("{0}\Devolutions\Gateway\gateway.json" -F $Env:ProgramData) Try { Get-Content -Path $Config | ConvertFrom-JSON -ErrorAction 'Stop' } Catch { $PSItem[0].Exception.Message } ``` Cela fonctionne avec PowerShell 5.1 et les versions ultérieures (la version recommandée est PowerShell 7.x). Une configuration typique est présentée ci-dessous. Vos valeurs peuvent différer, particulièrement le ***nom du sujet***, puisqu'il reflétera le nom de domaine auquel Devolutions Gateway répond. Les valeurs importantes à modifier sont : * `TlsCertificateSource` - `System` * `TlsCertificateSubjectName` - `gateway.ad.it-help.ninja` * `TlsCertificateStoreName` - `My` * `TlsCertificateStoreLocation` - `LocalMachine` Un exemple du fichier de configuration complet : ```json { "Id": "c912b379-8c34-449d-8ff3-3aa20a9cc3e4", "Hostname": "gateway.ad.it-help.ninja", "TlsCertificateFile": "server.crt", "TlsPrivateKeyFile": "server.key", "TlsCertificateSource": "System", "TlsCertificateSubjectName": "gateway.ad.it-help.ninja", "TlsCertificateStoreName": "My", "TlsCertificateStoreLocation": "LocalMachine", "ProvisionerPublicKeyFile": "provisioner.pem", "Listeners": [ { "InternalUrl": "https://*:7171", "ExternalUrl": "https://*:7171" }, { "InternalUrl": "tcp://*:8181", "ExternalUrl": "tcp://*:8181" } ] } ``` 1. Exécutez le script ci-dessus. 2. Ouvrez `services.msc`. 3. Faites un clic droit sur ***Devolutions Gateway Service*** et sélectionnez ***Redémarrer***. 4. Vérifiez que Devolutions Gateway fonctionne correctement en naviguant vers `https://{FQDN}:7171/jet/health` (en remplaçant `{FQDN}` par l'adresse DNS de votre Gateway) avec un navigateur Web. ## Configuration du magasin de certificats Windows via PowerShell Devolutions Gateway peut également être configuré au moyen de commandes PowerShell. Le [module PowerShell de Devolutions Gateway](https://www.powershellgallery.com/packages/DevolutionsGateway/) expose de nombreuses commandes pour le configurer. Par défaut, une installation de Devolutions Gateway inclut le module dans le répertoire d'installation. Importez le module de la façon suivante : ```powershell # Import the Module Import-Module -Name "C:\Program Files\Devolutions\Gateway\PowerShell\Modules\DevolutionsGateway" # View the imported Modules Get-Module ``` Une autre méthode pour rendre le module facilement accessible est de l'installer de la façon suivante : ```powershell # Install the DevolutionsGateway module Install-Module -Name 'DevolutionsGateway' # Update the module if installed via the above method (will not update the bundled version installed with Gateway) Update-Module -Name 'DevolutionsGateway' # Import the Module Import-Module -Name 'DevolutionsGateway' # View the imported modules to verify the DevolutionsGateway module is available Get-Module ``` Une fois importé, vous pouvez voir la configuration actuelle au moyen de la commande suivante : ```powershell Get-DGatewayConfig ``` Pour indiquer à Devolutions Gateway d'utiliser le magasin Windows, utilisez la commande suivante : ```powershell # Update the configuration; this will not remove any existing parameters, only configure those defined. # Replace the '{FQDN}` example with the fully-qualified DNS name of the Gateway address Set-DGatewayConfig -TlsCertificateSource "System" -TlsCertificateSubjectName "{FQDN}" -TlsCertificateStoreLocation "LocalMachine" -TlsCertificateStoreName "My" # Display the updated configuration Get-DGatewayConfig ``` Redémarrez le service pour que la configuration prenne effet. ```powershell Restart-Service -Name 'DevolutionsGateway' ``` Vérifiez que Devolutions Gateway fonctionne correctement en naviguant vers `https://{FQDN}:7171/jet/health` avec un navigateur Web. --- # 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/gateway/fr/knowledge-base/how-to-articles/use-windows-certificate-store-for-devolutions-gateway.md?ask=&goal= ``` `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.