ForHosting KIT · أدوات المطورين

إنشاء قيمة ترويسة HSTS مع max-age وpreload

مدة قدرها 31536000 ثانية مع تفعيل الخيارين تعطي سطرًا واحدًا: max-age أولًا ثم includeSubDomains ثم preload. الصقوه في الخادم أو في قاعدة الوكيل دون تجميع الأجزاء يدويًا. مجانًا في متصفحكم.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

مثال محلول

إذا أدخلت

أقصى عمر (max-age): 31,536,000

تحصل على

القيمة: max-age=31536000; includeSubDomains; preload

تحوّل أداة إنشاء قيمة ترويسة HSTS هذه مدة بالثواني وخيارين منطقيين واضحين إلى قيمة Strict-Transport-Security مرتبة ترتيبًا صحيحًا. تبدأ دائمًا بالتوجيه الإلزامي max-age، ثم تضيف includeSubDomains وpreload عند طلبهما فقط. وترفض الأداة المدد السالبة وأنواع الحقول غير الصحيحة بدل تحويلها إلى إعداد يبدو معقولًا لكنه لا يعبّر عن سياسة المتصفح المقصودة.

اختاروا max-age بوصفه مدة مدروسة للسياسة

تقبل هذه الأداة المدة في صورة عدد صحيح غير سالب، وتكتبها أول توجيه من دون صيغة أسية أو تقريب أو وحدة مضافة. تمثل القيمة صفر اختيارًا صالحًا، وتُستخدم عادةً لطلب حذف سياسة HSTS محفوظة سابقًا من المتصفحات. أما القيم الموجبة فتبقي السياسة نشطة حتى تنقضي المدة المحفوظة أو تستبدلها استجابة صالحة لاحقة.

اختاروا العدد وفق خطة النشر والتراجع لديكم، ولا تتعاملوا معه بوصفه مجرد تفصيل تنسيق. ترفض الأداة القيم الكسرية والمفقودة وغير الرقمية والسالبة لأنها لا تستطيع تمثيل توجيه الثواني الصحيحة المطلوب بأمان.

افهموا نطاق includeSubDomains وpreload

احصروا مناطق DNS المفوضة والخدمات التي تديرها جهات مستقلة قبل تفعيله. يختلف رمز preload، فهو يعبّر عن نية مرتبطة ببرامج التحميل المسبق في المتصفحات، لكن إضافة الكلمة لا ترسل النطاق ولا تضمن قبوله ولا تغيّر قائمة المتصفح فورًا. لهذه البرامج شروطها الحالية الخاصة بالأهلية والإزالة، وينبغي مراجعتها بصورة مستقلة.

تسمح الأداة بكل خيار على حدة لأن مهمتها إنشاء قيمة الترويسة بصورة حتمية، لا فرض سياسة برنامج تحميل مسبق بعينه. عند اختيار الرموز، تستخدم كتابتها الاصطلاحية وتظهر بعد max-age بترتيب ثابت. أما الخيارات المحذوفة أو ذات القيمة false فلا تظهر.

ويسهّل الترتيب الثابت مراجعة الإعدادات واختبارات النتائج المرجعية ومقارنة الفروق في ملفات البنية التحتية المنشأة.

انشروا القيمة المنشأة وتحققوا منها بأمان

انسخوا القيمة المعادة إلى ترويسة الاستجابة Strict-Transport-Security، ولا تتعاملوا معها كسطر ترويسة كامل. توفر إعدادات خادم الويب عادةً حقلًا للاسم وآخر للقيمة. اختبروا الاستجابة النهائية عند الحافة العامة، إذ قد تستبدل شيفرة التطبيق أو الوكيل أو شبكة توزيع المحتوى أو لوحة الاستضافة الترويسة أو تكررها أو تحذفها.

يمكن بدء نشر تدريجي بمدة موجبة قصيرة، ثم المراقبة والزيادة المخططة بعد إثبات موثوقية كل المضيفين المعنيين. إذا فُعّل includeSubDomains، فاختبروا أيضًا مضيفين متداخلين ممثلين. وإذا فُعّل preload، فتحققوا بصورة منفصلة من استيفاء النطاق لشروط برنامج المتصفح قبل إرساله.

الدالة نقية وحتمية؛ فالمدخلات المتطابقة تعيد السلسلة نفسها دائمًا، ولا يغادر أي طلب بيئة التشغيل، ولا تُحفظ أي إعدادات.

حالات الاستخدام

إنشاء إعدادات الوكيل العكسي

حوّلوا خيارات HSTS المراجعة إلى قيمة ثابتة لوكيل أو موزع أحمال أو قاعدة عند الحافة.

توحيد قوالب البنية التحتية

استخدموا الكتابة والترتيب نفسيهما للتوجيهات في كل البيئات من دون تركيب السلاسل يدويًا.

التخطيط لنشر HSTS

قارنوا السياسات القصيرة والطويلة والشاملة للنطاقات الفرعية والمهيأة للتحميل المسبق قبل تغيير الإنتاج.

الأسئلة الشائعة

هل تتضمن النتيجة اسم الترويسة؟

لا. القيمة مخصصة لحقل Strict-Transport-Security الذي يضبطه خادمكم أو وكيلكم أو تطبيقكم.

هل يمكن أن تكون max-age صفرًا؟

نعم. الصفر قيمة غير سالبة صالحة، وتطلب من المتصفح الداعم إنهاء سياسة HSTS المحفوظة لذلك المضيف.

ماذا يحدث إذا كانت max-age سالبة؟

يفشل الطلب بخطأ إدخال غير صالح، لأن المدة السالبة لا يمكن أن تكوّن توجيه max-age صالحًا.

هل تؤدي إضافة preload إلى إدراج نطاقي في قائمة؟

لا. إنها تضيف الرمز إلى القيمة فقط. لبرامج التحميل المسبق إجراءات منفصلة للأهلية والإرسال والإزالة.

هل يجب تفعيل includeSubDomains دائمًا؟

لا، بل فقط إذا كانت كل النطاقات الفرعية تعمل عبر اتصال آمن. وإلا فقد يتعذر الوصول إلى نطاق فرعي للتطوير أو لمورّد أو نطاق قديم. احصروا النطاقات والخدمات المستقلة قبل تفعيل هذا الخيار.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/security/hsts-header-build

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/security/hsts-header-build \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"max_age":31536000}'

const res = await fetch("https://api.kit.forhosting.com/security/hsts-header-build", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "max_age": 31536000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/security/hsts-header-build",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "max_age": 31536000
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/security/hsts-header-build", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"max_age":31536000}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"max_age":31536000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/security/hsts-header-build", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "max_age": 31536000
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "security.hsts_header_build",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

تصبح النتيجة جاهزة لترويسة استجابة HTTPS أو قاعدة وكيل عكسي أو قالب بنية تحتية.

اختاروا max-age بوصفه مدة مدروسة للسياسة

يخبر التوجيه الإلزامي max-age المتصفح الداعم بعدد الثواني التي ينبغي خلالها أن يتذكر وجوب الوصول إلى المضيف عبر HTTPS فقط. قبل زيادته، تحققوا من عمل HTTPS في كل المسارات، ومن تجدد الشهادات بصورة موثوقة، ومن عدم إخفاء عمليات إعادة التوجيه لأي اعتماد لا يعمل إلا عبر HTTP. الناتج هو قيمة الترويسة وحدها؛ ويظل خادمكم أو وكيلكم مسؤولًا عن إرفاق اسم الحقل Strict-Transport-Security باستجابة HTTPS.

افهموا نطاق includeSubDomains وpreload

فعّلوا includeSubDomains عندما ينبغي أن تشمل سياسة HTTPS الحصرية المضيف المسمى وكل مضيف يقع تحته. يمكن لهذا الخيار حماية شجرة نطاق كاملة، لكنه قد يجعل نطاقًا فرعيًا للتطوير أو لمورّد أو لنظام قديم غير قابل للوصول إذا لم يكن لديه HTTPS صالح.

انشروا القيمة المنشأة وتحققوا منها بأمان

أرسلوا HSTS عبر HTTPS فقط؛ فالمتصفحات تتجاهلها إذا استلمتها عبر اتصال غير آمن، كما أن إعادة التوجيه من HTTP وحدها لا تنشئ السياسة المحفوظة. يجري التنفيذ محليًا في المتصفح، وتبلغ كلفة كل طلب API آلي $0.002.

أسئلة تقنية

هل ينبغي تفعيل includeSubDomains دائمًا؟

لا تفعلوا ذلك إلا بعد التأكد من دعم كل النطاقات الفرعية المتأثرة لاتصال HTTPS موثوق، فالتوجيه يوسّع السياسة إلى الشجرة كلها.

ما كلفة طلب API؟

تبلغ كلفة كل طلب API مقدار $0.002. ويمكن تشغيل أداة الإنشاء النقية نفسها محليًا داخل المتصفح.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

مثال محلول

اختاروا max-age بوصفه مدة مدروسة للسياسة

افهموا نطاق includeSubDomains وpreload

انشروا القيمة المنشأة وتحققوا منها بأمان

حالات الاستخدام

إنشاء إعدادات الوكيل العكسي

توحيد قوالب البنية التحتية

التخطيط لنشر HSTS

الأسئلة الشائعة

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الأخطاء

ملاحظات تقنية

اختاروا max-age بوصفه مدة مدروسة للسياسة

افهموا نطاق includeSubDomains وpreload

انشروا القيمة المنشأة وتحققوا منها بأمان

أسئلة تقنية

شكرًا