За удобство на потребителите и разработчиците, SSL.com поддържа a пясък тестов екземпляр, клон на нашата производствена версия на портала SSL.com и SWS API. Пясъчникът е като „лаборатория“, където можете свободно да експериментирате с услугите на SSL.com, без страх от счупване на нещо важно или случайно харчене на реални пари. Тестването в пясъчника е особено важно при разработването на решения за автоматизация с SSL.com RESTful SWS API. Поръчките и транзакциите в Пясъчника не са активни и като разширение не могат да се платят.
Това ръководство ще започнете с настройката на a Профил в пясъчник, създаване на тестов ред в онлайн портала, използвайки пясъчника с SSL.com SWS APIи свързване на инстанция на SSL Manager до пясъчната кутия.
Първи стъпки
Настройка на пясъчна сметка
- Преди да можете да започнете да използвате Sandbox, ще трябва да създадете акаунт в Sandbox. Това е вярно, дори ако вече имате SSL.com клиент or търговец сметка. За да започнете, отворете https://sandbox.ssl.com/login. Можете да потвърдите, че влизате в пясъчника, като потърсите зелен банер за предупреждение в горната част на прозореца с надпис „SSL.com Sandbox. Това е тестова среда за api поръчки. Транзакциите и поръчките не се предават на живо. “
- Кликнете Създаване на нов акаунт.
- Въведете желаното потребителско име и имейл адрес, след което щракнете върху Регистрация бутон.
- Сега ще бъдете върнати на страницата за вход. Трябва да видите нов зелен банер с предупреждение, че акаунтът е създаден.
- Отворете вашия имейл клиент и потърсете ново съобщение, озаглавено „Инструкции за активиране на потребителски акаунт на SSL.com“. Отворете съобщението и щракнете върху връзката за активиране.
- На страницата, която се отваря, създайте нова, сигурна парола, въведете я отново за проверка, щракнете върху квадратчето за споразумение на абоната и щракнете върху Изпрати бутон. Вашата парола трябва да е с най-малко 8 знака и трябва да съдържа поне една малка буква, една главна буква, един цифров и един специален символ.
- След като кликнете Изпрати, ще бъдете влезли в новия си акаунт в Sandbox. Трябва да видите зелено поле за предупреждение, което показва, че акаунтът ви е активиран.
- Можете да влезете в Sandbox, като отворите https://sandbox.ssl.com/login и въвеждане на идентификационните данни, които сте създали по-горе.
- Вече можете да работите с Sandbox в уеб браузър, точно както бихте работили в SSL.com потребителски портал, с основната разлика, че поръчките в пясъчника не са на живо и не включват реални пари и сертификати. Следователно Sandbox е чудесен начин да експериментирате с функционалността на портала без риск. Моля, обърнете се към нашия документация за потребителски портал когато работите с Sandbox в уеб браузър.
Създаване на тестова поръчка в пясъчния портал
- След като акаунтът ви в Sandbox бъде настроен, можете да започнете да правите тестови поръчки. За да започнете да правите тестови поръчки в портала, щракнете върху инструменти за разработчици връзка, намираща се под разработчици и интеграция позиция.
- - Инструменти за разработчици ще се отвори прозорец Започнете, като изберете типа сертификат, който искате да поръчате от Продукт радио бутони, разположени под Метод за изпращане на формуляр заглавие. В този случай ще създадем заповед за подписване на EV код.
- След това превъртете надолу и изберете период от време (в дни) за поръчката. Ето, отиваме с 365 дни.
- Когато приключите с избора на продукта и периода от време, щракнете върху Създайте тестова поръчка бутон.
- Ще се появи диалогов прозорец. Щракнете OK.
- Вашата тестова поръчка ще бъде създадена и ще бъдете върнати в списъка с поръчки в портала. Имайте предвид, че поръчката е с префикс „(TEST)," за да посочи, че това е тестова поръчка, създадена в пясъчника. Можете да продължите да работите с тази поръчка в Sandbox така, сякаш е истинска поръчка. (За повече информация относно работата с поръчки в портала, моля, проверете нашите ръководи.)
Използване на Sandbox с SWS API на SSL.com
SSL.com RESTful SWS API е мощен инструмент за автоматизиране на подреждането и управлението на сертификати. С помощта на Sandbox можете да тествате старателно вашите API разговори и скриптове в безопасна среда, преди да работите с истински сертификати (и реални пари!).
Основите
- За да извършите API извиквания към пясъчника, просто трябва да използвате този URL във вашите скриптове:
https://sws-test.sslpki.com/
- Когато автоматизацията ви е тествана и готова, преминете към URL адреса на API за производство:
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 == \", \ "продукт \": \ "106 \", \ "период \": \ "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": null, "state_or_province": null, "post_office_box": null, "postal_code": null, "country": null, "email": null}, "order_status": "неизползвано. чака при заявка за подписване на сертификат (csr) "," валидации ": null," order_amount ":" $ 49.00 "," external_order_number ": null," certificate_url ":" https://sandbox.ssl.com/team/a1c-1f7ksgh/certificate_orders/co-991f7pdt0 " , "receive_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 ": { "ref": "co-991f7pdt0-0"}}
- Връщане към Поръчки раздела в портала Sandbox, за да видите новата поръчка за тестване.
- Можете да промените типа на сертификата, който поръчвате, като промените номер на продукт в командата. Номерите на продуктите са показани на инструменти за разработчици страница:
- Например, ако искаме да поръчаме сертификат за подписване на EV код вместо основен SSL /TLS сертификат, можем просто да променим
\"product\":\"106\"
да се\"product\":\"360\"
в нашата команда API. - Можем да изберем и по-голяма продължителност, като сменим
\"period\":\"365\"
да се\"period\":\"730\"
, Така че една команда за 730-дневен сертификат за подписване на EV код ще изглежда така (разбира се, в реалния живот ще включите своя собственаaccount_key
намляваsecret_key
.):curl -k -H "Приемам: application / json" \ -H "Тип съдържание: application / json" \ -X POST \ -d "{\" account_key \ ": \" a506819b81d6 \ ", \" secret_key \ " : \ "WkTRJzr19I7OUg == \", \ "продукт \": \ "360 \", \ "период \": \ "730 \"} "https: //sws-test.sslpki.com / сертификати
Следващи стъпки
Има много повече неща, които можете да направите с SWS API в Sandbox. Нашите уводно ръководство към API покрива поръчките за сертификати много по-подробно. Можете също да изтеглите предварително генерирани API разговори за различни цели от вашия портал за акаунти в Sandbox. Налична е документацията за API на SSL.com тук.
Използване на пясъчната кутия с SSL Manager
Ако използвате SSL Manager, Приложението на SSL.com за Windows за поръчка и управление на цифрови сертификати, е лесно да го настроите да използва Sandbox.
- SSL ManagerГлавният прозорец на ще се покаже, ако софтуерът е в производство or тест режим. Снимката по-долу показва новоинсталиран екземпляр в производствен режим:
- Преминаване към тестов режим като навигирате до Настройки> SSL Manager API> SSL Manager API - Тест в менюто.
- Щракнете върху OK , за да затворите диалоговия прозорец.
- SSL Manager сега е вътре тестов режим и ще използва Sandbox, а не производствения API.
- Влезте в акаунта си в Sandbox, като изберете Акаунт> Вход за клиенти от менюто.
- Въведете вашата Sandbox Влезте намлява Парола, след което кликнете върху Влезте бутон.
- Ще се появи диалогов прозорец, който ви насочва да предоставите достъп до акаунта в уеб портала. Първо щракнете върху OK бутон за отхвърляне на диалоговия прозорец.
- След влезте в пясъчника в уеб браузър. Ако сте задали няколко отбора в Sandbox, уверете се, че екипът, който искате да използвате, е зададен в Настоящият екип.
- Придвижете се до Поръчки , след което кликнете върху SSL Manager Приложения: връзка.
- Намерете екземпляра на SSL Manager в списъка и щракнете върху в очакване на връзка.
- Кликнете OK за да потвърдите, че искате да добавите SSL Manager например към вашия акаунт.
- Състоянието на SSL Manager инстанцията вече ще бъде показана като Активени вече можете да използвате приложението за създаване на тестови поръчки в пясъчника. За пълни подробности относно работата с поръчки и сертификати в SSL Manager, моля вижте нашите документация.