Sử dụng Hộp cát SSL.com để Kiểm tra và Tích hợp

Để thuận tiện cho người dùng và nhà phát triển, SSL.com duy trì một hộp đựng cát phiên bản thử nghiệm, một bản sao của bản phát hành sản xuất của chúng tôi đối với cổng SSL.com và API SWS. Sandbox giống như một “phòng thí nghiệm”, nơi bạn có thể tự do thử nghiệm với các dịch vụ của SSL.com mà không sợ làm hỏng bất cứ thứ gì quan trọng hoặc vô tình tiêu tiền thật. Kiểm tra trong Sandbox đặc biệt quan trọng khi phát triển các giải pháp tự động hóa với SSL.com's API SWS RESTful. Đơn đặt hàng và giao dịch trong Sandbox không tồn tại và bởi phần mở rộng không có hóa đơn.

Hướng dẫn này sẽ giúp bạn bắt đầu với việc thiết lập một Tài khoản hộp cát, tạo ra một Trật tự kiểm tra trong cổng trực tuyến, bằng cách sử dụng Hộp cát với SSL.com API SWSvà liên kết một thể hiện của SSL Manager vào hộp cát.

Bắt đầu

Thiết lập tài khoản hộp cát

1. Trước khi có thể bắt đầu sử dụng Hộp cát, bạn cần tạo tài khoản Hộp cát. Điều này đúng ngay cả khi bạn đã có SSL.com khách hàng or đại lý bán lẻ tài khoản. Để bắt đầu, điều hướng đến https://sandbox.ssl.com/login. Bạn có thể xác nhận rằng bạn đang đăng nhập vào Sandbox bằng cách tìm biểu ngữ cảnh báo màu xanh lá cây gần đầu cửa sổ có nội dung “SSL.com Sandbox. Đây là một môi trường thử nghiệm cho các đơn đặt hàng api. Các giao dịch và đơn đặt hàng không tồn tại ”.
   
2. Nhấp chuột Tạo một tài khoản mới.
   
3. Nhập tên người dùng và địa chỉ email mong muốn của bạn, sau đó nhấp vào Đăng ký .
   
4. Bây giờ bạn sẽ được trở lại trang đăng nhập. Bạn sẽ thấy một biểu ngữ cảnh báo màu xanh lá cây mới cho biết rằng tài khoản đã được tạo.
   
5. Mở ứng dụng email của bạn và tìm một thông báo mới, có tiêu đề “Hướng dẫn kích hoạt tài khoản người dùng SSL.com”. Mở tin nhắn và nhấp vào liên kết kích hoạt.
   
6. Trên trang mở ra, hãy tạo một mật khẩu mới, an toàn, nhập lại mật khẩu đó để xác minh, nhấp vào hộp kiểm thỏa thuận người đăng ký và nhấp vào Gửi cái nút. Mật khẩu của bạn phải dài ít nhất 8 ký tự và phải chứa ít nhất một chữ cái viết thường, một chữ cái viết hoa, một ký tự số và một ký tự đặc biệt.
   
7. Sau khi nhấp Gửi, bạn sẽ đăng nhập vào tài khoản Sandbox mới của mình. Bạn sẽ thấy một hộp cảnh báo màu xanh lá cây cho biết rằng tài khoản của bạn đã được kích hoạt.
   
8. Bạn có thể đăng nhập vào Hộp cát bằng cách điều hướng đến https://sandbox.ssl.com/login và nhập thông tin đăng nhập bạn đã tạo ở trên.
   
9. Bây giờ bạn có thể làm việc với Sandbox trong trình duyệt web giống như bạn làm trong SSL.com cổng thông tin người dùng, với sự khác biệt chính là các đơn đặt hàng trong Sandbox không trực tiếp và không liên quan đến tiền thật và chứng chỉ. Do đó, Sandbox là một cách tuyệt vời để thử nghiệm chức năng của cổng thông tin mà không gặp rủi ro. Hãy tham khảo của chúng tôi tài liệu cổng thông tin người dùng khi làm việc với Sandbox trong trình duyệt web.
   

Tạo một thứ tự kiểm tra trong Cổng thông tin Sandbox

1. Sau khi tài khoản Sandbox của bạn được thiết lập, bạn có thể bắt đầu thực hiện các đơn đặt hàng thử nghiệm. Để bắt đầu thực hiện các đơn đặt hàng thử nghiệm trong cổng thông tin, hãy nhấp vào công cụ phát triển liên kết, nằm dưới nhà phát triển và tích hợp tiêu đề.
   
2. Sản phẩm Những công cụ phát triển cửa sổ sẽ mở ra. Bắt đầu bằng cách chọn loại chứng chỉ bạn muốn đặt hàng từ Sản phẩm nút radio, nằm dưới Phương thức gửi mẫu phần mở đầu. Trong trường hợp này, chúng tôi sẽ tạo một lệnh ký mã EV.
   
3. Tiếp theo, cuộn xuống và chọn một khoảng thời gian (tính bằng ngày) cho đơn đặt hàng. Đây là chúng ta sẽ làm với 365 ngày.
   
4. Khi bạn chọn xong sản phẩm và khoảng thời gian, hãy nhấp vào Tạo thứ tự kiểm tra .
   
5. Một hộp thoại sẽ xuất hiện. Nhấp chuột OK.
   
6. Đơn đặt hàng thử nghiệm của bạn sẽ được tạo và bạn sẽ được đưa trở lại danh sách đơn đặt hàng trong cổng thông tin. Lưu ý rằng đơn đặt hàng có tiền tố là “(TEST)," để chỉ ra rằng đó là một thứ tự kiểm tra được tạo trong Sandbox. Bạn có thể tiếp tục làm việc với đơn hàng này trong Sandbox giống như đó là một đơn hàng thực sự. (Để biết thêm thông tin về cách làm việc với các đơn đặt hàng trong cổng, vui lòng kiểm tra hướng dẫn.)
   

Sử dụng Hộp cát với API SWS của SSL.com

SSL.com của API SWS RESTful là một công cụ mạnh mẽ để tự động hóa việc đặt hàng và quản lý chứng chỉ. Sử dụng Sandbox, bạn có thể kiểm tra kỹ lưỡng các lệnh gọi và tập lệnh API trong môi trường an toàn trước khi làm việc với các chứng chỉ thực (và tiền thật!).

Khái niệm cơ bản

1. Để thực hiện các lệnh gọi API tới Hộp cát, bạn chỉ cần sử dụng URL này trong các tập lệnh của mình:

   https://sws-test.sslpki.com/

2. Khi quá trình tự động hóa của bạn được thử nghiệm và sẵn sàng, hãy chuyển sang URL API sản xuất:

   https://sws.sslpki.com/

Tạo Đơn hàng thử nghiệm với API

1. Cổng trực tuyến bao gồm một mẫu cho lệnh API để tạo chứng chỉ. Để tìm nó, trước tiên hãy nhấp vào công cụ phát triển liên kết trên bảng điều khiển của bạn:
   
2. Tiếp theo, cuộn xuống Phương thức gọi API.
   
3. Trước khi có thể sử dụng lệnh, bạn cần thêm thông tin đăng nhập API của riêng mình. Cắt và dán API Tạo lệnh chứng chỉ SSL vào một trình soạn thảo văn bản:
   
   Lưu ý: Các ví dụ về lệnh và JSON đã được định dạng với các ngắt dòng để dễ đọc trong hướng dẫn này. Một ký tự dấu gạch chéo ngược (\) theo sau là ngắt dòng cho phép bạn ngắt một lệnh dài thành nhiều dòng trong thiết bị đầu cuối Linux / UNIX.

    

   curl -k -H "Chấp nhận: application/json" \ -H "Kiểu nội dung: application/json" \ -X POST \ -d "{\"account_key\":\"\",\"secret_key\":\"\",\"product\":\"106\",\"period\":\"365\"}" \ https://sws-test.sslpki.com/certificates

4. Để truy cập thông tin đăng nhập API của bạn, hãy quay lại trang tổng quan cổng thông tin và nhấp vào thông tin api.

   

5. Để sử dụng lệnh, bạn sẽ cần khóa tài khoản và chìa khoá bí mật. Bạn có thể sao chép chúng vào clipboard bằng cách nhấp vào biểu tượng ở bên phải các phím. Bạn cũng có thể chọn và sao chép trực tiếp các giá trị này, nhưng đối với khóa bí mật, bạn phải nhấp vào Nhấn vào đây để xem đầu tiên.

   

6. Thêm khóa tài khoản và khóa bí mật của bạn vào lệnh như hình dưới đây:

   curl -k -H "Chấp nhận: application/json" -H "Kiểu nội dung: application/json" \ -X POST -d "{\"account_key\":\"a506819b81d6\",\"secret_key\":\"WkTRJzr19I7OUg==\",\"product\":\"106\",\"period\":\"365\"}" \ https://sws-test.sslpki.com/certificates

7. Bây giờ bạn có thể dán lệnh vào một thiết bị đầu cuối và chạy nó. Lệnh sẽ trả về một đối tượng JSON mô tả đơn hàng.

   { "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":"chưa sử dụng. đang chờ yêu cầu ký chứng chỉ (csr)", "validations":null, "order_amount":"$49.00", "external_order_number":null, "certificate_url":"https://sandbox.ssl.com/team/a1c-1f7ksgh/certificate_orders/co-991f7pdt0", "receipt_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":{ "tham chiếu":"co-991f7pdt0-0" } }

8. Quay lại Đơn Đặt Hàng trong cổng Sandbox để xem thứ tự kiểm tra mới.
   
9. Bạn có thể thay đổi loại chứng chỉ bạn đang đặt hàng bằng cách thay đổi số sản phẩm trong lệnh. Số sản phẩm được hiển thị trên công cụ phát triển :
   
10. Ví dụ: nếu chúng tôi muốn đặt hàng chứng chỉ ký mã EV thay vì SSL cơ bản /TLS Giấy chứng nhận, chúng tôi chỉ có thể thay đổi \"product\":\"106\" đến \"product\":\"360\" trong lệnh API của chúng tôi.
11. Chúng tôi cũng có thể chọn thời lượng dài hơn bằng cách thay đổi \"period\":\"365\" đến \"period\":\"730\". Vì vậy, một lệnh cho chứng chỉ ký mã EV trong 730 ngày sẽ giống như thế này (tất nhiên, trong cuộc sống thực, bạn sẽ bao gồm chính bạn account_key và secret_key.):

     

    curl -k -H "Chấp nhận: application/json" \ -H "Kiểu nội dung: application/json" \ -X POST \ -d "{\"account_key\":\"a506819b81d6\",\"secret_key\":\"WkTRJzr19I7OUg==\",\"product\":\"360\",\"period\":\"730\"}" https://sws-test.sslpki.com/certificates

Các bước tiếp theo

Còn nhiều hơn thế nữa mà bạn có thể làm với API SWS trong Sandbox. Của chúng tôi hướng dẫn giới thiệu API bao gồm các đơn đặt hàng chứng chỉ chi tiết hơn nhiều. Bạn cũng có thể lấy các lệnh gọi API được tạo trước cho nhiều mục đích khác nhau từ cổng tài khoản Sandbox của bạn. Tài liệu API của SSL.com có ​​sẵn vào đây.

Sử dụng Sandbox với SSL Manager

Nếu bạn đang sử dụng SSL Manager, Ứng dụng Windows của SSL.com để đặt hàng và quản lý chứng chỉ kỹ thuật số, thật dễ dàng thiết lập để sử dụng Hộp cát.

1. SSL ManagerCửa sổ chính của sẽ hiển thị nếu phần mềm đang ở sản xuất or thử nghiệm chế độ. Ảnh chụp màn hình bên dưới hiển thị một phiên bản mới được cài đặt trong chế độ sản xuất:

   

2. Chuyển sang chê độ kiểm tra bằng cách điều hướng đến Cài đặt> SSL Manager API> SSL Manager API - Kiểm tra trong menu.
   
3. Nhấn vào OK để đóng hộp thoại.
   
4. SSL Manager hiện đang ở chê độ kiểm tra và sẽ sử dụng Sandbox chứ không phải API sản xuất.
   
5. Đăng nhập vào tài khoản Hộp cát của bạn bằng cách chọn Tài khoản> Đăng nhập khách hàng từ trình đơn.
   
6. Nhập Hộp cát của bạn Đăng nhập và Mật khẩu, Sau đó nhấp vào Đăng nhập .
   
7. Một hộp thoại sẽ xuất hiện hướng dẫn bạn cấp quyền truy cập vào tài khoản trong cổng thông tin điện tử. Đầu tiên, nhấp vào OK nút để loại bỏ hộp thoại.
   
8. Tiếp theo, đăng nhập vào Sandbox trong một trình duyệt web. Nếu bạn đã thiết lập nhiều nhóm trong Hộp cát, hãy đảm bảo rằng nhóm bạn muốn sử dụng được đặt ở Đội ngũ hiện tại.
   
9. Điều hướng đến Đơn Đặt Hàng tab, sau đó nhấp SSL Manager Ứng Dụng liên kết.
   
10. Xác định vị trí của SSL Manager trong danh sách và bấm vào chưa giải quyết liên kết.
    
11. Nhấp chuột OK để xác nhận rằng bạn muốn thêm SSL Manager ví dụ cho tài khoản của bạn.
    
12. Tình trạng của SSL Manager phiên bản bây giờ sẽ được hiển thị là hoạt độngvà bây giờ bạn có thể sử dụng ứng dụng để tạo đơn hàng thử nghiệm trong Hộp cát. Để biết chi tiết đầy đủ về làm việc với các đơn đặt hàng và chứng chỉ trong SSL Manager, vui lòng tham khảo tài liệu hướng dẫn.