קישור דומיין מותאם אישית

כשמשתמשים ב-Firebase Hosting, אין צורך לוותר על שמות הדומיינים הייחודיים שמתמקדים במותג. אפשר להשתמש בדומיין מותאם אישית (כמו example.com או app.example.com) במקום דומיין שנוצר ב-Firebase עבור אתר שמתארח ב-Firebase.

Firebase Hosting מקצה אישור SSL לכל אחד מהדומיינים שלך ומציגה את התוכן שלכם דרך CDN גלובלי.

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

הגדרת הדומיין שלך עבור Hosting

עליך לוודא שהשלמת את השלבים בקטע 'תחילת העבודה' מהפרויקט דף אחד (Firebase Hosting) שיהיה לכם אתר Firebase Hosting בפרויקט Firebase.

שלב 1: הוספת דומיין מותאם אישית

  1. בדף Hosting של הפרויקט, נכנסים לאשף לקישור דומיין בהתאמה אישית:

    • אם יש לכם רק אתר אחד ב-Hosting, לוחצים על Add custom domain (הוספת דומיין מותאם אישית).
    • אם יש לכם יותר מאתר Hosting אחד, לוחצים על View (הצגה) ליד האתר הרצוי ואז על Add custom domain (הוספת דומיין מותאם אישית).

  2. עליך להזין את שם הדומיין המותאם אישית שברצונך לקשר אל Hosting .

  3. (אופציונלי) מסמנים את התיבה כדי להפנות את כל הבקשות בדומיין בהתאמה אישית לדומיין שני שצוין (כך ש-example.com ו-www.example.com מפנים לאותו תוכן).

  4. לוחצים על המשך כדי להגדיר את רשומות ה-DNS ולסיים את הגדרת הדומיין המותאם אישית.

שלב 2: הגדרת דומיין בהתאמה אישית

אם מתבקשים לעשות זאת באשף ההגדרה קישור דומיין, לאמת את דומיין ה-apex שלך.

השלבים האלה מוודאים שהדומיין שלכם לא מקושר כבר עם לפרויקט Firebase ואתם הבעלים של הדומיין שצוין.

  1. באתר של ספק הדומיין, מאתרים את הדף של ניהול ה-DNS.

  2. מוסיפים ושומרים רשומה חדשה עם פרטי הקלט הבאים:

    • סוג: מוסיפים רשומת TXT.

      כדי להוכיח את הבעלות שלכם על הדומיין ולתת ל-Firebase הרשאה להקצות ולחדש אישורי SSL לאתר, Firebase Hosting מחייב אתכם להשאיר את רשומת ה-TXT הזו כל הזמן בהגדרות ה-DNS.

      יכול להיות שספק הדומיין יציג את המונח הזה בתור 'סוג רשומה'.

    • מארח: מזינים את מפתח דומיין apex.

      הוכחת הבעלות על דומיין apex, או על הדומיין הבסיסי (root), מוכיחה על כל תת-הדומיינים שלו.

      ספק הדומיין עשוי לרשום את המונח הזה בתור 'שם מארח', 'שם' או 'דומיין'.

    • ערך: מעתיקים את ערך האימות הייחודי לשדה.

      Firebase Hosting בודק את הערך הזה כדי להוכיח את הבעלות שלך על הדומיין.

      ספק הדומיין עשוי לכלול את המונח הזה כ"נתונים".

  3. צריך להמתין עד 24 שעות עד להפצה של רשומות ה-TXT המעודכנות, ואז ללחוץ על אימות.

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

    לאחר פרק זמן מספיק להפצה, אפשר ללחוץ על Verify בחלון Connect Domain במסוף Firebase כדי להתחיל בתהליך הקצאת אישור ה-SSL.

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

    אם לחיצה על אימות מציגה הודעת שגיאה, סימן שהרשומות לא מופץ, אחרת הערכים יהיו שגויים.

באשף Add Custom Domain (הוספת דומיין מותאם אישית) במסוף Firebase, בוחרים באפשרות Quick הגדרה או הגדרה מתקדמת.

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

אשף ההגדרה המתקדמת יעזור לך ליצור אישור SSL. הצהרת בעלות על מנת לאפשר ל-Hosting להציג תנועה בדומיין לפני מקבלים תנועה.

המתנה להקצאת אישור ה-SSL

אחרי שנאמת את הבעלות על הדומיין, נקצה אישור SSL ולפרוס אותו ברשת ה-CDN הגלובלית שלנו תוך 24 שעות לאחר שהפנייה רשומות DNS A ל-Firebase Hosting.

הדומיין שלכם יופיע כאחד מ-Subject Alternative Names‏ (SAN) באישור ה-SSL של FirebaseApp. אפשר להציג את האישור הזה דרך וכלי אבטחה חדשים. בזמן ההקצאה של הדומיין, יכול להיות שיוצג אישור לא חוקי שלא כולל את שם הדומיין. זהו חלק רגיל בתהליך, והבעיה תיפתר אחרי שהאישור של הדומיין יהיה זמין.

משתמשים עם הגדרה מתקדמת: האתר שלכם יאוחסן על ידי ספק האירוח הקודם עד שסטטוס ההגדרה בדף Firebase Hosting של הפרויקט יתעדכן ל-מחובר.

מפתח הדומיין המותאם אישית שלך

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

סוג הדומיין מפתח דומיין מותאם אישית
דומיין פסגה

דוגמאות לקלט נפוץ:

  • @
  • שם הדומיין של apex (לדוגמה, example.com)
  • משאירים את השדה Host ריק
תת-דומיין

דוגמאות קלט נפוצות:

  • שם תת-הדומיין המלא (לדוגמה, app.example.com)
  • רק החלק של תת-הדומיין (לדוגמה, app בלבד, בלי .example.com)
  • רק www לתת-הדומיין של www.example.com

ספקי דומיינים נפוצים

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

הגדרת תיאורי סטטוסים לדומיינים מותאמים אישית

סטטוס תיאור
נדרשת הגדרה

ייתכן שתצטרכו לשנות הגדרות אישיות ברשומות ה-DNS שלכם.

  • ברוב המקרים, רשומות DNS A שלך לא הופצו מספק שם הדומיין שלך לשרתים של Firebase Hosting.
    טיפ לפתרון בעיות: אם חלפו יותר מ-24 שעות, כדאי לבדוק שהפנית את הרשומות שלך אל Firebase Hosting.

  • במקרים נדירים יותר, במיוחד אם אתם משתמשים בתהליך ההגדרה המתקדמת, יכול להיות שהאתגרים של SSL נכשלים כי:

    • האתגרים של אישור ה-SSL נכשלו והאסימון (רשומות TXT של DNS או הקובץ שהועלו לאתר) לא חוקי עכשיו.
      טיפ לפתרון בעיות: לוחצים על הצגה לצד הדומיין. לאחר מכן מספקים את האסימון החדש לדומיין הקיים.
בהמתנה

הגדרת נכון את הדומיין המותאם אישית שלך, אבל Firebase Hosting לא הקצה אישור SSL.

מדי פעם, הבעיות הבאות עלולות לעכב את ההטבעה של SSL אישור של דומיין מותאם אישית:

  • רשומות ה-CAA שלך מגבילות מדי.
    טיפ לפתרון בעיות: עליך לוודא שרשויות האישורים ממשקי 'letsencrypt.org' ו-'pki.goog' מורשים ליצור אישורי SSL עבור הדומיין שלך.
  • קוד האתגר לא תקף.
    אם אתם משתמשים בתהליך ההגדרה המתקדם וההעברה נכשלה, האסימון (וגם קוד האתגר שלו) לא תקפים עכשיו.
    טיפ לפתרון בעיות: לוחצים על הצגה לצד הדומיין. לאחר מכן מספקים את האסימון החדש לדומיין הקיים.
  • ביקשת אישורים ליותר מדי תת-דומיינים.
    טיפ לפתרון בעיות: באופן כללי, מומלץ לא ליצור יותר מ-20 תת-דומיינים בדומיין מותאם אישית אחד ברמה העליונה, בגלל המגבלות על הנפקת אישורי SSL.
אישור הנפקת תעודות

מתבצע יצירת אישור SSL לדומיין שלכם.
מחובר

לדומיין המותאם אישית שלך יש רשומות DNS מתאימות וגם SSL אישור.
אתם יכולים להציג את התוכן של האתר.