Clave secreta

Tu clave de API funciona en el navegador, donde los dominios permitidos la protegen. Un servidor no tiene ningún dominio que comprobar, por lo que el contenido que traduces en un servidor, con React SSR, Next.js o Angular prerenderizado, utiliza una clave secreta en su lugar.

Las claves secretas comienzan con p-. Mantén el tuyo en el servidor y no lo pongas nunca en un código que se ejecute en el navegador.

Crea una clave secreta

Abre la página de tu cuenta y haz clic en Crear clave secreta en Tu clave secreta. La clave solo se muestra una vez, así que cópiala ahora mismo. Después, la página de la cuenta solo muestra sus cuatro últimos caracteres.

Tienes una clave secreta a la vez. Si se filtra o la pierdes, haz clic en Regenerar la clave secreta. La llave antigua deja de funcionar inmediatamente.

Úsalo en tu servidor

Establece la clave como la variable de entorno MAGIC_TRANSLATE_SECRET_KEY siempre que tu aplicación se renderice o compile, por ejemplo, en la configuración de tu proveedor de alojamiento o en tus secretos de CI.

MAGIC_TRANSLATE_SECRET_KEY=p-...

En un servidor, los clientes Magic Translate envían esta clave en lugar de tu clave de API. No necesitas cambiar ningún código. También puedes pasarlo de forma explícita:

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

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

En el navegador, los clientes nunca envían una clave secreta, ni siquiera una que pase como apiKey. En su lugar, registran un error.

Las claves secretas necesitan @magic-translate/react-ssr 1.3.0 o @magic-translate/angular 1.2.0 o posterior.

Cuando lo necesites

Las solicitudes que envían una clave secreta desde un navegador arrojan el error SECRET_KEY_IN_BROWSER. Una clave secreta ignora los dominios permitidos y funciona desde cualquier servidor.