أمر تسجيل الدخول في Intlayer CLI

الوصف

يتيح أمر login في Intlayer CLI المصادقة مع نظام إدارة المحتوى Intlayer. يقوم هذا الأمر تلقائيًا بفتح متصفحك الافتراضي لإكمال عملية المصادقة واستلام بيانات الاعتماد اللازمة (Client ID و Client Secret) لاستخدام خدمات Intlayer.

الاستخدام

npx intlayer login [options]

أو

intlayer login [options]

الخيارات

--cms-url <url>

حدد عنوان URL الخاص بـ Intlayer CMS للاتصال به لإجراء المصادقة.

• النوع: string
• الافتراضي: القيمة المكوّنة في intlayer.config.* أو https://intlayer.org
• مثال:

npx intlayer login --cms-url https://intlayer.org

خيارات التكوين

يمكنك أيضًا استخدام خيارات التكوين الشائعة:

• --env-file <path>: مسار ملف البيئة
• -e, --env <env>: بيئة التنفيذ
• --base-dir <dir>: الدليل الأساسي للمشروع
• --verbose: تفعيل الإخراج التفصيلي (الافتراضي: true)
• --prefix <prefix>: بادئة للسجلات

كيف يعمل

1. بدء خادم محلي: يقوم الأمر بتشغيل خادم HTTP محلي على منفذ عشوائي لاستقبال بيانات الاعتماد من الـ CMS
2. فتح المتصفح: يقوم الأمر تلقائيًا بفتح متصفحك الافتراضي إلى عنوان تسجيل الدخول الخاص بالـ CMS
3. المصادقة: أكمل عملية المصادقة في المتصفح باستخدام حساب Intlayer الخاص بك
4. استلام بيانات الاعتماد: يستقبل الخادم المحلي معرف العميل (Client ID) وسر العميل (Client Secret) من الـ CMS
5. التعليمات: يعرض الأمر تعليمات لتكوين بيانات الاعتماد في مشروعك

المخرجات

بعد تسجيل دخول ناجح، سيعرض الأمر:

1. بيانات الاعتماد المستلمة (Client ID و Client Secret)
2. تعليمات لملف .env:

INTLAYER_CLIENT_ID=your_client_id
INTLAYER_CLIENT_SECRET=your_client_secret

3. تعليمات لملف تكوين Intlayer:

{
  editor: {
    cmsURL: 'https://intlayer.org',
    clientId: process.env.INTLAYER_CLIENT_ID,
    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
  },
}

الحفاظ على مفتاح الوصول آمناً

يصدر intlayer login مفتاح وصول: زوج clientId / clientSecret يستخدمه كل أمر مفوّض (push, pull, fill, configuration push, live, …) للمصادقة.

import type { IntlayerConfig } from "intlayer";

const config: IntlayerConfig = {
  editor: {
    clientId: process.env.INTLAYER_CLIENT_ID,
    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
  },
};

export default config;

clientSecret بيانات اعتماد من جانب الخادم. تمنح الوصول الكامل إلى API بنطاق المشروع — قراءة وكتابة قواميس المشروع والمشروع والمؤسسة الخاصة بك. احفظها في .env (تم تجاهلها من git) أو متجر أسرار CI الخاص بك، ولا تضمّنها أبداً في ملف الإعدادات.

يفرض Intlayer هذا بدلاً من توثيقه فقط:

• clientSecret تم حذفه من الإعدادات التي ينقلها bundler الخاص بك، لذا لا يمكن أن يصل إلى حزمة متصفح مهما كان التكامل الإطار الذي تستخدمه. يتم قراءته فقط من جانب الخادم، في وقت التشغيل، من البيئة.
• clientId مختلف: فهو المفتاح العام للمشروع، آمن للشحن، وتستخدمه @intlayer/analytics للحصول على رمز قصير العمر وحصري للإدخال.

التعليق على clientId كافٍ لتعطيل كل السلوك المفوّض — جلب القاموس عن بعد، والوصول إلى CMS، والتحليلات — حتى عندما تكون متغيرات البيئة محددة.

بالنسبة لـ CI pipelines، فضّل أمر ci، الذي يحقن بيانات الاعتماد لمدة تشغيل واحد بدلاً من الاستمرار فيها.

التكوين اليدوي

إذا لم يفتح المتصفح تلقائيًا، يمكنك زيارة عنوان URL المعروض في الطرفية يدويًا.

أمثلة

تسجيل الدخول باستخدام عنوان CMS مخصص

npx intlayer login --cms-url https://custom-cms.example.com

تسجيل الدخول باستخدام ملف بيئة محدد

npx intlayer login --env-file .env.production

تسجيل الدخول بوضع الإخراج التفصيلي

npx intlayer login --verbose

استكشاف الأخطاء وإصلاحها

المتصفح لا يفتح

إذا لم يفتح المتصفح تلقائيًا، انسخ عنوان URL المعروض في الطرفية وافتحه يدويًا في متصفحك.

مشاكل الاتصال

إذا واجهت مشاكل في الاتصال، فتأكد من:

1. أن عنوان URL الخاص بالـ CMS صحيح
2. أن اتصال الإنترنت لديك يعمل بشكل صحيح
3. أنه لا توجد جدران حماية تمنع الاتصال

لم يتم استلام بيانات الاعتماد

إذا لم يتم استلام بيانات الاعتماد:

1. تأكد من أنك أتممت عملية المصادقة في المتصفح
2. تحقق من أن المنفذ المحلي غير محظور
3. حاول الأمر مرة أخرى

الخطوات التالية

بعد إتمام تسجيل الدخول:

1. أضف بيانات الاعتماد إلى ملف .env الخاص بك
2. قم بتكوين ملف intlayer.config.* باستخدام بيانات الاعتماد
3. استخدم أوامر CLI لإدارة القواميس الخاصة بك:
   • npx intlayer push - ادفع القواميس إلى الـ CMS
   • npx intlayer pull - اسحب القواميس من الـ CMS
   • npx intlayer fill - املأ الترجمات المفقودة

راجع أيضًا

• توثيق CLI
• تكوين Intlayer
• Intlayer CMS