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

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

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

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

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

שלבים מהירים

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

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

   Edge

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

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

   Classic Edge (ענן פרטי)

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

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

קבלת פרטי הכניסה של הלקוח באמצעות ממשקי Edge של 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.