Chìa khóa bí mật

Khóa API của bạn hoạt động trong trình duyệt, nơi các miền được phép bảo vệ nó. Một máy chủ không có tên miền để kiểm tra, vì vậy nội dung bạn dịch trên máy chủ, với React SSR, Next.js hoặc Angular, sử dụng khóa bí mật thay thế.

Các phím bí mật bắt đầu bằng p-. Giữ của bạn trên máy chủ và không bao giờ đưa nó vào mã chạy trong trình duyệt.

Tạo khóa bí mật

Mở trang tài khoản của bạn và nhấp vào Tạo khóa bí mật dưới Kh óa bí mật của bạn. Chìa khóa chỉ được hiển thị một lần, vì vậy hãy sao chép nó ngay lập tức. Sau đó, trang tài khoản chỉ hiển thị bốn ký tự cuối cùng của nó.

Bạn có một chìa khóa bí mật tại một thời điểm. Nếu nó bị rò rỉ hoặc bạn mất nó, hãy nhấp vào Tạo khóa bí mật. Chìa khóa cũ ngừng hoạt động ngay lập tức.

Sử dụng nó trên máy chủ của bạn

Đặt khóa làm biến môi trường MAGIC_TRANSLATE_SECRET_KEY bất cứ nơi nào ứng dụng của bạn hiển thị hoặc xây dựng, ví dụ: trong cài đặt của nhà cung cấp dịch vụ lưu trữ hoặc bí mật CI của bạn.

MAGIC_TRANSLATE_SECRET_KEY=p-...

Trên máy chủ, ứng dụng khách Magic Translate gửi khóa này thay vì khóa API của bạn. Bạn không cần phải thay đổi bất kỳ mã nào. Bạn cũng có thể truyền nó một cách rõ ràng:

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

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

Trong trình duyệt, khách hàng không bao giờ gửi một khóa bí mật, ngay cả một khóa được thông qua là apiKey. Thay vào đó, họ ghi lại một lỗi.

Các khóa bí mật cần @magic-translate/react-ssr 1.3.0 hoặc @magic-translate/angular 1.2.0 hoặc mới hơn.

Khi bạn cần một

Các yêu cầu gửi khóa bí mật từ trình duyệt trả về lỗi SECRET_KEY_IN_BROWSER. Một khóa bí mật bỏ qua các tên miền được phép của bạn và hoạt động từ bất kỳ máy chủ nào.