Chave secreta

Sua chave de API funciona no navegador, onde os domínios permitidos a protegem. Um servidor não tem domínio para verificar, então o conteúdo que você traduz em um servidor, com pré-renderização React SSR, Next.js ou Angular, usa uma chave secreta.

As chaves secretas começam com p-. Mantenha o seu no servidor e nunca o coloque em um código executado no navegador.

Crie uma chave secreta

Abra a página da sua conta e clique em Criar chave secreta em Sua chave secreta. A chave é mostrada apenas uma vez, então copie-a imediatamente. Depois disso, a página da conta mostra apenas os últimos quatro caracteres.

Você tem uma chave secreta por vez. Se vazar ou você perdê-la, clique em Regenerar chave secreta. A chave antiga para de funcionar imediatamente.

Use-o em seu servidor

Defina a chave como a variável de ambiente MAGIC_TRANSLATE_SECRET_KEY onde quer que seu aplicativo seja renderizado ou construído, por exemplo, nas configurações do seu provedor de hospedagem ou em seus segredos de CI.

MAGIC_TRANSLATE_SECRET_KEY=p-...

Em um servidor, os clientes Magic Translate enviam essa chave em vez da sua chave de API. Você não precisa alterar nenhum código. Você também pode passá-lo explicitamente:

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

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

No navegador, os clientes nunca enviam uma chave secreta, mesmo que seja passada como apiKey. Em vez disso, eles registram um erro.

As chaves secretas precisam de @magic-translate/react-ssr 1.3.0 ou @magic-translate/angular 1.2.0 ou posterior.

Quando você precisar de um

Solicitações que enviam uma chave secreta de um navegador retornam o erro SECRET_KEY_IN_BROWSER. Uma chave secreta ignora seus domínios permitidos e funciona em qualquer servidor.