מוצג המסמך של Apigee Edge.
עוברים אל
מסמכי תיעוד של Apigee X. מידע
Edge Microgateway v. 2.4.x
סקירה כללית
באמצעות ה-CLI של Edge Microgateway אפשר לשלוט בכל ההיבטים של מכשיר Edge Microgateway מכונה.
ניהול האישורים
באמצעות פקודות cert אפשר להתקין ולנהל את המפתח הציבורי/פרטי
שמשמש לחתימה על אסימונים למוכ"ז שלקוחות משתמשים בהם לביצוע קריאות מאובטחות דרך Edge
מיקרו-שער. המפתחות מאוחסנים ב-Apigee Edge במפת ערכי מפתחות מוצפנת (KVM). Microsoft Edge Microgateway משתמש ב-
מפתח ציבורי לאימות אסימונים למוכ"ז חתומים. המפתחות האלה נוצרים כשמריצים את endmicro
את הפקודה, כמו שמוסבר במאמר הגדרה
הגדרה והגדרה של Edge Microgateway. אפשר להשתמש
פקודות certification שמתוארות כאן כדי ליצור מחדש ולנהל את המפתחות האלה
במקרה הצורך.
התקנת אישור
התקנת המפתחות במפת ערכי מפתחות מוצפנת (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-----
הגדרת Microsoft Edge Microgateway ל-Apigee ענן Edge
המדיניות מאפשרת לפעול ב-Edge Microgateway באמצעות מכונה של Apigee Edge Cloud. הוא גולש ופועל רצף של פקודות לפריסת שרת proxy לאימות ב-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 |
(אופציונלי) מציין את הכינוי של המארח הווירטואלי עבור Organization:environment. לצפייה
מסמכי תיעוד של Edge למידע על מארחים וירטואליים.
ברירת מחדל: org-env.apigee.net |
-c, --configDir |
(אופציונלי) מציין את הנתיב לקובץ התצורה של Edge Microgateway. כברירת מחדל, קובץ התצורה הוא בפורמט ./config/config.yaml. (נוספה) v2.4.x) |
-x, --proxyName |
(אופציונלי) מגדיר את הנתיב הבסיסי עבור שרת ה-proxy edgemicro-auth. אם שרת ה-proxy 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 כדי
ללמוד על מארחים וירטואליים. |
-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. מכונת Microgateway.
- bootrap URL: כתובת ה-URL הזו מפנה לשירות Apigee Edge שמאפשר
מכונת Edge Microgateway כדי לשלוח ניתוח נתונים אל Apigee Edge. צריך להעתיק את כתובת ה-URL הזו
בקובץ התצורה של Edge Microgateway: ~
/.edgemicro/org-env-config.yaml. - key: המפתח. המפתח הזה והסוד נדרשים כקלט ל-CLI שמשמשת להפעלת מופע של 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
הגדרת Microsoft Edge Microgateway עבור ענן פרטי של Apigee Edge
הגדרת Edge Microgateway לעבודה עם התקנה בענן הפרטי של Apigee Edge.
שימוש
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 |
רשימה מופרדת בפסיקים של מארחים וירטואליים עבור Organization:environment. ברירת מחדל
'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!
Microsoft Edge Microgateway
לפני שמפעילים את Edge Microgateway, צריך להפעיל את dgemicro הגדרה (Public Cloud) או dgemicro private הגדרה (ענן פרטי). פקודת ה-config מחזירה את ערכי המפתח והסוד שנדרשות כדי להפעיל את 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. (נוספה) 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 חתום
אסימוני גישה. ראו גם מאובטחות
קריאות ל-API עם אסימון גישה מסוג OAuth2.
פענוח של אסימון
מפענח אסימון למוכ"ז חתום ומקודד ל-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: ... }
יצירת אסימון
יוצרת אסימון למוכ"ז חתום. האסימון מאפשר לאפליקציות לקוח לבצע קריאות מאומתות ל-API ל-Edge Microgateway. האסימון הוא אסימון אינטרנט מסוג JSON (JWT) שתואם ל-OAuth 2.0. הוא נדרש כ- להזין את הערכים של מפתח הצרכן (מזהה לקוח) וסוד הצרכן (סוד לקוח) של למפתחים ב-Apigee Edge. ראו גם מאובטחות קריאות ל-API עם אסימון גישה מסוג 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 שרת proxy. |
-s, --secret |
סוד הלקוח מאפליקציית המפתח שמשויכת לחשבון Microgateway שרת proxy. |
-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. נקודת הקצה של האסימון בפועל מוטמעת בשרת ה-proxy שנפרס באמצעות פקודת ה-CLI של שירות לפרוס קצה.
הנה דוגמה ל-curl. פשוט מחליפים את שמות הארגון והסביבה בכתובת ה-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>"
אתחול Microgateway חדש של 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