כללי

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

• תרשים 1: ארכיטקטורה לוגית - תשתית DevComAPI
  

  
  

• אופן החיבור
  

  הגישה אל תשתית הממשקים של פרטנר נעשית באמצעות שליחת הודעות, הבנויות בפורמט XML כפי שיפורט להלן, בפרוטוקול HTTP על גבי האינטרנט. בדרך זאת לא נדרשת מהספק תשתית תקשורת מיוחדת, וניתן לממש את העבודה מול הממשק באמצעות כל סביבות הפיתוח הנפוצות.
  קיימות שתי סביבות עבודה אליהן ניתן להתחבר ולשלוח את הבקשות:
  • סביבת הבדיקות, אליה יחובר הספק בשלב ראשון, על מנת שיוכל לבצע מולה את הפיתוח והבדיקות.
  • הסביבה המבצעית, אליה יחובר הספק לאחר שיעבור בדיקות קבלה של פרטנר.

• מבנה ההודעות
  

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

• הצפנת ההודעות
  

  לצורך זיהוי ודאי של הספק ואבטחת הנתונים, מוצפן החלק המשמעותי של ההודעות באמצעות אלגוריתם ההצפנה התקני AES (Advanced Encryption Standard), המשתמש במפתח סימטרי (מפתח זהה משמש להצפנה ולפענוח). כל ספק מקבל מפרטנר מפתח ייחודי (אחד לסביבת הבדיקות ואחד לסביבה המבצעית), וכך ניתן לזהות את הבקשות המגיעות ממנו. הספק יכול לממש בצד שלו את ההצפנה והפענוח של ההודעות באמצעות אובייקטים או קטעי קוד, הזמינים לכל סביבות הפיתוח הנפוצות. ההגדרה הפורמאלית של האלגוריתם נמצאת ב- http://csrc.nist.gov/publications/fips/fips197/fips-197.pdf ופורסמה על-ידי National Institute of Standards and Technology

• יש להשתמש בהגדרות ההצפנה הבאות, אלא אם הוגדר במפורש אחרת:
  

  אלגוריתם: (AES (Rijndael
  חוזק הצפנה: 256 bit
  Cipher Mode: CBC
  Padding Mode: PKCS7

• הערה:

  The PKCS #7 padding string consists of a sequence of bytes, each of which is equal to the total number of padding bytes added. For example, if 24 bits (3 bytes) of padding need to be added, the padding string is "03 03 03".
  (taken from Microsoft Developers Network – MSDN - http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpref/html/frlrfsystemsecuritycryptographypaddingmodeclasstopic.asp