ספרים
Google Apps Script
פרק 11. HTML והאינטרנט
שליחת בקשת HTTP עם אימות בסיסי

Google Apps Script:
שליחת בקשת HTTP עם אימות בסיסי

איך לעשות:

ב-Google Apps Script, לצורך שליחת בקשת HTTP עם אימות בסיסי, יש להשתמש בשירות UrlFetchApp בשילוב עם כותרת אישור מקודדת ב-base64. הנה מדריך צעד אחר צעד:

  1. קידוד הזהויות: תחילה, יש לקודד את שם המשתמש והסיסמה ב-base64. ל-Google Apps Script אין פונקציה יילידית לקידוד base64 של מחרוזות, לכן תשתמשו ב-Utilities.base64Encode למטרה זו.
var username = 'YourUsername';
var password = 'YourPassword';
var encodedCredentials = Utilities.base64Encode(username + ':' + password);
  1. הכנת אפשרויות הבקשה: עם הזהויות המקודדות מוכנות, הכינו את אובייקט האפשרויות לבקשת ה-HTTP, כולל השיטה והכותרות.
var options = {
  method: 'get', // או 'post', 'put', תלוי בצרכים שלכם
  headers: {
    'Authorization': 'Basic ' + encodedCredentials
  }
  // ניתן להוסיף כאן אפשרויות נוספות כמו 'muteHttpExceptions' לטיפול בשגיאות
};
  1. ביצוע הבקשה: השתמשו בשיטת UrlFetchApp.fetch עם ה-URL המבוקש ואובייקט האפשרויות.
var url = 'https://example.com/api/resource';
var response = UrlFetchApp.fetch(url, options);
Logger.log(response.getContentText());

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

{"status":"Success","data":"Resource data here..."}

וודאו שאתם מטפלים בשגיאות HTTP אפשריות על ידי בדיקת קוד התגובה או שימוש באפשרות muteHttpExceptions לניהול שגיאות מבוקר יותר.

צלילה עמוקה

שליחת בקשת HTTP עם אימות בסיסי הייתה שיטה סטנדרטית בשפות תכנות רבות לגישה למשאבים מבוססי אינטרנט הדורשים אימות. בהקשר של Google Apps Script, UrlFetchApp מספקת דרך ישירה לבצע בקשות HTTP אלו, כולל אלו הדורשות אימות. הכללת זהויות בסיסיות בכותרות הבקשה היא שיטה פשוטה אך יעילה, אך באה עם חששות אבטחה, בעיקר מאחר והזהויות נשלחות בטקסט גלוי, רק מקודדות ב-base64, שניתן לפענח בקלות אם הן נתפסות.

לשם שיפור האבטחה, מומלצות חלופות כמו OAuth 2.0, במיוחד כאשר מתמודדים עם נתונים או פעולות רגישות. ל-Google Apps Script יש תמיכה מובנית ב-OAuth 2.0 עם ספריית ה-OAuth2, המפשטת את תהליך האימות מול שירותים התומכים בפרוטוקול זה.

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

שליחת בקשת HTTP