Das Hardcodieren sensibler Daten – wie API-Keys, Datenbankpasswörter oder Tokens – stellt ein Sicherheitsrisiko dar. Um dies zu vermeiden, entkoppeln Umgebungsvariablen die Konfiguration von der Codebasis. Codesphere verwaltet diese Variablen über verschlüsselten Speicher und injiziert sie zur Laufzeit in die Anwendung.

Zugriff auf die Variablen

Die Secrets können im Tab Environment Variables der Landscape verwaltet werden.

1. Öffne Environment Variables in der Seitenleiste.

Eine neue Variable hinzufügen

So fügst du eine einzelne Variable hinzu:

1. Klicke auf die Schaltfläche + Add New Variable.
2. Key: Gib den Namen deiner Variable ein
3. Value: Gib den geheimen Wert ein.
4. Klicke auf Save.

Hinweis: Aus Sicherheitsgründen wird der Wert einer gespeicherten Variable maskiert. Du kannst ihn durch Klicken auf das Augensymbol neben dem Wert wieder einsehen.

Massenupload (.env-Dateien)​

Falls du ein bestehendes Projekt migrierst, hast du wahrscheinlich schon eine .env-Datei. Anstatt die Variablen einzeln einzutippen, kannst du die gesamte Datei hochladen.

1. Klicke auf die Schaltfläche Bulk Upload.
2. Ziehe deine .env-Datei per Drag-and-Drop in das Modal oder klicke, um sie auszuwählen.
3. Klicke auf Upload.

Beispiel einer .env-Datei

STRIPE_API_KEY=scr_12345
TWILIO_API_KEY=abcd1234

Wichtig: Dadurch werden bestehende Variablen mit demselben Key überschrieben.

Variablen in deiner Anwendung verwenden

Sobald sie definiert sind, stehen diese Variablen deiner Anwendung wie jede andere systemweite Umgebungsvariable zur Verfügung.

const apiKey = process.env.KEY_NAME;

import os
api_key = os.environ.get('KEY_NAME')

In deiner CI Pipeline (ci.yml): Du kannst diese Umgebungsvariablen auch in deinen Build- oder Run-Befehlen mit der üblichen Shell-Syntax referenzieren.

run:
  steps:
    - name: SERVERNAME
      command: ./your-app-server --api-key=$KEYNAME

Du kannst service-spezifische Umgebungsvariablen direkt in der ci.yml definieren. Details dazu findest du unter Konfiguration deiner CI Pipeline. Sie können auch mithilfe von Templating auf Umgebungsvariablen auf Workspace-Ebene verweisen, die im UI definiert wurden:

run: 
  my-service:
    env:
      KEY_NAME: {{ workspace.env.WORKSPACE_ENV_NAME }}