כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של
Apigee X. מידע
בקטע הזה מוסבר איך לתכנן ולבצע את ההעברה של נכסי הפורטל של Drupal 7 אל הפורטל המשולב.
שלב 1: יצירת פורטל משולב
לפני שמעבירים את נכסי הפורטל של Drupal 7, צריך ליצור פורטל משולב.
כדי ליצור פורטל משולב:
- חשוב לוודא שיש לכם תפקידים מתאימים בפורטל לניהול פורטל משולב.
- יוצרים פורטל משולב.
כשיוצרים פורטל משולב, מקבלים קבוצה של דפי התחלה שאפשר להשתמש בהם כנקודת התחלה. דפי הפתיחה מכילים תוכן הדגמה שיעזור לך לקבל השראה לפיתוח הפורטל שלך בזמן שמחליפים את הטקסט והתמונות בתוכן הייחודי שלך. מידע נוסף זמין במאמר מידע על הפורטל לדוגמה.
שלב 2: יצירת הפורטל המשולב
יוצרים את הפורטל המשולב, כמו שמתואר בקטע שלבים לבניית הפורטל.
לכל הפחות, עליך לבצע את השלבים המפורטים בטבלה הבאה.
| שלב | התיאור |
|---|---|
| פיתוח תוכן לפורטלים | למשל, מידע על מושגים ועל תחילת העבודה. אתם יכולים ליצור דפים, ואז להעתיק ולהדביק את תוכן הדף ישירות מפורטל Drupal 7 הקיים. |
| הגדרת הניווט | יוצרים את רכיבי הניווט שנדרשים למבנה הקיים. |
| התאמה אישית של העיצוב | לכל הפחות, יש להתאים אישית את הרכיבים הבאים בהתאם לדרישות המיתוג שלכם: |
| הוספת סקריפטים מותאמים אישית | מוסיפים לפורטל קוד JavaScript בהתאמה אישית, לפי הצורך. |
| הגדרת אימייל | יש להגדיר את שרת ה-SMTP ואת התוכן של התראות באימייל. הערה: בשלב זה, האפשרות להגדיר התראות על אימייל לא זמינה לפורטלים משולבים של Apigee. |
| ניהול ברירת המחדל של הרשאות הגישה | ניהול ברירת המחדל של הרשאות הגישה של משאבים ספציפיים. |
| הגדרה של מדיניות אבטחת תוכן | מגדירים מדיניות Content Security (CSP) לכל הדפים בפורטל, כדי להגן מפני פרצות של XSS (cross-site scripting) ומתקיפות אחרות של החדרת קוד, אם רוצים.
הערה: בשלב זה, התכונה הזו לא זמינה לפורטלים משולבים של Apigee. |
שלב 3: מגדירים את ספק הזהויות
מגדירים את ספק הזהויות בפורטל המשולב על סמך סוג האימות, כפי שמתואר בטבלה הבאה.
| אימות | התיאור |
|---|---|
| ספק זהויות מובנה (שם משתמש/סיסמה) | מגדירים את ספק הזהויות המובנה בפורטל המשולב. |
| כניסה יחידה (SSO) באמצעות SAML | הגדרת ספק הזהויות של SAML (בטא) בפורטל המשולב.
הערות:
|
אחרי שמפתחים נכנסים לפורטל, אתם יכולים לנהל את החשבון שלהם, כפי שמתואר בניהול חשבונות הפיתוח.
שלב 4: שליטה בגישה למשאבים באמצעות קהלים
אם אתם משתמשים בתפקידים ב-Drupal 7 כדי לשלוט בגישה לקבוצת משאבים, כמו תיעוד API או יצירת מפתח API למוצר API, תוכלו להשיג את אותה פונקציונליות באמצעות קהלים בפורטל המשולב.
באופן ספציפי, אפשר לשלוט בגישה למשאב הבא בפורטל המשולב באמצעות קהלים:
- דפים בפורטל שלך
- מוצרי API שפורסמו
במאמר ניהול קהלים מוסבר איך להוסיף קהל ולנהל את ההקצאות של משתמשים ספציפיים ושל צוות הפיתוח. כשמשתמש חדש יוצר חשבון ונכנס לפורטל שלך, צריך להקצות אותו לקהל אחד או יותר לפי הצורך, כפי שמתואר במאמר ניהול ההקצאות לקהל.
כדי שההעברה תהיה פשוטה יותר, מומלץ להשתמש בטיפים הבאים:
- נותנים שם לקהלים על שם התפקידים שהם מחליפים ב-Drupal.
- אפשר לנהל את החברות בקהל באמצעות צוותי הפיתוח. המפתחים יוצרים צוותים שמשתפים את האחריות על האפליקציות שלהם ומנהלים את חברות הצוות.
שלב 5: מפרסמים את ממשקי ה-API
כדי לפרסם ממשקי API וליצור באופן אוטומטי מסמכי עזר ל-API באמצעות SmartDocs בפורטל המשולב, נדרשת גישה למפרט OpenAPI המשויך ל-API.
ייתכן שהשתמשת במפרט OpenAPI כדי ליצור באופן אוטומטי את SmartDocs ב-Drupal 7, אבל בסופו של דבר התוכן מאוחסן בפורמט פנימי ללא שיוך למפרט OpenAPI המקורי. צוותי API שמשתמשים ב-Apigee Edge בדרך כלל מאחסנים את המפרטים של OpenAPI בחנות המפרט של Apigee Edge.
לאחר מכן, מפרסמים API בפורטל. מתכוננים לפעולות הבאות:
- צריך לציין את מפרט OpenAPI שישמש כמקור התיעוד: מחנות המפרטים, מהספרייה המקומית או מכתובת URL
- הגדרת החשיפה של המסמכים (גלוי לכולם, משתמשים לאימות הזהות או קהלים נבחרים)
- הגדרת כתובת URL לקריאה חוזרת (callback), במקרה הצורך
- אם צריך, אפשר להוסיף תמונה לתצוגה בקטלוג ה-API
שלב 6: משתפים את האחריות על האפליקציה באמצעות צוותי המפתחים
אם המפתחים שלכם משתמשים באפליקציות של החברה ב-Drupal 7 כדי לחלוק את האחריות על האפליקציה, הם יכולים להשיג את אותה הפונקציונליות באמצעות צוותי הפיתוח בפורטל המשולב.
המפתחים יוצרים צוותי מפתחים שחולקים את האחריות על האפליקציות שלהם ומנהלים את חברות הצוות, כפי שמתואר במאמר שיתוף אחריות על אפליקציה באמצעות צוותים של מפתחים (בטא).
כדאי להדריך את קהילת המפתחים לגבי צוותי המפתחים ולעודד אותם להעביר את האפליקציות שלהם כדי שיוכלו לשתף את האחריות עם המפתחים ולעבור להשתמש במפתחות ה-API החדשים. לאחר מכן אפשר להסיר את כל אפליקציות החברה ופריטי המידע שנוצרו בתהליך הפיתוח (Artifact) שקשורים אליה באמצעות Edge APIs.
לחלופין, אפשר להעביר אפליקציות של חברה לאפליקציות של צוות המפתחים, כפי שמתואר במאמר הקהילה הבא: העברת אפליקציות בבעלות החברה לצוותי המפתחים.
שלב 7: מתכוננים להשקת הפורטל המשולב
לפני שמפעילים את הפורטל המשולב לסביבת הייצור, כדאי לבצע את השלבים שמפורטים בטבלה הבאה.
| שלב | תיאור |
| התאמה אישית של הדומיין | כדי להתאים אישית את האתר, יש לספק שם דומיין מותאם אישית. הערה: בשלב זה, התכונה הזו לא זמינה לפורטלים משולבים של Apigee. |
| הגדרת מעקב ב-Analytics | הגדר מעקב של Analytics באמצעות Google Analytics או שירות מעקב מותאם אישית משלך. |
| יצירה של דף חיפוש בהתאמה אישית | יצירת דף חיפוש מותאם אישית והטמעה של מנוע חיפוש מותאם אישית של Google. |