Správa secrets

Zabezpečené úložiště pověření

Když se vaše aplikace potřebuje připojit k externím službám – jako je odesílání e-mailů přes SendGrid, zpracování plateb pomocí Stripe nebo používání funkcí OpenAI pro AI – musíte bezpečně uložit klíče a přihlašovací údaje API. Systém správy secrets Kliv to řeší automaticky.

Co dělá secrets bezpečné:

  • Šifrované úložiště v databázi
  • Po uložení se nikdy nezobrazují v plném rozsahu
  • Automaticky vkládáno do edge funkcí v případě potřeby
  • Pro celý účet, takže každý klíč uložíte pouze jednou
  • Auditní záznamy sledující, kdy byla secrets vytvořena nebo aktualizována

Jak secrets fungují

Když AI řeknete, že chcete integrovat s externí službou, požádá o potřebné přihlašovací údaje. Jakmile poskytnete klíč API, AI jej bezpečně uloží s popisným názvem (například OPENAI_API_KEY nebo STRIPE_SECRET_KEY). Od té doby k němu může automaticky přistupovat jakákoli edge funkce, která toto pověření potřebuje.

Maskované zobrazení: Po uložení secrets uvidíte v uživatelském rozhraní správce pouze částečně maskovanou verzi. Například sk-proj-abc123xyz789 se zobrazí jako sk-p****9789. To vám umožní ověřit, který klíč je který, aniž byste odhalili plnou hodnotu.

Automatické vkládání: Když se spustí edge funkce, secrets, na které odkazuje, jsou pro daný běh bezpečně vloženy. AI napíše funkci tak, aby je četla prostřednictvím rozhraní pro secrets dané platformy, a platforma dodá skutečnou hodnotu za běhu – takže vyměněný klíč se projeví při dalším běhu funkce.

Správa secrets

Prostřednictvím administrátorského rozhraní můžete:

  • Zobrazit všechna svá secrets (s maskovanými hodnotami)
  • Přidat nová secrets nebo aktualizovat stávající
  • Odstranit secrets, která již nepotřebujete
  • Podívat se, kdy bylo každé secret vytvořeno nebo naposledy aktualizováno

AI za vás může také vytvářet a aktualizovat secrets, když popisujete integrace, které chcete vytvořit.

Běžná použití pro secrets

  • E-mailové služby: přihlašovací údaje SendGrid, Mailgun nebo SMTP
  • Zpracování plateb: Stripe, PayPal nebo jiné platební klíče API
  • Služby AI: klíče OpenAI, Anthropic nebo Google API
  • SMS/volání: Ověřovací tokeny Twilio
  • Externí rozhraní API: Jakákoli služba třetí strany, se kterou se vaše aplikace integruje
  • Webhooky: Secrets podpisu pro ověřování příchozích webhooků
  • Připojení k databázi: Připojovací řetězce pro externí databáze

Nejlepší postupy

✅ Používejte popisné názvy - Pojmenujte secrets jasně jako SENDGRID_API_KEY spíše než key1 nebo secret.

✅ Pravidelně obměňujte - Pravidelně aktualizujte secrets, zejména u kritických služeb.

✅ Po dokončení smazat – Odstraňte secrets pro služby, které již nepoužíváte.

❌ Nesdílejte secrets - Každé prostředí (test, produkce) by mělo používat jiné klíče API.

❌ Nevkládejte do kódu - Secrets jsou z nějakého důvodu uložena odděleně od vašeho kódu. Nikdy nevkládejte klíče API přímo do svých zdrojových souborů.


Související dokumentace: