השגת פרטי הכניסה של הלקוח

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X. מידע

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

מהם פרטי כניסה של לקוח?

כדי להשתתף בכל תהליך של OAuth 2.0, כל אפליקציות הלקוח חייבות להיות רשומות ב-Apigee Edge ( שרת ההרשאה). כשתרשמו את האפליקציה שלכם, יוקצו לכם שני מפתחות: צרכן וסוד צרכן. מזהה הצרכן הוא אסור שמפתח ציבורי וסוד צרכן יתפרסמו לציבור. המפתחות האלה של פרטי הכניסה של הלקוח מאפשרים Apigee Edge לזיהוי ייחודי של אפליקציית הלקוח.

שלבים מהירים

בשלבים המהירים האלה מוסבר איך להשיג מפתחות למפתחים של אחת מהאפליקציות המקוריות שהוגדרו כשיצרת את ארגון Apigee Edge. אפשר להשתמש במפתחות האלה בעיקר לפיתוח ובדיקה:

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

   Edge

   כדי לגשת לדף 'אפליקציות למפתחים' באמצעות ממשק המשתמש של Edge:

   1. נכנסים לכתובת apigee.com/edge.
   2. בוחרים באפשרות פרסום > אפליקציות בסרגל הניווט הימני.
   3. לוחצים על +Proxy.

   Classic Edge (ענן פרטי)

   כדי לגשת לדף 'אפליקציות למפתחים' באמצעות ממשק המשתמש של Classic Edge:

   1. יש להיכנס אל http://ms-ip:9000, כאשר ms-ip הוא כתובת ה-IP או שם ה-DNS של הצומת של שרת הניהול.
   2. בוחרים באפשרות פרסום > אפליקציות למפתחים בסרגל הניווט העליון.
2. לוחצים על אפליקציית 'מזג אוויר' כדי לפתוח את דף הסקירה הכללית של אפליקציית 'מזג אוויר'. הודעה שהמפתח שמשויך לאפליקציה הוא Nicolai Tesla. האפליקציה הזו והמפתח הזה היו מוקצה כברירת מחדל כשהארגון נוצר. בכל האפליקציות למפתחים חייב להיות שמשויך אליהם.
3. בקטע מוצרים, לצד המוצר Premium Weather API, לוחצים על Show (הצגה) כדי לחשוף את מזהה הצרכן ואת הערכים של סוד הצרכן.
4. מעתיקים ושומרים את שני הערכים האלה. תצטרכו להשתמש בהם מאוחר יותר כדי לבצע קריאות ל-API לקבל אסימוני גישה.

קבלת פרטי כניסה של לקוח באמצעות ממשקי API של Edge

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

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps \
-u email:password 

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

[ "da496fae-2a04-4a5c-b2d0-709278a6f9db", "50e3e831-175b-4a05-8fb6-05a54701af6e" ]

כדי לאחזר את הפרופיל של האפליקציה, אפשר לבצע קריאה פשוטה ל-GET על מזהה האפליקציה:

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps/{app_id} \
-u email:password 

לדוגמה:

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps/da496fae-2a04-4a5c-b2d0-709278a6f9db \
-u email:password 

הקריאה ל-API תחזיר את הפרופיל של האפליקציה שציינתם. לדוגמה, פרופיל אפליקציה ל-weatherapp יש את ייצוג JSON הבא:

{
  "accessType" : "read",
  "apiProducts" : [ ],
  "appFamily" : "default",
  "appId" : "da496fae-2a04-4a5c-b2d0-70928a6f9db",
  "attributes" : [ ],
  "callbackUrl" : "http://weatherapp.com",
  "createdAt" : 1380290158713,
  "createdBy" : "noreply_admin@apigee.com",
  "credentials" : [ {
    "apiProducts" : [ {
      "apiproduct" : "PremiumWeatherAPI",
      "status" : "approved"
    } ],
    "attributes" : [ ],
    "consumerKey" : "bBGAQrXgivA9lKu7NMPyYpVKNhGar6K",
    "consumerSecret" : "hAr4Gn0gA9vyvI4",
    "expiresAt" : -1,
    "issuedAt" : 1380290161417,
    "scopes" : [ ],
    "status" : "approved"
  } ],
  "developerId" : "5w95xGkpnjzDBT4",
  "lastModifiedAt" : 1380290158713,
  "lastModifiedBy" : "noreply_admin@apigee.com",
  "name" : "weatherapp",
  "scopes" : [ ],
  "status" : "approved"
}

חשוב לשים לב לערכים בשביל consumerKey ו-consumerSecret.

ניתוח מעמיק יותר

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