Secrets-Verwaltung
Sichere Speicherung von Anmeldeinformationen
Wenn Ihre Anwendung eine Verbindung zu externen Diensten herstellen muss – wie dem Senden von E-Mails über SendGrid, der Verarbeitung von Zahlungen mit Stripe oder der Verwendung von OpenAI für KI-Funktionen – müssen Sie API-Schlüssel und Anmeldeinformationen sicher speichern. Das Secrets-Verwaltungssystem von Kliv erledigt dies automatisch.
Was Secrets sicher macht:
- Verschlüsselte Speicherung in der Datenbank
- Nie vollständig angezeigt, nachdem Sie sie gespeichert haben
- Bei Bedarf automatisch in Edge Functions eingespeist
- Kontoweit, sodass Sie jeden Schlüssel nur einmal speichern
- Audit-Trails verfolgen, wann Secrets erstellt oder aktualisiert wurden
Wie Secrets funktionieren
Wenn Sie der KI mitteilen, dass Sie einen externen Dienst integrieren möchten, fragt sie nach den erforderlichen Anmeldeinformationen. Sobald Sie einen API-Schlüssel angeben, speichert die KI ihn sicher unter einem beschreibenden Namen (z. B. OPENAI_API_KEY oder STRIPE_SECRET_KEY). Von da an kann jede Edge Function, die diese Anmeldeinformationen benötigt, automatisch darauf zugreifen.
Maskierte Anzeige: Nach dem Speichern eines Secrets sehen Sie in der Admin-Oberfläche nur eine teilweise maskierte Version. Beispielsweise wird sk-proj-abc123xyz789 als sk-p****9789 angezeigt. Auf diese Weise können Sie überprüfen, welcher Schlüssel welcher ist, ohne den vollständigen Wert preiszugeben.
Automatische Einspeisung: Wenn eine Edge Function läuft, werden die Secrets, auf die sie verweist, für diesen Lauf sicher eingespeist. Die KI schreibt die Funktion so, dass sie sie über die Secrets-Schnittstelle der Plattform liest, und die Plattform liefert den tatsächlichen Wert zur Laufzeit – ein rotierter Schlüssel wird also beim nächsten Lauf der Funktion wirksam.
Secrets verwalten
Über die Admin-Oberfläche können Sie:
- Alle Ihre Secrets anzeigen (mit maskierten Werten)
- Neue Secrets hinzufügen oder vorhandene aktualisieren
- Secrets löschen, die Sie nicht mehr benötigen
- Sehen, wann jedes Secret erstellt oder zuletzt aktualisiert wurde
Die KI kann auch Secrets für Sie erstellen und aktualisieren, wenn Sie Integrationen beschreiben, die Sie erstellen möchten.
Häufige Verwendungen für Secrets
- E-Mail-Dienste: SendGrid-, Mailgun- oder SMTP-Anmeldeinformationen
- Zahlungsabwicklung: Stripe-, PayPal- oder andere Zahlungs-API-Schlüssel
- KI-Dienste: OpenAI-, Anthropic- oder Google-API-Schlüssel
- SMS/Anrufe: Twilio-Authentifizierungstoken
- Externe APIs: Jeder Drittanbieterdienst, den Ihre App integriert
- Webhooks: Signatur-Secrets zur Überprüfung eingehender Webhooks
- Datenbankverbindungen: Verbindungszeichenfolgen für externe Datenbanken
Best Practices
✅ Verwenden Sie beschreibende Namen – Benennen Sie Secrets eindeutig wie SENDGRID_API_KEY und nicht key1 oder secret.
✅ Regelmäßig rotieren – Aktualisieren Sie Secrets regelmäßig, insbesondere für kritische Dienste.
✅ Löschen, wenn nicht mehr gebraucht – Entfernen Sie Secrets für Dienste, die Sie nicht mehr nutzen.
❌ Secrets nicht teilen – Jede Umgebung (Test, Produktion) sollte unterschiedliche API-Schlüssel verwenden.
❌ Nicht in den Code einchecken – Secrets werden aus gutem Grund getrennt von Ihrem Code gespeichert. Fügen Sie niemals API-Schlüssel direkt in Ihre Quelldateien ein.
Zugehörige Dokumentation: