Referencje do sekretów

server:
  master_key: ${file:/run/secrets/gomodel-master-key}

providers:
  openai:
    type: openai
    api_key: ${env:OPENAI_KEY}

OPENAI_API_KEY='${file:/run/secrets/openai}'
POSTGRES_URL='${file:/run/secrets/postgres-url}'

​

Składnia

providers:
  openai:
    type: openai
    api_key: ${env:OPENAI_KEY}
    proxy_url: http://gomodel:${file:/run/secrets/proxy-pass}@proxy:3128

mcp:
  servers:
    github:
      url: https://mcp.example.com/mcp
      headers:
        Authorization: Bearer ${env:GITHUB_TOKEN}

​

Schematy

​

Błędy zatrzymują uruchamianie

failed to resolve secret references: providers.openai.api_key: secret reference ${file:...}: open /run/secrets/openai: no such file or directory

​

Rotacja

• podmienia klucze API providerów w miejscu, gdy zmieniły się tylko one. Requesty w trakcie realizacji kończą się na kluczu, z którym się rozpoczęły. Sesje przypięte do usuniętego klucza przechodzą na inny; większość pozostałych sesji zachowuje swój klucz.
• przeładowuje konfigurację, tak jak SIGHUP, gdy zmieniło się cokolwiek innego w config.yaml lub w środowisku (DSN, master key, URL proxy, JSON konta usługi). Nieudane przeładowanie zachowuje działającą konfigurację i jest ponawiane przy następnej zmianie. Referencje zapisane z dashboardu nigdy nie przeładowują konfiguracji; zobacz Dane uwierzytelniające zarządzane z dashboardu.
• zachowuje wszystkie bieżące wartości, gdy referencji nie da się ponownie rozwiązać, i zapisuje ostrzeżenie w logach z nazwą ustawienia.

rotated provider API keys in place providers=[openai] fields=[providers.openai.api_keys[1]]

​

Dane uwierzytelniające zarządzane z dashboardu

• Referencja jest zapisywana tak, jak ją wpisano; GoModel rozwiązuje ją podczas budowania providera, połączenia MCP lub guardraila.
• Referencja nie jest sekretem, więc dashboard i Admin API pokazują bez maskowania wartość składającą się wyłącznie z referencji; nagłówek MCP może też zaczynać się od schematu uwierzytelniania (Bearer ${env:TOKEN}), a URL proxy jest pokazywany, gdy jego hasło jest referencją. Dosłowne sekrety oraz wartości łączące dosłowny tekst z referencją pozostają zamaskowane, a odesłanie maski zachowuje zapisaną wartość.
• Referencja, której nie da się rozwiązać, jest odrzucana przy zapisie z błędem 400 podającym pole i schemat.
• Tylko master key może dodać lub zmienić referencję. Referencja jest rozwiązywana na hoście gatewaya, więc może odczytać dowolną zmienną środowiskową lub plik dostępne dla gatewaya, łącznie z master key. Każde inne dane uwierzytelniające, np. zarządzany klucz z dostępem do dashboardu, otrzymują 403 (secret_reference_requires_master_key) z nazwą pola. Nadal mogą zapisywać dosłowne sekrety, odsyłać maskę i ponownie zapisywać encję, której referencje się nie zmieniły. Bez master key dane uwierzytelniające dashboardu zapisują referencje tak jak wcześniej.
• Z tego samego powodu tylko master key może zmienić miejsce, do którego encja zawierająca referencję ją wysyła: url serwera MCP, type, base_url, backend lub proxy_url providera albo typ lub URL usługi guardraila (np. analyzer_url Presidio). Inne dane uwierzytelniające otrzymują ten sam 403 z nazwą pola i nadal mogą edytować wszystkie pozostałe pola.
• Każde wywołanie resolvera przenosi ścieżkę pola na potrzeby audytu, np. provider_credentials.openai.api_keys[0], mcp_servers.github.headers.Authorization lub guardrail_definitions.pii.config.api_key.
• Gdy wartość wskazywana przez referencję podlega rotacji, ponownie instalowana jest tylko dotknięta encja: klucze providera są podmieniane w miejscu, każda inna zmiana providera powoduje jego przebudowanie, serwer MCP jest ponownie łączony, a guardrail przebudowywany. Jeśli referencji nie da się rozwiązać, encja zachowuje bieżącą wartość.

​

Dosłowne ${

​

Ograniczenia

• Referencje env i file są rozwiązywane przy ładowaniu lub przeładowaniu konfiguracji; zobacz Rotacja.
• Dotyczą ustawień tekstowych. Ustawienie logiczne lub liczbowe nie może być referencją, a zmienna środowiskowa, którą GoModel parsuje jako liczbę, wartość logiczną, czas trwania lub listę (LOGGING_ENABLED, HTTP_TIMEOUT, ENABLED_PASSTHROUGH_PROVIDERS, …), zatrzymuje uruchamianie, jeśli zawiera referencję. Zmienne JSON akceptują referencje wewnątrz swoich wartości tekstowych.
• Wyjątkiem są zmienne środowiskowe providerów: OPENAI_MODELS, OPENAI_MODEL_FILTER_* i OPENAI_SESSION_STICKY_KEYS są rozwiązywane przed parsowaniem.
• W encjach zarządzanych z dashboardu referencje akceptują tylko pola wymienione w sekcji Dane uwierzytelniające zarządzane z dashboardu.