Для удобства пользователей и разработчиков SSL.com поддерживает Песочница тестовый экземпляр, клон нашей производственной версии портала SSL.com и SWS API. Песочница похожа на «лабораторию», где вы можете свободно экспериментировать с услугами SSL.com, не опасаясь сломать что-нибудь важное или случайно потратить реальные деньги. Тестирование в песочнице особенно важно при разработке решений автоматизации с помощью SSL.com. RESTful SWS API. Заказы и транзакции в Песочнице не являются активными и, соответственно, не подлежат оплате.
Это руководство поможет вам начать настройку Аккаунт в песочнице, создавая тестовый заказ на онлайн-портале, используя Песочницу с SSL.com SWS-APIи связывание экземпляра SSL Manager в песочницу.
Первые шаги
Настройка учетной записи песочницы
- Прежде чем вы сможете начать использовать Песочницу, вам необходимо создать учетную запись Песочницы. Это верно, даже если у вас уже есть SSL.com клиент or торговый посредник учетная запись. Для начала перейдите к https://sandbox.ssl.com/login. Вы можете подтвердить, что входите в «Песочницу», посмотрев на зеленый предупреждающий баннер в верхней части окна с надписью «SSL.com Sandbox». Это тестовая среда для заказов API. Транзакции и заказы не действуют ».
- Нажмите Создать новую учетную запись.
- Введите желаемое имя пользователя и адрес электронной почты, затем нажмите Зарегистрируйтесь .
- Теперь вы вернетесь на страницу входа. Вы должны увидеть новый зеленый баннер с предупреждением о том, что учетная запись создана.
- Откройте свой почтовый клиент и найдите новое сообщение с заголовком «Инструкции по активации учетной записи пользователя SSL.com». Откройте сообщение и щелкните ссылку активации.
- На открывшейся странице создайте новый безопасный пароль, введите его еще раз для проверки, установите флажок подписного соглашения и нажмите кнопку Отправить кнопка. Ваш пароль должен содержать не менее 8 символов и содержать как минимум одну строчную букву, одну заглавную букву, один числовой символ и один специальный символ.
- После нажатия кнопки Отправить, вы войдете в свою новую учетную запись Sandbox. Вы должны увидеть зеленое окно с предупреждением о том, что ваша учетная запись активирована.
- Вы можете войти в песочницу, перейдя в https://sandbox.ssl.com/login и введите учетные данные, которые вы создали выше.
- Теперь вы можете работать с песочницей в веб-браузере так же, как в SSL.com портал пользователя, с основным отличием в том, что заказы в песочнице не являются действующими и не требуют реальных денег и сертификатов. Таким образом, песочница - отличный способ без риска поэкспериментировать с функциональностью портала. Пожалуйста, обратитесь к нашему документация портала пользователя при работе с Песочницей в веб-браузере.
Создание тестового заказа в портале песочницы
- Как только ваша учетная запись Sandbox будет настроена, вы можете начать делать тестовые заказы. Чтобы начать делать тестовые заказы на портале, нажмите кнопку Средства для разработчиков ссылка, расположенная под разработчики и интеграция заголовок.
- Ассоциация Инструменты разработчика окно откроется. Начните с выбора типа сертификата, который вы хотите заказать в Продукт переключатели, расположенные под Способ отправки формы заголовок. В этом случае мы собираемся создать заказ на подпись кода EV.
- Затем прокрутите вниз и выберите период времени (в днях) для заказа. Вот и 365 дней.
- Когда вы закончите выбирать продукт и период времени, нажмите кнопку Создать тестовый заказ .
- Появится диалоговое окно. Нажмите OK.
- Ваш тестовый заказ будет создан, и вы вернетесь к списку заказов на портале. Обратите внимание, что заказ имеет префикс «(ТЕСТ), чтобы указать, что это тестовый заказ, созданный в Песочнице. Вы можете продолжить работу с этим заказом в Песочнице, как если бы это был настоящий заказ. (Для получения дополнительной информации о работе с заказами на портале, пожалуйста, проверьте наш инструкция.)
Использование песочницы с SSL.com SWS API
SSL.com's RESTful SWS API это мощный инструмент для автоматизации заказа и управления сертификатами. Используя Песочницу, вы можете тщательно протестировать свои вызовы API и скрипты в безопасной среде, прежде чем работать с реальными сертификатами (и реальными деньгами!).
Основы
- Чтобы выполнить вызовы API к песочнице, вам просто нужно использовать этот URL в своих скриптах:
https://sws-test.sslpki.com/
- Когда ваша автоматизация протестирована и готова, переключитесь на URL-адрес производственного API:
https://sws.sslpki.com/
Создание тестового заказа с API
- Онлайн-портал включает шаблон для команды API для создания сертификата. Чтобы найти его, сначала щелкните значок Средства для разработчиков ссылка на панели инструментов:
- Затем прокрутите вниз до Метод вызова API.
- Прежде чем вы сможете использовать команду, вам необходимо добавить свои собственные учетные данные API. Вырежьте и вставьте Команда создания сертификата SSL API в текстовый редактор:Примечание: Примеры команд и 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": null, "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 " , "Receiver_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 "," Certificates ": null," certificate_contents ": { "ref": "co-991f7pdt0-0"}}
- Вернуться в Заказы вкладка на портале Песочница, чтобы просмотреть новый тестовый заказ.
- Вы можете изменить тип сертификата, который вы заказываете, изменив номер продукта в команде. Номера продуктов указаны на Средства для разработчиков страницы:
- Например, если мы хотим заказать сертификат подписи кода EV вместо базового SSL /TLS сертификат, мы можем просто изменить
\"product\":\"106\"
в\"product\":\"360\"
в нашей команде API. - Мы также можем выбрать более длительный срок, изменив
\"period\":\"365\"
в\"period\":\"730\"
, Итак, команда для сертификата подписи кода EV на 730 дней выглядела бы так (конечно, в реальной жизни вы бы включили свой собственныйaccount_key
иsecret_key
.):curl -k -H "Принять: 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 в песочнице можно сделать гораздо больше. Наши вводное руководство к API, более подробно описывает заказы на сертификаты. Вы также можете получить предварительно сгенерированные вызовы API для различных целей на портале вашей учетной записи Sandbox. Документация по API SSL.com доступна здесь.
Использование Песочницы с SSL Manager
Если вы используете SSL Manager, Приложение SSL.com для Windows для заказа цифровых сертификатов и управления ими, его легко настроить для использования песочницы.
- SSL Managerглавное окно отображается, если программное обеспечение производство or тестXNUMX Режим. На снимке экрана ниже показан недавно установленный экземпляр в рабочем режиме:
- Переключитесь на вкладку тестовый режим перейдя к Настройки> SSL Manager API> SSL Manager API - Тест в меню.
- Нажмите OK чтобы закрыть диалоговое окно.
- SSL Manager сейчас в тестовый режим и будет использовать Песочницу, а не производственный API.
- Войдите в свою учетную запись Sandbox, выбрав Аккаунт> Вход для клиентов из меню.
- Войдите в свою песочницу Логин и Пароль, А затем нажмите Логин .
- Появится диалоговое окно, предлагающее предоставить доступ к учетной записи на веб-портале. Сначала нажмите кнопку OK кнопка, чтобы закрыть диалоговое окно.
- Далее, войти в Песочницу в веб-браузере. Если вы настроили несколько команд в Песочнице, убедитесь, что команда, которую вы хотите использовать, установлена на Текущая команда.
- Перейдите в Заказы , затем нажмите SSL Manager Apps ссылку.
- Найдите экземпляр SSL Manager в списке и нажмите в ожидании ссылку.
- Нажмите OK чтобы подтвердить, что вы хотите добавить SSL Manager экземпляр на ваш счет.
- Статус SSL Manager Экземпляр теперь будет отображаться как Активныеи теперь вы можете использовать приложение для создания тестовых заказов в Песочнице. Для получения полной информации о работе с заказами и сертификатами в SSL Managerпожалуйста, обратитесь к нашему документации.