مفتاح سري

يعمل مفتاح API الخاص بك في المتصفح، حيث تحميه النطاقات المسموح بها. لا يحتوي الخادم على مجال للتحقق منه، لذا فإن المحتوى الذي تترجمه على الخادم، مع العرض المسبق لـ React SSR أو Next.js أو Angular، يستخدم مفتاحًا سريًا بدلاً من ذلك.

تبدأ المفاتيح السرية بـ p-. احتفظ بها على الخادم ولا تضعها أبدًا في التعليمات البرمجية التي يتم تشغيلها في المتصفح.

قم بإنشاء مفتاح سري

افتح صفحة حسابك وانقر فوق إنشاء مفتاح سري ضمن مفتاحك السري. يتم عرض المفتاح مرة واحدة فقط، لذا انسخه على الفور. بعد ذلك، تعرض صفحة الحساب الأحرف الأربعة الأخيرة فقط.

لديك مفتاح سري واحد في كل مرة. إذا تسرب أو فقدته، انقر فوق إعادة إنشاء المفتاح السري. يتوقف المفتاح القديم عن العمل على الفور.

استخدمه على الخادم الخاص بك

عيّن المفتاح كمتغير البيئة MAGIC_TRANSLATE_SECRET_KEY أينما يتم عرض تطبيقك أو إنشاؤه، على سبيل المثال في إعدادات مزود الاستضافة أو أسرار CI الخاصة بك.

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 أو أحدث.

عندما تحتاج إلى واحدة

تقوم الطلبات التي ترسل مفتاحًا سريًا من متصفح بإرجاع الخطأ SECRET_KEY_IN_BROWSER. يتجاهل المفتاح السري المجالات المسموح بها ويعمل من أي خادم.