API-Schlüssel
Erstelle und verwalte API-Schlüssel zur Authentifizierung mit deinen Tuix AI Agents-Anwendungen.
Ein API-Schlüssel authentifiziert Chat- und Session-Anfragen, wenn es keinen eingeloggten Nutzer gibt, für den gesprochen wird, ein öffentlicher Chat auf einer Marketingseite, eine interne Automatisierung, ein Skript. Du erstellst und verwaltest Schlüssel im Tuix-Dashboard, unter deinem Profilmenü → API Keys.
API-Schlüssel gelten kontoweit: Ein Schlüssel kann jede Anwendung aufrufen, die zu deinem Konto gehört, nicht nur eine. Welche Anwendung er betrifft, wird durch den Endpunkt bestimmt, den du damit aufrufst, siehe Anwendungs-Endpunkte.
Einen API-Schlüssel erstellen
Öffne im Dashboard dein Profil und wähle API Keys aus dem Menü.
Der Schlüssel wird nur einmal angezeigt. Nachdem du den Dialog geschlossen hast, kannst du ihn nicht mehr sehen. Kopiere ihn sofort und bewahre ihn sicher auf.
Die Tabelle listet deine Schlüssel nach Name, mit einer maskierten Vorschau des Werts und dem Erstellungsdatum. Lösche einen Schlüssel dort, wenn er nicht mehr benötigt wird; die Löschung wird sofort wirksam.
Umgang mit Schlüsseln
- Schlüssel sind privat. Behandle sie wie ein Passwort: Sie dürfen niemals in clientseitigem Code, einem öffentlichen Repository oder innerhalb einer mobilen oder Browser-App offengelegt werden.
- Ein Schlüssel gibt dem Agenten die Autorität deines Kontos, was auch immer die verbundenen APIs des Agenten erlauben, tut er mit der Identität des Schlüssels, nicht der eines bestimmten Endnutzers. Verwende ihn nur dort, wo das das gewünschte Verhalten ist.
- Wenn dein Chat im Browser oder auf einer anderen öffentlichen Oberfläche laufen muss, setze ein Backend dazwischen: Der Browser spricht mit deinem Backend, und nur dein Backend hält den Schlüssel und ruft Tuix AI Agents auf.
- Speichere den Schlüssel in einer Umgebungsvariable (z. B.
TUIX_AI_AGENTS_API_KEY), nicht in der Versionskontrolle. - Verwende pro Umgebung oder pro nutzendem Dienst einen eigenen Schlüssel, sodass ein einzelner Schlüssel widerrufen werden kann, ohne die anderen zu beeinträchtigen.