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

# En hemmelighedsreference løses ikke

Ret en devo-reference som Devolutions CLI ikke kan løse, såsom ugyldig syntaks, et forkert arbejdsområde, en post eller et felt der ikke findes, eller et felt arbejdsområdet ikke kan læse.

`devo secret run`, `devo secret read`, `devo secret inject` eller en AI-klient kan ikke gøre en `devo://`-reference til en værdi. Med `devo secret run` stopper Devolutions CLI før programmet starter, så der kører intet med en manglende hemmelighed.

## Hvorfor det sker

* Referencen er ikke skrevet korrekt (`invalidSecretReference`).
* Referencen peger på et andet arbejdsområde end den valgte kontekst.
* Boksen, posten eller feltet findes ikke, eller Deres konto kan ikke læse det.
* Arbejdsområdetypen kan ikke læse det felt eller den form for reference.
* En skabelon bruger en variabel der ikke er angivet.

{% hint style="info" %}
Test en reference uden at læse nogen hemmelighed. `devo secret run --check --env-ref TEST=<reference> -- <your-command>` kontrollerer at kommandoen findes, og at hver reference er velformet, uden at læse nogen hemmelighed eller starte kommandoen. Se [Kør en kommando med dens hemmeligheder](/cli/da/vejledninger/secrets/run-with-secrets.md).
{% endhint %}

## Ret den

{% stepper %}
{% step %}

### Kopiér referencen igen

De fleste problemer forsvinder når De kopierer referencen fra Devolutions CLI i stedet for at skrive den.

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

Den viser hver reference for posten, aldrig værdierne. På Devolutions Server indeholder listen kanoniske referencer (`devo://ws/…/vault/…/entry/…/field/…`). Brug dem som de er. Se [Find referencen til en hemmelighed](/cli/da/vejledninger/secrets/find-a-reference.md).
{% endstep %}

{% step %}

### Ret syntaksen

`invalidSecretReference` kommer med en meddelelse der siger hvad der er galt.

<table><thead><tr><th width="330">MEDDELELSE</th><th>RET</th></tr></thead><tbody><tr><td>"Secret reference must start with 'devo://'."</td><td>Tilføj præfikset <code>devo://</code>.</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>En navngiven reference har fire dele, eller fem med en sektion. Kontrollér om der mangler et <code>/</code>, eller om der er et for meget. Et navn der indeholder et <code>/</code>, skal skrives <code>%2F</code>.</td></tr><tr><td>"Secret reference path segments cannot be empty."</td><td>Fjern det dobbelte <code>//</code> inde i stien.</td></tr><tr><td>"Canonical ID references must use devo://ws/&#x3C;id>/vault/&#x3C;id>/entry/&#x3C;id>/field/&#x3C;field>."</td><td>Behold ordene <code>ws</code>, <code>vault</code>, <code>entry</code> og <code>field</code> i den rækkefølge, hver efterfulgt af sin værdi.</td></tr><tr><td>"Secret references do not support URI fragments."</td><td>Fjern <code>#</code> og det der følger efter.</td></tr></tbody></table>

`unsupportedSecretAttribute` betyder, at delen `?attribute=` ikke er en af `value`, `type`, `id`, `title`, `purpose` eller `otp`. Den vises også, når en kommando har brug for hemmelighedens værdi, for eksempel `devo secret run`, og referencen beder om en anden attribut. På alle arbejdsområdetyper kan en værdi kun komme fra `value`. Fjern delen `?attribute=`, eller sæt den til `value`. Attributterne uden værdi `type`, `id`, `title` og `purpose` virker med `devo secret read` og `devo secret get` på alle tre arbejdsområdetyper. Den fulde syntaks står i [Syntaks for hemmelighedsreferencer](/cli/da/reference/secret-references.md).
{% endstep %}

{% step %}

### Brug den rigtige kontekst

Den første del af en navngiven reference er arbejdsområdet. På Devolutions Cloud og Devolutions Server skal den matche den valgte kontekst, ellers afviser Devolutions CLI med `providerSelectionChanged`: "The secret reference workspace does not match the selected cloud source context."

1. Kontrollér den valgte kontekst.

   ```bash
   devo status
   ```
2. Kør kommandoen med den kontekst referencen tilhører.

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

For at gøre den kontekst til standard skal De bruge `devo context use <context-name>`. Se [Skift mellem arbejdsområder](/cli/da/vejledninger/connect/switch-workspaces.md).
{% endstep %}

{% step %}

### Kontrollér at posten og feltet findes

* `entryNotFound` eller `vaultNotFound`: navnet matcher ikke noget kontoen kan se. Kontrollér stavningen med `devo entry list "<entry-name>" --vault-name "<vault-name>"`. En omdøbt post bryder en navngiven reference. Skift til den kanoniske reference, som bruger id’er og overlever omdøbninger.
* `entrySelectorAmbiguous`. Flere poster deler det navn. Brug den kanoniske reference.
* `serverSecretNotFound`. Devolutions Server fandt ikke feltet, eller denne konto må ikke læse det.
* `cloudSecretFieldUnavailable`. Devolutions Cloud kan ikke returnere det felt for denne post. Kontrollér at feltet er udfyldt.
  {% endstep %}

{% step %}

### Brug et felt som arbejdsområdet kan læse

Hver arbejdsområdetype læser forskellige felter. `devo secret capabilities` viser dem uden at læse nogen hemmelighed.

* **Devolutions Cloud** læser de vigtigste felter i en post, såsom `password`, `username`, `domain`, `host`, `port`, `url` og `privatekey`, uden sektion. En reference med en sektion stopper med `unsupportedSecretField`.
* **Devolutions Server** læser én dataegenskab for posten, såsom `password` eller `username`, uden en sektion.
* `--stdin-reference` af `devo secret run` tager én nøjagtig `devo://`-reference, navngiven eller kanonisk. Alt andet stopper med `invalidSecretStdinReference`.
  {% endstep %}

{% step %}

### Angiv de variabler referencen bruger

I en skabelon udfyldt af `devo secret inject` kan en reference indeholde miljøvariabler, såsom `devo://${WORKSPACE}/…`, med en valgfri standardværdi: `${WORKSPACE:-<default>}`. `missingSecretReferenceVariable` betyder, at en variabel ikke er angivet og ikke har en standardværdi: "Environment variable '\<name>' is required by the secret reference." Angiv den i den terminal eller pipeline, der kører kommandoen. Et `${` uden den afsluttende `}` afvises også. Se [Udfyld en konfigurationsfil fra en skabelon](/cli/da/vejledninger/secrets/fill-a-template.md).
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
`devo secret run` afviser en reference der er skrevet som et argument til kommandoen (`secretLaunchArgumentReference`). Angiv den med `--env-ref`, `--stdin-reference` eller et startmanifest i stedet.
{% endhint %}

## Fejler det stadig?

Sørg for at De er logget på. En udløbet session stopper også løsningen. Se [Logon mislykkes, eller sessionen er udløbet](/cli/da/hjaelp/troubleshooting/sign-in-fails.md). Derefter [indsaml diagnostik](/cli/da/hjaelp/troubleshooting/collect-diagnostics.md) og kontakt [Devolutions-support](https://devolutions.net/support/). Send referencen hvis De vil. Den indeholder ingen hemmelighed, men aldrig værdien.


---

# 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/da/hjaelp/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.