> 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/hilfe/troubleshooting/reference-does-not-resolve.md).

# Eine Geheimnisreferenz wird nicht aufgelöst

Eine devo-Referenz beheben, die Devolutions CLI nicht auflösen kann, etwa ungültige Syntax, der falsche Workspace, ein Eintrag oder Feld, das nicht gefunden wird, oder ein Feld, das der Workspace nich

`devo secret run`, `devo secret read`, `devo secret inject` oder ein KI-Client kann eine `devo://`-Referenz nicht in einen Wert umwandeln. Mit `devo secret run` stoppt Devolutions CLI, bevor Ihr Programm startet, sodass nichts mit einem fehlenden Geheimnis läuft.

## Warum es geschieht

* Die Referenz ist nicht richtig geschrieben (`invalidSecretReference`).
* Die Referenz zeigt auf einen anderen Workspace als den ausgewählten Kontext.
* Der Tresor, der Eintrag oder das Feld ist nicht vorhanden, oder Ihr Konto kann es nicht lesen.
* Der Workspace-Typ kann dieses Feld oder diese Form der Referenz nicht lesen.
* Eine Vorlage verwendet eine Variable, die nicht festgelegt ist.

{% hint style="info" %}
Testen Sie eine Referenz, ohne ein Geheimnis zu lesen: `devo secret run --check --env-ref TEST=<reference> -- <your-command>` prüft, dass der Befehl existiert und dass jede Referenz wohlgeformt ist, ohne ein Geheimnis zu lesen oder den Befehl zu starten. Siehe [Einen Befehl mit seinen Geheimnissen ausführen](/cli/de/anleitungen/secrets/run-with-secrets.md).
{% endhint %}

## Korrigieren Sie es

{% stepper %}
{% step %}

### Kopieren Sie die Referenz erneut

Die meisten Probleme verschwinden, wenn Sie die Referenz aus Devolutions CLI kopieren, statt sie zu tippen:

```bash
devo entry references "<entry-name>" --vault-name "<vault-name>"
```

Sie listet jede Referenz des Eintrags auf, nie die Werte. Auf Devolutions Server enthält die Liste kanonische Referenzen (`devo://ws/…/vault/…/entry/…/field/…`). Verwenden Sie sie so, wie sie sind. Siehe [Die Referenz zu einem Geheimnis finden](/cli/de/anleitungen/secrets/find-a-reference.md).
{% endstep %}

{% step %}

### Korrigieren Sie die Syntax

`invalidSecretReference` kommt mit einer Meldung, die sagt, was nicht stimmt:

<table><thead><tr><th width="330">MELDUNG</th><th>KORREKTUR</th></tr></thead><tbody><tr><td>"Secret reference must start with 'devo://'."</td><td>Fügen Sie das Präfix <code>devo://</code> hinzu.</td></tr><tr><td>"Use devo://&#x3C;workspace>/&#x3C;vault>/&#x3C;entry>/&#x3C;field> or devo://&#x3C;workspace>/&#x3C;vault>/&#x3C;entry>/&#x3C;section>/&#x3C;field>."</td><td>Eine benannte Referenz hat vier Teile, oder fünf mit einem Abschnitt. Prüfen Sie auf ein fehlendes oder zusätzliches <code>/</code>. Ein Name, der ein <code>/</code> enthält, muss als <code>%2F</code> geschrieben werden.</td></tr><tr><td>"Secret reference path segments cannot be empty."</td><td>Entfernen Sie das doppelte <code>//</code> im Pfad.</td></tr><tr><td>"Canonical ID references must use devo://ws/&#x3C;id>/vault/&#x3C;id>/entry/&#x3C;id>/field/&#x3C;field>."</td><td>Behalten Sie die Wörter <code>ws</code>, <code>vault</code>, <code>entry</code> und <code>field</code> in dieser Reihenfolge bei, jedes gefolgt von seinem Wert.</td></tr><tr><td>"Secret references do not support URI fragments."</td><td>Entfernen Sie <code>#</code> und das, was darauf folgt.</td></tr></tbody></table>

`unsupportedSecretAttribute` bedeutet, dass der Teil `?attribute=` nicht `value`, `type`, `id`, `title`, `purpose` oder `otp` ist. Er erscheint auch, wenn ein Befehl den Geheimniswert braucht, zum Beispiel `devo secret run`, und die Referenz ein anderes Attribut verlangt: bei jedem Workspace-Typ kann ein Wert nur aus `value` kommen. Entfernen Sie den Teil `?attribute=`, oder setzen Sie ihn auf `value`. Die wertfreien Attribute `type`, `id`, `title` und `purpose` funktionieren mit `devo secret read` und `devo secret get` bei allen drei Workspace-Typen. Die vollständige Syntax steht in [Syntax der Geheimnisreferenz](/cli/de/referenz/secret-references.md).
{% endstep %}

{% step %}

### Verwenden Sie den richtigen Kontext

Der erste Teil einer benannten Referenz ist der Workspace. Auf Devolutions Cloud und Devolutions Server muss er zum ausgewählten Kontext passen, sonst lehnt Devolutions CLI mit `providerSelectionChanged` ab: "The secret reference workspace does not match the selected cloud source context."

1. Prüfen Sie den ausgewählten Kontext:

   ```bash
   devo status
   ```
2. Führen Sie den Befehl mit dem Kontext aus, zu dem die Referenz gehört:

   ```bash
   devo secret run --context <context-name> --env-ref DB_PASSWORD=<reference> -- <your-command>
   ```

Um diesen Kontext zum Standard zu machen, verwenden Sie `devo context use <context-name>`. Siehe [Zwischen Workspaces wechseln](/cli/de/anleitungen/connect/switch-workspaces.md).
{% endstep %}

{% step %}

### Prüfen Sie, dass der Eintrag und das Feld vorhanden sind

* `entryNotFound` oder `vaultNotFound`: Der Name passt zu nichts, was Ihr Konto sehen kann. Prüfen Sie die Schreibweise mit `devo entry list "<entry-name>" --vault-name "<vault-name>"`. Ein umbenannter Eintrag macht eine benannte Referenz ungültig: Wechseln Sie zur kanonischen Referenz, die IDs verwendet und Umbenennungen übersteht.
* `entrySelectorAmbiguous`: mehrere Einträge teilen diesen Namen. Verwenden Sie die kanonische Referenz.
* `serverSecretNotFound`: Devolutions Server hat das Feld nicht gefunden, oder dieses Konto darf es nicht lesen.
* `cloudSecretFieldUnavailable`: Devolutions Cloud kann dieses Feld für diesen Eintrag nicht zurückgeben. Prüfen Sie, dass das Feld ausgefüllt ist.
  {% endstep %}

{% step %}

### Verwenden Sie ein Feld, das der Workspace lesen kann

Jeder Workspace-Typ liest andere Felder. `devo secret capabilities` listet sie auf, ohne ein Geheimnis zu lesen.

* **Devolutions Cloud** liest die Hauptfelder eines Eintrags, etwa `password`, `username`, `domain`, `host`, `port`, `url` und `privatekey`, ohne Abschnitt. Eine Referenz mit einem Abschnitt stoppt mit `unsupportedSecretField`.
* **Devolutions Server** liest eine Eintragsdateneigenschaft, etwa `password` oder `username`, ohne einen Abschnitt.
* `--stdin-reference` von `devo secret run` nimmt eine einzige genaue `devo://`-Referenz, benannt oder kanonisch. Alles andere stoppt mit `invalidSecretStdinReference`.
  {% endstep %}

{% step %}

### Legen Sie die Variablen fest, die die Referenz verwendet

In einer von `devo secret inject` gefüllten Vorlage kann eine Referenz Umgebungsvariablen enthalten, etwa `devo://${WORKSPACE}/…`, mit einem optionalen Standardwert: `${WORKSPACE:-<default>}`. `missingSecretReferenceVariable` bedeutet, dass eine Variable nicht gesetzt ist und keinen Standardwert hat: "Environment variable '\<name>' is required by the secret reference." Setzen Sie sie in dem Terminal oder der Pipeline, die den Befehl ausführt. Ein `${` ohne schließendes `}` wird ebenfalls abgelehnt. Siehe [Eine Konfigurationsdatei aus einer Vorlage füllen](/cli/de/anleitungen/secrets/fill-a-template.md).
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
`devo secret run` lehnt eine Referenz ab, die als Argument Ihres Befehls geschrieben ist (`secretLaunchArgumentReference`). Übergeben Sie sie stattdessen mit `--env-ref`, `--stdin-reference` oder einem Startmanifest.
{% endhint %}

## Schlägt es immer noch fehl?

Stellen Sie sicher, dass Sie angemeldet sind: Eine abgelaufene Sitzung stoppt die Auflösung ebenfalls. Siehe [Die Anmeldung schlägt fehl oder die Sitzung ist abgelaufen](/cli/de/hilfe/troubleshooting/sign-in-fails.md). Dann [Diagnosedaten sammeln](/cli/de/hilfe/troubleshooting/collect-diagnostics.md) und den [Devolutions-Support](https://devolutions.net/support/) kontaktieren. Senden Sie die Referenz, wenn Sie möchten, sie enthält kein Geheimnis, aber niemals den Wert.


---

# 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/hilfe/troubleshooting/reference-does-not-resolve.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.