רישום אפליקציות וניהול מפתחות API

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

רושמים אפליקציות ומנהלים מפתחות API, כמו שמתואר בקטעים הבאים.

מבוא

רישום האפליקציה הוא המנגנון העיקרי לשליטה בגישה לממשקי ה-API שלכם.

ספקי API יוצרים מוצר API אחד או יותר כדי לאגד את ממשקי ה-API שלהם, כמו שמוסבר במאמר ניהול מוצרי API. כשמפתחי אפליקציות רושמים אפליקציה, הם בוחרים באילו מוצרי API להשתמש, ו-Edge מספק מפתח API יחיד שהמפתחים יכולים להשתמש בו כדי לגשת למוצרי ה-API האלה. מפתח ה-API מועבר על ידי מפתח האפליקציה בכל קריאה לשרתי ה-proxy של ה-API שכלולים במוצרי ה-API. בכל שלב אפשר לבטל את מפתח ה-API של אפליקציה מסוימת, וכך למנוע ממפתח אפליקציה לגשת לכל מוצרי ה-API שאליהם האפליקציה מפנה או לחלק מהם.

בדרך כלל, מפתחי אפליקציות נרשמים לשימוש במוצרי ה-API שלכם באמצעות פורטל המפתחים. השלבים לבניית הפורטל ולפרסום מוצרי ה-API מפורטים במאמר בניית הפורטל.

לחלופין, אם אתם ספקי API, יכול להיות שתרצו יותר שליטה בתהליך רישום האפליקציות ותבחרו לרשום אפליקציות ב-Edge, כמו שמתואר בקטעים הבאים. לדוגמה, יכול להיות שתרצו לרשום אפליקציות עבור צוותי הפיתוח הפנימיים שלכם או בשם מפתח שאין לו גישה לפורטל.

בקטעים הבאים מוסבר איך לרשום אפליקציות ולנהל מפתחות API באמצעות ממשק המשתמש וממשק ה-API.

הכרת הדף 'אפליקציות'

ניגשים לדף 'אפליקציות' ומעיינים בו, כמו שמתואר בהמשך.

רישום אפליקציה

אפשר לרשום אפליקציה באחת מהשיטות הבאות:

• מפתח אפליקציה יכול לרשום את האפליקציה דרך הפורטל שלכם, כמו שמתואר במאמר איך מפתחי אפליקציות משתמשים בפורטל.
• אפשר לרשום אפליקציה ב-Edge, כמו שמתואר בהמשך. אתם קובעים איך לספק את המפתח למפתח האפליקציה.

אפליקציות רשומות נוספות אל:

• רשימת האפליקציות הרשומות ב-Edge. איך צופים בפרטים של מפתחים ועורכים אותם
• דף האפליקציות בפורטל למפתחים.

כדי לרשום אפליקציה ב-Edge:

1. עוברים לדף האפליקציות.
2. לוחצים על + App (הוספת אפליקציה).
3. מציינים את פרטי האפליקציה:

   שדה	תיאור	חובה?
   שם	שם האפליקציה. אי אפשר לשנות את השם אחרי שיוצרים את האפליקציה. השם הזה משמש לקריאות ל-API לניהול.	כן
   השם המוצג	השם לתצוגה של האפליקציה שמופיע בממשק הניהול של Edge ובפורטל למפתחים.	לא
   חברה/מפתח	הערה: אין תמיכה באפליקציות של החברה ב-Apigee hybrid, ולכן השדה הזה לא רלוונטי. בוחרים באפשרות חברה או מפתח ובוחרים שם של חברה או מפתח מהתפריט הנפתח. הערה: מטעמי ביצועים, לא כל החברות או המפתחים מוצגים בתפריט הנפתח. מתחילים להקליד את שם החברה, שם המפתח או כתובת האימייל בתיבת החיפוש. אפשר לעיין גם במאמר בנושא רישום של מפתחי אפליקציות.	כן
   כתובת אתר של קריאה חוזרת (callback)	בדרך כלל מציינים כאן את כתובת ה-URL של אפליקציה שמיועדת לקבל קוד הרשאה מטעם אפליקציית הלקוח. הערך הזה לא נדרש לכל מוצרי ה-API.	לא
   הערות	הערות תיאוריות לגבי האפליקציה.	לא

4. מציינים את האישורים, כולל התפוגה והסטטוס של מפתח ה-API ומוצרי ה-API המשויכים.
   בקטע 'פרטי כניסה', לוחצים על ומזינים את הפרטים הבאים:

   שדה	תיאור
   תאריך תפוגה	מגדירים את משך התוקף או את תאריך התפוגה, או מגדירים את מפתח ה-API כך שתוקפו לא יפוג לעולם, ולוחצים על אישור.
   מוצרים	משייכים מפתח API למוצר API אחד או יותר: לוחצים על הוספת מוצר. בוחרים מוצר API אחד או יותר מהרשימה. לוחצים על הוספה. מגדירים את הסטטוס כמאושר או כמבוטל לכל מוצר API. חוזרים על השלבים כדי להוסיף עוד מוצרי API.

5. מציינים את המאפיינים המותאמים אישית:
   1. בקטע 'מאפיינים מותאמים אישית', לוחצים על .
   2. מזינים את השם והערך.
   3. לוחצים על הוספה או על הוספה והתחלת עוד.
      אפשר להוסיף עד 18 מאפיינים מותאמים אישית.
6. לוחצים על יצירה.

אם מפתחות ה-API של מוצרי ה-API ששייכתם לאפליקציה דרשו אישור ידני, צריך לאשר אותם כמו שמתואר במאמר אישור מפתחות API או ביטול שלהם.

צפייה באפליקציות שרשומות למפתח

כדי לראות את האפליקציות שרשומות אצל מפתח מסוים, משתמשים באחת מהשיטות הבאות:

• View all registered apps, select Developer in the Search drop-down, and enter the name of the developer in the search field.
• צפייה בכל מפתחי האפליקציות הרשומים ולחיצה על השורה שמשויכת למפתח.

צפייה באפליקציה ועריכה שלה

כדי להציג ולערוך אפליקציה:

1. עוברים לדף האפליקציות.
2. לוחצים בשורה של האפליקציה שרוצים לראות ולערוך.
   פרטי האפליקציה מוצגים.
3. כדי לערוך אפליקציה, לוחצים על עריכה.
4. מבצעים אחת או יותר מהמשימות הבאות:
   • משנים את פרטי האפליקציה, כולל השם, כתובת ה-URL של הקריאה החוזרת או ההערות.
   • ניהול פרטי הכניסה
   • מוסיפים או מוחקים מאפיינים מותאמים אישית.
     המספר המקסימלי של מאפיינים מותאמים אישית שאפשר להוסיף הוא 18.
   • אישור או ביטול אישור של האפליקציה.
5. לוחצים על שמירה.

ניהול פרטי כניסה

כשעורכים אפליקציה, אפשר לנהל את פרטי הכניסה שלה בקטע פרטי כניסה, כמו שמוצג באיור הבא:

כפי שמודגש באיור הקודם, בקטע Credentials (פרטי כניסה) אפשר לבצע את המשימות הבאות באמצעות ממשק המשתמש:

• הצגה של מפתח API ו-API Secret
• אישור או ביטול של מפתח API לכל מוצרי ה-API המשויכים או למוצר API יחיד.
• ניהול מוצרי API באפליקציה
• יצירת פרטי כניסה חדשים

כדי להשתמש ב-API לניהול פרטי כניסה, אפשר לעיין בסעיפים הבאים:

• ניהול מפתחות צרכן לאפליקציות
• ייבוא של טוקנים קיימים לצרכן וסודות

איך רואים מפתח API וסוד

כדי לראות מפתח API ו-API Secret:

1. עוברים לדף האפליקציות.
2. לוחצים בשורה של האפליקציה שרוצים לראות את מפתח ה-API ואת ה-Secret שלה.
3. בקטע Credentials (פרטי כניסה), לוחצים על Show (הצגה) שמשויך למפתח ה-API או לסוד שרוצים להציג.

אישור או ביטול של מפתח API

קריאות ל-API לשרתי proxy של API בדרך כלל דורשות מפתח API. ‫Edge מאפשר את הקריאות רק אם מפתח ה-API אושר, תקף ועומד בתנאים שהוגדרו במוצר ה-API שמכיל את ה-API.

אפשר להגדיר מוצר API לאישור אוטומטי של מפתחות API, כמו שמתואר במאמר בנושא ניהול מוצרי API. עם זאת, אם מוצר ה-API דורש אישור ידני של מפתחות API, צריך לאשר את המפתח באופן ידני.

אפשר לבטל מפתח API לכל מוצרי ה-API או למוצר API יחיד. במקרה כזה, מפתח ה-API והסוד לא תקינים ואי אפשר להשתמש בהם כדי לגשת לממשקי API במוצרי ה-API המשויכים. אפשר לאשר מחדש מפתח API בכל שלב.

כדי לאשר או לבטל מפתח API:

1. עוברים לדף האפליקציות.
2. לוחצים בשורה של האפליקציה שרוצים לראות ולערוך.
3. לוחצים על עריכה.
4. מבצעים אחת מהמשימות הבאות:
   • כדי לאשר או לבטל מפתח API לכל מוצרי ה-API שמשויכים למפתח, בוחרים באפשרות Approved (אושר) או Revoked (בוטל) שמשויכת למפתח ה-API.
   • כדי לאשר או לבטל מפתח API למוצר API ספציפי, בוחרים באפשרות אושר או בוטל בעמודה 'סטטוס' של מוצר ה-API.
5. לוחצים על שמירה.

ניהול מוצרי API באפליקציה

כדי לנהל מוצרי API באפליקציה, מבצעים את המשימות הבאות:

• הוספת מוצר API לאפליקציה
• הסרת מוצר API מאפליקציה

הוספה של מוצר API לאפליקציה

כדי להוסיף מוצר API לאפליקציה:

1. עוברים לדף האפליקציות.
2. לוחצים בשורה של האפליקציה שרוצים לראות ולערוך.
3. לוחצים על עריכה.
4. מבצעים אחת מהמשימות הבאות:
   • כדי להוסיף מוצר API למפתח API חדש, לוחצים על כדי ליצור פרטי כניסה חדשים, בוחרים תאריך תפוגה ומוסיפים את מוצר ה-API למפתח ה-API.
   • כדי להוסיף מוצר API למפתח API קיים, בקטע Credential (אישורים) לוחצים על Add product (הוספת מוצר) ובוחרים את מוצר ה-API מהרשימה הנפתחת.
5. לוחצים על שמירה.

הסרת מוצר API מאפליקציה

אם רוצים להשאיר מפתח API פעיל אבל לא לאפשר שימוש בו במוצר API, אפשר להסיר אותו מפרטי הכניסה המשויכים.

1. עוברים לדף האפליקציות.
2. לוחצים בשורה של האפליקציה שרוצים לראות ולערוך.
3. לוחצים על עריכה.
4. לוחצים על לצד מוצר ה-API.
5. לוחצים על שמירה.

אפשר להוסיף מחדש מוצר שהוסר.

יצירת פרטי כניסה חדשים

אתם יכולים ליצור פרטי כניסה חדשים לאפליקציה. לדוגמה, אם אתם משתמשים ברוטציית מפתחות API, אתם יכולים ליצור מפתחות חדשים שתוקפם חופף לתוקף של מפתחות שיפוג תוקפם בזמן שהם לא ברוטציה. אפשר גם ליצור מפתח/סוד חדשים אם האבטחה של המפתח/הסוד המקוריים נפגעה. אם יוצרים מפתח חדש, מפתחות API קיימים ימשיכו לפעול עד שהתוקף שלהם יפוג או עד שמבטלים אותם באופן מפורש.

כדי ליצור מפתח API חדש:

1. עוברים לדף האפליקציות.
2. לוחצים בשורה של האפליקציה שרוצים לראות ולערוך.
3. לוחצים על עריכה.
4. בקטע 'פרטי כניסה', לוחצים על .
5. מציינים את תאריך התפוגה, מוסיפים את מוצרי ה-API ומגדירים את הסטטוס שלהם.
6. אפשר גם לבטל את מפתחות ה-API האחרים, לפי הצורך.
7. לוחצים על שמירה.

אישור או ביטול של אפליקציה

מאשרים או מבטלים את הגישה של האפליקציה, כמו שמתואר בהמשך. כשמבטלים את הגישה לאפליקציה, אי אפשר יותר להשתמש במפתחות API שאושרו בקריאות ל-API של Edge. כשמאשרים מחדש אפליקציה, אפשר להשתמש בכל מפתחות ה-API המאושרים והתקינים כדי לבצע קריאות ל-API.

אם האפליקציה רשומה בארגונים אחרים, צריך לבטל את הגישה שלה בכל אחד מהארגונים האלה. יכול להיות שיחלפו כמה דקות עד שכל מעבדי ההודעות יזהו את השינויים.

כדי לאשר או לבטל את הגישה של אפליקציה:

1. עוברים לדף האפליקציות.
2. לוחצים בשורה של האפליקציה שרוצים לראות ולערוך.
3. לוחצים על עריכה.
4. בשדה סטטוס האפליקציה, לוחצים על אישור או על ביטול כדי לאשר את האפליקציה או לבטל את האישור שלה.
5. לוחצים על שמירה.

מחיקת אפליקציה

כשמוחקים אפליקציה, כל מפתחות הלקוח שמשויכים לאפליקציה הופכים ללא תקפים. שימוש במפתח לא תקין בבקשה גורם לכך שהבקשה תיכשל.

אם אתם חושבים שאולי תרצו להחזיר אפליקציה של מפתח בעתיד, אפשרות חלופית למחיקה היא ביטול הגישה לאפליקציה.

כדי למחוק אפליקציה:

1. עוברים לדף האפליקציות.
2. מציבים את הסמן בשורה של האפליקציה שרוצים למחוק.
3. לוחצים על בעמודה 'פעולות'.

הערה: ב-Apigee Edge for Public Cloud, המחיקה של אפליקציית המפתח ושל הארטיפקטים שמשויכים אליה מתבצעת באופן אסינכרוני. אפליקציית המפתח נמחקת באופן מיידי, אבל יכולות לעבור כמה שניות עד כמה דקות עד שהמשאבים שמשויכים לאפליקציית המפתח הזו, כמו מפתחות אפליקציה או אסימוני גישה, יימחקו אוטומטית.

רישום אפליקציות וניהול מפתחות API באמצעות ה-API

מידע על רישום וניהול אפליקציות באמצעות ה-API זמין במאמר בנושא רישום אפליקציות למפתחים. אפשר לעיין גם בקטעים הבאים במאמרי העזרה של ה-API:

• אפליקציות
• אפליקציות: חברה
• אפליקציות: מפתח
• מפתחות של אפליקציות של החברה
• מפתחות אפליקציה למפתחים

אפשר גם לקרוא על ייבוא של מפתחות וסודות קיימים של צרכנים.