בהגדרות › גישה דרך API, אפשר ליצור אסימוני גישה אישיים כדי שסקריפט או לקוח MCP יוכלו להשתמש ב-Dvina בשמכם. מנהלי מערכת יכולים גם להוסיף שם webhooks כדי לשלוח אירועים מה-Livespace למערכות שלהם.
גישה דרך API כלולה בתוכנית Enterprise. כל חבר יכול ליצור אסימונים משלו; רק בעלים ומנהלי מערכת רואים את Webhooks.
יצירת אסימון
- פתחו את ההגדרות ובחרו גישה דרך API.
- תחת אסימוני גישה אישיים, בחרו יצירת אסימון.
- הזינו שם כדי שתוכלו לזהות בהמשך מה משתמש באסימון.
- בחרו את הרשאת הגישה: קריאה בלבד או קריאה וכתיבה.
- בחרו מתי התוקף פג: בעוד 30 ימים, בעוד 90 ימים, בעוד 365 ימים או ללא תפוגה.
- בחרו יצירת אסימון.
- תחת העתקת האסימון שלכם, העתיקו את האסימון ושמרו אותו במקום בטוח. זו הפעם היחידה שבה הוא מוצג.
אסימון פועל בשמכם, ב-Livespace שבו יצרתם אותו, בהתאם לתפקיד הנוכחי שלכם בו. אסימון עם הרשאת קריאה בלבד יכול לקרוא מידע, אך לא להוסיף או לשנות דבר.
כדי להשתמש באסימון עם לקוח MCP, ראו התחברות עם מפתח API במקום OAuth.
בדיקה, החלפה או ביטול של אסימון
האסימונים שלכם מופיעים תחת אסימוני גישה אישיים, לצד הרשאות הגישה שלהם. בחרו אסימון כדי לראות במה הוא מתחיל, את הרשאת הגישה שלו, מתי היה בשימוש לאחרונה ומתי התוקף פג.
- כדי להחליף אסימון, בחרו החלפה… ואז החלפה לאישור. אסימון חדש יחליף אותו, והאסימון הישן יפסיק לפעול מיד. העתיקו את האסימון החדש תחת העתקת האסימון שלכם.
- כדי לבטל אסימון, בחרו ביטול… ואז ביטול לאישור. כל מה שמשתמש בו יפסיק לפעול מיד.
יצירה, החלפה וביטול של אסימון מתועדים ביומן הביקורת.
הוספת webhook
webhook שולח אירועים מה-Livespace לכתובת שתבחרו. אלה אותן רשומות שמופיעות ביומן הביקורת.
- בהגדרות › גישה דרך API, תחת Webhooks, בחרו הוספת Webhook.
- הזינו שם וכתובת URL. השתמשו בכתובת HTTPS נגישה לציבור.
- תחת אירועים, השאירו את השדה ריק כדי לקבל את כל האירועים, או ציינו פעולות ותחומים, כגון
member.addedאוsharing.*. - בחרו הוספה.
- תחת העתקת הסוד לחתימה, העתיקו את הסוד. זו הפעם היחידה שבה הוא מוצג.
אם Dvina מציגה את ההודעה לא ניתן להגיע לכתובת הזו מ-Dvina, השתמשו בכתובת HTTPS נגישה לציבור.
בדיקת החתימה של כל בקשה
Dvina שולחת אירועים בקבוצות, בפורמט JSON, וחותמת על כל בקשה. השתמשו בסוד לחתימה כדי לבדוק שהבקשה הגיעה מ-Dvina:
- לכל בקשה יש כותרת
X-Dvina-Signatureבמבנהt=<timestamp>,v1=<signature>. - החתימה היא ערך HMAC-SHA256 בייצוג הקסדצימלי, המחושב מחותמת הזמן, נקודה וגוף הבקשה, באמצעות הסוד שלכם לחתימה.
- חשבו את החתימה בעצמכם והשוו. דחו בקשה שהחתימה שלה אינה תואמת או שחותמת הזמן שלה ישנה מדי.
בדיקה או שינוי של webhook
ה-webhooks שלכם מופיעים תחת Webhooks עם הסטטוס שלהם: פעיל, מושהה או נכשל. בחרו אחד מהם כדי לראות את הפרטים שלו.
- כדי לשנות אותו, ערכו את השם, הכתובת (URL) או האירועים, ואז בחרו שמירה.
- כדי להשהות אותו, כבו את שליחת אירועים. הפעילו אותה שוב כדי לחדש את השליחה.
- כדי לבדוק איך הוא פועל, בדקו את הסטטוס שלו וכמה אירועים נשלחו. ב-webhook שנכשל מופיעה השגיאה האחרונה שלו. Dvina ממשיכה לנסות ומתעדת את הכשל ביומן הביקורת.
- כדי לשנות את הסוד שלו, בחרו סוד חתימה חדש…, ואז אשרו. הבקשות נחתמות בסוד החדש מיד, לכן עדכנו מיד את הצד המקבל.
- כדי להסיר אותו, בחרו מחיקה…, ואז מחיקה לאישור. לא יישלח אליו דבר נוסף.