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: