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

כשמשתמשים ב-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: הגדרת דומיין מותאם אישית

אם מוצגת בקשה באשף ההגדרה Connect Domain, מאמתים את הדומיין ברמה העליונה.

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

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

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

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

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

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

    • מארח: מזינים את מפתח הדומיין ברמה העליונה.

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

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

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

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

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

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

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

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

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

    אם לוחצים על Verify (אימות) ומופיעה הודעת שגיאה, המשמעות היא שהרשומות לא הופצו או שהערכים שגויים.

במסוף Firebase, באשף Add Custom Domain בוחרים באפשרות Quick Setup או באפשרות Advanced Setup.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

לפעמים הבעיות הבאות עלולות לעכב את הנפקת אישור ה-SSL לדומיין מותאם אישית:

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

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

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