لراحة المستخدمين والمطورين ، يحافظ SSL.com على أ رمل مثيل الاختبار ، وهو نسخة من إصدار الإنتاج الخاص بنا لبوابة SSL.com و SWS API. يشبه Sandbox "المختبر" ، حيث يمكنك تجربة خدمات SSL.com بحرية دون خوف من كسر أي شيء مهم أو إنفاق أموال حقيقية عن طريق الخطأ. يعد الاختبار في Sandbox مهمًا بشكل خاص عند تطوير حلول الأتمتة باستخدام SSL.com واجهة برمجة تطبيقات SWS المريحة. الطلبات والمعاملات في Sandbox ليست مباشرة ، وبالتالي لا يمكن تحرير فواتير بها.
سيساعدك هذا الدليل في إعداد ملف حساب Sandbox، خلق شيء أمر اختبار في البوابة الإلكترونية ، باستخدام Sandbox مع SSL.com واجهة برمجة تطبيقات SWS، وربط مثيل SSL Manager إلى Sandbox.
كيف تبدأ
إنشاء حساب Sandbox
- قبل أن تتمكن من البدء في استخدام Sandbox ، ستحتاج إلى إنشاء حساب Sandbox. هذا صحيح حتى إذا كان لديك بالفعل SSL.com زبون or التجزئة الحساب. للبدء ، انتقل إلى https://sandbox.ssl.com/login. يمكنك تأكيد تسجيل الدخول إلى Sandbox بالبحث عن لافتة تنبيه خضراء بالقرب من أعلى النافذة مكتوب عليها “SSL.com Sandbox. هذه بيئة اختبار لأوامر API. المعاملات والأوامر ليست مباشرة. "
- انقر إنشاء حساب جديد.
- أدخل اسم المستخدم وعنوان البريد الإلكتروني المطلوبين ، ثم انقر فوق تسجيل .
- ستتم إعادتك الآن إلى صفحة تسجيل الدخول. يجب أن ترى لافتة تنبيه خضراء جديدة تفيد بأن الحساب قد تم إنشاؤه.
- افتح عميل البريد الإلكتروني وابحث عن رسالة جديدة بعنوان "تعليمات تنشيط حساب مستخدم SSL.com." افتح الرسالة وانقر فوق ارتباط التنشيط.
- في الصفحة التي تفتح ، أنشئ كلمة مرور جديدة وآمنة ، وأدخلها مرة أخرى للتحقق ، وانقر فوق خانة الاختيار اتفاقية المشترك ، وانقر فوق تقدم زر. يجب أن تتكون كلمة المرور من 8 أحرف على الأقل ، ويجب أن تحتوي على حرف صغير واحد على الأقل وحرف كبير واحد وحرف رقمي وحرف خاص واحد.
- بعد النقر تقدم، سيتم تسجيل دخولك إلى حساب Sandbox الجديد. يجب أن تشاهد مربع تنبيه أخضر يشير إلى أنه تم تنشيط حسابك.
- يمكنك تسجيل الدخول إلى Sandbox بالانتقال إلى https://sandbox.ssl.com/login وإدخال أوراق الاعتماد التي قمت بإنشائها أعلاه.
- يمكنك الآن العمل مع Sandbox في متصفح الويب تمامًا كما تفعل في SSL.com بوابة المستخدم، مع الاختلاف الرئيسي في أن الطلبات في Sandbox ليست مباشرة ولا تتضمن أموالًا وشهادات حقيقية. لذلك ، يعد Sandbox طريقة رائعة لتجربة وظائف البوابة دون أي مخاطر. يرجى الرجوع إلى وثائق بوابة المستخدم عند العمل مع Sandbox في متصفح الويب.
إنشاء أمر اختبار في Sandbox Portal
- بمجرد إعداد حساب Sandbox الخاص بك ، يمكنك البدء في إصدار أوامر الاختبار. للبدء في إصدار أوامر الاختبار في البوابة ، انقر فوق أدوات المطورين الارتباط الموجود تحت المطورين والتكامل عنوان.
- • ادوات المطورين ستفتح النافذة. ابدأ بتحديد نوع الشهادة التي تريد طلبها من منتج
أزرار الراديو ، الموجودة تحت طريقة إرسال النموذج عنوان. في هذه الحالة ، سننشئ أمر توقيع رمز EV.
- بعد ذلك ، قم بالتمرير لأسفل وحدد الفترة الزمنية (بالأيام) للطلب. ها نحن ذاهبون مع 365 يومًا.
- عند الانتهاء من تحديد المنتج والفترة الزمنية ، انقر فوق إنشاء أمر اختبار .
- سيظهر مربع الحوار. انقر OK.
- سيتم إنشاء أمر الاختبار الخاص بك ، وستتم إعادتك إلى قائمة الطلبات في البوابة. لاحظ أن الطلب مسبوق بـ "(TEST) ،" للإشارة إلى أنه أمر اختبار تم إنشاؤه في Sandbox. يمكنك متابعة العمل مع هذا الطلب في Sandbox كما لو كان أمرًا حقيقيًا. (لمزيد من المعلومات حول التعامل مع الطلبات في البوابة ، يرجى مراجعة موقعنا توجيه.)
استخدام Sandbox مع واجهة برمجة تطبيقات SWS الخاصة بـ SSL.com
SSL.com's واجهة برمجة تطبيقات SWS المريحة أداة قوية لأتمتة ترتيب الشهادات وإدارتها. باستخدام Sandbox ، يمكنك اختبار مكالمات API والنصوص البرمجية في بيئة آمنة بدقة قبل العمل باستخدام شهادات حقيقية (وأموال حقيقية!).
أساسيات
- لإجراء مكالمات API إلى Sandbox ، تحتاج ببساطة إلى استخدام عنوان URL هذا في البرامج النصية الخاصة بك:
https://sws-test.sslpki.com/
- عندما يتم اختبار الأتمتة الخاصة بك وتصبح جاهزة ، قم بالتبديل إلى عنوان URL الخاص بواجهة برمجة تطبيقات الإنتاج:
https://sws.sslpki.com/
إنشاء أمر اختبار باستخدام API
- تشتمل البوابة الإلكترونية على قالب لأمر API لإنشاء شهادة. للعثور عليه ، انقر أولاً فوق أدوات المطورين رابط على لوحة القيادة الخاصة بك:
- بعد ذلك ، قم بالتمرير لأسفل إلى طريقة استدعاء API.
- قبل أن تتمكن من استخدام الأمر ، ستحتاج إلى إضافة بيانات اعتماد API الخاصة بك. قص ولصق ملف API إنشاء أمر شهادة SSL في محرر نصوص:ملحوظة: تم تنسيق أمثلة Command و JSON مع فواصل أسطر لإمكانية القراءة في هذا الدليل. حرف الخط المائل العكسي (
\
) متبوعًا بفاصل أسطر يتيح لك تقسيم أمر طويل إلى أسطر متعددة في محطة Linux / UNIX.curl -k -H "Accept: application / json" \ -H "Content-type: application / json" \ -X POST \ -d "{\" account_key \ ": \" \ "، \" secret_key \ ": \ "\"، \ "المنتج \": \ "106 \"، \ "الفترة \": \ "365 \"} "\ https: //sws-test.sslpki.com / الشهادات
- للوصول إلى بيانات اعتماد API الخاصة بك ، ارجع إلى لوحة معلومات البوابة الإلكترونية وانقر وثائق التفويض api.
- لاستخدام الأمر ، ستحتاج إلى ملف مفتاح الحساب و مفتاح سري. يمكنك نسخها إلى الحافظة بالنقر فوق الرموز الموجودة على يمين المفاتيح. يمكنك أيضًا تحديد هذه القيم ونسخها مباشرةً ، ولكن بالنسبة للمفتاح السري ، يجب النقر فوقها اضغط للعرض لأول مرة.
- أضف مفتاح حسابك ومفتاح السر إلى الأمر كما هو موضح أدناه:
curl -k -H "Accept: application / json" -H "Content-type: application / json" \ -X POST -d "{\" account_key \ ": \" a506819b81d6 \ "، \" secret_key \ ": \ "WkTRJzr19I7OUg == \"، \ "product \": \ "106 \"، \ "period \": \ "365 \"} "\ https: //sws-test.sslpki.com / الشهادات
- يمكنك الآن لصق الأمر في محطة وتشغيله. سيعيد الأمر كائن JSON الذي يصف الترتيب.
{"ref": "co-991f7pdt0"، "registrant": {"organization": null، "organization_unit": null، "street_address_1": null، "street_address_2": null، "street_address_3": null، "locality": خالية ، "state_or_province": null ، "post_office_box": null ، "postal_code": null ، "country": null ، "email": null} ، "order_status": "unused. قيد انتظار طلب توقيع الشهادة (csr) "،" validations ": null،" order_amount ":" 49.00 دولارًا "،" external_order_number ": null،" Certificate_url ":" https://sandbox.ssl.com/team/a1c-1f7ksgh/certificate_orders/co-991f7pdt0 " ، "Receiving_url": "https://sandbox.ssl.com/team/a1c-1f7ksgh/orders/cfb1-1f7pdt1" ، "smart_seal_url": "https://sandbox.ssl.com/team/a1c-1f7ksgh/ Certificate_orders / co-991f7pdt0 / site_seal "،" validation_url ":" https://sandbox.ssl.com/team/a1c-1f7ksgh/certificate_orders/co-991f7pdt0/validation "،" الشهادات ": null،" Certificate_contents ": { "المرجع": "co-991f7pdt0-0"}}
- العودة إلى الطلبات علامة التبويب في بوابة Sandbox لعرض أمر الاختبار الجديد.
- يمكنك تغيير نوع الشهادة التي تطلبها عن طريق تغيير رقم المنتج في الأمر. تظهر أرقام المنتج على أدوات المطورين الصفحة:
- على سبيل المثال ، إذا أردنا طلب شهادة توقيع رمز EV بدلاً من SSL / الأساسيTLS الشهادة ، يمكننا ببساطة تغييرها
\"product\":\"106\"
إلى\"product\":\"360\"
في أمر API الخاص بنا. - يمكننا أيضًا اختيار مدة أطول من خلال التغيير
\"period\":\"365\"
إلى\"period\":\"730\"
. لذا ، فإن الأمر للحصول على شهادة توقيع رمز EV لمدة 730 يومًا سيبدو كهذا (بالطبع ، في الحياة الواقعية يمكنك تضمين شهادتك الخاصةaccount_key
وsecret_key
.):curl -k -H "Accept: application / json" \ -H "Content-type: application / json" \ -X POST \ -d "{\" account_key \ ": \" a506819b81d6 \ "، \" secret_key \ " : \ "WkTRJzr19I7OUg == \"، \ "product \": \ "360 \"، \ "period \": \ "730 \"} "https: //sws-test.sslpki.com / الشهادات
الخطوات التالية
هناك الكثير مما يمكنك القيام به باستخدام SWS API في Sandbox. لنا دليل تمهيدي إلى API يغطي طلبات الشهادات بمزيد من التفاصيل. يمكنك أيضا استرداد مكالمات API مسبقة لمجموعة متنوعة من الأغراض من بوابة حساب Sandbox الخاص بك. وثائق API الخاصة بـ SSL.com متاحة هنا.
باستخدام Sandbox مع SSL Manager
إذا كنت تستخدم SSL Manager، تطبيق SSL.com لنظام Windows لطلب وإدارة الشهادات الرقمية ، من السهل إعداده لاستخدام Sandbox.
- SSL Managerستظهر النافذة الرئيسية في حالة وجود البرنامج إنتاج or تجربه بالعربي الوضع. تُظهر لقطة الشاشة أدناه مثيلًا مثبتًا حديثًا في وضع الإنتاج:
- التحول إلى وضع الاختبار بالانتقال إلى الإعدادات> SSL Manager API> SSL Manager API - اختبار في القائمة.
- انقر على OK زر لإغلاق مربع الحوار.
- SSL Manager هو الآن في وضع الاختبار وسيستخدم Sandbox بدلاً من واجهة برمجة تطبيقات الإنتاج.
- قم بتسجيل الدخول إلى حساب Sandbox الخاص بك عن طريق تحديد الحساب> تسجيل دخول العميل من القائمة.
- أدخل Sandbox الخاص بك تسجيل الدخول و كلمة المرور، ثم انقر فوق تسجيل الدخول .
- سيظهر مربع حوار يوجهك لمنح حق الوصول إلى الحساب في بوابة الويب. أولاً ، انقر فوق ملف OK الزر لإغلاق مربع الحوار.
- المقبل، تسجيل الدخول إلى Sandbox في متصفح الويب. إذا قمت بإعداد عدة فرق في Sandbox ، فتأكد من تعيين الفريق الذي تريد استخدامه في الفريق الحالي.
- انتقل إلى الطلبات ، ثم انقر فوق SSL Manager تطبيقات الرابط.
- حدد موقع مثيل SSL Manager في القائمة وانقر فوق قائمة الانتظار الرابط.
- انقر OK لتأكيد رغبتك في إضافة SSL Manager مثيل لحسابك.
- وضع SSL Manager سيظهر المثال الآن على شكل النشطه، ويمكنك الآن استخدام التطبيق لإنشاء أوامر اختبار في Sandbox. للحصول على التفاصيل الكاملة للعمل مع الطلبات والشهادات في SSL Manager، يرجى الرجوع إلى موقعنا توثيق.