نمای کلی
مدیران فضای کاری میتوانند با استفاده از کنترلهای SharePoint، مجموعهسایتهای تأییدشده را مجاز و مجموعهسایتهای منتخب را مسدود کنند، و فایلهای پشتیبانیشده با برچسبهای حساسیت منتخب Microsoft Purview را از نتایج حذف کنند.
یک مجموعهسایت SharePoint که SPSite نیز نامیده میشود، میتواند شامل چند سایت باشد. قاعدهٔ مجموعه بر کل مجموعه اعمال میشود و تابع مجوزهای فعلی مایکروسافت هر کاربر است. این قاعده به کاربر اجازهٔ دسترسی به محتوایی را نمیدهد که در Microsoft 365 به آن دسترسی ندارد.
محدودیتهای سایت بر عملیات پشتیبانیشدهٔ جستوجو، مرور، بازیابی فایل و خواندن/نوشتن در SharePoint اعمال میشوند. دسترسی به OneDrive جداگانه مدیریت میشود.
حالت دسترسی متناسب با خطمشی خود را انتخاب کنید:
سایتهای مجاز: اگر فهرست مجاز خالی نباشد، کاربران فقط میتوانند از طریق برنامه به مجموعهسایتهای موجود در فهرست دسترسی داشته باشند.
سایتهای مسدود: کاربران میتوانند با رعایت مجوزهای مایکروسافت خود، به مجموعهسایتهایی که در فهرست مسدود نیستند دسترسی داشته باشند.
در هر زمان فقط یکی از فهرستها میتواند حاوی موارد باشد. فهرست مجازِ خالی، همهٔ سایتها را مسدود نمیکند. وقتی هر دو فهرست خالی باشند، محدودیتهای سایت SharePoint برداشته میشوند؛ مجوزهای مایکروسافت و سایر کنترلهای تنظیمشده همچنان اعمال میشوند.
دسترسپذیری
کنترلها و API مدیریت فضای کاری باید برای فضای کاری شما فعال شده باشند. کنترلهای موجود شامل فهرست مجاز مجموعهسایتها، فهرست مسدود مجموعهسایتها، ورود سایتها از CSV و حذف از نتایج بر اساس برچسب حساسیت هستند.
قواعد بر کل مجموعهسایتها اعمال میشوند. تعیین دامنهٔ دقیق در سطح یک سایت، پوشه یا فایل مشخص و اعمال Microsoft Sites.Selected در این کنترلهای مجموعهسایت گنجانده نشدهاند.
پیش از شروع
مجموعهسایتهایی را که سازمان شما میخواهد مجاز یا مسدود کند، مشخص کنید.
GUID هر مجموعه را دریافت کنید. در شناسهٔ کامل سایت Microsoft Graph، مقدار میانی همان GUID مجموعه است. API مدیریت از GUID مجموعهها استفاده میکند؛ ابزار ورود CSV در رابط کاربری نیز میتواند آنها را از شناسههای سهجزئی سایت Graph استخراج کند.
مجوزهای مایکروسافت موردنیاز برنامهٔ SharePoint، از جمله
Sites.Read.AllوFiles.Read.All، را هم در تنظیمات مجوزهای ChatGPT و هم در Microsoft Entra فعال کنید. این کنترلها دسترسی را در سمت OpenAI فیلتر میکنند و جایگزین مجوزهای تفویضشدهٔ مایکروسافت نیستند.برای حذف از نتایج بر اساس برچسب حساسیت، GUID تغییرناپذیر هر برچسب بدون رمزگذاری را از مدیر Microsoft 365 یا Purview خود بخواهید.
برای مدیریت از طریق API، UUID فضای کاری و یک کلید مدیریت فضای کاری ChatGPT را دریافت کنید؛ اگر به تبدیل نشانیهای SharePoint به شناسه نیاز دارید، یک توکن Microsoft Graph نیز دریافت کنید. این دو اعتبارنامهٔ احراز هویت، کاربردهای متفاوتی دارند.
دربارهٔ راهنمای کاربردی OpenAI
راهنمای کاربردی OpenAI مجموعهٔ عمومی کدهای نمونه و راهنماهای OpenAI است. این مقاله از راهنمای دسترسی به سایت SharePoint و اسکریپت مدیریتی پایتون آن استفاده میکند که هر دو در GitHub میزبانی میشوند. برای خواندن فایلها میتوانید این پیوندها را در مرورگر خود باز کنید. برای اجرای اسکریپت، آن را دانلود کنید و دستورالعملهای راهاندازی و اجرای فرمانها را در راهنما دنبال کنید.
در سراسر این مقاله، «راهنمای کاربردی» به همان راهنمای SharePoint و «ابزار راهنمای کاربردی» به اسکریپت پایتونِ پیوندشده اشاره دارد. برای نمونهٔ فرمانها و مدیریت فهرست مجاز از طریق API، از این منابع استفاده کنید.
آمادهسازی اطلاعات احراز هویت برای مدیریت از طریق API
توجه: برای ایجاد کلیدهای مدیریت باید مدیر فضای کاری باشید. بیشتر بخوانید.
ایجاد کلید مدیریت فضای کاری ChatGPT
کنسول مدیریت ChatGPT را باز و فضای کاری موردنظر را انتخاب کنید.
به اطلاعات احراز هویت بروید و کلیدهای مدیریت را انتخاب کنید.
کلیدی با مجوزهای محدود ایجاد کنید و برنامهها را روی نوشتن تنظیم کنید.
کلید را در جای امن نگهداری کنید. این کلید اجازهٔ خواندن و تغییر خطمشی SharePoint فضای کاری شما را میدهد.
مجوز موردنیاز chatgpt.enterprise.apps.write است. توجه داشته باشید که کلید پلتفرم API و توکن Microsoft Graph نمیتوانند جایگزین کلید مدیریت فضای کاری ChatGPT شوند.
برای اطلاعات بیشتر، به مدیریت کلیدهای مدیریت در زبانهٔ اطلاعات احراز هویت مراجعه کنید. برای آشنایی با متغیرهای محیطی احراز هویت اسکریپت و نمونهٔ ورود امن اطلاعات، به دستورالعملهای احراز هویت در راهنمای کاربردی مراجعه کنید.
دریافت توکن Microsoft Graph
از فرایند احراز هویت مایکروسافت که سازمان شما تأیید کرده است استفاده کنید. برای جستوجوی تعاملی، اگر سازمان شما استفاده از Graph Explorer را مجاز میداند:
Microsoft Graph Explorer را باز کنید و با یک حساب کاری در مستأجری که سایتهای SharePoint در آن قرار دارند وارد شوید.
با استفاده از تغییر مجوزها یا رضایت به مجوزها، مجوزهای لازم برای خواندن سایتها را انتخاب کنید؛ معمولاً
Sites.Read.All. اگر سازمان شما تأیید دسترسی را الزامی میداند، از مدیر مایکروسافت خود بخواهید آن را تأیید کند.زبانهٔ توکن دسترسی را باز کنید و توکن را برای استفاده با Microsoft Graph کپی کنید.
برای دستورالعملهای مایکروسافت، به کار با Graph Explorer مراجعه کنید.
توکن Graph برای تبدیل نشانیهای SharePoint به شناسه به کار میرود. کلید مدیریت ChatGPT برای خواندن یا بهروزرسانی خطمشی ChatGPT به کار میرود. ابزار راهنمای کاربردی فقط برای فرمانهایی به توکن Graph نیاز دارد که نشانیها را به شناسه تبدیل میکنند؛ خواندن یا پاککردن فهرست مجاز موجود فقط به کلید مدیریت ChatGPT نیاز دارد.
هیچیک از این دو اعتبارنامه را در مخزن کد، اسناد مشترک، نماگرفتها یا گزارشهای ثبت رویداد قرار ندهید.
یافتن GUID مجموعهسایت
استفاده از نشانی سایت SharePoint
با حساب مایکروسافتی که به سایت SharePoint دسترسی دارد وارد شوید و سایت را باز کنید.
/_api/site/idرا به انتهای نشانی سایت اضافه کنید. برای مثال، ازhttps://contoso.sharepoint.com/sites/Finance/_api/site/idاستفاده کنید.GUID برگرداندهشده در پاسخ را کپی کنید.
توجه: دامنهها و شناسههای نمونه در این مقاله صرفاً برای مثال هستند.
استفاده از Microsoft Graph
Microsoft Graph یک شناسهٔ سایت با سه جزء جداشده با ویرگول برمیگرداند: نام میزبان، GUID مجموعهسایت و GUID سایت. برای قاعدهٔ مجموعهسایت، از مقدار میانی استفاده کنید. نشانیهای متفاوت سایت ممکن است به GUID یک مجموعهٔ واحد اشاره کنند.
برای نمونههای جستوجو و شناسه، به آشنایی با شناسههای سایت SharePoint مراجعه کنید. برای تبدیل چند نشانی به شناسه، بدون تغییر خطمشی ChatGPT، از دستورالعملهای بررسی در راهنمای کاربردی و اسکریپت مدیریتی پایتون استفاده کنید.
برای الزامات جستوجوی مایکروسافت، به دریافت سایت SharePoint از طریق مسیر مراجعه کنید.
مدیریت مجموعهسایتهای مجاز و مسدود
استفاده از کنترلهای فضای کاری
کنترلهای ایمنی و امنیت برنامهٔ SharePoint را در فضای کاری خود باز کنید.
در بخش حالت دسترسی، سایتهای مجاز یا سایتهای مسدود را انتخاب کنید.
مجموعهسایتها را به فهرست انتخابشده اضافه کنید. همچنین میتوانید از بارگذاری CSV که در ادامه توضیح داده شده است استفاده کنید.
تغییرات را مرور کنید و ذخیره را انتخاب کنید.
خطمشی ذخیرهشده را بررسی و تنظیمات خود را آزمایش کنید.
سایتهایی که از طریق API مدیریت اضافه میشوند، در کنترلهای فضای کاری ظاهر میشوند. سایتهایی که در رابط کاربری اضافه میشوند، از طریق API نیز در دسترس هستند. میتوانید از هر دو روش برای افزودن یا حذف موارد استفاده کنید؛ روش افزودن یک سایت، مدیریت آن را به همان روش محدود نمیکند.
جابهجایی بین سایتهای مجاز و مسدود
در هر زمان فقط یکی از فهرستها میتواند حاوی موارد باشد. پیش از افزودن موارد در حالت دیگر، فهرست فعلی را پاک و این تغییر را ذخیره کنید. سپس حالت دیگر را انتخاب کنید، مجموعههای موردنظر را اضافه کنید و دوباره ذخیره کنید.
پاککردن فهرست فعال، بهمحض ذخیرهشدن، دسترسی را تغییر میدهد. پاککردن فهرست مجاز، محدودیت دسترسی به سایتهای آن فهرست را برمیدارد؛ پاککردن فهرست مسدود، مسدودسازیهای آن را لغو میکند. این جابهجایی را با هماهنگی سایر مدیران برنامهریزی کنید؛ زیرا در فاصلهٔ بین پاککردن یک فهرست و ذخیرهکردن فهرست دیگر، ممکن است دسترسیهایی مجاز شود که خطمشی نهایی شما آنها را محدود میکند.
بارگذاری مجموعهسایتها از CSV
بارگذاری CSV فقط از مجموعهسایتها پشتیبانی میکند. برای حذف فایلها از نتایج بر اساس برچسب حساسیت، GUID برچسبها را در بخش برچسبهای حساسیت بدون رمزگذاری برای حذف از نتایج اضافه کنید.
کنترلهای ایمنی و امنیت را باز و حالت دسترسی موردنظر را انتخاب کنید.
یک فایل CSV از GUID مجموعهسایتها یا شناسههای سهجزئی سایت در Microsoft Graph تهیه کنید. در سراسر فایل از یک قالب شناسه استفاده کنید.
بارگذاری فایل CSV را انتخاب و فایل را مشخص کنید.
نتیجهٔ ورود دادهها و فهرست انتخابشده را بررسی کنید. پیش از ادامه، خطاها یا هشدارهای مربوط به ردیفها را برطرف کنید.
برای اعمال تغییرات، ذخیره را انتخاب کنید؛ سپس فهرست ذخیرهشده را بررسی کنید.
الزامات CSV و نحوهٔ پردازش آن:
حداکثر اندازهٔ فایل: ۱ مگابایت.
سرستونها اختیاری هستند.
در هر ردیف یک GUID مجموعه یا یک شناسهٔ سهجزئی سایت Graph قرار دهید. شناسههای سهجزئی را میتوان داخل علامت نقلقول در یک فیلد قرار داد یا بین سه ستون تقسیم کرد.
شناسههای سهجزئی Graph به GUID مجموعه تبدیل میشوند. واردکردن یک شناسهٔ سهجزئی، قاعدهای مختص یک سایت مشخص ایجاد نمیکند.
ورود دادهها، موارد جدید را به فهرست انتخابشده اضافه میکند و موارد موجود را حفظ میکند. موارد تکراری مجموعهها حذف میشوند؛ شمارشِ ورود دادهها، تعداد مجموعههای تازه اضافهشده را نشان میدهد.
قالبهای ترکیبی و ردیفهایی با ساختار نادرست رد میشوند. اگر فایل بارگذاریشده فقط حاوی نشانی سایتها باشد، هشداری نمایش داده میشود و هیچ سایتی اضافه نمیشود. ابتدا نشانیها را به GUID مجموعه تبدیل کنید.
بارگذاری فقط پیشنویس فهرست را تغییر میدهد. تا زمانی که ذخیره را انتخاب نکنید، دسترسی فضای کاری بهروز نمیشود.
بارگذاری CSV که در اینجا توضیح داده شده، برای مدیریت مجموعهسایتهاست. حذف از نتایج بر اساس برچسب حساسیت را جداگانه تنظیم کنید.
اگر یک فایل CSV از نشانیهای SharePoint دارید، روند کار با CSV در ابزار راهنمای کاربردی میتواند آنها را به شناسه تبدیل کند و فهرست مجاز را از طریق API مدیریت کند. ورودی site_url یا url این ابزار، قالب و روند کاری متفاوتی با بارگذاری شناسهها در رابط کاربری دارد.
آشنایی با سقف خطمشی و درخواستها
سقف پیشفرض خطمشی ۱۰٬۰۰۰ مجموعهسایت است. سقفهای بالاتر خطمشی فضای کاری، تا ۱۲۰٬۰۰۰ مجموعهسایت، باید توسط OpenAI فعال شوند؛ پیش از برنامهریزی برای استقرار در مقیاس بزرگتر، با تیم OpenAI خود تماس بگیرید.
هر عملیات تغییردهندهٔ API و اسکریپت فعلی راهنمای کاربردی، حداکثر ۱۰٬۰۰۰ GUID مجموعه در هر درخواست میپذیرند. افزایش سقف خطمشی فضای کاری، این سقفِ هر درخواست را افزایش نمیدهد. مجموعهسایتهای یکتا را بشمارید، نه نشانیهای مبدأ را؛ چند نشانی ممکن است به یک مجموعه اشاره کنند.
استفاده از API مدیریت فضای کاری
از UUID فضای کاری و کلید مدیریت فضای کاری ChatGPT خود با https://api.chatgpt.com استفاده کنید.
برای فرمانهای بهروز فهرست مجاز و نمونههای درخواست، از راهنمای کاربردی استفاده کنید:
پیشنمایش و افزودن مجموعهسایتها. افزودن موارد جدید، مجموعههای مجاز موجود را حفظ میکند.
پیش از اعمال تغییرات، خطمشی فعلی را بررسی کنید؛ سپس آن را دوباره بخوانید و دسترسی حاصل را آزمایش کنید. حذف آخرین مجموعهٔ مجاز یا پاککردن فهرست مجاز، این محدودیت دسترسی به سایتها را برمیدارد. درخواست افزودنِ خالی ارسال نکنید، مگر اینکه قصد برداشتن محدودیتهای فهرست مجاز را داشته باشید.
ابزار عمومی راهنمای کاربردی در حال حاضر فقط فهرستهای مجاز را مدیریت میکند. این ابزار فهرستهای مسدود یا حذف از نتایج بر اساس برچسب حساسیت را مدیریت نمیکند. برای این کارها از کنترلهای فضای کاری که در بالا توضیح داده شد استفاده کنید.
حذف فایلها از نتایج بر اساس برچسب حساسیت
یافتن GUID برچسب
GUID تغییرناپذیر برچسب موردنظر را از مدیر Microsoft 365 یا Purview خود بخواهید. از GUID استفاده کنید، نه نام نمایشی برچسب.
مدیر میتواند فهرست برچسبها را از طریق Microsoft Graph دریافت کند. توکن، بسته به مورد، به مجوز SensitivityLabel.Read یا SensitivityLabels.Read.All نیاز دارد. نام برچسب موردنظر را با شناسهٔ آن تطبیق دهید و تنظیمات محافظت آن را بررسی کنید.
برای الزامات و نمونهها، به فهرستکردن برچسبهای حساسیت و ویژگیهای برچسب حساسیت مراجعه کنید. این مجوزهای برچسب، جدا از مجوز خواندن سایت هستند که برای تبدیل نشانیهای SharePoint به شناسه استفاده میشود.
افزودن برچسبها برای حذف از نتایج
کنترلهای ایمنی و امنیت برنامهٔ SharePoint را باز کنید.
GUID هر برچسب بدون رمزگذاری را در بخش برچسبهای حساسیت بدون رمزگذاری برای حذف از نتایج وارد کنید.
تنظیمات را ذخیره کنید و یک فایل پشتیبانیشده با برچسب تعیینشده برای حذف از نتایج را آزمایش کنید.
فایلهایی که برچسبهای پشتیبانیشدهٔ آنها با این فهرست مطابقت دارد، از نتایج برنامهٔ SharePoint حذف میشوند. فایلهای دارای برچسبهایی که رمزگذاری را اعمال میکنند، از قبل بهطور پیشفرض از نتایج حذف میشوند.
آزمایش تنظیمات
از فایلها و حسابهای آزمایشی تأییدشدهٔ سازمان خود استفاده کنید. پیش از آزمایش، مطمئن شوید همان حساب مایکروسافت میتواند مستقیماً در SharePoint به هر فایل دسترسی داشته باشد.
در حالت سایتهای مجاز با فهرستی غیرخالی، یک فایل در مجموعهای مجاز و یک فایل در مجموعهای خارج از فهرست را بررسی کنید. فقط مجموعهٔ مجاز باید از طریق برنامه در دسترس باشد.
در حالت سایتهای مسدود، یک فایل در مجموعهای مسدود و یک فایل در مجموعهای مسدودنشده را بررسی کنید. مجموعهٔ مسدود باید خارج از دسترس باشد؛ دسترسی به مجموعهٔ مسدودنشده همچنان تابع مجوزهای مایکروسافت و سایر کنترلهاست.
یک فایل آزمایشی پشتیبانیشده را که برچسب حساسیت آن برای حذف از نتایج تعیین شده است، بررسی کنید. این فایل نباید در نتایج برنامه ظاهر شود.
پس از تغییر از طریق API، فهرست ذخیرهشده در رابط کاربری را با خطمشی برگرداندهشده از API مقایسه کنید.
پس از بارگذاری CSV، تغییرات را ذخیره کنید و کنترلها را دوباره باز کنید تا مطمئن شوید مجموعههای موردنظر حفظ شدهاند.
اگر نتایج با خطمشی موردنظر متفاوت بود، فضای کاری، حالت دسترسی انتخابشده، فهرست ذخیرهشده، GUID مجموعهها، GUID برچسبها، نوع فایل پشتیبانیشده و مجوزهای مایکروسافت کاربر را بررسی کنید. برای عیبیابی، فهرست را پاک نکنید، مگر اینکه تغییر دسترسی ناشی از آن را در نظر داشته باشید.
برای دریافت راهنمایی دربارهٔ کنترلهای در دسترسنبوده یا دسترسی غیرمنتظره، به تماس با پشتیبانی OpenAI مراجعه کنید. کلیدهای مدیریت یا توکنهای Microsoft Graph را در درخواست پشتیبانی خود درج نکنید.
آشنایی با محدودیتها
قاعدهٔ مجموعه، کل مجموعهسایت را پوشش میدهد. این قاعده نمیتواند دسترسی را به یک زیرسایت، پوشه یا فایل خاص محدود کند.
محدودیتهای سایت SharePoint بهطور خودکار دسترسی به OneDrive را محدود نمیکنند.
فیلترکردن بر اساس برچسب حساسیت فقط در مواردی اعمال میشود که Microsoft Graph فرادادهٔ برچسبهای پشتیبانیشده را ارائه میکند؛ از جمله اسناد Office و فایلهای PDF و MP4 پشتیبانیشده.
انواع فایلی که از برچسب حساسیت پشتیبانی نمیکنند، مانند فایلهای TXT و CSV، بدون برچسب محسوب میشوند. اگر دسترسی به آنها از جهات دیگر مجاز باشد، همچنان در دسترس میمانند. این محدودیتِ نوع فایل، ارتباطی با بارگذاری CSV برای تنظیم دسترسی به سایت ندارد.
بارگذاری CSV و ابزار نمونهٔ عمومی، حذف از نتایج بر اساس برچسب حساسیت را تنظیم نمیکنند. این مقاله مستندات API مدیریت انبوه برچسبها را ارائه نمیکند.
ذخیرهشدن خطمشی یا دریافت پاسخ موفق از API، جای آزمایش دسترسی با حساب موردنظر را نمیگیرد.
استفاده از ابزار مدیریتی پایتون
کد نمونه و فرمانهای کامل در راهنمای کاربردی OpenAI نگهداری و بهروز میشوند:
از پایتون نسخهٔ ۳٫۱۰ یا بالاتر استفاده کنید. این ابزار از کتابخانهٔ استاندارد پایتون استفاده میکند. پیش از اجرای ابزار، راهنما را بخوانید و برای بررسی تغییرات از اجرای آزمایشی بدون اعمال تغییر استفاده کنید.
نسخهٔ فعلی ابزار، اطلاعات احراز هویت را از متغیرهای محیطی میخواند؛ از دستورالعملهای راهنما برای ورود امن این اطلاعات استفاده کنید. پاککردن فهرست مجاز به تأیید صریح نیاز دارد. عملیات حذف ممکن است بدون این تأیید اجرا شود؛ بنابراین ابتدا آن را با اجرای آزمایشی بدون اعمال تغییر بررسی کنید.
برای آشنایی با رفتار تلاش مجدد و کلیدهای اختیاری همتوانی، به تلاش مجدد ایمن برای بهروزرسانی خطمشی مراجعه کنید. فقط زمانی از کلیدهای همتوانی استفاده کنید که فضای کاری از آنها پشتیبانی میکند، و پس از خطایی با نتیجهٔ نامشخص، خطمشی فعلی را بررسی کنید.
این ابزار قابلیتهای فضای کاری را فعال نمیکند و اجرای محدودیتها را نیز تأیید نمیکند. آزمونهای آفلاین آن از فراخوانیهای شبیهسازیشدهٔ Microsoft Graph و API مدیریت ChatGPT استفاده میکنند.
تغییراتی که در چند درخواست انجام میشوند، اتمی نیستند. اگر حذف چند مجموعه در میانهٔ راه با خطا مواجه شود، ممکن است حذفهای قبلی با موفقیت انجام شده باشند. پیش از تلاش مجدد، خطمشی فعلی را بخوانید.
پرسشهای متداول
آیا کنترلهای سایت جایگزین مجوزهای مایکروسافت میشوند؟
خیر. برنامه همچنان از مجوزهای مایکروسافت هر کاربر استفاده میکند. OpenAI پیش از نمایش پاسخها به کاربر و مدل، فیلترهای تنظیمشدهٔ سایت را اعمال میکند.
آیا فهرست مجازِ خالی همهٔ سایتها را مسدود میکند؟
خیر. فهرست مجازِ خالی به معنی «مسدودکردن همه» نیست. اگر فهرست مسدود حاوی مواردی باشد، آن مجموعهها همچنان مسدود میمانند. وقتی هر دو فهرست خالی باشند، مجوزهای مایکروسافت کاربران و سایر کنترلهای تنظیمشده، دسترسی را تعیین میکنند.
آیا تغییرات API مدیریت ثبت میشوند؟
تغییرات خطمشی از طریق API مدیریت، در گزارشهای ممیزی و انطباق فضای کاری ثبت میشوند.
