Ci sono due tipi di chiave e vivono in posti diversi. Una chiave di progetto traduce i contenuti per un sito. Una chiave di area di lavoro gestisce l'account. Se un plugin o un'integrazione richiede una chiave per tradurre, vuole quella di progetto.
La chiave di progetto
Apri il progetto, quindi Impostazioni API. La chiave è mascherata finché non scegli Mostra chiave API e Copia la inserisce negli appunti.
Questa è la chiave che utilizza il plugin WordPress e quella con cui si autentica l'API Translator. Ogni progetto ha la sua: una chiave di un progetto non tradurrà il sito di un altro progetto.
Rigenera la sostituisce. La vecchia chiave smette di funzionare nel momento in cui esiste quella nuova, quindi tutto ciò che la utilizza smette di tradurre finché non incolli quella nuova. Usala quando una chiave è stata compromessa, non per fare pulizia.
La chiave dell'area di lavoro
Apri l'area di lavoro, quindi Chiavi API, quindi Crea chiave. Queste sono chiavi con ambito di area di lavoro per accedere all'API della Piattaforma, che gestisce lingue, regole del glossario, siti e traduzioni archiviate.
Quattro differenze rispetto alla chiave di progetto:
- La vedi una volta sola. La chiave viene mostrata al momento della creazione e mai più, quindi copiala subito. Se la perdi, revocala e creane un'altra.
- Non c'è rigenerazione. Le chiavi vengono create e revocate. La revoca è immediata e interrompe qualsiasi cosa utilizzi quella chiave, il che la rende la risposta corretta a una fuga di notizie.
- Scadono. Scade tra è un campo obbligatorio al momento della creazione, che offre 30, 90, 180 o 365 giorni, e 180 è l'impostazione predefinita. Non è possibile estenderla e nulla oltre un anno. Una chiave scaduta restituisce un errore di autenticazione, quindi creane una sostitutiva e scambiala prima della data. Un'integrazione che smette di funzionare circa sei mesi dopo averla creata è solitamente questa.
- Portano solo le autorizzazioni che selezioni. Le autorizzazioni vengono scelte al momento della creazione e non possono superare le tue autorizzazioni in quell'area di lavoro, quindi una chiave creata senza alcuna selezione non può accedere a nulla. Fornisci a una chiave il minimo necessario.
Mantenere una chiave al sicuro
Una chiave è una password con il tuo conteggio di parole allegato. Chiunque la possieda può spenderla.
- Mantienila lato server. Una chiave in JavaScript frontend, in un pacchetto di app mobili o in un repository pubblico è una chiave che è stata ceduta.
- Non incollarla in un ticket di supporto, uno screenshot o un messaggio di chat. Se l'hai già fatto, sostituiscila.
- Ruota in caso di sospetto, non per programma: Rigenera per una chiave di progetto, Revoca per una chiave di area di lavoro.