JSON in .env-Umgebungsvariablen-Konverter (Flatten & Export)

JSON in .env-Umgebungsvariablen-Konverter (Flatten & Export)

Verschachtelte JSON-Payloads mit anpassbaren Trennzeichen und Präfixoptionen in SNAKE_CASE-Großbuchstaben für .env-Konfigurationen reduzieren.

Voreinstellungen:
Optionen für Verebnung und Schreibweise
Verschachtelte JSON-Quelle
JSON
# ==============================================================================
# Generated by ToolsAA JSON to .env Converter (100% Client-Side Pure)
# ==============================================================================

# ── SERVICE ─────────────────────────────────────────────────────────────
SERVICE_NAME=payment-gateway
SERVICE_VERSION=2.4.0
SERVICE_ENVIRONMENT=production
SERVICE_PORT=8080
SERVICE_CORS_ORIGINS_0=https://toolsaa.com
SERVICE_CORS_ORIGINS_1=https://api.toolsaa.com

# ── DATABASE ─────────────────────────────────────────────────────────────
DATABASE_POSTGRES_HOST=db.internal.aws.toolsaa.net
DATABASE_POSTGRES_PORT=5432
DATABASE_POSTGRES_DATABASE=production_billing
DATABASE_POSTGRES_USER=billing_svc
DATABASE_POSTGRES_PASSWORD=Secr3t_Billing_Db_Pass!9988
DATABASE_POSTGRES_POOL_MAX=20
DATABASE_POSTGRES_POOL_IDLE_TIMEOUT_MILLIS=30000
DATABASE_POSTGRES_SSL=true

# ── REDIS ─────────────────────────────────────────────────────────────
REDIS_CLUSTER_HOST=redis-cluster.toolsaa.internal
REDIS_CLUSTER_PORT=6379
REDIS_CLUSTER_PASSWORD=SuperClusterAuthKey_9090
REDIS_CLUSTER_TTL_SECONDS=3600

# ── SECURITY ─────────────────────────────────────────────────────────────
SECURITY_JWT_SECRET=f3b890a2c4189e87519cd934bf2a09887711223344
SECURITY_JWT_EXPIRES_IN=2h
SECURITY_JWT_ISSUER=toolsaa-auth-service
SECURITY_API_KEY=ak_live_toolsaa_992288334455

# ── AWS ─────────────────────────────────────────────────────────────
AWS_REGION=us-east-1
AWS_S3_BUCKET=toolsaa-billing-receipts-prod
AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Generierte VariablenTrennzeichen: "_"
26

Aktive Konfigurationsschlüssel in Großbuchstaben umgewandelt UPPER_SNAKE.

Erkannte SecretsMasking OFF
7

Anmeldedaten gegen heuristische Passwort-/Tokenmuster geprüft.

Maximale VerschachtelungstiefeArray: INDEXED
4

Objekthierarchie erfolgreich durchlaufen und eingeebnet.

Vollständige clientseitige Verarbeitung

Alle JSON-Daten und Umgebungsvariablen-Secrets werden ausschließlich im Browser-Speicher per AST-Traversierung verarbeitet. Keine Netzwerkübertragung.

Intelligente Heuristik & Flattening

Tief verschachtelte Objektbäume werden mit anpassbaren Trennzeichen und Framework-Präfixen in saubere SNAKE_CASE-Variablen umgewandelt.

Bereit für moderne DevOps-Ökosysteme

Direkter Export in Standard-.env, Docker Compose, Kubernetes ConfigMap/Secret-Manifeste, Terraform .tfvars und TypeScript-Typdefinitionen.

Technische Referenz & Architektur-Leitfaden

JSON in .env-Umgebungsvariablen-Konverter (Flatten & Export) — Referenz-Leitfaden

Verschachtelte JSON-Payloads mit anpassbaren Trennzeichen und Präfixoptionen in SNAKE_CASE-Großbuchstaben für .env-Konfigurationen reduzieren.

Wichtige Parameter & Steuerelemente

SchlüsseltrennzeichenEnum (Einfacher Unterstrich _ | Doppelter Unterstrich __ | Punkt . | Doppelpunkt :)

Trennzeichen zum Verknüpfen übergeordneter und untergeordneter Schlüssel beim Reduzieren der Hierarchie. Doppelunterstriche (__) sind Standard für ASP.NET Core und Spring Boot.

Standard: Einfacher Unterstrich (_)
SchreibweiseEnum (UPPER_SNAKE_CASE | lower_snake_case | camelCase | PRESERVE)

Ziel-Namenskonvention für generierte Variablenschlüssel. Standard-POSIX-Umgebungsvariablen verlangen UPPER_SNAKE_CASE.

Standard: UPPER_SNAKE_CASE
Präfix-VoreinstellungEnum (Keines | NEXT_PUBLIC_ | VITE_ | REACT_APP_ | Benutzerdefiniert)

Optionales Namespace-Präfix für Variablenschlüssel zur Freigabe für Client-Bundler in Frameworks wie Next.js oder Vite.

Standard: Keines
Array-BehandlungEnum (Indexbasiert _0 | Kommagetrennt | JSON-Zeichenkette)

Steuert die Transformation von JSON-Arrays: nullbasierte Index-Suffixe (z. B. HOSTS_0, HOSTS_1), kommagetrennte Listen oder serialisierte JSON-Strings.

Standard: Indexbasiert (_0)
Werte in AnführungszeichenEnum (Intelligent / Auto | Immer doppelte Anführungszeichen | Einfache Anführungszeichen | Ohne Anführungszeichen)

Regeln für Anführungszeichen. Im Smart-Modus werden Werte mit Leerzeichen, Rautezeichen (#), Zeilenumbrüchen oder Anführungszeichen automatisch sicher maskiert.

Standard: Intelligent / Auto
Sensible Werte maskierenBoolean

Ersetzt Werte von Schlüsseln mit sensiblen Begriffen (password, secret, token, key, private) durch Maskierungszeichen (********) für sichere Bildschirmfotos und Dokumentationen.

Standard: false

Profi-Tipps & Best Practices

Wählen Sie den doppelten Unterstrich

Wählen Sie den doppelten Unterstrich (__) als Schlüsseltrennzeichen für ASP.NET Core oder Spring Boot. Die Konfigurations-Binder dieser Frameworks mappen APP__DATABASE__PORT automatisch auf app.database.port bzw. App:Database:Port.

Schutz von Secrets in CI/CD-Pipelines

Verwenden Sie für CI/CD-Pipelines (GitHub Actions, GitLab CI) stets intelligente Anführungszeichen. Dadurch wird verhindert, dass Shells Zeichen wie Dollarzeichen ($) oder kaufmännische Unds (&) in generierten Passwörtern versehentlich interpretieren.

Nutzen Sie Präfixe wie NEXT_PUBLIC_

Nutzen Sie Präfixe wie NEXT_PUBLIC_ oder VITE_ ausschließlich für Variablen, die im Client-Browsercode benötigt werden. Versehen Sie niemals Datenbank-Zugangsdaten oder private Schlüssel mit solchen Präfixen.

Nutzen Sie den Tab 'TypeScript Typen'

Nutzen Sie den Tab 'TypeScript Typen', um eine globale NodeJS.ProcessEnv-Schnittstellendeklaration zu exportieren. Damit erhalten Sie vollständige IDE-Autovervollständigung und verhindern Tippfehler bei Umgebungsvariablen.

Häufige Fallstricke & Fehlerbehebung

Werte mit '#'-Zeichen werden in dotenv-Parsern abgeschnitten oder als Kommentar gewertet

Ohne Anführungszeichen interpretieren viele dotenv-Parser ein '#' als Beginn eines Zeilenkommentars. Aktivieren Sie 'Intelligent / Auto' oder 'Immer doppelte Anführungszeichen' (z. B. DB_PASS="p#ssw0rd"), um das Problem zu lösen.

Mehrzeilige Zertifikate oder RSA-Schlüssel führen zu Syntaxfehlern in .env-Dateien

Standard-.env-Dateien erfordern einzeilige Einträge. Das Tool konvertiert Zeilenumbrüche innerhalb von doppelten Anführungszeichen automatisch in '\n' (z. B. PRIVATE_KEY="-----BEGIN...\n...END-----"). Ihre Anwendung muss '\n' beim Start zurückwandeln.

Einfache JSON-Arrays erzeugen eine unübersichtliche Flut nummerierter Schlüssel

Wenn Ihre Anwendung lediglich eine Liste von Hostnamen oder Domains benötigt, schalten Sie die Array-Behandlung auf 'Kommagetrennt'. Dadurch wird ["a.com", "b.com"] zu ALLOWED_HOSTS="a.com,b.com" verdichtet.

Häufig gestellte Fragen (FAQ)

Wie reduziert der Konverter verschachtelte JSON-Objekte in flache Umgebungsvariablen?▼

Der Konverter durchläuft den JSON-Syntaxbaum rekursiv, verknüpft Eltern- und Kindschlüssel mit dem gewählten Trennzeichen (standardmäßig '_') und wandelt das Ergebnis in UPPER_SNAKE_CASE um (z. B. wird {"database": {"primary": {"host": "localhost"}}} zu DATABASE_PRIMARY_HOST=localhost).

Welche Exportformate werden neben Standard-.env unterstützt?▼

Neben regulären .env-Dateien unterstützt das Werkzeug Shell-Exporte (export KEY="val"), Docker Compose environment-Blöcke, Kubernetes ConfigMap/Secret-Manifeste (YAML), Terraform .tfvars, TypeScript-Typdeklarationen und flache JSON-Dateien.

Werden meine vertraulichen JSON-Payloads oder Zugangsdaten an externe Server gesendet?▼

Nein. Die gesamte Verarbeitung läuft zu 100 % clientseitig im lokalen JavaScript-Kontext Ihres Browsers ab. Es werden keinerlei Passwörter, Secrets oder Konfigurationsdaten über das Netzwerk übertragen oder protokolliert.

Wie werden boolesche Werte und Null-Werte aus JSON transformiert?▼

Boolesche Werte werden in kleingeschriebene Strings ('true', 'false') umgewandelt. Null-Werte werden als leere Zeichenkette (KEY=) ausgegeben, um Laufzeitfehler bei der Variablenauflösung zu vermeiden.

Können generierte .env-Dateien wieder in hierarchisches JSON rückgewandelt werden?▼

Ja. ToolsAA bietet entsprechende Reziprok-Tools, mit denen flache Schlüssel anhand der Trennzeichen (_ oder __) wieder in die ursprüngliche verschachtelte JSON-Struktur rekonstruiert werden können.

Verwandte Werkzeuge & Dienstprogramme

Alle Werkzeuge →