מה החיבור מאפשר לכם
חיבור חשבון ה-Cloudflare שלכם מאפשר לנו לפרסם אתרים סטטיים ב-Cloudflare Pages בחשבונכם, ולספק את ה-DNS ואת זיכרון המטמון של האתרים שלכם מתוכו. הכול מנוהל בלוח הבקרה של Cloudflare שלכם ובמסגרת התוכנית שלכם ב-Cloudflare.
לפני שמתחילים
חשבון Cloudflare, שבו הדומיינים שבהם ברצונכם להשתמש נוספו כאזורים (zones). התוכנית החינמית מספיקה לצורך החיבור; הפעולות שתוכלו לבצע בכל אזור תלויות במה שהתוכנית שלכם מאפשרת.
1. יצירת המפתח ב-Cloudflare
בלוח הבקרה של Cloudflare פתחו את My Profile ← API Tokens ובחרו ב-Create Token, ולאחר מכן ב-Create Custom Token. תנו לו שם, הוסיפו את ההרשאות המפורטות להלן, ותחת Zone Resources בחרו את האזורים שברצונכם לאפשר לנו לגשת אליהם — כל האזורים, או רק אלה שתציינו. בדקו את הפרטים ולחצו על 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 כולל את כל ההרשאות הקיימות בחשבונכם, בכל אזור, ולא ניתן להגביל אותו. השתמשו בטוקן אם באפשרותכם לעשות זאת.
2. התחברו כאן
פתחו את Integrations בלוח הבקרה שלכם ובחרו ב-Connect an account. בחרו ב-Cloudflare account (Pages, CDN & DNS) כקבוצה וב-Cloudflare כחשבון, הזינו את API token — או, עבור החלופה הישנה יותר, את API key ואת Account email, ולחצו על Connect account.
אנו בודקים את מה שהדבקתם לפני שדבר כלשהו נשמר. מפתח שאינו פועל לעולם לא יישמר, והתשובה שתתקבל תסביר מה הייתה הבעיה איתו. מפתח שפועל נשמר בצורה מוצפנת בכספת הסודות שלנו — לעולם לא במסד הנתונים שלנו — ואינו מוצג שוב לעולם, אפילו לא לכם.
מה קורה לאחר מכן
- Cloudflare Pages מופיע כיעד לפריסה בעת יצירה או העברה של אתר סטטי, ואנו מפרסמים את תוצר הבנייה לפרויקט Pages בחשבונכם.
- האזורים שלכם יכולים לספק את ה-DNS של הדומיין ואת זיכרון המטמון של האתר מתוך חשבון זה.
- אנו מוודאים שהטוקן יכול לקרוא את האזורים שלכם, לערוך DNS, לנקות את זיכרון המטמון ולשנות הגדרות אזור. רשימת הבדיקה לצד החיבור מציגה אילו מבין פעולות אלו הצלחנו לאמת.
אם ברצונכם להחזיק את ה-CDN ואת ה-DNS בחשבונות Cloudflare נפרדים, חברו אותם בנפרד כ-Cloudflare CDN וכ-Cloudflare DNS במקום זאת — לכל אחד מהם יש מדריך משלו.
אם החיבור אינו מצליח
הרשאה מסוימת מוצגת ככזו שלא אומתה. Cloudflare לא תמיד מאפשרת לטוקן לרשום את ההרשאות של עצמו, לכן חלקן מאומתות בפעם הראשונה שבה אנו משתמשים בהן. אם פעולה נכשלת בהמשך עקב שגיאת הרשאה, ערכו את הטוקן ב-My Profile ← API Tokens והוסיפו את ההרשאה החסרה — ערך הטוקן אינו משתנה, ולכן אין צורך לחבר אותו מחדש.
אזור חסר. ה-Zone Resources של הטוקן אינו כולל אותו. ערכו את הטוקן כדי לכלול את האזור הזה, או את כל האזורים.
מוצגת הודעה שהמפתח נדחה. כמעט תמיד מדובר באחד משלושה דברים: רווח או ירידת שורה שהועתקו יחד איתו, מפתח שתוקפו פג, או מפתח שבוטל או נוצר מחדש לאחר שהעתקתם אותו. צרו מפתח חדש והדביקו אותו שוב.
החיבור מצליח, אך משהו נכשל בהמשך. המפתח מבצע אימות בהצלחה אך חסרה לו הרשאה שהפעולה דורשת. צרו מפתח חדש עם ההרשאות המפורטות לעיל, ולאחר מכן נתקו את החיבור הישן וחברו את המפתח החדש.
ניתוק
פתחו את Integrations, מצאו את החשבון ולחצו על Disconnect. פעולה זו מוחקת את המפתח השמור באופן מיידי. כל מה שהשתמש בו יפסיק לפעול בפעולה הבאה שלו, והמסכים שהיו תלויים בו יציגו הודעה על כך במקום להיכשל בשקט.
הניתוק אינו מבטל את מה שכבר בוצע — רשומות, פריסות או הגדרות ששינינו בחשבונכם יישארו כפי שהם. אם יש לכם חשש שהמפתח עצמו דלף, בטלו אותו גם אצל הספק; הניתוק מסיר את העותק שלנו, לא את שלהם.