אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info
כדי שהמשתמשים יוכלו להתחיל לעבוד עם פורטל שירותי הפיתוח, צריך להוסיף אותם למערכת. כברירת מחדל, כל משתמש יכול להירשם בפורטל המפתחים על ידי לחיצה על הקישור Register (רישום) בתפריט הפורטל. לאחר מכן החשבון של המשתמש מאומת באופן אוטומטי והוא מוקצה לתפקיד המשתמש המאומת.
אתם יכולים להתאים אישית את פורטל המפתחים כך שרק משתמשים עם הרשאת אדמין יוכלו להוסיף חשבונות משתמשים. במקרה כזה, האדמין צריך להוסיף ידנית את חשבונות המשתמשים. יכול להיות גם שתצטרכו להוסיף ידנית חשבונות משתמשים למפתחים פנימיים או להוסיף מפתחים בשם לקוח.
אחרי שמוסיפים חשבון משתמש, האדמין יכול להקצות לו תפקיד, שמשויך לחשבון את ההרשאות של התפקיד הזה. בנוסף, אדמינים יכולים לנהל חשבון משתמש קיים, כולל עריכת פרופיל המשתמש בחשבון, מחיקה של החשבון, חסימה או ביטול חסימה של החשבון או הקצאת תפקיד חדש לחשבון. האדמין יכול גם לציין מה יקרה לחשבון המשתמש ולתוכן המשויך אליו (למשל, רשומות בבלוג ופוסטים בפורום) כשהחשבון יבוטל.
פורטל המפתחים יכול לשלוח אימיילים למשתמשים באופן אוטומטי כשמתרחשים אירועים. לדוגמה, הפורטל יכול לשלוח אימייל כשמשתמש מתווסף, כשחשבון חסום או כשחשבון מבוטל. כחלק מהניהול של המשתמשים, אתם יכולים לקבוע את התוכן והפורמט של הודעות האימייל האלה. מידע נוסף זמין במאמר הגדרת אימייל.
בסרטון הזה מוסבר איך לנהל תהליכי עבודה של רישום, להתאים אישית את האימיילים של הרישום, לחסום כתובות IP מפני רישום, ליצור חשבונות משתמשים, לנהל אותם ולחסום אותם.
קביעת האנשים שיכולים לרשום חשבונות
כברירת מחדל, כל משתמש יכול ליצור חשבון בפורטל למפתחים בלחיצה על הקישור 'רישום'.
כדי לקבוע מי יוכל לרשום חשבונות:
- מתחברים לפורטל בתור משתמש עם הרשאות אדמין או הרשאות ליצירת תוכן.
- בתפריט הניהול של Drupal, בוחרים באפשרות Configuration > People > Account settings. הדף 'הגדרות החשבון' ייפתח.
- לוחצים על אפשרות הרישום המתאימה בקטע Who Can Register Accounts (מי יכול לרשום חשבונות) בקטע Registration and cancellation (רישום וביטול). האפשרויות הן:
- אדמינים בלבד: רק אדמינים יכולים לרשום חשבונות משתמשים.
- מבקרים: כל אחד יכול להירשם. זוהי ברירת המחדל.
- מבקרים, אבל נדרש אישור של אדמין: כל אחד יכול להירשם, אבל אדמין צריך לאשר את החשבון.
- מסמנים את התיבה חובת אימות באימייל כשמבקר יוצר חשבון או מבטלים את הסימון שלה. אם לא מסמנים את התיבה הזו, המפתח מתחבר לפורטל באופן מיידי אחרי הרישום. אם התיבה מסומנת, המשתמש יקבל אימייל שבעזרתו הוא יוכל לאמת את כתובת האימייל שלו לפני שהוא יוכל להתחבר.
- לוחצים על Save configuration.
הוספת חשבון משתמש
בהתאם להגדרות של הפורטל, האדמינים צריכים להוסיף משתמשים באופן ידני, או שהמשתמשים יכולים להוסיף את עצמם על ידי לחיצה על הקישור Register בפורטל למפתחים.
הוספת חשבון משתמש באופן ידני
כדי להוסיף חשבון משתמש באופן ידני:
- מתחברים לפורטל בתור משתמש עם הרשאות אדמין או הרשאות ליצירת תוכן.
- בתפריט הניהול של Drupal, בוחרים באפשרות אנשים > הוספת משתמש.
- מזינים את הפרטים של המשתמש בשדות השם הפרטי, שם המשפחה, שם המשתמש, כתובת האימייל והסיסמה, ומציינים הסכמה להסכם המשתמש.
- אפשר גם להגדיר את הסטטוס והתפקידים של המשתמש.
- בוחרים באפשרות Notify user of new account כדי ליצור הודעת אימייל אוטומטית שתישלח למשתמש.
- לוחצים על Create Account (יצירת חשבון).
רישום משתמש דרך פורטל המפתחים
כדי לרשום משתמש מפורטל המפתחים:
- המשתמש בוחר באפשרות Register (רישום) בדף הבית של פורטל המפתחים.
- דף ההרשמה יופיע.
- המשתמש מזין את הפרטים הנדרשים ובוחר באפשרות Create new account.
בהתאם להגדרות של רישום החשבון החדש, כשהחשבון החדש נוצר, נשלחת למשתמש הודעת אימייל אוטומטית של קבלת פנים.
שליחת התראה אוטומטית לאדמינים כשמשתמש חדש נרשם
כברירת מחדל, כשמשתמש חדש נרשם בפורטל, הוא מקבל אימייל. מידע נוסף זמין במאמר הגדרת אימייל.
עם זאת, אדמינים של פורטלים לא מקבלים התראה כברירת מחדל כשמשתמש חדש נרשם. לדוגמה, אם מגדירים את הפורטל כך שמשתמשים חדשים יצטרכו אישור אדמיני כדי להפעיל את החשבון שלהם, חשוב לוודא שהאדמינים יקבלו הודעה כשהחשבון החדש נוצר. אחרת, חשבון המשתמש יישאר לא פעיל.
כדי לשלוח התראות לאדמינים כשמשתמש חדש רושם חשבון:
- מתחברים לפורטל בתור משתמש עם הרשאות אדמין או הרשאות ליצירת תוכן.
- בתפריט הניהול של Drupal, בוחרים באפשרות Configuration > People > Admin Notification.
- בקטע התראות למשתמשים, מציינים מי יקבל את האימייל. אפשר להפנות אותו אל:
- שליחה לכתובת אימייל מותאמת אישית
- שליחה לתפקיד ספציפי. אם בוחרים באפשרות הזו, כדאי ליצור תפקיד חדש. אחרת, אם בוחרים תפקיד כמו 'אדמין', כל האדמינים יקבלו את האימייל, ויכול להיות שהוא לא רלוונטי לכל האדמינים.
- שניהם
- עורכים את הנושא ואת גוף ההודעה.
- בוחרים מתי האימייל יישלח:
- קבלת אימייל עם יצירת המשתמש.
- קבלת אימייל לאחר יצירת משתמש ועדכון שלו.
- לוחצים על Save configuration.
ניהול חשבון משתמש
אדמינים יכולים לנהל חשבונות משתמשים כדי להגדיר את פרטי המשתמשים, לאפס סיסמאות, להפעיל חשבונות, לבטל או להשעות חשבונות ולבצע משימות אחרות.
כדי לערוך את פרופיל המשתמש בחשבון משתמש:
- מתחברים לפורטל בתור משתמש עם הרשאות אדמין או הרשאות ליצירת תוכן.
- בתפריט הניהול של Drupal, בוחרים באפשרות אנשים.
- אפשר להשתמש באזור הסינון בחלק העליון של הדף כדי לסנן את התצוגה של המשתמשים לפי שם משתמש, כתובת אימייל, סטטוס או הרשאה ספציפיים. כברירת מחדל, האפשרות 'כלשהו' מסומנת במסננים האלה, ובמקרה כזה כל המשתמשים מופיעים בדף.
- לוחצים על Edit (עריכה) בשורה Username (שם משתמש) של חשבון המשתמש. תוצג תצוגה שניתן לערוך של פרופיל המשתמש.
- משנים את נתוני פרופיל המשתמש בהתאם.
- לוחצים על שמירה.
הוספת CAPTCHA
כדי להוסיף אתגר CAPTCHA לדף הכניסה ולדפים אחרים, מפעילים את המודולים CAPTCHA ו-reCAPTCHA ב-Drupal. המודול של reCAPTCHA מוסיף תמיכה בשירות reCAPTCHA החינמי של Google.
מערכת Drupal תומכת במודולים אחרים של CAPTCHA, כמו CAPTCHA של תמונה, שאפשר להשתמש בהם גם בפורטל.
סרטון: צפייה בסרטון קצר בנושא הפעלת CAPTCHA בפורטל המפתחים.
כדי להפעיל את reCAPTCHA:
- מתחברים לפורטל בתור משתמש עם הרשאות אדמין או הרשאות ליצירת תוכן.
- בתפריט Drupal, בוחרים באפשרות Modules.
- מפעילים את המודולים CAPTCHA ו-reCAPTCHA.
- נרשמים לקבלת מפתחות reCAPTCHA מ-Google בכתובת https://www.google.com/recaptcha/intro/index.html.
- בתפריט Drupal, בוחרים באפשרות Configuration > People > CAPTCHA > reCAPTCHA.
- מזינים את המפתח הציבורי (מפתח האתר של Google) ואת המפתח הפרטי (מפתח הסוד של Google). אפשר להשאיר את שאר ההגדרות עם ערכי ברירת המחדל.
- בוחרים באפשרות Configuration (הגדרה) > People (אנשים) > CAPTCHA כדי להגדיר איפה הטופס של reCAPTCHA יוצג. כברירת מחדל, הוא מופיע בטפסי ההתחברות וטפסי ההרשמה של המשתמשים.
- בדף הזה, מגדירים את סוג האתגר לכל טופס.
- שומרים את השינויים.
הוספת דף תנאים והגבלות
אתם יכולים להוסיף דף תנאים והגבלות לפורטל המפתחים, שהמשתמשים צריכים לאשר כשהם מתחברים כדי לקבל גישה לפורטל. אם תשנו את דף התנאים וההגבלות מאוחר יותר, המשתמשים יצטרכו לאשר את התנאים וההגבלות המעודכנים בפעם הבאה שהם יתחברו.
ההטמעה של דף התנאים וההגבלות מתבצעת באמצעות המודול המשפטי של Drupal. המודול הזה מספק דרך גמישה ליצור דף תנאים והגבלות, לעקוב אחרי היסטוריית הגרסאות של התנאים וההגבלות ולעקוב אחרי המשתמשים שאישרו את התנאים וההגבלות.
לאחר היצירה, כתובת ה-URL של דף התנאים וההגבלות היא <siteURL>/legal
.
כדי להפעיל את המודול 'משפטי':
- נכנסים לפורטל בתור משתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות Modules. תוצג רשימה של כל המודולים של Drupal שמותקנים.
- גוללים למטה בדף ומסמנים את התיבה לצד מודול משפטי.
- לוחצים על Save configuration.
כדי ליצור דף תנאים והגבלות:
- נכנסים לפורטל בתור משתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות Configuration > People > Legal.
פריט התפריט הזה מופיע רק כשהמודול 'משפטי' מופעל. בתיבה העליונה בדף, בקטע 'הגרסה/התיקון האחרונים', מוצגים התנאים וההגבלות הנוכחיים. אם לא הגדרתם תנאים והגבלות, האזור הזה יהיה ריק. יוצרים גרסה חדשה בקטע 'תנאים והגבלות', בקטע 'יצירת גרסה/תרגום חדשים'. - מזינים את התנאים וההגבלות בקטע 'תנאים והגבלות'.
- בוחרים איך רוצים להציג את התנאים וההגבלות בדף: תיבת גלילה, תיבת גלילה (CSS), טקסט HTML או קישור לדף.
- אפשר גם להוסיף תיבות סימון נוספות ואזור טקסט שמתאר את השינויים האחרונים.
- בוחרים באפשרות תצוגה מקדימה כדי להציג תצוגה מקדימה של התנאים וההגבלות בקטע 'התנאים וההגבלות', בקטע 'הגרסה/התיקון האחרונים', או באפשרות שמירה כדי לשמור אותם.
כדי לעקוב אחרי השינויים בתנאים ובהגבלות ואישורם:
- מתחברים לפורטל בתור משתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות Configuration > People > Legal.
- לוחצים על הכרטיסייה היסטוריית התנאים וההגבלות כדי לראות את היסטוריית העריכה של התנאים וההגבלות.
- בוחרים בכרטיסייה Accepted כדי לראות את רשימת המשתמשים שאישרו כל גרסה של התנאים וההגבלות.
הפניה אוטומטית של משתמש בזמן ההתחברות
כברירת מחדל, כשמשתמש מתחבר לפורטל, הוא מופנה לדף שבו מוצגים הפרטים שלו, כמו שם פרטי ושם משפחה. לחלופין, אפשר להשתמש במודול Drupal Rules כדי להוסיף כלל להפניה אוטומטית של המשתמש לדף אחר. לדוגמה, אפשר להפנות את המשתמש לדף שבו מפורטות כל האפליקציות שלו או לדף הבית של הפורטל.
כדי ליצור כלל להפניה אוטומטית, צריך לוודא שכל המודולים הנדרשים של Drupal מופעלים.
מפעילים את המודולים הנדרשים של Drupal:
- נכנסים לפורטל בתור משתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות Modules.
- מפעילים את המודולים הבאים, אם הם לא מופעלים כבר:
- כינויים של 'me' (מופיע בחלק העליון של רשימת המודולים, ולא במיקום האלפביתי שלו כמו כל שאר המודולים)
- LoginToboggan
- כללים
- ממשק המשתמש של הכללים
- לוחצים על Save configuration.
יכול להיות שתראו מודולים נדרשים אחרים שמופעלים באופן אוטומטי.
יוצרים כלל להפניה אוטומטית לאחר התחברות:
- מתחברים לפורטל בתור משתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות Configuration > Workflow > Rules.
- בוחרים באפשרות + הוספת כלל חדש בדף 'כללים'.
- מציינים את שם הכלל: Login redirect.
- אפשר לציין תג כהתחברות.
- בתיבה הנפתחת 'תגובה לאירוע', בוחרים באפשרות משתמש > המשתמש נכנס לחשבון.
- בוחרים באפשרות שמירה
הדף 'עריכת כלל התגובה' מופיע. כבר הגדרתם את האירוע בשלב הקודם, כך שבקטע 'אירוע' אמור להופיע הכיתוב 'המשתמש נכנס'. משאירים את השדה 'תנאים' ריק בכלל הזה. - בקטע 'פעולות', בוחרים באפשרות + הוספת פעולה.
- בתפריט הנפתח, בוחרים באפשרות מערכת > הפניה אוטומטית לדף.
הפורמט של הדף 'הוספת פעולה חדשה' ישתנה כדי לאפשר לכם לציין את כתובת ה-URL להפניה אוטומטית. - בקטע Value (ערך), מציינים user/[account:uid]/apps.
[account:uid] הוא תבנית החלפה שתואמת למזהה הפורטל של המשתמש. כדי לראות את הרשימה המלאה של תבניות ההחלפה, בוחרים באפשרות 'תבניות החלפה' מתחת לתיבת הזנת הערך. - לוחצים על Save (שמירה) כדי לחזור לדף Editing reaction rule (עריכת כלל התגובה). הדף אמור להיראות כך:
- לוחצים על שמירה של השינויים.
כדי לערוך את הכלל מאוחר יותר, בוחרים באפשרות 'כללים' בדף ההגדרות, ואז בוחרים באפשרות 'הפניה אוטומטית לדף הכניסה' מרשימת הכללים.
עכשיו, כשמשתמש יתחבר, הוא יועבר לדף שבו מפורטות כל האפליקציות שלו. אם במקום זאת רוצים להפנות אותם לדף הבית של הפורטל, צריך לערוך את הערך שהגדרתם למעלה בשלב 11 כדי לציין את כתובת ה-URL של דף הבית של הפורטל. לדוגמה: http://dev-myCompany.devportal.apigee.io/.
הגדרת תפקידים והרשאות של משתמשים
תפקיד מגדיר קבוצה ספציפית של הרשאות שמאפשרות למשתמש לבצע פעילויות מסוימות. כדי להעניק הרשאות למשתמש או לקבוצת משתמשים, מקצים למשתמש תפקיד עם ההרשאות הנדרשות. האדמינים מנהלים את התפקידים, כולל הגדרת ההרשאות של התפקידים, בפורטל למפתחים.
כברירת מחדל, Drupal יוצר שני תפקידים:
- משתמש אנונימי – התפקיד של כל משתמש שלא נכנס לחשבון. משתמשים אנונימיים לא יכולים לבצע את רוב הפעולות.
- משתמש מאומת – תפקיד ברירת המחדל שהוקצה לכל המשתמשים. אפשר להקצות למשתמש תפקידים נוספים, אבל הוא תמיד יהיה מוקצה לתפקיד הזה.
בנוסף, ב-Apigee נוספה התפקיד אדמין. מקצים למשתמשים את תפקיד האדמין כדי לתת להם הרשאות אדמין בפורטל.
בדרך כלל מוסיפים תפקידים לפורטל כדי שתוכלו להבדיל בין הרשאות לפי סוגי משתמשים שונים. משתמש יכול להיות בתפקיד אחד או בכמה תפקידים. כל המשתמשים מוגדרים לתפקיד 'משתמש מאומת', אבל אם רוצים להקצות משתמש לתפקידים נוספים, צריך להוסיף לפורטל לוגיקה או להקצות את התפקידים באופן ידני.
כדי לראות את כל התפקידים וההרשאות:
- מתחברים לפורטל בתור משתמש עם הרשאות אדמין או הרשאות ליצירת תוכן.
- בתפריט הניהול של Drupal, בוחרים באפשרות אנשים > הרשאות > תפקידים.
כדי להוסיף תפקיד חדש:
- בוחרים באפשרות אנשים > הרשאות > תפקידים.
- מזינים שם תפקיד חדש בתיבת הטקסט שמעל הלחצן 'הוספת תפקיד' בדף 'אנשים'.
- לוחצים על התפקיד Add.
כדי לערוך תפקיד:
- בוחרים באפשרות אנשים > הרשאות > תפקידים.
- לוחצים על edit role בשורה של התפקיד הרלוונטי בדף 'אנשים'.
- משנים את שם התפקיד לפי הצורך.
- לוחצים על שמירה.
כדי למחוק תפקיד:
- בוחרים באפשרות אנשים > הרשאות > תפקידים.
- לוחצים על edit role בשורה של התפקיד הרלוונטי בדף 'אנשים'.
- לוחצים על התפקיד Delete.
כדי להוסיף משתמש לתפקיד:
- מתחברים לפורטל בתור משתמש עם הרשאות אדמין או הרשאות ליצירת תוכן.
- בתפריט הניהול של Drupal, בוחרים באפשרות אנשים.
- לוחצים על Edit (עריכה) בשורה Username (שם משתמש) של חשבון המשתמש. תוצג תצוגה שניתן לערוך של פרופיל המשתמש.
- בוחרים את כל התפקידים למשתמש בהתאם.
- לוחצים על שמירה.
כדי לשנות את ההרשאות של תפקיד:
- בוחרים באפשרות אנשים > הרשאות > תפקידים.
- לוחצים על הכרטיסייה Permission בדף 'אנשים'.
תוצג טבלה של תפקידים והרשאות. סימני הביקורת בטבלה מציינים אילו הרשאות הוקצו לאילו תפקידים.
- מסמנים או מבטלים את הסימון בתיבות הסימון כדי להעניק או לבטל את ההרשאה המשויכת לתפקיד הזה, בהתאמה.
לדוגמה, כדי למנוע ממשתמשים מאומתים ליצור או למחוק אפליקציות, גוללים למטה לקטע אפליקציות למפתחים ב-DevConnet בטבלת ההרשאות ומבטלים את הסימון בתיבות של יצירת אפליקציות למפתחים ושל מחיקת אפליקציות למפתחים בקטע משתמשים מאומתים. - לוחצים על שמירה ההרשאות.
התאמה אישית של שדות הטופס המשמשים לרישום משתמש
כשהמשתמש רושם חשבון בפורטל, מוצג בדף הרשום כברירת מחדל עם השדות: שם פרטי, שם משפחה, שם משתמש, כתובת אימייל וסיסמה. כספק API, מומלץ לשנות את הטופס הזה כדי לבקש מהמשתמש לספק מידע נוסף, כמו שם החברה, כתובת למשלוח דואר או מידע אחר. בפורטל יש לכם אפשרות להוסיף שדות חדשים לטופס הזה. השדות האלה יכולים להיות:
- נדרש או אופציונלי
- מוצגים על ידי רכיבי HTML שונים, כמו תיבות טקסט, לחצני בחירה, תיבות סימון ועוד
- אפשר להגדיר שהם יופיעו בכל מקום בטופס
בסרטון הזה מוסבר איך להתאים אישית את טופס ההרשמה של המשתמשים שזמין בפורטל למפתחים.
לדוגמה, אפשר להוסיף שדה חובה בשם 'שם החברה' או שדה אופציונלי בשם 'מספר טלפון'. אפשר גם להוסיף כמה שדות, אופציונליים וחובה.
בתמונה הבאה מוצג שדה חובה בשם 'שם החברה' שנוסף לטופס:
כאדמינים בפורטל, אתם יכולים לראות ולערוך את פרטי המשתמש, כולל שדות מותאמים אישית, באופן הבא:
- לוחצים על אנשים בתפריט הניהול של Drupal בפורטל.
- לוחצים על עריכה בשורה שמתאימה לשם המשתמש.
זוהי הדרך העיקרית שבה, כאדמינים, אתם יכולים לגשת לנתוני המשתמשים.
כברירת מחדל, כשמוסיפים שדות חדשים לטופס, ערכי השדות לא מועלים ל-Edge. עם זאת, אפשר להגדיר את הפורטל כך שיעלה את הערכים האלה כשהמשתמש שולח את הטופס. כלומר, אפשר להציג את השדות האלה ב-Edge, או להשתמש ב-Edge Management API כדי לגשת לשדות האלה מתוך סקריפט.
לדוגמה, כדי להציג את שדות הטופס החדשים בממשק המשתמש לניהול ב-Edge,עוברים אל פרסום > מפתחים ובוחרים את שם המשתמש. ערכי השדות החדשים מופיעים בקטע 'מאפיינים מותאמים אישית' בדף, עם שם שתואם לשם הפנימי של השדה:
כדי להוסיף שדה לטופס ההרשמה של המשתמש:
- מתחברים לפורטל בתור משתמש עם הרשאות אדמין או הרשאות ליצירת תוכן.
- בתפריט האדמין של Drupal, בוחרים באפשרות Configuration > People > Account Settings.
- בוחרים בלחצן ניהול שדות בחלק העליון של הדף.
- גוללים למטה בדף לאזור 'הוספת שדה חדש':
- מגדירים את השדה. לדוגמה, בשדה 'שם החברה' שמוצג למעלה, צריך להשתמש בהגדרות הבאות:
- לוחצים על שמירה.
- מכיוון שזהו שדה טקסט, תתבקשו לציין את האורך המקסימלי של השדה.
- מזינים את האורך המקסימלי ובוחרים באפשרות שמירה של הגדרות השדה.
- יופיע דף חדש שבו תוכלו לציין פרטים נוספים לגבי השדה, כולל:
- תיבת סימון להגדרת השדה כחובה.
- תיבת סימון כדי לציין שהשדה יוצג.
- טקסט עזרה אופציונלי שיופיע בחלון קופץ בטופס.
- הגדרות אחרות.
- חשוב לסמן את התיבה כדי להגדיר את השדה הזה כחובה.
- אם מבצעים שינויים בדף הזה, שומרים את ההגדרות.
יכול להיות שתצטרכו לנקות את המטמון של הדפדפן כדי שהשדה החדש יופיע בטופס.
כדי לשנות את הסדר של המאפיינים בטופס:
כברירת מחדל, שדות חובה חדשים מופיעים בטופס אחרי השדה 'שם משפחה'. השדות האופציונליים מופיעים בתחתית הטופס, אחרי שדות הסיסמה.
- מתחברים לפורטל בתור משתמש עם הרשאות אדמין או הרשאות ליצירת תוכן.
- בתפריט הניהול של Drupal, בוחרים באפשרות Configuration > People > Account Settings.
- בחלק העליון של הדף, לוחצים על הלחצן ניהול שדות.
- בוחרים את סמל הפלוס + מתחת לעמודה Label וגוררים את השדה למיקום שבו רוצים להציג אותו בטופס.
- שומרים את השינויים.
שמירה של ערכים של שדות טופס כמאפייני פיתוח מותאמים אישית ב-Edge
אפשר לשמור ערכים של שדות טופס במאפייני פיתוח בהתאמה אישית ב-Edge. אפשר להציג ולנהל מאפיינים מותאמים אישית של מפתח, כפי שמתואר במאמר ניהול מפתחי אפליקציות.
אחרי שמשמרים את מאפייני המפתחים בהתאמה אישית, אפשר להשתמש במדיניות של ישות הגישה, למשל, כדי להפעיל התנהגות דינמית על סמך ערכי המאפיינים בהתאמה אישית.
בסרטון הזה מוסבר איך לשמור ערכים של שדות טופס כמאפייני פיתוח בהתאמה אישית.
כדי לשמור את ערכי השדות כמאפייני פיתוח בהתאמה אישית ב-Edge:
- מתחברים לפורטל בתור משתמש עם הרשאות אדמין או הרשאות ליצירת תוכן.
- בתפריט הניהול של Drupal, בוחרים באפשרות Configuration > Dev Portal > Developer Attributes.
תוצג רשימה של השדות הזמינים. - בוחרים את השדה שרוצים לשמור כמאפיין ב-Edge, למשל שם החברה.
- מסמנים את התיבה Persist this field as an attribute in Edge.
- מציינים את שם מאפיין הקצה. זה השם שמופיע בעמודה Name בטבלה Custom Attributes של המשתמש.
- הגדרת ההתנהגות בשדה ריק
- בוחרים את המחרוזת Convert value to true|false אם רוצים להמיר את הערך כערך בוליאני ולהמיר אותו למחרוזת true או false לפני השליחה אל Edge.
- לוחצים על Save configuration.
עכשיו המאפיין המותאם אישית יועלה ל-Edge כשהמשתמש ישלח את הטופס. אם אתם אדמינים ואתם רוצים לשנות את הערך של שדה מותאם אישית, עליכם לעשות זאת דרך הפורטל ולא דרך Edge.
יצירת אפליקציית ברירת מחדל כשמשתמש רושם חשבון חדש
אתם יכולים ליצור אפליקציית ברירת מחדל באופן אוטומטי כשמשתמש רושם חשבון חדש בפורטל. כשהמשתמש נכנס לחשבון בפעם הראשונה, האפליקציה מופיעה בדף 'האפליקציות שלי'. בהתאם להרשאות שהוקצו לתפקיד של המשתמש, תוכלו לאפשר לו להוסיף אפליקציות נוספות, או שהאפליקציה הזו תהיה האפליקציה היחידה שזמינה לו.
יש לכם שליטה מלאה על המאפיינים של אפליקציית ברירת המחדל, כולל:
- מוצרי ה-API שכלולים באפליקציה
- מצב האפליקציה: בהמתנה או אושרה
- כתובת ה-URL לקריאה חוזרת (callback), אם יש צורך
- פרמטרים מותאמים אישית שחלים על האפליקציה
כדי לשלוט ביצירה של אפליקציית ברירת המחדל, יוצרים כלל באמצעות מודול הכללים של Drupal. כלל מאפשר לכם להגדיר פעולה שתתבצע בתגובה לאירוע בפורטל. בתרחיש הזה, האירוע הוא משתמש שנרשם לחשבון בפורטל. הפעולה היא יצירת אפליקציית ברירת מחדל למשתמש.
בקטע התאמה אישית של שדות הטופס המשמשים לרישום אפליקציה מוסבר איך מוסיפים מאפיינים מותאמים אישית שמשמשים להגדרת אפליקציה. המאפיינים האלה יכולים להיות אופציונליים או חובה, בהתאם לאופן שבו מגדירים אותם. אם יצרתם מאפייני אפליקציה מותאמים אישית, תוכלו להגדיר אותם כשמגדירים אפליקציית ברירת מחדל.
מפעילים את המודולים של כללי Drupal:
- מתחברים לפורטל בתור משתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות Modules.
- מפעילים את המודולים הבאים, אם הם לא מופעלים כבר:
- כינויים של 'me' (מופיע בחלק העליון של רשימת המודולים, ולא במיקום האלפביתי שלו כמו כל שאר המודולים)
- LoginToboggan
- כללים
- ממשק המשתמש של הכללים
- לוחצים על Save configuration.
יכול להיות שתראו מודולים נדרשים אחרים שמופעלים באופן אוטומטי.
יוצרים כלל להוספת אפליקציית ברירת מחדל:
- נכנסים לפורטל בתור משתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות Configuration > Workflow > Rules.
- לוחצים על הלחצן +הוספת כלל חדש.
- נותנים שם לכלל (Name).
- אפשר לציין את שם הכניסה בשדה Tags, או כל תג אחר שרוצים להשתמש בו כדי לסווג את הכלל.
- בתיבה הנפתחת React on event, בוחרים באפשרות User > After saving a new user account.
- לוחצים על שמירה.
דף העריכה של הכלל יופיע. כבר הגדרתם את האירוע בשלב הקודם, כך שצריך להופיע הכיתוב 'אחרי שמירת חשבון משתמש חדש' בקטע 'אירוע'. - משאירים את השדה תנאים ריק בכלל הזה.
- בקטע פעולות, בוחרים באפשרות + הוספת פעולה.
- בתפריט הנפתח, בוחרים באפשרות Devconnect > Create a developer application.
הפריסה של הדף 'הוספת פעולה חדשה' משתנה כדי לאפשר לכם להגדיר את האפליקציה. - בקטע API Name, מציינים את שם אפליקציית ברירת המחדל. לדוגמה, אפשר להשתמש ב-[account:field_last_name] Application.
הערך [account:field_last_name] הוא תבנית החלפה שתואמת לשם המשפחה של המשתמש. כדי לראות את הרשימה המלאה של תבניות ההחלפה, בוחרים באפשרות Replacement patterns מתחת לתיבה להזנת Value. - מגדירים את Developer UID כ-[account:uid]. הערך הזה נדרש כדי לשייך את המשתמש לאפליקציה.
- מגדירים את הסטטוס של האפליקציה ל-בהמתנה או ל-אושרה. מגדירים את הסטטוס ל-בהמתנה אם האדמין עדיין צריך לאשר את האפליקציה לפני שהמשתמש יוכל להשתמש בה כדי לגשת לממשקי ה-API שלכם.
- אם צריך, מגדירים את כתובת ה-URL לקריאה חוזרת (callback) לאפליקציה. השדה הזה מופיע רק אם הגדרתם לאפליקציות דרישה לכתובת URL לקריאה חוזרת. מידע נוסף על הגדרת כתובות URL לקריאה חוזרת זמין במאמר הגדרת טיפול בכתובות URL לקריאה חוזרת.
- אם הגדרתם מאפייני אפליקציה מותאמים אישית, אופציונליים או נדרשים, מגדירים אותם. מידע נוסף זמין במאמר התאמה אישית של שדות הטופס המשמשים לרישום אפליקציה.
- מציינים את מוצרי ה-API שכלולים באפליקציה.
באזור הטקסט ערך, כל מוצר API צריך להופיע בשורה נפרדת, בלי פסיקים או תוספי מפריד אחרים. רשימת מוצרי ה-API הזמינים מוצגת מעל אזור הטקסט Value. - לוחצים על Save כדי לחזור לדף Editing rule.
- לוחצים על שמירה של השינויים.
- כדי לערוך את הכלל מאוחר יותר, בוחרים באפשרות Configuration > Workflow > Rules בתפריט הניהול של Drupal, ואז בוחרים את הכלל מרשימת הכללים.
כשמשתמש חדש נכנס לפורטל בפעם הראשונה ובוחר בקישור 'האפליקציות שלי' בתפריט, הוא רואה עכשיו אפליקציה בשם lastName Application, כאשר lastName הוא השם האחרון שבו המשתמש השתמש כשנרשם לחשבון.
ניהול אפליקציות של משתמשים
אדמינים בפורטל יכולים להשתמש בדוח 'אפליקציות למפתחים' כדי לנהל אפליקציות של משתמשים ישירות מהפורטל. בדוח הזה, האדמין יכול לראות מידע על האפליקציה של המשתמש, לשנות אותה או למחוק אותה. לדוגמה, אדמין בפורטל יכול לשנות את האפליקציה כדי להוסיף או להסיר מוצרים של ממשקי API, לשנות את כתובת ה-URL להודעת החזרה או לבצע שינויים אחרים.
כדי לנהל אפליקציה של משתמש:
- נכנסים לפורטל בתור משתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות Reports > Developer Apps. תוצג רשימה של אפליקציות של משתמשים שאפשר למיין.
- בכל אפליקציה ברשימה:
- לוחצים על הקישור עריכה כדי לערוך את מאפייני האפליקציה.
- בוחרים בקישור Delete (מחיקה) כדי למחוק את האפליקציה.
ביטול חשבון משתמש
אדמין בפורטל יכול לבטל חשבון משתמש. האדמין יכול לבטל חשבון ספציפי או לבטל כמה חשבונות בו-זמנית.
כדי לבטל חשבונות של משתמשים ספציפיים:
- נכנסים לפורטל בתור משתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות אנשים.
- בעמודה Operations בטבלת המשתמשים, בוחרים באפשרות Cancel account.
- לוחצים על אפשרות הביטול המתאימה בקטע 'כשמבטלים חשבון משתמש'. האפשרויות הן:
- השבתה של החשבון ושמירת התוכן שלו: (ברירת המחדל) חשבון המשתמש והתוכן שקשור אליו נשמרים. עם זאת, חשבון המשתמש חסום לגישה למשאבי API. זוהי ברירת המחדל. לאחר מכן, אדמין יכול לבטל את החסימה של חשבון המשתמש.
- להשבית את החשבון ולבטל את פרסום התוכן שלו: חשבון המשתמש נשאר. עם זאת, התוכן שמשויך לחשבון המשתמש יוסר. חשבון המשתמש חסום לגישה למשאבי API. לאחר מכן, אדמין יכול לבטל את החסימה של חשבון המשתמש.
- מחיקת החשבון, אבל הבעלות על התוכן שלו תעבור למשתמש Anonymous: חשבון המשתמש נמחק. התוכן שמשויך לחשבון המשתמש נשמר, אבל הוא משויך לחשבון המשתמש 'אנונימי', כלומר לחשבון שלא בוצעה לו אימות. לא ניתן להפעיל מחדש את חשבון המשתמש. המשתמש צריך להירשם מחדש, וחשבון המשתמש צריך לעבור אימות לפני הגישה למשאבי ה-API.
- מחיקת החשבון והתוכן שלו: חשבון המשתמש והתוכן שקשור אליו נמחקים. לא ניתן להפעיל מחדש את חשבון המשתמש. המשתמש צריך להירשם מחדש, וחשבון המשתמש צריך לעבור אימות לפני הגישה למשאבי ה-API.
- אם רוצים שהמשתמש יקבל אימייל עם בקשה לאשר את הביטול, בוחרים באפשרות Require e-mail confirmation to cancel account.
אם בוחרים באפשרות הזו, לחשבון המשתמש צריכות להיות ההרשאות המתאימות כדי לאפשר את הביטול. בוחרים באפשרות People > Permissions ומוודאים שהתפקיד authenticated user כולל את ההרשאה Cancel own user account. - לוחצים על ביטול החשבון.
כדי לבטל כמה חשבונות משתמשים:
- נכנסים לפורטל בתור משתמש עם הרשאות אדמין.
- בתפריט הניהול של Drupal, בוחרים באפשרות אנשים.
- בקטע Operations, בתפריט הנפתח בוחרים באפשרות Cancel user account.
- מסמנים את התיבה לצד כל משתמש שרוצים לבטל את החשבון שלו.
- לוחצים על הלחצן Execute.
- לוחצים על אפשרות הביטול המתאימה בקטע 'כשמבטלים חשבון משתמש'. האפשרויות הן:
- להשבית את החשבון ולשמור את התוכן שלו.
- להשבית את החשבון ולבטל את פרסום התוכן שלו.
- למחוק את החשבון, אבל להעביר את התוכן שלו למשתמש Anonymous.
- למחוק את החשבון ואת התוכן שלו.
- לוחצים על הבא.
- לוחצים על אישור.
הגדרת פעולת ברירת המחדל כשחשבון מבוטל
אדמינים בפורטל למפתחים יכולים להגדיר את פעולת ברירת המחדל של הפורטל כשחשבון משתמש מבוטל.
כדי להגדיר את פעולת ברירת המחדל כשחשבון מבוטל:
- מתחברים לפורטל בתור משתמש עם הרשאות אדמין או הרשאות ליצירת תוכן.
- בתפריט הניהול של Drupal, בוחרים באפשרות Configuration.
- בוחרים באפשרות הגדרות חשבון.
- לוחצים על אפשרות הביטול המתאימה בקטע 'כשמבטלים חשבון משתמש' בקטע 'רישום וביטול'. האפשרויות הן:
- להשבית את החשבון ולשמור את התוכן שלו.
- להשבית את החשבון ולבטל את פרסום התוכן שלו.
- למחוק את החשבון, אבל להעביר את התוכן שלו למשתמש Anonymous.
- למחוק את החשבון ואת התוכן שלו.
- לוחצים על Save (שמירה) כדי לשמור את ההגדרות.