يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
Edge Microgateway، الإصدار 2.4.x
نظرة عامة
يتيح لك واجهة سطر الأوامر الخاصة بـ Edge Microgateway التحكّم في جميع جوانب مثيل Edge Microgateway وإدارتها.
إدارة الشهادات
تتيح لك الأوامر cert
تثبيت وإدارة زوج المفاتيح العام/الخاص الذي يُستخدم لتوقيع الرموز المميّزة للحامل التي يستخدمها العملاء لإجراء مكالمات آمنة من خلال Edge
Microgateway. يتم حفظ المفاتيح في 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 Microgateway لخدمة Apigee Edge Cloud
تفعِّل هذه الميزة طريقة عمل 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 |
(اختياري) يحدد الاسم المستعار للمضيف الظاهري لمؤسستك:البيئة. يمكنك الاطّلاع على مستندات Edge لمعرفة المزيد عن المضيفين الافتراضيين.
عناوين URL التلقائية: org-env.apigee.net |
-c, --configDir |
(اختياري) يحدد المسار إلى ملف إعداد Edge Microgateway. يكون ملف الإعداد تلقائيًا هو ./config/config.yaml. (تمت إضافة الإصدار 2.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:environment بخلاف هذه الإعدادات التلقائية. اطّلِع على مستندات Edge
لمعرفة معلومات حول المضيفين الافتراضيين. |
-d, --debug |
(اختياري) يوفر معلومات تصحيح الأخطاء. |
-h, --help |
الحصول على معلومات استخدام النتائج |
ملاحظات الاستخدام
يخزِّن هذا الأمر معلومات الإعدادات في /.edgemicro/org-env-config.yaml
تقريبًا.
مثال
edgemicro configure -o docs -e test -u jdoe@example.com
الناتج
بعد نجاح الأمر، يعرض الأمر مجموعة من المفاتيح التي تحتاج إلى استخدامها عند بدء تشغيل Edge Microgateway.
... The following credentials are required to start edge micro key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372 edgemicro configuration complete!
إنشاء المفاتيح
ينشئ الأمر genkeys
زوج مفتاح ومفتاح سري يستخدمه Edge
Microgateway للمصادقة على نفسه عند نشر بيانات الإحصاءات بشكل غير متزامن في Apigee
Edge.
الاستخدام
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 Microgateway.
- عنوان URL لإطار التشغيل: يشير عنوان URL هذا إلى خدمة Apigee Edge التي تتيح لمثيل Edge Microgateway إرسال بيانات الإحصاءات إلى Apigee Edge. عليك نسخ عنوان URL هذا إلى ملف إعداد Edge Microgateway: ~
/.edgemicro/org-env-config.yaml
. - المفتاح: المفتاح يكون هذا المفتاح والمفتاح السرّي مطلوبين كإدخال في أمر CLI المستخدَم لبدء مثيل من Edge Microgateway.
- السر: السر.
مثال
edgemicro genkeys -o docs -e test -u jdoe@example.com
الناتج (عيّنة)
بعد نجاح الأمر، يعرض الأمر مجموعة من المفاتيح التي تحتاج إلى استخدامها عند بدء تشغيل Edge Microgateway.
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 Microgateway لخدمة Apigee Edge Private Cloud
تعمل هذه السياسة على ضبط 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 |
قائمة مفصولة بفواصل للمضيفين الافتراضيين لمؤسستك:environment. الإعداد التلقائي
"default,secure ". |
-c, --configDir |
(اختياري) يحدد المسار إلى ملف إعداد Edge Microgateway. يكون ملف الإعداد تلقائيًا هو ./config/config.yaml. (تمت إضافة الإصدار 2.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 Microgateway.
... The following credentials are required to start edge micro key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372 edgemicro configuration complete!
طريق مصغَّرة ضمن حافة الانطلاق
قبل بدء Edge Microgateway، عليك أولاً تشغيل Edgemicro setup (الضبط الشامل) (Public Cloud) أو edgemicro special (الضبط الخاص) (Private Cloud). يعرض الأمر 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 تقريبًا. القيمة التلقائية: 8,000 |
-c, --cluster |
(اختياري) يبدأ Edge Microgateway في وضع المجموعة. ملاحظة: اعتبارًا من الإصدار 2.3.1، تمت إزالة هذا الخيار. وفي الإصدار 2.3.1 والإصدارات الأحدث، يبدأ تشغيل Edge Micro دائمًا في وضع المجموعة. |
-c, --configDir |
(اختياري) يحدد المسار إلى ملف إعداد Edge Microgateway. يكون ملف الإعداد تلقائيًا هو ./config/config.yaml. (تمت إضافة الإصدار 2.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 بتنسيق JSON JWT (Java Web Token) بتنسيق النص العادي. ينقل الرمز المميّز معلومات حول تطبيق المطوّر 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 مميز متوافق مع OAuth 2.0 (JWT). كما يتطلب إدخال قيم مفتاح العميل (معرّف العميل) وسر العميل (سر العميل) من تطبيق مطوّر برامج مسجَّل على 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 |
سر العميل من تطبيق المطوّر المرتبط بالوكيل الوكيل لـ 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 أولي للحصول على الرمز المميّز. إليك مثال على curl. ما عليك سوى استبدال اسمَي المؤسسة والبيئة في عنوان 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. يتم تنفيذ نقطة نهاية الرمز المميّز الفعلية في الخادم الوكيل الذي يتم نشره باستخدام أمر واجهة سطر الأوامر (CLI) لخدمة جديدة.
إليك مثال على curl. ما عليك سوى استبدال أسماء المؤسسة والبيئة في عنوان URL وقيم سر العميل ورقم تعريف المستهلك التي تم الحصول عليها من تطبيق مطوِّر على Apigee Edge بالمَعلمتَين 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 Microgateway
شغّل هذا الأمر مرة واحدة بعد تثبيت Edge Microgateway لأول مرة. يؤدي هذا الإجراء إلى إنشاء ملف إعداد تلقائي جديد: ~/.edgemicro/default.yaml
.
الاستخدام
edgemicro init
المعلّمات
المَعلمات | الوصف |
---|---|
-c, --configDir |
(اختياري) يحدد المسار إلى ملف إعداد Edge Microgateway. يكون ملف الإعداد تلقائيًا هو ./config/config.yaml. (تمت إضافة الإصدار 2.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