> 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/cli/fr/guides/secrets/find-a-reference.md). # Trouver la référence d’un secret Trouver la référence devo d’un mot de passe ou d’un autre champ avec Devolutions CLI, sans lire ni afficher le secret lui-même. Chaque commande Devolutions CLI qui utilise un secret prend une **référence** : l’adresse d’un champ, qui commence par `devo://`. Trouver une référence ne lit jamais le secret, donc vous pouvez le faire n’importe où, y compris devant un agent d’IA ou dans un terminal partagé. ## Trouver l’entrée Si vous ne connaissez pas le nom exact de l’entrée, cherchez-la d’abord : ```bash devo entry list "" --vault-name "" ``` `devo entry list` retourne jusqu’à 100 entrées par défaut (`--limit` change cela). Vous pouvez aussi filtrer par type d’entrée avec `--type`. Pour chercher dans un autre espace de travail que l’actuel, ajoutez `--context `. Consultez [Basculer entre les espaces de travail](/cli/fr/guides/connect/switch-workspaces.md). ## Lister les références de l’entrée ```bash devo entry references "" --vault-name "" ``` Pour sélectionner l’entrée par ID, écrivez `id:` ou ajoutez `--id`. `devo secret catalog entry` prend les mêmes arguments et renvoie le même résultat. Devolutions CLI affiche une ligne par champ qu’il peut résoudre, avec la référence à copier : ``` Secret references: 2 password (secret): devo://ws//vault//entry//field/password username: devo://ws//vault//entry//field/username ``` La commande examine les champs `password`, `username`, `host`, `domain` et `url` de l’entrée. Elle affiche la référence canonique lorsque les ID sont connus, et la référence nommée sinon. Avec `--output json`, chaque champ liste les deux formes. Consultez [Lire les résultats en JSON](/cli/fr/pour-le-devops-et-les-administrateurs/automate/json-output.md). ## Référence nommée ou canonique
FORMERESSEMBLE ÀÀ UTILISER QUAND
Nomméedevo://<workspace>/<vault>/<entry>/<field>Vous voulez une référence que les gens peuvent lire. Elle se résout sur le contexte actuel, ou sur celui que vous sélectionnez avec --context, et cesse de fonctionner si l’entrée ou le coffre est renommé.
Canoniquedevo://ws/<workspace-id>/vault/<vault-id>/entry/<entry-id>/field/<field>Vous consignez la référence ou vous la partagez. Elle continue de fonctionner après un renommage, et elle se résout toujours sur l’espace de travail qui la possède, quel que soit le contexte sélectionné. Une commande peut mélanger des références canoniques de plusieurs espaces de travail.
Sur Devolutions Server, `devo entry references` n’énumère que des références canoniques. Chaque partie d’une référence est décodée comme une URL. Si un nom contient un `/` ou un `#`, écrivez-le sous la forme `%2F` ou `%23`. ## Pointer vers un champ dans une section Sur un profil local, certaines entrées regroupent les champs en sections. Dans une référence nommée, ajoutez la section entre l’entrée et le champ : ``` devo://///
/ ``` `devo secret get` prend la section avec `--section`. Les sections ne fonctionnent qu’avec les profils locaux : Devolutions Cloud et Devolutions Server refusent une référence avec une section, et les références canoniques n’ont pas de section. ## Lire un attribut au lieu de la valeur Ajoutez `?attribute=` (ou `?attr=`) à une référence pour lire autre chose que la valeur. `devo secret read` et `devo secret get` acceptent aussi `--attribute`.
ATTRIBUTCE QUE VOUS OBTENEZ
valueLa valeur du secret. C’est la valeur par défaut.
typeLe type de champ. Les valeurs dépendent du type d’espace de travail.
idL’ID de l’entrée.
titleLe nom de l’entrée. Vide pour une référence canonique sur Devolutions Cloud et Devolutions Server.
purposeSur Devolutions Cloud et Devolutions Server, pourquoi la valeur a été demandée, comme read. Vide sur un profil local.
`type`, `id`, `title` et `purpose` sont des lectures sans valeur : Devolutions CLI les renvoie sans lire le secret, sur Devolutions Cloud, Devolutions Server et les profils locaux. C’est une première vérification sûre d’une référence, sans lire le secret : ```bash devo secret read "?attribute=type" ``` Mettez la référence entre guillemets pour que votre shell n’interprète pas le `?`. Une réussite confirme que la référence est bien formée et, pour une référence nommée ou sur un profil local, que le coffre et l’entrée existent. Cela ne prouve pas que le champ peut être lu : sur Devolutions Cloud et Devolutions Server, une référence canonique n’est pas recherchée du tout. Seule la lecture de la valeur confirme le champ. ## Quels champs chaque type d’espace de travail peut lire `devo secret capabilities` décrit, pour Devolutions Cloud, Devolutions Server et les profils locaux, quels champs peuvent être lus et écrits. Il ne lit aucun contexte ni aucun secret. Ajoutez `--output json` pour la liste complète des champs ; la sortie texte n’affiche qu’un résumé. ```bash devo secret capabilities --output json ``` ## Si cela ne fonctionne pas * La commande dit que la référence n’est pas valide, ou que l’entrée ou le champ est introuvable : consultez [Une référence de secret ne se résout pas](/cli/fr/aide/troubleshooting/reference-does-not-resolve.md). * Un champ manque dans la liste : l’entrée ne l’a peut-être pas, ou votre type d’espace de travail ne peut pas le résoudre. Consultez [Comparer les types d’espace de travail](/cli/fr/guides/understand/workspace-types.md). ## Suivant * [Run a command with its secrets](/cli/fr/guides/secrets/run-with-secrets.md) * [Secret reference syntax](/cli/fr/reference/secret-references.md) --- # 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/cli/fr/guides/secrets/find-a-reference.md?ask=&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.