مرجع واجهة سطر الأوامر (CLI) لـ Edge Microgateway

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X.
معلومات

Edge Microgateway الإصدار 2.4.x

نظرة عامة

يتيح لك واجهة سطر الأوامر Microgateway التحكم في جميع جوانب بوابة Edge Microgateway وإدارتها مثال.

إدارة الشهادات

تتيح لك أوامر cert إمكانية تثبيت المفتاح العام/الخاص وإدارته. الزوج الذي يستخدم لتوقيع الرموز المميزة للحامل التي يستخدمها العملاء لإجراء مكالمات آمنة من خلال Edge مدخل مصغّر. يتم تخزين المفاتيح على Apigee Edge في خريطة مشفّرة لقيم المفاتيح (KVM). تستخدم بوابة Edge Microgateway مفتاح عام لإثبات صحة رموز الحامل الموقَّعة. يتم إنشاء هذه المفاتيح عند تشغيل Edgemicro. إعداد الأمر، كما هو موضح في قسم الإعدادات وضبط إعدادات بوابة Edge Microgateway يمكنك استخدام أوامر cert الموضحة هنا لإعادة إنشاء هذه المفاتيح وإدارتها إذا لزم الأمر.

تثبيت شهادة

تثبِّت المفاتيح في خريطة قيم مفتاح مشفّرة (KVM) باستخدام خدمة التخزين الآمن في Apigee Edge وتعرض المفتاح العام كإخراج. يتم تحديد أزواج المفاتيح في مؤسسة محدّدة.

الاستخدام

edgemicro cert install -o [organization] -e [environment] -u [username] -p [password] --force

المعلّمات

المعلمات الوصف
-o, --org مؤسسة Apigee التي ضبطت لها Edge Microgateway.
-e, --env بيئة ضبطت لها بوابة Edge Microgateway.
-u, --username اسم مستخدم Apigee. يجب أن تكون مشرف المؤسسة لما تم تحديده التنظيم.
-p, --password (اختياري) كلمة مرورك. سيُطلب منك في حال عدم تقديم هذه المَعلمة في سطر الأوامر.
-f, --force (اختياري) في حال تخزين مفتاح من قبل في KVM المشفر، يمكنك فرض استبداله.
-h, --help معلومات استخدام الإخراج

مثال

edgemicro cert install -o docs -e test -u jdoe@example.com -f

الناتج

current nodejs version is v6.1.0
current edgemicro version is 2.2.4-beta
password:
deleting vault
creating vault
adding private_key
adding public_key
installed cert

حذف شهادة

يؤدي هذا الإجراء إلى حذف مفتاحَي التشفير لمؤسسة.

الاستخدام

edgemicro cert delete -o [organization] -e [environment] -u [username] -p [password]

المعلّمات

المعلمات الوصف
-o, --org مؤسسة Apigee التي ضبطت لها Edge Microgateway.
-e, --env بيئة ضبطت لها بوابة Edge Microgateway.
-u, --username اسم مستخدم Apigee. يجب أن تكون مشرف المؤسسة لما تم تحديده التنظيم.
-p, --password (اختياري) كلمة مرورك. سيُطلب منك في حال عدم تقديم هذه المَعلمة في سطر الأوامر.
-h, --help معلومات استخدام الإخراج

مثال

edgemicro cert delete -o docs -e test -u jdoe@example.com 

الناتج

deleting vault
Vault deleted!

التحقّق من الشهادة

يتحقّق من أنّ مؤسستك لديها شهادة مثبَّتة.

الاستخدام

edgemicro cert check -o [organization] -e [environment] -u [username] -p [password]

المعلّمات

المعلمات الوصف
-o, --org مؤسسة Apigee التي ضبطت لها Edge Microgateway.
-e, --env بيئة ضبطت لها بوابة Edge Microgateway.
-u, --username اسم مستخدم Apigee. يجب أن تكون مشرف المؤسسة لما تم تحديده التنظيم.
-p, --password (اختياري) كلمة مرورك. سيُطلب منك في حال عدم تقديم هذه المَعلمة في سطر الأوامر.
-h, --help معلومات استخدام الإخراج

مثال

edgemicro cert check -o docs -e test -u jdoe@example.com

الناتج (بنجاح)

checked cert successfully

الناتج (تعذُّر)

إذا لم تكن الشهادة موجودة، سيتم عرض خطأ.

الحصول على المفتاح العام

تعرض المفتاح العام للمؤسسة المحددة. لا يتطلب المصادقة.

الاستخدام

edgemicro cert public-key -o [organization] -e [environment]

المعلّمات

المعلمات الوصف
-o, --org مؤسسة Apigee التي ضبطت لها Edge Microgateway.
-e, --env بيئة ضبطت لها بوابة Edge Microgateway.
-h, --help معلومات استخدام الإخراج

مثال

edgemicro cert public-key -o docs -e test

الناتج (نموذج)

-----BEGIN CERTIFICATE----- 

MIICpDCCAYwCCQCKpXWGum9uTjANBgkq9w0BAQsFADAUMRIwEAYDVQQDEwls
b2NhbGhvc3cNMTYxMTAyMjAxNTA2WhcNMTYxMTAzMjAxNTA2WjAUMRIwEAYD
VQQDEwlsb2Nvc3QwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDD
ETr/ne/gP47+9LgjLvBJjpbFVdaeUabZZ3wbA7sSIVnnNXWt3yPklrWSfIh+
L2+dq4k+YunsQE2+dwPdXA2x8DPGvqGcCdWPxnpZ7ix5Akbs8i/J+Ue0pXT4
jkpWbaDDftGL2tcxwP45yI+slpDYvmWRps07TFXkAPjGEHYPvCT9/v/35GkL
0h4v0S+XfpcjS5c47o7CIWlkgEM5GBosQUb17kuVR48392vGFPsnCP34iNe7
zguhiCXYg2zkOcj/N3AE4xKIhCz0QcewULy08GltWMmyjJ/30zs8P41JqoA4
RwfeEZ8RenN3rJQim1ppAAEwDQYJKoZIhvcNAQELBQADggEBAHcORIfc+ySe
2FMmqicNe6Wt5V/5zOaBMLsGQdqGOHB5cQc79sMBrk680KVhrwHXZ2nBIkVe
UEL+2qLY1VLfswBNAvcNwV9U4TwHq4eIANiD751oJK1tHmM/ujThQkwNf96o
6I7Ws+wfpGO3ppJCttRbtnATIxrwsCHN4i5lbW/tJSL7t/Zf6T1B+YSJU9AF
xuvLq22cCqyYJQdmKq2vVS55WRZdllm+mRtJrv7MLM9gfDPRxVlwrBz/eQHy
Fv+dwzxcvQjkz03RNhZUodzuD34DPJoYeK++rItsddwQ26KTahH80yYTAFzY
x9gfPf1/+qo=  

-----END CERTIFICATE-----

تكوين بوابة Edge الصغيرة في Apigee سحابة الحافة

يعمل على تفعيل Edge Microgateway للعمل مع مثيل Apigee Edge Cloud. التفاف وتنفيذ سلسلة من الأوامر لنشر الخادم الوكيل المطلوب للمصادقة على Edge وإنشاء المصادقة والرموز المميزة، وتحديث ملفات التكوين. للحصول على مثال عمل كامل، راجع إعدادات وضبط إعدادات بوابة Edge Microgateway

الاستخدام

edgemicro configure -o [organization] -e [environment] -u [username] -p [password]

المعلّمات

المعلمات الوصف
-o, --org مؤسسة Apigee التي ضبطت لها Edge Microgateway.
-e, --env بيئة ضبطت لها بوابة Edge Microgateway.
-u, --username اسم مستخدم Apigee. يجب أن تكون مشرف المؤسسة لما تم تحديده التنظيم.
-p, --password (اختياري) كلمة مرورك. سيُطلب منك في حال عدم تقديم هذه المَعلمة في سطر الأوامر.
-r, --url (اختياري) تحدِّد هذه السياسة الاسم المستعار للمضيف الافتراضي الخاص بمؤسستك:environment. يمكنك الاطّلاع على وثائق Edge للتعرف على المضيفات الظاهرية. عناوين URL التلقائية: org-env.apigee.net
-c, --configDir (اختياري) يحدد المسار إلى ملف إعداد Edge Microgateway. بشكل افتراضي، يكون ملف الإعداد في ./config/config.yaml. (مضاف) v2.4.x)
-x, --proxyName (اختياري) يتم ضبط المسار الأساسي للخادم الوكيل edgemicro-auth. في حال تفعيل الخادم الوكيل edgemicro-auth ضمن مسار مختلف من /edgemicro-auth التلقائي، تتيح لك هذه الميزة ضبط مسارًا جديدًا في بوابة Edge Microgateway. بشكل افتراضي، هي /edgemicro-auth (تمت الإضافة الإصدار 2.4.x)
-t, --token (اختياري) يسمح لك باستخدام رمز OAuth المميز للمصادقة بدلاً من اسم المستخدم/كلمة المرور. مثال:

edgemicro configure -o docs -e test -t <your token>
-v, --virtualHosts (اختياري) لإلغاء المضيفات الافتراضية الافتراضية، وهي "default,secure". استخدم هذا الخيار إذا كانت لديك مضيفات افتراضية محددة لموقعك Edge organisation:environment آخر غير هذه الإعدادات التلقائية. اطلع على وثائق Edge والتعرف على المضيفات الظاهرية.
-d, --debug (اختياري) يتم تقديم معلومات تصحيح الأخطاء.
-h, --help معلومات استخدام الإخراج

ملاحظات الاستخدام

يخزن هذا الأمر معلومات التهيئة في /.edgemicro/org-env-config.yaml تقريبًا.

مثال

edgemicro configure -o docs -e test -u jdoe@example.com

الناتج

بعد نجاح الأمر، يعرض الأمر مجموعة من المفاتيح التي تحتاج إلى استخدامها عند بدء تشغيل Edge مدخل مصغّر.

...

The following credentials are required to start edge micro
  key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f
  secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372

edgemicro configuration complete!

إنشاء المفاتيح

ينشئ الأمر genkeys زوجًا رئيسيًا وسرًا يستخدمهما Edge. مدخل Microgateway للمصادقة الذاتية عند نشر بيانات الإحصاءات بشكل غير متزامن في Apigee الحافة.

الاستخدام

edgemicro genkeys -o [organization] -e [environment] -u [username] -p [password]

المعلّمات

المعلمات الوصف
-o, --org مؤسسة Apigee التي ضبطت لها Edge Microgateway.
-e, --env بيئة ضبطت لها بوابة Edge Microgateway.
-u, --username اسم مستخدم Apigee. يجب أن تكون مشرف المؤسسة لما تم تحديده التنظيم.
-p, --password (اختياري) كلمة مرورك. سيُطلب منك في حال عدم تقديم هذه المَعلمة في سطر الأوامر.
-h, --help معلومات استخدام الإخراج

ملاحظات الاستخدام

بعد النجاح، يعرض الأمر ثلاثة عناصر. الأول هو عنوان URL الذي يجب وضعه ملف التهيئة. الاثنين الآخران هما زوج مفاتيح مطلوبين عند تشغيل Edge. مثيل المدخل المصغّر.

  • عنوان URL لـ Bootstapp: يشير عنوان URL هذا إلى خدمة Apigee Edge التي تتيح مثيل Edge Microgateway لإرسال بيانات الإحصاءات إلى Apigee Edge عليك نسخ عنوان URL هذا. في ملف إعداد Edge Microgateway: ~/.edgemicro/org-env-config.yaml.
  • key: المفتاح. هذا المفتاح والسر مطلوبان كإدخال في واجهة سطر الأوامر المستخدم لبدء مثيل Edge Microgateway.
  • secret: السر.

مثال

edgemicro genkeys -o docs -e test -u jdoe@example.com

الناتج (نموذج)

بعد نجاح الأمر، يعرض الأمر مجموعة من المفاتيح التي تحتاج إلى استخدامها عند بدء تشغيل Edge مدخل مصغّر.

configuring host edgemicroservices-us-east-1.apigee.net for region us-east-1
Please copy the following property to the edge micro agent config
  bootstrap: https://edgemicroservices-us-east-1.apigee.net/edgemicro/bootstrap/organization/jdoe/environment/test

The following credentials are required to start edge micro
  key: db39324077989c75eac34c13d285772ea8e3b982b957b3f52916f3048511443f
  secret: 5bf8da39de0056f88fdd5f25a8602d22f312c1c8c870580a5fef55ac6637b7ae

finished

تكوين بوابة Edge الصغيرة لـ السحابة الإلكترونية الخاصة في Apigee Edge

تعمل هذه السياسة على ضبط Edge Microgateway للعمل مع تثبيت Apigee Edge Private Cloud.

الاستخدام

edgemicro private configure -o [organization] -e [environment] -u [username] -p [password]

المعلّمات

المعلمات الوصف
-o, --org مؤسسة Apigee التي ضبطت لها Edge Microgateway.
-e, --env بيئة ضبطت لها بوابة Edge Microgateway.
-u, --username اسم مستخدم Apigee. يجب أن تكون مشرف المؤسسة لما تم تحديده التنظيم.
-p, --password (اختياري) كلمة مرورك. سيُطلب منك في حال عدم تقديم هذه المَعلمة في سطر الأوامر.
-r, --runtime-url تُحدِّد هذه السياسة عنوان URL لبيئة التشغيل لمثيل السحابة الإلكترونية الخاص.
-m, --mgmt-url عنوان URL لخادم الإدارة لمثيل السحابة الإلكترونية الخاص بك.
-v, --virtualHosts قائمة مفصولة بفواصل للمضيفات الافتراضية لمؤسستك:بيئتك. الإعداد التلقائي "default,secure".
-c, --configDir (اختياري) يحدد المسار إلى ملف إعداد Edge Microgateway. بشكل افتراضي، يكون ملف الإعداد في ./config/config.yaml. (مضاف) v2.4.x)
-t, --token (اختياري) يسمح لك باستخدام رمز OAuth المميز للمصادقة بدلاً من اسم المستخدم/كلمة المرور. مثال:

edgemicro configure -o docs -e test -t <your token>
-d, --debug (اختياري) يتم تقديم معلومات تصحيح الأخطاء.
-h, --help معلومات استخدام الإخراج

ملاحظات الاستخدام

يخزن هذا الأمر معلومات التهيئة في /.edgemicro/org-env-config.yaml تقريبًا.

مثال

edgemicro private configure -o docs -e test -u jdoe@example.com -r http://192.162.55.100:9002 -m http://192.162.55.100:8080

الناتج

بعد نجاح الأمر، يعرض الأمر مجموعة من المفاتيح التي تحتاج إلى استخدامها عند بدء تشغيل Edge مدخل مصغّر.

...

The following credentials are required to start edge micro
  key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f
  secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372

edgemicro configuration complete!

بداية بوابة Edge الصغيرة

قبل بدء Edge Microgateway، يجب أولاً تشغيل edgemicro ضبط (السحابة العامة) أو edgemicro خاص" ضبط (السحابة الإلكترونية الخاصة). يعرض أمر Configuration (ضبط) قيم المفتاح والقيم السرّية. المطلوبة لتشغيل بوابة Edge Microgateway.

الاستخدام

edgemicro start -o [organization] -e [environment] -k [public-key] -s [secret-key]

المعلّمات

المعلمات الوصف
-o, --org مؤسسة Apigee التي ضبطت لها Edge Microgateway.
-e, --env بيئة ضبطت لها بوابة Edge Microgateway.
-k, --key قيمة المفتاح التي يتم عرضها عند تشغيل "edgemicro configure" الأمر.
-s, --secret القيمة السرية التي يتم عرضها عند تشغيل "edgemicro configure" الأمر.
-p, --processes (اختياري) عدد العمليات المراد البدء فيها. الإعداد التلقائي: عدد النوى في .
-d, --pluginDir (اختياري) المسار المطلق لدليل المكوّن الإضافي.
-r, --port (اختياري) لإلغاء رقم المنفذ المحدّد في ملف واحد (/.edgemicro/org-env-config.yaml) تقريبًا. القيمة التلقائية: 8000
-c, --cluster

(اختياري) يؤدي إلى تشغيل بوابة Edge Microgateway في وضع المجموعة.

ملاحظة: اعتبارًا من الإصدار 2.3.1، تمت إزالة هذا الخيار. ضِمن الإصدار 2.3.1 والإصدارات الأحدث، يبدأ تشغيل Edge Micro دائمًا في وضع المجموعة.

-c, --configDir (اختياري) يحدد المسار إلى ملف إعداد Edge Microgateway. بشكل افتراضي، يكون ملف الإعداد في ./config/config.yaml. (مضاف) v2.4.x)
-d, --debug (اختياري) يتم تقديم معلومات تصحيح الأخطاء.
-h, --help معلومات استخدام الإخراج

ضبط المنفذ

يتيح لك الأمر start تحديد رقم منفذ لإلغاء المنفذ المحددة في ملف التهيئة. يمكنك أيضًا تحديد رقم منفذ باستخدام متغير بيئة PORT. على سبيل المثال:

edgemicro start -o docs -e test -k abc123 -s xyz456 -p 2 --port 8002

أو

export PORT=8002 
edgemicro start -o org -e test -k key -s secret -p 2

إذا كان المنفذ قيد الاستخدام، ستعرض Edge Microgateway رسالة خطأ.

لمحة عن التجميع

تستخدم Edge Microgateway عقدة Node.js واحدة لتفعيل التجميع العنقودي. يسمح التجميع العنقودي لـ Edge Microgateway بأخذ الاستفادة من الأنظمة متعددة النواة. ولمزيد من التفاصيل، اطّلِع على مستندات Node.js.

مثال

edgemicro start -o docs -e test -k abc123 -s xyz456

عينة الناتج:

...

PROCESS PID : 54709
installed plugin from analytics
installed plugin from analytics
installed plugin from oauth
installed plugin from oauth
installed plugin from analytics
installed plugin from oauth
5a86b570-a142-11e6-aa1f-6730e9065d6c edge micro listening on port 8000
5a86dc80-a142-11e6-962c-43d9cc723190 edge micro listening on port 8000
5a8751b0-a142-11e6-8241-cf1c517c91eb edge micro listening on port 8000
installed plugin from analytics
installed plugin from oauth
5a924e30-a142-11e6-8740-2944162ce275 edge micro listening on port 8000

إدارة الرموز المميزة

تتيح لك أوامر token الحصول على بروتوكول OAuth2 الموقَّع وفك ترميزه والتحقّق من صحته. رموز الدخول. راجع أيضًا آمن طلبات بيانات من واجهة برمجة التطبيقات باستخدام رمز الدخول OAuth2

فك ترميز رمز مميّز

فك ترميز رمز حامل مُوقَّع ومشفّر إلى رمز JSON JWT بالنص العادي (رمز Java للويب) التمثيل المناسب. ينقل الرمز المميز معلومات حول تطبيق مطوّري برامج Apigee Edge الذي قدم المستخدمة لإنشاء الرمز المميز، بما في ذلك اسم التطبيق، وclient_id، وقائمة المنتجات، وغيرها.

الاستخدام

edgemicro token decode -f [filename]

المعلّمات

المعلمات الوصف
-f, --file اسم ملف يحتوي على رمز JWT المميز لفك ترميزه
-h, --help معلومات استخدام الإخراج

مثال

edgemicro token decode -f token.jwt

الإخراج (نموذج)

{ header: { typ: 'JWT', alg: 'RS256' },

  payload:
   { application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217',
     client_id: 'O9ZQRZKnn1rdgcKQgsABSMdOsKS',
     scopes: [],
     api_product_list: [ 'MicroTest' ],
     iat: 1436280566,
     exp: 1436282365 },
  signature: ... }

إنشاء رمز مميّز

إنشاء رمز حامل موقَّع يتيح الرمز المميّز لتطبيقات العميل إجراء طلبات بيانات من واجهة برمجة التطبيقات التي تمت مصادقتها. إلى بوابة Edge Microgateway. الرمز المميّز هو رمز JSON المميّز للويب (JWT) المتوافق مع OAuth 2.0. يتطلب الأمر أدخل قيم مفتاح العميل (معرِّف العميل) وسر العميل (سر العميل) من ملف مطوّر البرامج على Apigee Edge. راجع أيضًا آمن طلبات بيانات من واجهة برمجة التطبيقات باستخدام رمز الدخول OAuth2

الاستخدام

edgemicro token get -o [org] -e [env] -i [client_id] -s [client_secret]

المعلّمات

المعلمات الوصف
-o, --org مؤسسة Apigee التي ضبطت لها Edge Microgateway.
-e, --env بيئة ضبطت لها بوابة Edge Microgateway.
-1, --key معرِّف العميل الوارد من تطبيق المطوِّر المرتبط ببطاقة Microgateway الخادم الوكيل.
-s, --secret سر العميل (Client Secret) المتوفّر في تطبيق المطوِّر المرتبط ببطاقة Microgateway الخادم الوكيل.
-h, --help معلومات استخدام الإخراج

مثال

edgemicro token get -o docs -e test -i 5UzOwAXGoOeo60aew94PPG5MAZE3aJp -s 6vahKFGS9a3qMLwz

الإخراج (نموذج)

{ token: 'eyJ0eXAiOiJKV1JhbGciOiJSUzI1NiJ9Glvbl9uYW1lIjoiNWNiMGY0NTV6TV3
EtOWMzOC00YmJjLWIzNzEtZGMxZTQzOGMxIiwiY2xpZW50X2lkIjoiNVV6T3dBWEdvSU9lbz
YwYWV3OTRQN0c1TUFaRTNhSnAiLCJzY2MiOltdLCJhcGlfcHJvZHVjdF9saXN0IjpbIkVkZ2
VNaWNyb1Rlc3RQcm9kdWN0Il0sImlhdCI3ODEyMzQ2MSwiZXhwIjoxNDc4MTI1MjYwfQ.Dx5
f5U7PXm8koNGmFX4N6VrxKMJnpndKgoJ5zWSJvBZ6Ccvhlpd85ipIIA5S2A5nx4obYWp_rpY
RJpIGYwyxP6Oq2j0rxnVjdCC4qyYMgthZjhKgEBVBe3s1ndP72GP2vV6PsSA9RQ2-yzsy9r0
TzhAZ3NJTxT1tS0XKqKngE-OhR3fJHVLAzdMDT0AmS9H0Z2NAJtQOuK6RTpCjG9B6Bc48AEM
sj7QSM-1LWiQ8LdY8k_BoC06qsTI7bCQGWwTuqL-ismbcx2bxovUxSemZIaoROfuF-dCZHG3
2aTP75WxBvvNgBBvPvQtPzbeSOtEaww' }

تقديم طلب HTTP للحصول على رمز مميّز

ويمكنك أيضًا إنشاء طلب HTTP أولي للحصول على الرمز المميّز. إليك مثال على التجاعيد. بديل فقط أسماء مؤسستك وبيئتك في عنوان URL، واستبدل معرّف العميل وسر العميل قيم للمَعلمتين client_id وclient_secret:

curl -i -X POST "http://<org>-<test>.apigee.net/edgemicro-auth/token" -d '{"grant_type": "client_credentials", "client_id": "4t8X137pOUUtMR7wag3M1yZTcRxeK", "client_secret": "RAcOFVOvO0jns"}' -H "Content-Type: application/json"

إثبات صحة رمز مميّز

التحقُّق من رمز الحامل المُوقَّع مقابل المفتاح العام المخزن في Apigee Edge للنطاق المحدَّد التنظيم والبيئة.

الاستخدام

edgemicro token verify -o [org] -e [env] -f [filename]

المعلّمات

المعلمات الوصف
-o, --org مؤسسة Apigee التي ضبطت لها Edge Microgateway.
-e, --env بيئة ضبطت لها بوابة Edge Microgateway.
-f, --file اسم ملف يحتوي على JWT المطلوب التحقّق منه
-h, --help معلومات استخدام الإخراج

مثال

edgemicro token get -o docs -e test -f token.jwt

نموذج ناتج عن رمز مميّز صالح

{ application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217',

  client_id: 'O9ZQRZKnn1rdgcKQsAZUBkQSMdOsKS',

  scopes: [],

  api_product_list: [ 'MicroTest' ],

  iat: 1436396155,

  exp: 1436397954 }

نموذج ناتج عن رمز مميّز غير صالح

{ [JsonWebTokenError: invalid token] name: 'JsonWebTokenError', message: 'invalid token' }

نموذج ناتج عن رمز مميّز منتهي الصلاحية

{ [TokenExpiredError: jwt expired]

  name: 'TokenExpiredError',

  message: 'jwt expired',

  expiredAt: Tue Jul 07 2015 09:19:25 GMT-0600 (MDT) }

الحصول على رموز الحامل المميزة مباشرةً

قد يكون من الأفضل الحصول على رموز الحامل المميزة مباشرةً، وذلك عن طريق تقديم طلب HTTP إلى الرمز المميز نقطة النهاية في Apigee Edge. يتم تنفيذ نقطة نهاية الرمز المميّز الفعلية في الخادم الوكيل الذي تم نشره. باستخدام أمر Publishing-edge-service CLI.

إليك مثال على التجاعيد. ما عليك سوى استبدال اسم مؤسستك واسم البيئة في عنوان URL، استبدال قيم رقم تعريف المستهلك وسر المستهلك التي تم الحصول عليها من تطبيق مطوِّر على Apigee حافة لـ المَعلمتَان client_id وclient_secret:

curl -i -X POST "http://<org>-<test>.apigee.net/edgemicro-auth/token" -d '{"grant_type": "client_credentials", "client_id": "4t8X137pOUUtMR7wag3M1yZTcRxeK", "client_secret": "RAcOFVOvO0jns"}' -H "Content-Type: application/json"

عينة الناتج:

HTTP/1.1 200 OK

X-Powered-By: Express

Cache-Control: no-store

Pragma: no-cache

Content-Type: application/json; charset=utf-8

Content-Length: 640

ETag: W/"280-ze/g/k+c9taqp110vjYQ"

Date: Fri, 17 07 2015 15:49:24 GMT

Connection: keep-alive

"<long string of numbers and letters>"

جارٍ إعداد بوابة مصغَّرة جديدة على Edge الإعدادات

شغّل هذا الأمر مرة واحدة بعد تثبيت Edge Microgateway لأول مرة. تنشئ لغة تلقائية جديدة ملف الإعداد: ~/.edgemicro/default.yaml.

الاستخدام

edgemicro init 

المعلّمات

المعلمات الوصف
-c, --configDir (اختياري) يحدد المسار إلى ملف إعداد Edge Microgateway. بشكل افتراضي، يكون ملف الإعداد في ./config/config.yaml. (مضاف) v2.4.x)
-h, --help معلومات استخدام الإخراج

مثال

edgemicro init

الناتج (بنجاح)

config initialized to /MyHome/.edgemicro/default.yaml

جارٍ التحقّق من إعدادات Edge Microgateway

التحقق من ضبط بوابة Edge Microgateway بشكل صحيح.

الاستخدام

edgemicro verify -o [organization] -e [environment] -k [public-key] -s [secret-key]

المعلّمات

مثال

edgemicro verify -o docs -e test -k abc123 -s xyz456

الناتج (بنجاح)

logging to /var/tmp/edgemicro-My-Machine.local-a0c48610-a148-11e6-8466-93f081b05988
installed plugin from analytics
installed plugin from oauth
a0c48610-a148-11e6-8466-93f081b05988 edge micro listening on port 8000
verifying analytics negative case: OK
verifying bootstrap url availability:OK
verifying jwt_public_key availability: OK
verifying products availability: OK
verifying quota with configured products: OK
verifying analytics with payload: OK
verification complete

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

تاريخ الإضافة: الإصدار 2.2.4-الإصدار التجريبي

بشكل افتراضي، تبدأ بوابة Edge Microgateway في وضع المجموعة. يمكنك استخدام هذا الأمر للتحقق من حالة المجموعة العنقودية.

الاستخدام

edgemicro status

المعلّمات

المعلمات الوصف
-h, --help معلومات استخدام الإخراج

مثال

edgemicro status

الناتج (بنجاح)

current nodejs version is v6.1.0
current edgemicro version is 2.2.4-beta
edgemicro is running with 4 workers

إيقاف مجموعة المدخل الصغير

تاريخ الإضافة: الإصدار 2.2.4-الإصدار التجريبي

يؤدي هذا الاختصار إلى إيقاف مجموعة Edge Microgateway.

الاستخدام

edgemicro stop

المعلّمات

المعلمات الوصف
-h, --help معلومات استخدام الإخراج

مثال

edgemicro stop

الناتج (بنجاح)

current nodejs version is v6.1.0
current edgemicro version is 2.2.4-beta
Stop Completed Successfully

إعادة تحميل مجموعة المدخل الصغير

تاريخ الإضافة: الإصدار 2.2.4-الإصدار التجريبي

تتيح هذه السياسة إعادة تشغيل الجهاز بعد تغيير الإعدادات. يعيد تحميل بوابة Edge Microgateway عبر سحب تهيئة جديدة.

الاستخدام

edgemicro reload -o [organization] -e [environment] -k [public-key] -s [secret-key]

المعلّمات

المعلمات الوصف
-o, --org مؤسسة Apigee التي ضبطت لها Edge Microgateway.
-e, --env بيئة ضبطت لها بوابة Edge Microgateway.
-k, --key قيمة المفتاح التي يتم عرضها عند تشغيل "edgemicro configure" الأمر.
-s, --secret القيمة السرية التي يتم عرضها عند تشغيل "edgemicro configure" الأمر.
-h, --help معلومات استخدام الإخراج

مثال

edgemicro reload -o docs -e test -k abc123 -s xyz456

الناتج (بنجاح)

...

Reload Completed Successfully