> 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/de/anleitungen/secrets/find-a-reference.md). # Die Referenz zu einem Geheimnis finden Die devo-Referenz eines Passworts oder eines anderen Feldes mit Devolutions CLI finden, ohne das Geheimnis selbst zu lesen oder anzuzeigen. Jeder Devolutions CLI-Befehl, der ein Geheimnis verwendet, nimmt eine **Referenz**: die Adresse eines Feldes, die mit `devo://` beginnt. Eine Referenz zu finden liest nie das Geheimnis, daher können Sie das überall tun, auch vor einem KI-Agenten oder in einem gemeinsamen Terminal. ## Den Eintrag finden Wenn Sie den genauen Namen des Eintrags nicht kennen, suchen Sie ihn zuerst: ```bash devo entry list "" --vault-name "" ``` `devo entry list` gibt standardmäßig bis zu 100 Einträge zurück (`--limit` ändert das). Sie können auch nach Eintragstyp mit `--type` filtern. Um einen anderen Workspace als den aktuellen zu durchsuchen, fügen Sie `--context ` hinzu. Siehe [Zwischen Workspaces wechseln](/cli/de/anleitungen/connect/switch-workspaces.md). ## Die Referenzen des Eintrags auflisten ```bash devo entry references "" --vault-name "" ``` Um den Eintrag nach ID auszuwählen, schreiben Sie `id:` oder fügen Sie `--id` hinzu. `devo secret catalog entry` nimmt dieselben Argumente und gibt dasselbe Ergebnis zurück. Devolutions CLI gibt eine Zeile pro Feld aus, das es auflösen kann, mit der zu kopierenden Referenz: ``` Secret references: 2 password (secret): devo://ws//vault//entry//field/password username: devo://ws//vault//entry//field/username ``` Der Befehl betrachtet die Felder `password`, `username`, `host`, `domain` und `url` des Eintrags. Er zeigt die kanonische Referenz, wenn die IDs bekannt sind, und sonst die benannte Referenz. Mit `--output json` listet jedes Feld beide Formen auf. Siehe [Ergebnisse als JSON lesen](/cli/de/fur-devops-und-administratoren/automate/json-output.md). ## Benannte oder kanonische Referenz
FORMSIEHT AUS WIEVERWENDEN, WENN
Benanntdevo://<workspace>/<vault>/<entry>/<field>Sie wollen eine Referenz, die Menschen lesen können. Sie wird gegen den aktuellen Kontext aufgelöst, oder gegen den, den Sie mit --context auswählen, und funktioniert nicht mehr, wenn der Eintrag oder der Tresor umbenannt wird.
Kanonischdevo://ws/<workspace-id>/vault/<vault-id>/entry/<entry-id>/field/<field>Sie committen die Referenz oder geben sie weiter. Sie funktioniert nach einer Umbenennung weiter und wird immer gegen den Workspace aufgelöst, dem sie gehört, unabhängig vom ausgewählten Kontext. Ein Befehl kann kanonische Referenzen aus mehreren Workspaces mischen.
Auf Devolutions Server listet `devo entry references` nur kanonische Referenzen auf. Jeder Teil einer Referenz wird URL-dekodiert. Wenn ein Name ein `/` oder ein `#` enthält, schreiben Sie ihn als `%2F` oder `%23`. ## Auf ein Feld in einem Abschnitt zeigen Bei einem lokalen Profil gruppieren manche Einträge Felder in Abschnitten. Fügen Sie in einer benannten Referenz den Abschnitt zwischen dem Eintrag und dem Feld ein: ``` devo://///
/ ``` `devo secret get` nimmt den Abschnitt mit `--section`. Abschnitte funktionieren nur mit lokalen Profilen: Devolutions Cloud und Devolutions Server lehnen eine Referenz mit einem Abschnitt ab, und kanonische Referenzen haben keinen Abschnitt. ## Ein Attribut statt des Werts lesen Fügen Sie `?attribute=` (oder `?attr=`) zu einer Referenz hinzu, um etwas anderes als den Wert zu lesen. `devo secret read` und `devo secret get` akzeptieren auch `--attribute`.
ATTRIBUTWAS SIE BEKOMMEN
valueDer Geheimniswert. Dies ist der Standard.
typeDie Art des Felds. Die Werte hängen vom Workspace-Typ ab.
idDie ID des Eintrags.
titleDer Name des Eintrags. Leer für eine kanonische Referenz auf Devolutions Cloud und Devolutions Server.
purposeAuf Devolutions Cloud und Devolutions Server, warum der Wert angefordert wurde, etwa read. Leer bei einem lokalen Profil.
`type`, `id`, `title` und `purpose` sind wertfreie Lesevorgänge: Devolutions CLI gibt sie zurück, ohne das Geheimnis zu lesen, auf Devolutions Cloud, Devolutions Server und lokalen Profilen. Das ist eine sichere erste Prüfung einer Referenz, ohne das Geheimnis zu lesen: ```bash devo secret read "?attribute=type" ``` Setzen Sie die Referenz in Anführungszeichen, damit Ihre Shell das `?` nicht interpretiert. Ein Erfolg bestätigt, dass die Referenz wohlgeformt ist und, bei einer benannten Referenz oder einem lokalen Profil, dass der Tresor und der Eintrag existieren. Es beweist nicht, dass das Feld gelesen werden kann: Auf Devolutions Cloud und Devolutions Server wird eine kanonische Referenz überhaupt nicht nachgeschlagen. Nur das Lesen des Werts bestätigt das Feld. ## Welche Felder jeder Workspace-Typ lesen kann `devo secret capabilities` beschreibt für Devolutions Cloud, Devolutions Server und lokale Profile, welche Felder gelesen und geschrieben werden können. Es liest keinen Kontext und kein Geheimnis. Fügen Sie `--output json` für die vollständige Feldliste hinzu; die Textausgabe zeigt nur eine Zusammenfassung. ```bash devo secret capabilities --output json ``` ## Wenn es nicht funktioniert * Der Befehl sagt, dass die Referenz ungültig ist oder dass der Eintrag oder das Feld nicht gefunden wird: siehe [Eine Geheimnisreferenz wird nicht aufgelöst](/cli/de/hilfe/troubleshooting/reference-does-not-resolve.md). * Ein Feld fehlt in der Liste: Der Eintrag hat es vielleicht nicht, oder Ihr Workspace-Typ kann es nicht auflösen. Siehe [Workspace-Typen vergleichen](/cli/de/anleitungen/understand/workspace-types.md). ## Weiter * [Run a command with its secrets](/cli/de/anleitungen/secrets/run-with-secrets.md) * [Secret reference syntax](/cli/de/referenz/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/de/anleitungen/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.