ממשקי API לניהול עבור ארגונים בתוכנית Enterprise.

במסמך העזרה הזה

ניתן להריץ עבודת ניהול באמצעות קוד במקום להגדיר הגדרות.

הערה: תכונה זו זמינה רק בתוכנית Enterprise, ורק בעלי הארגון יכולים להגדיר אותה.

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

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

מי יכול להשתמש בממשקי API של ניהול

הארגון שלכם צריך להיות בתוכנית Enterprise.
עליכם להיות בעל הארגון.
זה נבנה עבור צוותי ניהול, IT, אבטחה ותאימות. חברים ואורחים לא יבחינו בשינוי כלשהו בעבודתם היומיומית.

הגדרת חיבור ואסימון ניהול

לפתוח את מחליף סביבת העבודה ולבחור ב-ניהול הארגון.
יש לגשת ל-General ולאחר מכן לפתוח את Manage organization-level admin API tokens.
יש לבחור ב-יצירת חיבור.
יש לתת לחיבור שם שהצוות שלכם יזהה, כמו "אוטומציית תאימות", ולבחור רק את הגישה הדרושה לו. אם החיבור מופעל רק עבור ייצוא, אין להקצות לו גישה להחזקת מידע לצורך משפטי.
יש לבחור ב-Create token, ולאחר מכן להעתיק את האסימון ולשמור אותו במנהל הסודות שבו כבר משתמש הצוות.

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

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

יש לשמור על האסימונים שלכם בצורה מאובטחת.

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

צפו בפעילות ממשקי ה-API של הניהול ביומן הביקורת שלכם

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

פתרון בעיות

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

היכן למצוא פרטי נקודת קצה

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

שאלות נפוצות

האם זה זהה לאסימון חיבור של Notion API?

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

האם זה מחליף את הגדרות הארגון?

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

האם ניתן להגביל אסימון לכתובות IP מסוימות?

לא כרגע. הגבלות כתובת IP חלות על אנשים שנכנסים למערכת, לא על אסימוני מנהל מערכת.