문서화

시크릿 키

너의 API 키는 브라우저에서 작동해. 허용된 도메인은 키를 보호해.서버에는 확인할 도메인이 없어. 따라서 서버에서 React SSR, Next.js 또는 Angular 사전 렌더링을 사용하여 번역하는 콘텐츠는 비밀 키를 대신 사용해.

비밀 키는 p- 로 시작해.네 것은 서버에 보관하고 브라우저에서 실행되는 코드에 절대 넣지 마.

비밀 키 만들기

계정 페이지를 열고 비밀 키 아래에 비밀 키 만들기 클릭해.키는 한 번만 표시돼. 바로 복사해.그 이후에는 계정 페이지에 마지막 네 글자만 보여.

비밀 키는 한 번에 하나씩만 있어.유출되거나 분실되면 비밀 키 재생성 눌러줘.기존 키는 즉시 작동을 멈춰.

서버에서 사용해.

앱이 렌더링되거나 빌드되는 모든 곳, 예를 들어 호스팅 제공자 설정이나 CI 비밀에서 키를 MAGIC_TRANSLATE_SECRET_KEY 환경 변수로 설정해.

MAGIC_TRANSLATE_SECRET_KEY=p-...

서버에서는 Magic Translate 클라이언트가 너의 API 키 대신 이 키를 보낸대.어떤 코드도 바꿀 필요가 없어.명시적으로 전달할 수도 있어.

import { setupT } from '@magic-translate/react-ssr';
export const translate = setupT({
secretKey: process.env.MAGIC_TRANSLATE_SECRET_KEY
});

브라우저에서는 클라이언트가 비밀 키를 절대 보내지 않아. 비밀키는 apiKey 로 전달된 키라도.그들은 대신 오류를 기록해.

비밀 키는 @magic-translate/react-ssr 1.3.0 또는 @magic-translate/angular 1.2.0 이상이 필요해.

하나 필요할 때

너의 API 키비밀 키 없는 서버 요청
도메인 허용 안 돼.계속 일해.
도메인 허용 됐어.오류 SECRET_KEY_REQUIRED 돌려줘요

브라우저에서 비밀 키를 보내는 요청은 SECRET_KEY_IN_BROWSER 오류를 반환해.비밀 키는 허용된 도메인을 무시하고 모든 서버에서 작동해.