Vulnerability Plain-Text pada Nix Store

Nixidy menggunakan Nix untuk mengompilasi deklarasi Kubernetes manifest ke format YAML/JSON. Karakteristik utama Nix adalah sifat deterministik: setiap file yang diinterpolasi ke dalam konfigurasi (misalnya melalui fungsi builtins.readFile) otomatis disalin ke /nix/store.

Jika secret didekripsi langsung saat fase evaluasi Nix flake, nilai plain-text tersebut tersimpan di Nix store lokal atau remote binary cache tanpa enkripsi. Setiap user atau proses dengan izin baca ke /nix/store dapat mengekstrak secret tersebut. Untuk mencegah leakage ini, proses evaluasi manifest harus dipisahkan dari runtime decryption, atau enkripsi harus dipertahankan hingga fase deployment.

Arsitektur Enkripsi Deklaratif: SOPS dan Age

Integrasi SOPS (Secrets OPerationS) dengan Age key menyediakan enkripsi file deklaratif di dalam repository GitOps. Kunci privat disimpan secara lokal atau diinject via CI runner (misalnya GitHub Actions secrets atau HashiCorp Vault), sementara file terenkripsi disimpan langsung di repository.

1. Generate Keypair Age

Jalankan perintah berikut untuk membuat identitas Age:

age-keygen -o ~/.config/sops/age/keys.txt
# Catat public key yang dihasilkan, misal: age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zmrj2kg5sfn9aqmcac8p

2. Konfigurasi .sops.yaml

Definisikan aturan enkripsi pada root direktori repository:

creation_rules:
  - path_regex: secrets/.*\.ya?ml$
    age: "age1ql3z7hjy54pw3hyww5ayyfg7zqgvc7w3j2elw8zmrj2kg5sfn9aqmcac8p"

3. Enkripsi Payload Kubernetes Secret

Buat file secret dan enkripsi in-place:

cat <<EOF > secrets/api-secrets.yaml
apiVersion: v1
kind: Secret
metadata:
  name: api-credentials
  namespace: production
type: Opaque
stringData:
  DATABASE_URL: "postgres://user:supersecretpass@db:5432/app"
  API_KEY: "ak_live_992384712984124"
EOF

sops -e -i secrets/api-secrets.yaml

Konfigurasi Modul Nixidy

Nixidy mengelola Kubernetes resources menggunakan struktur modul. Untuk menghindari plain-text leak pada Nix store, manifest secret didekripsi via dynamic runner script pada pipeline GitOps atau dikonversi menjadi custom resource (seperti SOPS Secret operator atau ExternalSecrets). Jika menggunakan rendering langsung, path file terenkripsi direferensikan tanpa membaca isinya ke Nix language context.

# env/production.nix
{ config, lib, pkgs, ... }:

{
  nixidy.target.destination = "./manifests";

  # Jangan gunakan builtins.readFile pada file plaintext!
  # Referensikan resource sebagai SOPS-managed secret template
  kubernetes.resources.secrets."api-credentials" = {
    metadata = {
      name = "api-credentials";
      namespace = "production";
      annotations = {
        "sops.nixidy.io/encrypted" = "true";
        "sops.nixidy.io/hash" = builtins.hashFile "sha256" ../secrets/api-secrets.yaml;
      };
    };
    # Template manifest diisi oleh deployment hook runtime
    data = {};
  };
}

Pipeline Deployment dan Validasi Runtime

Eksekusi deployment tidak boleh mengevaluasi plain-text ke Nix flake metadata. Deployment pipeline memproses manifest dalam tiga tahap berurutan:

  1. Build: Nixidy mengompilasi manifest struktural dari Nix expressions. Secret hanya direferensikan via hash integritas.
  2. Validate: Pipeline memvalidasi kesesuaian hash file terenkripsi untuk mencegah modifikasi tidak sah (tampering).
  3. Decrypt & Apply: SOPS mendekripsi payload di memori (stdin stream) langsung ke kubectl apply.

Validasi Hash dan Deployment Pipeline Script

#!/usr/bin/env bash
set -euo pipefail

SECRET_FILE="secrets/api-secrets.yaml"
EXPECTED_HASH=$(nix eval .#nixidyEnvironments.production.config.kubernetes.resources.secrets.api-credentials.metadata.annotations."sops.nixidy.io/hash" --raw)
CURRENT_HASH=$(sha256sum "$SECRET_FILE" | awk '{print $1}')

# 1. Validasi Schema & Hash
if [ "$EXPECTED_HASH" != "$CURRENT_HASH" ]; then
  echo "Error: Hash mismatch pada $SECRET_FILE. Re-run compilation!" >&2
  exit 1
fi

# 2. Compile Nixidy environment
nixidy build .#production

# 3. Decrypt directly to kubectl without persisting to disk/store
export SOPS_AGE_KEY_FILE="$HOME/.config/sops/age/keys.txt"
sops -d "$SECRET_FILE" | kubectl apply --dry-run=server -f -
sops -d "$SECRET_FILE" | kubectl apply -f -

Mitigasi Risiko dan Best Practices

  • Cegah Evaluasi Impure: Jangan menggunakan --impure dengan environment variable yang memuat secret saat menjalankan nix build atau nixidy build. Nilai tersebut tetap tercatat pada graph derivation evaluasi.
  • Gunakan .gitignore Eksplisit: Pastikan seluruh file dekripsi sementara (misal *.dec.yaml) masuk dalam blacklist Git. Lebih baik tidak membuat file temporer sama sekali, gunakan UNIX pipe (stdout | stdin).
  • Key Rotation: Saat merotasi Age key, jalankan sops updatekeys secrets/api-secrets.yaml, perbarui hash di deklarasi Nixidy, dan commit perubahan secara atomik.