اتصال آن چه کمکی به شما میکند
اتصال حساب Cloudflare شما به ما امکان میدهد سایتهای ایستا را در Cloudflare Pages در حساب خودتان منتشر کنیم، و DNS و حافظهٔ پنهان (Cache) سایتهای شما را از طریق آن ارائه دهیم. همهچیز در داشبورد Cloudflare خودتان و در پلن Cloudflare خودتان باقی میماند.
پیش از شروع
یک حساب Cloudflare، همراه با دامنههایی که میخواهید استفاده کنید و بهصورت zone به آن اضافه شدهاند. پلن رایگان برای اتصال کافی است؛ اقداماتی که میتوانید در هر zone انجام دهید به مواردی بستگی دارد که پلن شما اجازه میدهد.
۱. ایجاد کلید در Cloudflare
در داشبورد Cloudflare، بخش My Profile ← API Tokens را باز کنید و Create Token و سپس Create Custom Token را انتخاب نمایید. نامی برای آن تعیین کنید، مجوزهای زیر را اضافه کنید، و در بخش Zone Resources ناحیههایی (zones) را که میخواهید به آنها دسترسی داشته باشیم انتخاب نمایید — همهٔ zoneها یا فقط مواردی که مشخص میکنید. آن را بررسی کنید و Create Token را فشار دهید. Cloudflare توکن را فقط یک بار نمایش میدهد؛ آن را در همان لحظه کپی کنید.
این مجوزها را اضافه کنید:
- Zone ← Zone ← Read
- Zone ← DNS ← Edit
- Zone ← Cache Purge ← Purge
- Zone ← Zone Settings ← Edit
- Account ← Cloudflare Pages ← Edit — فقط در صورتی که میخواهید سایتها را در Pages منتشر کنیم. توکن بدون این مورد نیز همچنان متصل میشود و برای DNS و حافظهٔ پنهان کار میکند.
جایگزین قدیمیتر. بهجای توکن، میتوانید با Global API Key خود و آدرس ایمیلی که با آن وارد میشوید (My Profile ← API Tokens ← API Keys ← Global API Key ← View) متصل شوید. Cloudflare این روش را توصیه نمیکند: Global API Key شامل تمام مجوزهایی است که حساب کاربری شما دارد، روی تمام zoneها اعمال میشود، و امکان محدود کردن آن وجود ندارد. در صورت امکان از توکن استفاده کنید.
۲. اتصال آن در اینجا
بخش Integrations را در داشبورد خود باز کنید و Connect an account را انتخاب نمایید. Cloudflare account (Pages, CDN & DNS) را بهعنوان گروه و Cloudflare را بهعنوان حساب انتخاب کنید، API token — یا برای جایگزین قدیمیتر، API key و Account email — را وارد کنید، و Connect account را فشار دهید.
ما پیش از ذخیره شدن هر چیزی، آنچه را جایگذاری کردهاید آزمایش میکنیم. کلیدی که کار نمیکند هرگز ذخیره نمیشود، و پاسخ دریافتی نشان میدهد که چه مشکلی داشته است. کلیدی که کار میکند بهصورت رمزگذاریشده در مخزن امن (secrets vault) ما نگهداری میشود — هرگز در پایگاه دادهٔ ما ذخیره نمیشود — و هرگز دوباره، حتی به شما، نمایش داده نخواهد شد.
در ادامه چه اتفاقی میافتد
- هنگامی که یک سایت ایستا را ایجاد یا منتقل میکنید، Cloudflare Pages بهعنوان یک مقصد استقرار (deploy target) ظاهر میشود و ما نسخهٔ نهایی (build) را در یک پروژهٔ Pages در حساب شما منتشر میکنیم.
- zoneهای شما میتوانند DNS یک دامنه و حافظهٔ پنهان یک سایت را از این حساب ارائه دهند.
- ما بررسی میکنیم که توکن بتواند zoneهای شما را بخواند، DNS را ویرایش کند، حافظهٔ پنهان را پاکسازی نماید و تنظیمات zone را تغییر دهد. چکلیست کنار اتصال نشان میدهد که کدامیک از این موارد را توانستهایم تأیید کنیم.
اگر میخواهید CDN و DNS را در حسابهای متفاوتی از Cloudflare نگه دارید، آنها را بهصورت جداگانه بهعنوان Cloudflare CDN و Cloudflare DNS متصل کنید — هرکدام راهنمای خاص خود را دارند.
در صورت متصل نشدن
مجوزی بهصورت تأییدنشده نمایش داده میشود. Cloudflare همیشه به توکن اجازه نمیدهد که فهرست مجوزهای خود را مشاهده کند، بنابراین برخی از آنها در اولین باری که از آنها استفاده میکنیم تأیید میشوند. اگر عملیاتی بعداً با خطای مجوز مواجه شد، توکن را در My Profile ← API Tokens ویرایش کنید و مجوز مفقود را اضافه نمایید — مقدار توکن تغییر نمیکند، بنابراین نیازی به اتصال مجدد چیزی نیست.
یک zone مفقود است. بخش Zone Resources در توکن شامل آن نمیشود. توکن را ویرایش کنید تا آن zone یا همهٔ zoneها را در بر بگیرد.
پیام رد شدن کلید نمایش داده میشود. تقریباً همیشه یکی از این سه مورد است: یک فاصله یا شکست خط که همراه با آن کپی شده، کلیدی که منقضی شده، یا کلیدی که پس از کپی کردن باطل شده یا مجدداً تولید شده است. یک کلید جدید بسازید و آن را دوباره جایگذاری کنید.
متصل میشود، اما بعداً عملیاتی ناموفق میماند. کلید احراز هویت میشود اما فاقد مجوزی است که آن عملیات نیاز دارد. یک کلید جدید با مجوزهای ذکرشده در بالا ایجاد کنید، سپس اتصال قدیمی را قطع نموده و کلید جدید را متصل کنید.
قطع اتصال
بخش Integrations را باز کنید، حساب را پیدا کرده و Disconnect را فشار دهید. این کار کلید ذخیرهشده را فوراً حذف میکند. هر چیزی که از آن استفاده میکرده در اقدام بعدی خود متوقف میشود، و صفحاتی که به آن وابسته بودند بهجای شکست بیصدا، این موضوع را اعلام میکنند.
قطع اتصال کارهایی را که قبلاً انجام شده است لغو نمیکند — رکوردها، استقرارها یا تنظیماتی که در حساب شما تغییر دادهایم به همان شکلی که هستند باقی میمانند. اگر فکر میکنید خود کلید ممکن است لو رفته باشد، آن را در ارائهدهنده نیز باطل کنید؛ قطع اتصال فقط نسخهٔ موجود نزد ما را حذف میکند، نه نسخهٔ آنها را.