כיצד הרכיבים משתלבים זה בזה
צרו חשבון שירות אחד לכל
אינטגרציה. בחרו מפתח API או לקוח OAuth עבור אותו חשבון; אין צורך בשתי
השיטות בכל בקשת API. אף אחד מאמצעי הזיהוי אינו יכול לחרוג מההרשאות
הנוכחיות של החשבון.
המדריך למתחילים משתמש באימות Basic. כותרת Bearer נתמכת גם היא עבור
מפתחות API; השימוש בכותרת זו אינו אומר שנדרש לקוח OAuth.
בחרו במפתח API לאינטגרציה פשוטה
השתמשו במפתח API עבור משימות מתוזמנות, סקריפטים לדיווח, צינורות נתונים או שירותי צד שרת אחרים שלכם, כאשר סוד המאוחסן במנהל הסודות שלכם עונה על דרישות האבטחה שלכם.- שלחו בקשות מאומתות ישירות; אין צורך בהחלפת אסימונים.
- בחרו רק את ההרשאות שעומס העבודה זקוק להן והגדירו תוקף.
- בצעו רוטציה של המפתח באמצעות חלון החפיפה שלו, או בטלו אותו מיידית אם נחשף.
בחרו ב-OAuth עבור אסימוני גישה קצרי טווח
השתמשו ב-OAuth client credentials עבור שירות צד שרת חסוי כאשר הארגון שלכם דורש אסימוני גישה בעלי תוקף מוגבל או כאשר כלי אינטגרציה מצפה לסוג ההענקהclient_credentials.
- צרו לקוח OAuth מוגבל-היקף עבור חשבון השירות.
- בצעו אימות של הלקוח מול נקודת הקצה האזורית של האסימונים בשיטת האימות של הלקוח שסופקה במהלך ההגדרה.
- שלחו את אסימון הגישה שהתקבל יחד עם בקשות ה-API שלכם. השיגו אסימון חדש לפני שתוקפו של האסימון הנוכחי יפוג.