Tajny klucz

Twój klucz API działa w przeglądarce, gdzie chronią go dozwolone domeny. Serwer nie ma domeny do sprawdzenia, więc zawartość tłumaczona na serwerze z prerenderowaniem React SSR, Next.js lub Angular używa zamiast tego klucza tajnego.

Tajne klucze zaczynają się od p-. Zachowaj swój na serwerze i nigdy nie umieszczaj go w kodzie działającym w przeglądarce.

Utwórz tajny klucz

Otwórz stronę konta i kliknij Utwórz tajny klucz w obszarze Twój tajny klucz. Klucz jest wyświetlany tylko raz, więc skopiuj go od razu. Następnie strona konta pokazuje tylko ostatnie cztery znaki.

Masz jeden sekretny klucz na raz. Jeśli wycieknie lub go zgubisz, kliknij przycisk Z regeneruj tajny klucz. Stary klucz natychmiast przestaje działać.

Użyj go na swoim serwerze

Ustaw klucz jako zmienną środowiskową MAGIC_TRANSLATE_SECRET_KEY wszędzie tam, gdzie aplikacja renderuje lub tworzy, na przykład w ustawieniach dostawcy hostingu lub w sekretach CI.

MAGIC_TRANSLATE_SECRET_KEY=p-...

Na serwerze klienci Magic Translate wysyłają ten klucz zamiast klucza API. Nie musisz zmieniać żadnego kodu. Możesz również przekazać go wyraźnie:

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

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

W przeglądarce klienci nigdy nie wysyłają tajnego klucza, nawet jednego przekazanego jako apiKey. Zamiast tego rejestrują błąd.

Tajne klucze wymagają @magic-translate/react-ssr 1.3.0 lub @magic-translate/angular 1.2.0 lub nowszego.

Kiedy potrzebujesz jednego

Żądania wysyłające tajny klucz z przeglądarki zwracają błąd SECRET_KEY_IN_BROWSER. Tajny klucz ignoruje dozwolone domeny i działa z dowolnego serwera.