> 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/reference/secret-references.md).

# Syntaks for hemmelighedsreferencer

Syntaks for devo-referencer, navngivne og kanoniske former, sektioner, attributter, kodning, SecretSpec-udbyder-URI’er, og hvordan referencer findes i tekst.

En hemmelighedsreference er adressen på ét felt i en post. Den starter med `devo://` og siger hvor hemmeligheden er, aldrig hvad den er. Hver `devo secret`-kommando, startmanifester, `.env`-filer og skabeloner bruger den samme syntaks.

For at få referencen til et felt uden at skrive den, skal De køre `devo entry references <entry>`. Se [Find referencen til en hemmelighed](/cli/da/vejledninger/secrets/find-a-reference.md).

## Navngivne referencer

En navngiven reference bruger navnene på arbejdsområdet, boksen og posten, så den er let at læse.

```
devo://<workspace>/<vault>/<entry>/<field>
devo://<workspace>/<vault>/<entry>/<section>/<field>
```

<table><thead><tr><th width="190">SEGMENT</th><th>HVAD DET ER</th></tr></thead><tbody><tr><td><code>&#x3C;workspace></code></td><td>Arbejdsområdet der indeholder boksen.</td></tr><tr><td><code>&#x3C;vault></code></td><td>Den boks der indeholder posten.</td></tr><tr><td><code>&#x3C;entry></code></td><td>Den post der indeholder feltet.</td></tr><tr><td><code>&#x3C;section></code></td><td>Valgfri, kun lokal profil. Den sektion af posten der indeholder feltet, når feltet er i en sektion. Devolutions Cloud og Devolutions Server afviser en sektion med <code>unsupportedSecretField</code>.</td></tr><tr><td><code>&#x3C;field></code></td><td>Feltet der skal læses, såsom <code>password</code>, <code>username</code>, <code>domain</code>, <code>host</code>, <code>otp</code> eller <code>privatekey</code>.</td></tr></tbody></table>

En navngiven reference løses i det arbejdsområde der er valgt til kommandoen. Den aktuelle kontekst, eller den De vælger med `--context` eller `--source`. Se [Globale indstillinger](/cli/da/reference/global-options.md).

## Kanoniske referencer

En kanonisk reference bruger id’er i stedet for navne.

```
devo://ws/<workspace-id>/vault/<vault-id>/entry/<entry-id>/field/<field>
```

* Den bliver ved med at virke når posten, boksen eller arbejdsområdet omdøbes.
* Den navngiver det arbejdsområde der ejer den, så den løses i det arbejdsområde uanset den aktuelle kontekst. Ét `devo secret run` kan blande referencer fra en lokal profil, Devolutions Cloud og Devolutions Server.
* Den har ikke et sektionssegment.
* På Devolutions Server viser `devo entry references` kun kanoniske referencer. En navngiven reference De selv skriver, virker stadig.

## Attributter

Som standard returnerer en reference feltets værdi. Tilføj `?attribute=` (eller den korte form `?attr=`) for at læse oplysninger om feltet i stedet for dets værdi. Værdierne skelner ikke mellem store og små bogstaver.

<table><thead><tr><th width="190">ATTRIBUT</th><th>HVAD DEN RETURNERER</th><th width="150">HEMMELIGHED</th></tr></thead><tbody><tr><td><code>value</code></td><td>Feltets værdi. Det er standarden og den eneste attribut der returnerer en hemmelighed.</td><td>Ja</td></tr><tr><td><code>type</code></td><td>Felttypen.</td><td>No</td></tr><tr><td><code>id</code></td><td>Postens id.</td><td>No</td></tr><tr><td><code>title</code></td><td>Postens navn. Tomt for en kanonisk reference på Devolutions Cloud og Devolutions Server.</td><td>No</td></tr><tr><td><code>purpose</code></td><td>Hvorfor værdien blev anmodet. <code>read</code>, <code>inject</code>, <code>run</code> eller <code>mcp</code>. Tom på en lokal profil.</td><td>No</td></tr></tbody></table>

`type`, `id`, `title` og `purpose` returnerer kun oplysninger, aldrig hemmeligheden, på alle arbejdsområdetyper.

For eksempel returnerer `devo://<workspace>/<vault>/<entry>/password?attribute=type` typen af feltet `password`, ikke adgangskoden. `devo secret read` og `devo secret get` accepterer også `--attribute` i stedet for forespørgslen.

## Specialtegn

Hvert segment mellem to `/` URL-afkodes. Hvis et navn indeholder `/`, `?`, `#`, `%` eller et mellemrum, skal De kode det. Skriv for eksempel `Web%2FProd` for en post med navnet `Web/Prod`, og `My%20vault` for `My vault`. Et `:` kan blive som det er.

Referencer som Devolutions CLI udskriver, for eksempel med `devo entry references`, er allerede kodet.

## Regler og fejl

Når en reference ikke kan læses, fejler kommandoen med fejlkoden `invalidSecretReference` og en af disse meddelelser.

<table><thead><tr><th width="320">MEDDELELSE</th><th>HVAD DER SKAL KONTROLLERES</th></tr></thead><tbody><tr><td>"Secret reference cannot be empty."</td><td>Referencen er tom eller kun mellemrum.</td></tr><tr><td>"Secret reference must start with 'devo://'."</td><td>Præfikset mangler eller er stavet forkert. Præfikset skelner ikke mellem store og små bogstaver.</td></tr><tr><td>"Secret references do not support URI fragments."</td><td>Referencen indeholder <code>#</code>. Kod det som <code>%23</code> hvis det er en del af et navn.</td></tr><tr><td>"Secret reference path cannot be empty."</td><td>Intet følger efter <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 skal bruge 4 eller 5 segmenter. Kontrollér om der mangler et segment, eller om der er et ukodet <code>/</code> i et navn.</td></tr><tr><td>"Secret reference path segments cannot be empty."</td><td>To <code>/</code> følger efter hinanden, eller referencen slutter med <code>/</code>.</td></tr><tr><td>"Canonical ID references must use devo://ws/&#x3C;id>/vault/&#x3C;id>/entry/&#x3C;id>/field/&#x3C;field>."</td><td>En reference der starter med <code>ws</code> og har 8 segmenter, skal bruge ordene <code>vault</code>, <code>entry</code> og <code>field</code> i den rækkefølge.</td></tr><tr><td>"Canonical workspace, vault, and entry identifiers cannot be empty."</td><td>Et id mangler i en kanonisk reference.</td></tr><tr><td>"Canonical field segment cannot be empty."</td><td>Feltet mangler i slutningen af en kanonisk reference.</td></tr></tbody></table>

En ukendt attribut fejler med koden `unsupportedSecretAttribute` og meddelelsen «Unsupported secret reference attribute '\<value>'.». Andre forespørgselsparametre ignoreres.

Når referencen er gyldig, men ikke fører til et felt De kan læse, se [En hemmelighedsreference løses ikke](/cli/da/hjaelp/troubleshooting/reference-does-not-resolve.md).

## Referencer inde i en tekst

`devo secret inject` finder referencerne i en skabelon og erstatter hver med dens værdi. Den genkender to former.

<table><thead><tr><th width="250">FORM</th><th>HVOR DET SLUTTER</th></tr></thead><tbody><tr><td><code>{{ devo://… }}</code></td><td>Ved det afsluttende <code>}}</code>. Klammerne erstattes også, og mellemrum inde i dem ignoreres. Brug denne form når referencen står ved siden af anden tekst.</td></tr><tr><td><code>devo://…</code></td><td>Ved det første mellemrum, linjeskift, <code>"</code>, <code>'</code>, <code>&#x3C;</code>, <code>></code>, <code>)</code>, <code>]</code> eller <code>}</code>.</td></tr></tbody></table>

Tekst der starter med `devo://`, men ikke er en gyldig reference, efterlades som den er.

I en skabelon kan en reference også indeholde miljøvariabler, som `devo secret inject` erstatter før den læser hemmeligheden.

<table><thead><tr><th width="250">UDTRYK</th><th>HVAD DEN BLIVER TIL</th></tr></thead><tbody><tr><td><code>$NAME</code> or <code>${NAME}</code></td><td>Værdien af miljøvariablen <code>NAME</code>. Hvis den ikke er angivet eller er tom, mislykkes kommandoen med <code>missingSecretReferenceVariable</code>.</td></tr><tr><td><code>${NAME:-default}</code></td><td>Værdien af <code>NAME</code>, eller <code>default</code> når den ikke er angivet eller er tom.</td></tr></tbody></table>

For eksempel læser `{{ devo://<workspace>/${VAULT:-Staging}/<entry>/password }}` fra den boks der er navngivet i `VAULT`, eller fra `Staging`.

{% hint style="warning" %}
`devo secret inject` skriver værdierne i klartekst til sit output. Se [Udfyld en konfigurationsfil fra en skabelon](/cli/da/vejledninger/secrets/fill-a-template.md).
{% endhint %}

## SecretSpec-udbyder-URI’er

SecretSpec bruger ikke hemmelighedsreferencer. I `secretspec.toml` bruger den en udbyder-URI der fortæller hvilket arbejdsområde Devolutions CLI skal læse. Udskriv den rigtige med `devo secretspec uri`. Se [Brug Devolutions CLI med SecretSpec](/cli/da/vejledninger/secrets/secretspec.md).

<table><thead><tr><th width="330">UDBYDER-URI</th><th>ARBEJDSOMRÅDE</th></tr></thead><tbody><tr><td><code>devo://cloud[/&#x3C;vault-id>][?context=&#x3C;name>]</code></td><td>Devolutions Cloud, gennem konteksten <code>&#x3C;name></code>, eller den aktuelle Devolutions Cloud-kontekst uden <code>?context=</code>.</td></tr><tr><td><code>devo://server[/&#x3C;vault-id>][?context=&#x3C;name>]</code></td><td>Devolutions Server, gennem konteksten <code>&#x3C;name></code>, eller den aktuelle Devolutions Server-kontekst uden <code>?context=</code>.</td></tr><tr><td><code>devo://sqlite[/&#x3C;vault-id>]?workspace=&#x3C;workspace-id></code></td><td>Et lokalt Devolutions Remote Desktop Manager-arbejdsområde. <code>?workspace=</code> er påkrævet, med et arbejdsområde-id såsom <code>sqlite:Connections.db</code>. <code>devo workspace current</code> viser det.</td></tr></tbody></table>

`<vault-id>` er valgfri. Den angiver standardboksen, og hver hemmelighed kan stadig navngive sin egen boks.


---

# 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/reference/secret-references.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.