تسجيل الدخول
للأداة طريقان للدخول. تدفق المتصفح هو ما تستخدمه: لا شيء تنسخه، ولا شيء تلصقه، وبيانات الاعتماد تحفظ على القرص بالصلاحيات الصحيحة. أما مفتاح API في بيئتك فموجود للخوادم وأنظمة CI، حيث لا متصفح أصلًا.
وكل أمر يفشل بدون واحد منهما.
سجل الدخول بمتصفحك
Section titled “سجل الدخول بمتصفحك”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، أو خادم، أو حاوية بلا متصفح:
export SHAREK_API_KEY=your-api-keyخذ المفتاح من الإعدادات، ثم المطورون، ثم بطاقة مفتاح API في شارك. ومصادقة API تشرح تلك الشاشة.
ليست ضمن كل الخطط. لا يظهر تبويب المطورون إلا حين تتضمن خطتك واجهة API العامة، ولا تعمل الأداة إلا على خطة كهذه أيًا كانت طريقة دخولك. راجع الأسعار.
ولتوجيه الأداة إلى عنوان أساسي مختلف، وهو ما لا تحتاجه عادةً:
export SHAREK_API_URL=https://dash.sharek.app/apiويمكن تغيير خادم تسجيل الدخول بالطريقة نفسها، عبر SHAREK_AUTH_SERVER أو
sharek auth:login --auth-server <url>. وإن ضبطت الاثنين فالأولوية للخيار.
تحقق من حالة تسجيل الدخول
Section titled “تحقق من حالة تسجيل الدخول”sharek auth:statusيبلغ عن الطريقة المستخدمة ويعرض أول أحرف رمز الوصول أو المفتاح، ويسمي ملف بيانات الاعتماد بعد تسجيل الدخول بالمتصفح. ثم يستدعي API ليؤكد أن بيانات الاعتماد ما زالت تعمل ويخبرك بعدد القنوات المربوطة. وبيانات الاعتماد المنتهية أو المسحوبة يبلغ عنها بذلك بدل أن تفشل عند الأمر التالي.
سجل الخروج
Section titled “سجل الخروج”sharek auth:logoutيحذف ~/.sharek/credentials.json. وإن كان SHAREK_API_KEY مضبوطًا في بيئتك، رجعت الأداة
إليه من الأمر التالي فصاعدًا.
حين يتعذر تسجيل الدخول
Section titled “حين يتعذر تسجيل الدخول”- «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.
إلى أين بعد ذلك
Section titled “إلى أين بعد ذلك”- مرجع الأوامر بعد أن سجلت الدخول.
- سحب بيانات اعتماد إن ظننت أنها تسربت: مع
SHAREK_API_KEYيلزمك تدوير مفتاح API، ومع تسجيل الدخول بالمتصفح ألغ وصول الأداة من الإعدادات ← التطبيقات ← التطبيقات المصرح لها.