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

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

בהמשך המסמך מוסבר איך לקשר דומיין בהתאמה אישית באחת מהדרכים הבאות:

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

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

לפני שמתחילים: סוגי רשומות 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... מאפשרת ל-Certificate Manager ליצור אישורים ולחדש אותם בשבילכם. אחרי ההצטרפות, אסור להסיר את הרשומה הזו, אחרת הכיסוי של האישור יפוג.
כן
TXT הרשומות האלה מאפשרות לצרף מטא-נתונים שרירותיים לדומיין. App Hosting מאפשר להשתמש בפורמט ספציפי של רשומת TXT, fah-claim=[UUID], כדי לציין איזה דומיין מותאם אישית צריך להציג בדומיין שלכם. לא
CAA הרשומות האלה משמשות כרשימה לבדיקת הרשאות כדי לציין רשויות אישורים מורשות להנפקת אישורי SSL לדומיין שלכם. App Hosting מבקש רשומות CAA רק אם הוא חסום אחרת משימוש בשירותי הנפקת האישורים לדומיין שלכם. לא

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

כשאתם מוסיפים או עורכים רשומות DNS, ספקי דומיינים שונים מצפים שתזינו נתונים שונים בשדה מארח (או שם מארח) באתרים שלהם לניהול DNS. בשלב 'הדרכת הדומיין המותאם אישית' של App Hosting, צריך להזין את אותו ערך בשדה Name.

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

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

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

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

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

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

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

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

מארח קלט
example.com. @
www.example.com. www
מארח קלט
example.com. ‎.example.com.
www.example.com. www‎.example.com.
מארח קלט
example.com. @
www.example.com. www
מארח קלט
example.com. @
www.example.com. www

העברת דומיין

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

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

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

שלב 2: הכנת הדומיין

  1. בוחרים בכרטיסייה Migrate a domain (העברת דומיין) באשף Set up domain (הגדרת דומיין).
  2. פועלים לפי ההוראות בשלב הראשון, הכנת הדומיין, שכולל את קבוצת השינויים הנדרשים כדי ש-App Hosting ישמש את הקצה העורפי המועדף ויקים חיבורי TLS מאובטחים לדומיין. מוסיפים, מסירים ושומרים רשומות מהדומיין שלכם אצל ספק ה-DNS באמצעות הקלט הבא לרשומות הנדרשות:
    • שם: מזינים את שם הדומיין בהתאמה אישית של הרשומות. המארח שציינתם הוא הדומיין שבו אתם רוצים להציג תוכן. הדומיין הזה יכול להיות דומיין פסגה או תת-דומיין. יכול להיות שספק הדומיין יציג את המונח הזה בתור 'שם המארח', 'שם' או 'דומיין'.
    • סוג רשומה: מוסיפים את רשומת ה-DNS שסופקה.
    • Value: הקצאת הערך שסופק לרשומות. ספק הדומיין עשוי לרשום את המונח הזה בתור 'נתונים', 'מפנה אל', 'תוכן', 'כתובת' או 'כתובת IP'. התוכן של שדה הערך משתנה בהתאם לסוג הרשומה. ברשומות A ו-AAAA, כתובות ה-IP הן הערכים, ואילו ברשומות TXT הערכים הם מחרוזות.
  3. בוחרים באפשרות אימות רשומות. App Hosting ינסה לזהות את השינויים שביצעתם אצל ספק הדומיין. יכול להיות שיחלפו עד 24 שעות עד שהשינויים ייכנסו לתוקף. אפשר לבדוק את הסטטוס בתצוגה הגדרות > דומיינים בלוח הבקרה של הקצה העורפי.

שלב 3: מפנים אל App Hosting

  1. אחרי ש-App Hosting מאמת את עדכוני הרשומות מהשלב הקודם, האשף עובר לשלב האחרון Direct to App Hosting. בשלב הזה מוצגים עדכוני הרשומות שצריך לבצע כדי להפנות את התנועה של הדומיין לשרתים של App Hosting. כמו קודם, מוסיפים, מסירים ושומרים רשומות מהדומיין שלכם אצל ספק ה-DNS באמצעות הקלט הבא לרשומות הנדרשות:
    • שם: מזינים את שם הדומיין בהתאמה אישית של הרשומות. המארח שציינתם הוא הדומיין שבו אתם רוצים להציג תוכן. הדומיין הזה יכול להיות דומיין פסגה או תת-דומיין. יכול להיות שספק הדומיין יציג את המונח הזה בתור 'שם המארח', 'שם' או 'דומיין'.
    • סוג רשומה: מוסיפים את רשומת ה-DNS שסופקה.
    • Value: הקצאת הערך שסופק לרשומות. ספק הדומיין עשוי לרשום את המונח הזה בתור 'נתונים', 'מפנה אל', 'תוכן', 'כתובת' או 'כתובת IP'. התוכן של שדה הערך משתנה בהתאם לסוג הרשומה. ברשומות A ו-AAAA, כתובות ה-IP הן הערכים, ואילו ברשומות TXT הערכים הם מחרוזות.
  2. בוחרים באפשרות אימות רשומות. App Hosting ינסה לזהות את השינויים שביצעתם אצל ספק הדומיין. יכול להיות שיחלפו עד 24 שעות עד שהשינויים ייכנסו לתוקף. אפשר לבדוק את הסטטוס בתצוגה הגדרות > דומיינים בלוח הבקרה של הקצה העורפי.

חיבור דומיין חדש

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

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

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

שלב 2: מאמתים את רשומות ה-DNS

  1. במסוף Firebase, באשף הגדרת דומיין יוצגו הרשומות הנדרשות שצריך לעדכן כדי להפנות את הדף ל-Firebase App Hosting. מוסיפים, מסירים ושומרים רשומות מהדומיין שלכם אצל ספק ה-DNS באמצעות הקלטות הבאות:
    • שם: מזינים את שם הדומיין בהתאמה אישית של הרשומות. המארח שציינתם הוא הדומיין שבו אתם רוצים להציג תוכן. הדומיין הזה יכול להיות דומיין פסגה או תת-דומיין. יכול להיות שספק הדומיין יציג את המונח הזה בתור 'שם המארח', 'שם' או 'דומיין'.
    • סוג רשומה: מוסיפים את רשומת ה-DNS שסופקה.
    • Value: הקצאת הערך שסופק לרשומות. ספק הדומיין עשוי לרשום את המונח הזה בתור 'נתונים', 'מפנה אל', 'תוכן', 'כתובת' או 'כתובת IP'. התוכן של שדה הערך משתנה בהתאם לסוג הרשומה. ברשומות A ו-AAAA, כתובות ה-IP הן הערכים, ואילו ברשומות TXT הערכים הם מחרוזות.
  2. בוחרים באפשרות אימות רשומות. App Hosting ינסה לזהות את השינויים שביצעתם אצל ספק הדומיין. יכול להיות שיחלפו עד 24 שעות עד שהשינויים ייכנסו לתוקף. אפשר לבדוק את הסטטוס בתצוגה הגדרות > דומיינים בלוח הבקרה של הקצה העורפי.

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

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

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

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

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

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

יכול להיות שתצטרכו לשנות הגדרה ברשומות ה-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.
אתם יכולים להציג את התוכן של האתר.