Es gibt zwei Arten von Schlüsseln, und sie befinden sich an unterschiedlichen Orten. Ein Projektschlüssel übersetzt Inhalte für eine Website. Ein Workspace-Schlüssel verwaltet das Konto. Wenn ein Plugin oder eine Integration nach einem Schlüssel zur Übersetzung fragt, benötigt sie den Projektschlüssel.
Der Projektschlüssel
Öffne das Projekt und dann API-Einstellungen. Der Schlüssel ist maskiert, bis du API-Schlüssel anzeigen wählst, und Kopieren legt ihn in deine Zwischenablage.
Dies ist der Schlüssel, den das WordPress-Plugin verwendet, und der Schlüssel, mit dem die Translator API authentifiziert. Jedes Projekt hat seinen eigenen: Ein Schlüssel von einem Projekt übersetzt nicht die Website eines anderen Projekts.
Erneut generieren ersetzt ihn. Der alte Schlüssel funktioniert im Moment, in dem der neue existiert, nicht mehr. Alles, was ihn noch verwendet, hört auf zu übersetzen, bis du den neuen einfügst. Verwende ihn, wenn ein Schlüssel durchgesickert ist, nicht zur Bereinigung.
Der Workspace-Schlüssel
Öffne den Workspace und dann API-Schlüssel, dann Schlüssel erstellen. Dies sind Workspace-bezogene Schlüssel für den Zugriff auf die Platform API, die Sprachen, Glossarregeln, Websites und gespeicherte Übersetzungen verwaltet.
Vier Unterschiede zum Projektschlüssel:
- Du siehst ihn einmal. Der Schlüssel wird angezeigt, wenn du ihn erstellst, und nie wieder. Kopiere ihn also sofort. Wenn du ihn verlierst, widerrufe ihn und erstelle einen neuen.
- Es gibt kein Erneut generieren. Schlüssel werden erstellt und widerrufen. Der Widerruf ist sofortig und unterbricht alles, was diesen Schlüssel verwendet, was ihn zur richtigen Reaktion auf ein Leck macht.
- Sie laufen ab. Läuft ab in ist ein Pflichtfeld bei der Erstellung und bietet 30, 90, 180 oder 365 Tage, wobei 180 Tage der Standard sind. Es gibt keine Verlängerung und nichts Längeres als ein Jahr. Ein abgelaufener Schlüssel gibt einen Authentifizierungsfehler zurück. Erstelle also einen Ersatz und tausche ihn vor dem Datum aus. Eine Integration, die etwa sechs Monate nach ihrer Erstellung nicht mehr funktioniert, ist normalerweise darauf zurückzuführen.
- Sie tragen nur die Berechtigungen, die du auswählst. Berechtigungen werden bei der Erstellung ausgewählt und können deine eigenen Berechtigungen in diesem Workspace nicht überschreiten. Ein Schlüssel, der ohne ausgewählte Berechtigungen erstellt wurde, kann nichts erreichen. Gib einem Schlüssel das Minimum, das er benötigt.
Einen Schlüssel sicher aufbewahren
Ein Schlüssel ist ein Passwort mit deinem Wortguthaben daran. Jeder, der ihn besitzt, kann ihn ausgeben.
- Bewahre ihn serverseitig auf. Ein Schlüssel in Frontend-JavaScript, in einem mobilen App-Bundle oder in einem öffentlichen Repository ist ein Schlüssel, der weggegeben wurde.
- Füge ihn nicht in ein Support-Ticket, einen Screenshot oder eine Chat-Nachricht ein. Wenn du es bereits getan hast, ersetze ihn.
- Rotiere bei Verdacht, nicht nach Zeitplan: Erneut generieren für einen Projektschlüssel, Widerrufen für einen Workspace-Schlüssel.