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

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

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

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

חשוב לוודא שהשלמתם את המשימות הבסיסיות של הגדרת App Hosting, כדי שיהיה לכם אתר Firebase App Hosting בפרויקט Firebase.

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

  1. פותחים את הדף App Hosting של הפרויקט.
  2. בוחרים קצה עורפי של App Hosting באמצעות האפשרות View Dashboard.
  3. בוחרים בכרטיסייה הגדרות ולאחר מכן לוחצים על הוספת דומיין מותאם אישית.
  4. מזינים את שם הדומיין המותאם אישית שרוצים לקשר לאתר App Hosting.
  5. (אופציונלי) מסמנים את התיבה כדי להפנות את כל הבקשות בדומיין בהתאמה אישית לדומיין שני שצוין (כך ש-example.com ו-www.example.com מפנים לאותו תוכן).
  6. לוחצים על המשך כדי להגדיר את רשומות ה-DNS ולהשלים את ההגדרה של הדומיין המותאם אישית.

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

  1. במסוף Firebase, באשף Add Custom Domain יוצגו הרשומות הנדרשות שצריך לעדכן כדי להפנות את הדף ל-Firebase App Hosting. מוסיפים, מסירים ושומרים רשומות מהדומיין שלכם אצל ספק ה-DNS באמצעות הקלטות הבאות:

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

    • Value: הקצאת הערך שסופק לרשומות. ספק הדומיין עשוי לרשום את המונח הזה כ'נתונים', 'מפנה אל', 'תוכן', 'כתובת' או 'כתובת IP'. התוכן בשדה הערך משתנה לפי סוג הרשומה. רשומות A ו-AAAA כוללות כתובות IP כערכים, ורשומות TXT הן מחרוזות.

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

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

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

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

הערה: Firebase App Hosting מקצה מחדש באופן אוטומטי אישורי SSL, לפי הצורך, לדומיינים מותאמים אישית.

סוגי רשומות DNS

יכול להיות שמדריך הדומיין המותאם אישית App Hosting יבקש מכם להוסיף 1 עד 5 רשומות DNS, בהתאם להגדרה הנוכחית של הדומיין. הסוג של הרשומה קובע את הפונקציה שלה. אלה סוגי הרשומות ש-App Hosting עשוי לבקש:

סוג תיאור בלעדי
A הרשומות האלה מכילות ערכים של IPv4 (למשל 8.8.8.8), שמספרים לדפדפנים באיזו כתובת להשתמש כשהם מנסים ליצור קשר עם הדומיין שלכם. כן
AAAA הרשומות האלה מכילות ערכים של IPv6 (למשל 2001:4860:4860::8888), סוג אחר של רשומת כתובת עם פונקציה דומה לזו של רשומות A. App Hosting לא משתמש כרגע ברשומות AAAA, אבל תתבקשו להסיר את הרשומות הקיימות מהדומיין שלנו, אם הן קיימות. כן
CNAME הרשומות האלה מכילות שם דומיין נפרד שצריך להשתמש בו במקום הדומיין הנוכחי כדי לפתור שאילתות DNS. מותר להשתמש ברשומות CNAME רק בתת-דומיינים (למשל www.example.com). App Hosting משתמש ברשומות CNAME משתי סיבות:
  • התחלה קלה: כשהדבר אפשרי, App Hosting מבקשת ליצור רשומת CNAME לדומיין שהוגדר מראש ומתחיל ב-_custom-domain....
  • אימות אישורי SSL: App Hosting משתמש ב-Cloud Certificate Manager כדי להקצות אישורי SSL לדומיין המותאם אישית. רשומת CNAME בתת-דומיין _acme-challenge... מאפשרת למנהל האישורים ליצור ולחדש אישורים עבורך. אחרי תחילת השימוש, אין להסיר את הרשומה, אחרת הכיסוי של האישורים יפוג.
כן
TXT הרשומות האלה מאפשרות לצרף מטא-נתונים שרירותיים לדומיין. App Hosting מאפשר להשתמש בפורמט ספציפי של רשומת TXT, fah-claim=[UUID], כדי לציין איזה דומיין מותאם אישית צריך להציג בדומיין שלכם. לא
CAA הרשומות האלה משמשות כרשימה לבדיקת הרשאות (whitelist) לציון רשויות אישורים מורשות להנפקת אישורי SSL לדומיין שלכם. הבקשה של App Hosting לרשומות CAA נשלחת רק אם הדומיין חסום מסיבה אחרת להנפקת אישורים לדומיין שלך. לא

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בהמתנה

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

לפעמים, רשומות CAA מגבילות מדי יכולות לעכב את הנפקת אישור ה-SSL לדומיין בהתאמה אישית. מוודאים שרשויות האישורים ‎letsencrypt.org ו-‎pki.goog מורשות ליצור אישורי SSL לדומיין שלכם.

אישור על הנפקה

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

מחובר

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