تخطَّ إلى المحتوى

تسجيل الدخول

للأداة طريقان للدخول. تدفق المتصفح هو ما تستخدمه: لا شيء تنسخه، ولا شيء تلصقه، وبيانات الاعتماد تحفظ على القرص بالصلاحيات الصحيحة. أما مفتاح API في بيئتك فموجود للخوادم وأنظمة CI، حيث لا متصفح أصلًا.

وكل أمر يفشل بدون واحد منهما.

Terminal window
sharek auth:login

تطلب الأداة من https://cli-auth.sharek.app رمزًا، وتطبعه في إطار، وتفتح متصفحك على صفحة خادم تسجيل الدخول والرمز مملوء فيها:

🔐 Starting device authorization flow...
Your authorization code:
┌─────────────────┐
│ ABCD-EFGH │
└─────────────────┘
Open this URL and enter the code above:
https://cli-auth.sharek.app/device/verify
Waiting for authorization...

اضغط Authorize في تلك الصفحة، ثم تصريح في شاشة شارك التي تنقلك إليها، وسجل الدخول أولًا إن طلب شارك ذلك. تفحص الطرفية كل خمس ثوانٍ، فتلتقط الموافقة فور وقوعها تقريبًا وتحفظ بيانات الاعتماد.

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

أين تحفظ بيانات الاعتماد

Section titled “أين تحفظ بيانات الاعتماد”

في ~/.sharek/credentials.json، مكتوبًا بحيث لا يقرأه غيرك. يحمل ذلك الملف رمز الوصول الذي ترسله الأداة في كل استدعاء، فعامله معاملة مفتاح SSH. فنسخه إلى جهاز آخر يعمل، وكذلك يعمل لأي شخص آخر يقع عليه.

سجل الدخول بمفتاح API بدلًا من ذلك

Section titled “سجل الدخول بمفتاح API بدلًا من ذلك”

لأنظمة CI، أو خادم، أو حاوية بلا متصفح:

Terminal window
export SHAREK_API_KEY=your-api-key

خذ المفتاح من الإعدادات، ثم المطورون، ثم بطاقة مفتاح API في شارك. ومصادقة API تشرح تلك الشاشة.

ليست ضمن كل الخطط. لا يظهر تبويب المطورون إلا حين تتضمن خطتك واجهة API العامة، ولا تعمل الأداة إلا على خطة كهذه أيًا كانت طريقة دخولك. راجع الأسعار.

ولتوجيه الأداة إلى عنوان أساسي مختلف، وهو ما لا تحتاجه عادةً:

Terminal window
export SHAREK_API_URL=https://dash.sharek.app/api

ويمكن تغيير خادم تسجيل الدخول بالطريقة نفسها، عبر SHAREK_AUTH_SERVER أو sharek auth:login --auth-server <url>. وإن ضبطت الاثنين فالأولوية للخيار.

تحقق من حالة تسجيل الدخول

Section titled “تحقق من حالة تسجيل الدخول”
Terminal window
sharek auth:status

يبلغ عن الطريقة المستخدمة ويعرض أول أحرف رمز الوصول أو المفتاح، ويسمي ملف بيانات الاعتماد بعد تسجيل الدخول بالمتصفح. ثم يستدعي API ليؤكد أن بيانات الاعتماد ما زالت تعمل ويخبرك بعدد القنوات المربوطة. وبيانات الاعتماد المنتهية أو المسحوبة يبلغ عنها بذلك بدل أن تفشل عند الأمر التالي.

Terminal window
sharek auth:logout

يحذف ~/.sharek/credentials.json. وإن كان SHAREK_API_KEY مضبوطًا في بيئتك، رجعت الأداة إليه من الأمر التالي فصاعدًا.

  • «Could not reach auth server» تعني أن الأداة لم تصل إلى https://cli-auth.sharek.app. افحص الشبكة وأي وسيط. واختبار سريع هو curl https://cli-auth.sharek.app/health، الذي يجيب {"status":"ok"}.
  • انتهاء الرمز وأنت بعيد. نفذ sharek auth:login مرة أخرى للحصول على رمز جديد.
  • فشل الأوامر مباشرة بعد تسجيل الدخول. نفذ sharek auth:status. فإن قال إن بيانات الاعتماد منتهية أو غير صالحة: بعد تسجيل الدخول بالمتصفح، يكون وصول الأداة قد ألغي من الإعدادات ← التطبيقات ← التطبيقات المصرح لها، فنفذ sharek auth:login من جديد؛ ومع SHAREK_API_KEY يكون المفتاح قد جرى تدويره، فاضبط المفتاح الجديد. وتظهر الرسالة نفسها أيضًا حين لا تتضمن خطتك واجهة API.
  • مرجع الأوامر بعد أن سجلت الدخول.
  • سحب بيانات اعتماد إن ظننت أنها تسربت: مع SHAREK_API_KEY يلزمك تدوير مفتاح API، ومع تسجيل الدخول بالمتصفح ألغ وصول الأداة من الإعدادات ← التطبيقات ← التطبيقات المصرح لها.