المصدر: CustomDomain
CustomDomain
هو كيان يربط اسم المجال بموقع استضافة Firebase. قم بإضافة CustomDomain
إلى موقعك للسماح للاستضافة بخدمة محتوى الموقع استجابة للطلبات المقدمة ضد اسم المجال الخاص بك.
تمثيل جيسون |
---|
{ "name": string, "annotations": { string: string, ... }, "createTime": string, "updateTime": string, "deleteTime": string, "expireTime": string, "etag": string, "hostState": enum ( |
مجالات | |
---|---|
name | الإخراج فقط. الاسم المؤهل بالكامل لـ |
annotations | التعليقات التوضيحية التي يمكنك إضافتها لترك بيانات تعريف يمكن قراءتها بواسطة الإنسان والآلية حول كائن يحتوي على قائمة |
createTime | الإخراج فقط. وقت إنشاء النطاق المخصص. طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
updateTime | الإخراج فقط. آخر مرة تم فيها تحديث طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
deleteTime | الإخراج فقط. الوقت الذي تم فيه حذف طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
expireTime | الإخراج فقط. الحد الأدنى من الوقت قبل إزالة طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
etag | الإخراج فقط. سلسلة تمثل الحالة الحالية لـ |
hostState | الإخراج فقط. |
ownershipState | الإخراج فقط. |
requiredDnsUpdates | الإخراج فقط. مجموعة من التحديثات التي يجب عليك إجراؤها على سجلات DNS لاسم النطاق للسماح للاستضافة بتقديم محتوى آمن نيابة عنها. |
issues[] | الإخراج فقط. مجموعة من الأخطاء التي واجهتها أنظمة الاستضافة عند محاولة إثبات قدرة الاستضافة على تقديم محتوى آمن لاسم النطاق الخاص بك. قم بحل هذه المشكلات للتأكد من أن |
certPreference | حقل يتيح لك تحديد نوع شهادة SSL التي تنشئها الاستضافة لاسم المجال الخاص بك. تتمتع النطاقات المخصصة لخطة Spark فقط بإمكانية الوصول إلى نوع الشهادة |
cert | الإخراج فقط. تحتوي استضافة شهادة SSL على اسم المجال الخاص بهذا المجال المخصص. بالنسبة للنطاقات المخصصة الجديدة، يمثل هذا غالبًا نية الاستضافة لإنشاء شهادة، بدلاً من شهادة فعلية. تحقق من حقل |
redirectTarget | اسم النطاق الذي يجب أن يقوم هذا |
reconciling | الإخراج فقط. حقل يشير، إذا كان صحيحًا، إلى أن أنظمة الاستضافة تحاول جعل حالة النطاق المخصص مطابقة لحالتك المفضلة. يكون هذا |
labels | التصنيفات المستخدمة للبيانات الوصفية الإضافية و/أو التصفية. كائن يحتوي على قائمة |
حالة المضيف
الحالة المضيفة لاسم المجال الخاص بك. يتم تحديد حالة المضيف عن طريق التحقق من كل عنوان IP مرتبط باسم المجال الخاص بك لمعرفة ما إذا كان يقدم محتوى استضافة.
التعدادات | |
---|---|
HOST_STATE_UNSPECIFIED | حالة مضيف نطاقك المخصص غير محددة. الرسالة غير صالحة إذا كان هذا غير محدد. |
HOST_UNHOSTED | اسم المجال الخاص بنطاقك المخصص غير مرتبط بأي عناوين IP. |
HOST_UNREACHABLE | لا يمكن الوصول إلى اسم المجال الخاص بنطاقك المخصص. أدت استعلامات DNS الخاصة بخدمات الاستضافة للعثور على عناوين IP لاسم المجال الخاص بك إلى حدوث أخطاء. راجع حقل issues كائن CustomDomain للحصول على مزيد من التفاصيل. |
HOST_MISMATCH | يحتوي اسم المجال الخاص بنطاقك المخصص على عناوين IP لا تتحول في النهاية إلى الاستضافة. |
HOST_CONFLICT | يحتوي اسم المجال الخاص بنطاقك المخصص على عناوين IP التي تتوافق مع كل من الاستضافة والخدمات الأخرى. لضمان الحصول على نتائج متسقة، قم بإزالة سجلات A و AAAA المتعلقة بالخدمات غير المتعلقة بالاستضافة. |
HOST_ACTIVE | يتم تقديم كافة الطلبات المقدمة ضد اسم المجال الخاص بك عن طريق الاستضافة. إذا كانت OwnershipState ملكية النطاق المخصص ACTIVE أيضًا، فإن الاستضافة تخدم محتوى موقع الاستضافة الخاص بك على اسم المجال. |
حالة الملكية
حالة ملكية المجال الخاص بك. يمكن أن يمتلك النطاق موقع استضافة Firebase واحد على الأكثر. يمكن تحديد الملكية بطريقتين:
* TXT records: A TXT record on the domain in the form
`hosting-site=[siteId]`.
* CNAME records: A CNAME record that points to a Hosting site's default
domain.
إذا كان CustomDomain
الخاص بك في OwnershipState
غير OWNERSHIP_ACTIVE
لأكثر من 30 يومًا ولم يتم تحديثه خلال 30 يومًا على الأقل، فإن أنظمة ملكية الاستضافة تحذف CustomDomain
. لاستعادة CustomDomain
محذوف، قم بتقديم طلب customDomains.undelete
.
التعدادات | |
---|---|
OWNERSHIP_STATE_UNSPECIFIED | حالة ملكية المجال المخصص الخاص بك غير محددة. هذا لا ينبغي أن يحدث أبدا. |
OWNERSHIP_MISSING | لا يحتوي اسم المجال الخاص بنطاقك المخصص على سجلات ملكية متعلقة بالاستضافة؛ لا يوجد مشروع Firebase لديه الإذن بالتصرف نيابة عن اسم النطاق. |
OWNERSHIP_UNREACHABLE | لا يمكن الوصول إلى اسم المجال الخاص بنطاقك المخصص. أدت استعلامات DNS الخاصة بخدمات الاستضافة للعثور على سجلات ملكية اسم النطاق الخاص بك إلى حدوث أخطاء. راجع حقل issues كائن CustomDomain للحصول على مزيد من التفاصيل. |
OWNERSHIP_MISMATCH | اسم المجال الخاص بنطاقك المخصص مملوك لمشروع Firebase آخر. قم بإزالة سجلات TXT المتعارضة واستبدلها بسجلات خاصة بالمشروع لمشروع Firebase الحالي. |
OWNERSHIP_CONFLICT | يحتوي اسم المجال الخاص بنطاقك المخصص على سجلات TXT متعارضة تشير إلى ملكية كل من مشروع Firebase الحالي ومشروع آخر. قم بإزالة سجلات ملكية المشروع الآخر لمنح ملكية المشروع الحالية. |
OWNERSHIP_PENDING | تم تكوين سجلات DNS الخاصة بنطاقك المخصص بشكل صحيح. ستقوم الاستضافة بنقل ملكية النطاق الخاص بك إلى هذا CustomDomain خلال 24 ساعة. |
OWNERSHIP_ACTIVE | يحتوي اسم المجال الخاص بنطاقك المخصص على سجلات TXT التي تمنح مشروعه الإذن بالتصرف نيابة عنه. |
تحديثات نظام أسماء النطاقات
مجموعة من تحديثات سجل DNS التي يجب عليك إجراؤها للسماح للاستضافة بتقديم محتوى آمن استجابة للطلبات المقدمة ضد اسم المجال الخاص بك. تعرض هذه التحديثات الحالة الحالية لسجلات DNS الخاصة باسم النطاق الخاص بك عندما استفسرت عنها الاستضافة آخر مرة، ومجموعة السجلات المطلوبة التي تحتاج الاستضافة إلى رؤيتها قبل أن يصبح مجالك المخصص نشطًا بالكامل.
تمثيل جيسون |
---|
{ "discovered": [ { object ( |
مجالات | |
---|---|
discovered[] | مجموعة سجلات DNS التي اكتشفتها الاستضافة عند فحص النطاق. |
desired[] | تحتاج مجموعة سجلات DNS للاستضافة إلى تقديم محتوى آمن على المجال. |
checkTime | آخر مرة قامت فيها الاستضافة بالتحقق من سجلات DNS الخاصة بنطاقك المخصص. طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
DNSRecordSet
مجموعة من سجلات DNS ذات الصلة بإعداد وصيانة نطاق مخصص في Firebase Hosting.
تمثيل جيسون |
---|
{ "domainName": string, "checkError": { object ( |
مجالات | |
---|---|
domainName | الإخراج فقط. اسم المجال الذي تنتمي إليه مجموعة السجلات. |
checkError | الإخراج فقط. حدث خطأ في خدمات الاستضافة عند الاستعلام عن سجلات DNS الخاصة باسم المجال الخاص بك. ملاحظة: تتجاهل الاستضافة أخطاء |
records[] | الإخراج فقط. السجلات على المجال. |
سجل DNS
سجلات DNS هي سجلات الموارد التي تحدد كيفية تصرف الأنظمة والخدمات عند التعامل مع طلبات اسم المجال. على سبيل المثال، عند إضافة سجلات A
إلى سجلات DNS لاسم النطاق الخاص بك، فإنك تبلغ الأنظمة الأخرى (مثل متصفحات الويب الخاصة بالمستخدمين) بالاتصال بعناوين IPv4 هذه لاسترداد الموارد ذات الصلة باسم المجال الخاص بك (مثل ملفات موقع الاستضافة الخاصة بك) ).
تمثيل جيسون |
---|
{ "domainName": string, "type": enum ( |
مجالات | |
---|---|
domainName | الإخراج فقط. اسم المجال الذي ينتمي إليه السجل، على سبيل المثال |
type | الإخراج فقط. نوع السجل، الذي يحدد البيانات التي يحتوي عليها السجل. |
rdata | الإخراج فقط. بيانات السجل. يعتمد معنى القيمة على نوع السجل: - A وAAAA: عناوين IP لاسم النطاق. - CNAME: مجال آخر للتحقق من السجلات. - TXT: سلاسل نصية عشوائية مرتبطة باسم المجال. تستخدم الاستضافة سجلات TXT لتحديد مشاريع Firebase التي لديها إذن بالتصرف نيابة عن اسم النطاق. - CAA: علامات السجل وعلامته وقيمته، على سبيل المثال |
requiredAction | الإخراج فقط. تعداد يشير إلى الإجراء المطلوب لهذا السجل. |
يكتب
نوع سجل DNS، بما في ذلك A
و TXT
و AAAA
و CAA
.
التعدادات | |
---|---|
TYPE_UNSPECIFIED | نوع السجل غير محدد. الرسالة غير صالحة إذا كان هذا غير محدد. |
A | سجل A ، كما هو محدد في RFC 1035 . تحدد السجلات عناوين IPv4 التي يوجه اسم المجال حركة المرور إليها. |
CNAME | سجل CNAME ، كما هو محدد في RFC 1035 . تقوم سجلات CNAME أو Canonical Name بتعيين اسم المجال لاسم نطاق أساسي مختلف. إذا كان سجل CNAME موجودًا، فيجب أن يكون السجل الوحيد في اسم المجال. |
TXT | سجل TXT ، كما هو محدد في RFC 1035 . تحتفظ سجلات TXT ببيانات نصية عشوائية على اسم المجال. تستخدم الاستضافة سجلات TXT لتحديد مشروع Firebase الذي لديه الإذن بالتصرف على اسم النطاق. |
AAAA | يحدد سجل AAAA، كما هو محدد في RFC 3596، سجلات AAAA عناوين IPv6 التي يوجه اسم المجال حركة المرور نحوها. |
CAA | سجل CAA، كما هو محدد في RFC 6844 . تحدد سجلات CAA، أو ترخيص المرجع المصدق، المراجع المصدقة (مؤسسات استخراج شهادات SSL) المصرح لها بإصدار شهادة لاسم النطاق. تستخدم استضافة Firebase سجلات الجهاز المركزي للمحاسبات تتالي. ينطبق سجل CAA على سجلات CAA اختيارية. إذا كان اسم النطاق وأصوله ليس لديهما سجلات CAA، فإن جميع المراجع المصدقة مخولة بإصدار الشهادات نيابة عنه. بشكل عام، تطلب منك الاستضافة فقط تعديل سجلات CAA عندما يكون القيام بذلك مطلوبًا لإلغاء حظر إنشاء شهادة SSL. |
فعل
الإجراء هو نوع الإجراء الذي يجب عليك اتخاذه بشأن سجل DNS هذا لتكوين المجال الخاص بك للاستخدام مع استضافة Firebase.
التعدادات | |
---|---|
NONE | لا يوجد إجراء ضروري. |
ADD | أضف هذا السجل إلى سجلات DNS الخاصة بك. |
REMOVE | قم بإزالة هذا السجل من سجلات DNS الخاصة بك. |
يكتب
نوع الشهادة. يحدد كيفية تعامل أنظمة الاستضافة مع إنشاء الشهادة والحفاظ عليها.
التعدادات | |
---|---|
TYPE_UNSPECIFIED | نوع الشهادة غير محدد. الرسالة غير صالحة إذا كان هذا غير محدد. |
TEMPORARY | نوع شهادة قصير الأجل يغطي اسم النطاق مؤقتًا، بينما تقوم الاستضافة بإنشاء شهادة أكثر استدامة. |
GROUPED | الشهادة القياسية للنطاقات المخصصة لخطة Spark. |
PROJECT_GROUPED | خطة الحريق فقط. شهادة تغطي من 1 إلى 100 اسم نطاق بنطاقات مخصصة في نفس مشروع Firebase. |
DEDICATED | خطة الحريق فقط. شهادة تغطي اسم مجال واحد. |
شهادة
شهادة SSL تُستخدم لتوفير التشفير الشامل للطلبات المقدمة ضد اسم المجال الخاص بك. يمكن أن تكون Certificate
شهادة SSL فعلية، أو، بالنسبة للنطاقات المخصصة المنشأة حديثًا، نية الاستضافة لإنشاء واحدة.
تمثيل جيسون |
---|
{ "type": enum ( |
مجالات | |
---|---|
type | الإخراج فقط. نوع الشهادة. |
state | الإخراج فقط. حالة الشهادة. توفر حالتا |
verification | الإخراج فقط. مجموعة من تحديات ACME التي يمكنك إضافتها إلى سجلات DNS الخاصة بك أو إلى موفر الاستضافة الحالي غير المستضيف للسماح للاستضافة بإنشاء شهادة SSL لاسم المجال الخاص بك قبل توجيه حركة المرور نحو الاستضافة. يمكنك استخدام هذه التحديات كجزء من عملية انتقال صفرية من مزود الخدمة القديم إلى الاستضافة. |
issues[] | الإخراج فقط. مجموعة من الأخطاء التي واجهتها الاستضافة عند محاولة إنشاء شهادة لاسم المجال الخاص بك. قم بحل هذه المشكلات للتأكد من أن الاستضافة قادرة على توفير اتصال آمن مع زوار موقعك. |
createTime | الإخراج فقط. وقت إنشاء الشهادة. بالنسبة للشهادات طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
expireTime | الإخراج فقط. وقت انتهاء الشهادة. وبعد هذا الوقت، لم يعد من الممكن استخدام الشهادة لتوفير اتصال آمن بين الاستضافة وزوار موقعك. طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
حالة سيرت
حالة استضافة شهادة SSL لاسم المجال الخاص بك. يمكن أن يمثل هذا إما حالة الشهادة الفعلية أو، بالنسبة للنطاقات المخصصة الجديدة، محاولة الاستضافة إنشاء شهادة.
التعدادات | |
---|---|
CERT_STATE_UNSPECIFIED | حالة الشهادة غير محددة. الرسالة غير صالحة إذا كان هذا غير محدد. |
CERT_PREPARING | تمثل الحالة الأولية لكل شهادة نية الاستضافة في إنشاء شهادة، قبل تقديم الطلبات إلى المرجع المصدق. |
CERT_VALIDATING | تقوم الاستضافة بالتحقق مما إذا كانت سجلات DNS لاسم النطاق في حالة تسمح بإنشاء الشهادة نيابة عنه. |
CERT_PROPAGATING | تم إنشاء الشهادة مؤخرًا، وتحتاج إلى وقت لنشرها في شبكة CDN الخاصة بالاستضافة. |
CERT_ACTIVE | الشهادة نشطة، وتوفر اتصالات آمنة لأسماء النطاق التي تمثلها. |
CERT_EXPIRING_SOON | تنتهي صلاحية الشهادة، وسيتم منح جميع أسماء النطاقات الموجودة عليها شهادات جديدة. |
CERT_EXPIRED | انتهت صلاحية الشهادة. لم تعد الاستضافة قادرة على تقديم محتوى آمن على اسم المجال الخاص بك. |
التحقق من الشهادة
مجموعة من تحديات ACME التي يمكنك استخدامها للسماح للاستضافة بإنشاء شهادة SSL لاسم النطاق الخاص بك قبل توجيه حركة المرور إلى خوادم الاستضافة. استخدم تحدي DNS أو HTTP؛ ليس من الضروري توفير كليهما.
تمثيل جيسون |
---|
{ "dns": { object ( |
مجالات | |
---|---|
dns | الإخراج فقط. سجل |
http | الإخراج فقط. ملف لإضافته إلى خدمة الاستضافة الحالية غير المستضيفة لديك والذي يؤكد نيتك في السماح للاستضافة بإنشاء شهادة SSL لاسم المجال الخاص بك. |
تحديث المتشعب
ملف يمكنك إضافته إلى خدمة الاستضافة الحالية غير المستضيفة لديك والذي يؤكد نيتك في السماح لسلطات التصديق الخاصة بالاستضافة بإنشاء شهادة SSL لنطاقك.
تمثيل جيسون |
---|
{
"path": string,
"desired": string,
"discovered": string,
"lastCheckTime": string,
"checkError": {
object ( |
مجالات | |
---|---|
path | الإخراج فقط. المسار إلى الملف. |
desired | الإخراج فقط. سلسلة نصية للخدمة في المسار. |
discovered | الإخراج فقط. ما إذا كانت الاستضافة قادرة على العثور على محتويات الملف المطلوبة على المسار المحدد أثناء فحصها الأخير. |
lastCheckTime | الإخراج فقط. آخر مرة قامت فيها أنظمة الاستضافة بالتحقق من محتويات الملف. طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
checkError | الإخراج فقط. حدث خطأ أثناء فحص المحتويات الأخيرة. إذا كان فارغًا، فهذا يعني أن عملية التحقق قد اكتملت بنجاح. |
طُرق | |
---|---|
| يقوم بإنشاء CustomDomain . |
| يحذف CustomDomain المحدد. |
| يحصل على CustomDomain المحدد. |
| يسرد كل CustomDomain المرتبط بموقع الاستضافة الأصلي المحدد. |
| يقوم بتحديث CustomDomain المحدد. |
| يلغي حذف CustomDomain المحدد إذا تم حذفه بشكل مبدئي. |