Aurabase Logosu
aura tabanıdokümanlar
dokümanlar›Edge Functions›Secrets and environment

Sırlar ve ortam değişkenleri

Bir Stripe anahtarının veya herhangi bir ayarın koda yazılmadan bir işleve nasıl aktarılacağı ve platformun gerçekte neyi koruduğu.

6 dk. oku·Seviye orta düzey·12 Eki 2026 tarihinde revize edildi
Bu İngilizce metin, Fransızca orijinalinden otomatik olarak oluşturulmuştur ve henüz incelenmemiştir.
Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.
#
Yaz

1. Bir değişken belirleyin

Her değişken bir fonksiyona aittir. Değişkenleri ayarlamak için bir service_role anahtarı gerekir.

terminalbash
aura secrets set --function checkout STRIPE_SECRET_KEY=sk_live_… WEBHOOK_SECRET=whsec_…
aura secrets list --function checkout     # değerler maskelenmiştir: STRIPE_SECRET_KEY sk_l***
aura secrets unset --function checkout WEBHOOK_SECRET
terminalbash
curl -X PUT "$AURA_URL/v1/functions/checkout/env" \
  -H "apikey: $AURA_SERVICE_ROLE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vars":[{"key":"STRIPE_SECRET_KEY","value":"sk_live_…"}]}'

PUT /env , gönderdiğiniz listedeki tüm değişken kümesini ile değiştirir. aura secrets set ve unset mevcut değerleri okur, isimlendirdiğiniz tuşları değiştirir ve sonucu geri yazar.

Yeniden konuşlandırma sırlarınızı korur

Yeni kodun aura functions deploy ile dağıtılması değişkenlere dokunulmaz.

#
Oku

2. Fonksiyonda okuyun

aurabase/functions/checkout/index.tstypescript
Deno.serve(async (req) => {
  const key = Deno.env.get('STRIPE_SECRET_KEY')
  if (!key) return new Response('STRIPE_SECRET_KEY is not set', { status: 500 })
  // …Stripe'ı 'anahtar' ile arayın
  return Response.json({ ok: true })
})

Değişkenler her çağrıda okunur: bir değişiklik sonraki çağrıya uygulanır.

#
Enjekte edildi

3. Platformun eklediği değişkenler

DeğişkenDeğer
AURABASE_PROJECT_IDProje kimliği. Her zaman ayarlayın.
AURABASE_FUNCTION_NAMEFonksiyonun adı. Her zaman ayarlayın.
AURABASE_URLPlatform operatörünün tanımladığı platform URL'si.
AURABASE_ANON_KEYOperatör tanımladığında bir platform anahtarı.

Bu adları geçersiz kılamazsınız. Ana bilgisayarın ortamı işleviniz tarafından görülemiyor: gerçek bir çalıştırmada Deno.env.get('PATH') undefined değerini döndürdü.

Bir işlevden kendi projenizi çağırmak için, o işlevin sırrı olarak bir service_role anahtarını saklayın ve bunu bir HTTP isteğinin apikey başlığına gönderin. Asla bir kullanıcının anahtarını iletmeyin ve asla tarayıcıya service_role anahtarını koymayın.

#
Koruma

4. Şifrelenen nedir

YolDinlenme sırasında şifrelendi
PUT /v1/functions/{name}/envEvet, eğer hizmetin yapılandırılmış bir şifreleme anahtarı varsa (FN_ENV_ENCRYPTION_KEY, AES-256-GCM). Bu olmadan, değerler gönderildiği gibi saklanır ve hizmet başlangıçta bir uyarıyı günlüğe kaydeder.
aura secrets set / unsetHayır: CLI, gönderilen değerleri saklayan PATCH aracılığıyla yazar.
Dağıtım isteğinde env_varsHayır, aynı sebep.

Yerel testimizde, hiçbir anahtar yapılandırılmadığından, PUT /env tarafından yazılan bir değer, işlevin tanımı tarafından değişmeden döndürüldü.

Şifrelemeye güvenmeden önce platform operatörünüze danışın

Gizli dizilerin şifrelenip şifrelenmeyeceği dağıtıma bağlıdır ve bunları yalnızca PUT /env yolu şifreleyebilir. CLI yolu bunları verildiği gibi saklar. CLI PUT /env kullanana kadar üretim sırları için yukarıdaki HTTP çağrısını kullanın.

Sırları geri okumak da sınırlıdır. GET /v1/functions/{name}/env şifresi çözülmüş değerleri döndürür ve GET /v1/functions/{name} gibi bir service_role anahtarı gerektirir. Ortak anahtar 403 alır.

#
Kurallar

5. Uyulması gereken kurallar

  • Bir sırrı asla index.ts içine sabit kodlamayın. Bir fonksiyonun kaynak kodu projenizde saklanır ve herhangi bir service_role çağırıcısına döndürülür.
  • Asla bir sırrı kaydetmeyin. console.log çıktısı çalışma zamanının günlüklerinde sona erer.
  • Çalışan en dar anahtarla (ana anahtar değil, sağlayıcınızdan alınan kısıtlı bir anahtar) işlev başına bir değişken kullanın.
  • Yeni değeri ayarlayarak ve hiçbir şeyi yeniden dağıtmadan bir anahtarı döndürün: sonraki çağrı onu kullanır.