API-Keys
API-Keys für den Tuix PDF Service erstellen und verwalten.
Ein API-Key authentifiziert deine Anfragen an den Tuix PDF Service. Keys erstellst und verwaltest du im Tuix Dashboard unter API Keys.
API-Key erstellen
Öffne im Dashboard unten in der Seitenleiste dein Profil und wähle im Menü API Keys.
Klicke oben rechts auf New API Key, um den Dialog zu öffnen.
Gib einen sprechenden Key Name ein, z. B. "production API key".
Klicke auf Generate Key und kopiere den Wert sofort.
Der Key wird nur einmal angezeigt. Nach dem Schliessen des Dialogs ist er nicht mehr einsehbar. Kopiere ihn sofort und bewahre ihn sicher auf.
Die Tabelle listet deine Keys mit Name, maskiertem Wert und Erstellungsdatum.
Dort löschst du einen Key, wenn er nicht mehr gebraucht wird; das wirkt sofort,
Anfragen mit diesem Key antworten danach mit 403 Forbidden.
Umgang mit Keys
- Keys sind geheim. Es gibt keine öffentliche Variante: jeder Key erreicht die gesamte API und gehört deshalb ausschliesslich auf den Server.
- Lege den Key in einer Umgebungsvariable ab (z. B.
TUIX_PDF_API_KEY), nicht in der Versionsverwaltung. - Nutze einen eigenen Key pro Umgebung und pro nutzendem Service, damit ein einzelner Key widerrufen werden kann, ohne den Rest zu treffen.
- Aus einer Browser-App heisst erzeugen: über das eigene Backend leiten, siehe Aus einem anderen Service.