Chiave segreta

La tua chiave API funziona nel browser, dove i domini consentiti la proteggono. Un server non ha un dominio da controllare, quindi i contenuti che traduci su un server, con prerendering React SSR, Next.js o Angular, utilizzano invece una chiave segreta.

Le chiavi segrete iniziano con p-. Conserva il tuo sul server e non inserirlo mai in codice che viene eseguito nel browser.

Crea una chiave segreta

Apri la pagina del tuo account e fai clic su Crea chiave segreta sotto La tua chiave segreta. La chiave viene mostrata solo una volta, quindi copiala subito. Successivamente la pagina dell'account mostra solo gli ultimi quattro caratteri.

Hai una chiave segreta alla volta. Se viene divulgata o la perdi, fai clic su Rigenera chiave segreta. La vecchia chiave smette di funzionare immediatamente.

Usalo sul tuo server

Imposta la chiave come variabile di ambiente MAGIC_TRANSLATE_SECRET_KEY ovunque venga renderizzata o creata la tua app, ad esempio nelle impostazioni del tuo provider di hosting o nei tuoi segreti CI.

MAGIC_TRANSLATE_SECRET_KEY=p-...

Su un server, i client Magic Translate inviano questa chiave anziché la tua chiave API. Non è necessario modificare alcun codice. Puoi anche passarlo esplicitamente:

import { setupT } from '@magic-translate/react-ssr';

export const translate = setupT({
  secretKey: process.env.MAGIC_TRANSLATE_SECRET_KEY
});

Nel browser, i clienti non inviano mai una chiave segreta, nemmeno una passata come apiKey. Registrano invece un errore.

Le chiavi segrete richiedono @magic-translate/react-ssr 1.3.0 o @magic-translate/angular 1.2.0 o versioni successive.

Quando ne hai bisogno

Le richieste che inviano una chiave segreta da un browser restituiscono l'errore SECRET_KEY_IN_BROWSER. Una chiave segreta ignora i domini consentiti e funziona da qualsiasi server.