Brug af SSL.com Sandbox til test og integration

For nemheds skyld for brugere og udviklere opretholder SSL.com en sandkasse testinstans, en klon af vores produktionsudgivelse af SSL.com-portalen og SWS API. Sandkassen er som et "laboratorium", hvor du frit kan eksperimentere med SSL.coms tjenester uden frygt for at bryde noget vigtigt eller ved et uheld bruge rigtige penge. Test i Sandbox er især vigtigt, når man udvikler automatiseringsløsninger med SSL.com RESTful SWS API. Ordrer og transaktioner i sandkassen er ikke direkte og kan i forlængelse heraf ikke faktureres.

Denne vejledning kommer i gang med opsætning af en Sandkasse-konto, skaber en testordre i online-portalen ved hjælp af Sandbox med SSL.com's SWS API, og sammenkæde en forekomst af SSL Manager til sandkassen.

Kom godt i gang

Opsætning af en Sandbox-konto

1. Inden du kan begynde at bruge Sandbox, skal du oprette en Sandbox-konto. Dette gælder, selvom du allerede har et SSL.com kunde or forhandler konto. For at komme i gang skal du navigere til https://sandbox.ssl.com/login. Du kan bekræfte, at du logger ind på Sandkassen ved at kigge efter et grønt alarmbanner øverst i vinduet, der viser "SSL.com Sandbox. Dette er et testmiljø for api-ordrer. Transaktioner og ordrer er ikke live. ”
   
2. Klik Opret en ny konto.
   
3. Indtast dit ønskede brugernavn og din e-mail-adresse, og klik derefter på Registrer .
   
4. Du vil nu blive returneret til login-siden. Du skal se et nyt grønt alarmeringsbanner, der siger, at kontoen er oprettet.
   
5. Åbn din e-mail-klient, og se efter en ny besked med titlen "SSL.com brugervejledning til aktivering af brugerkonti." Åbn meddelelsen, og klik på aktiveringslinket.
   
6. Opret en ny, sikker adgangskode på den side, der åbnes, indtast den igen til bekræftelse, klik på afkrydsningsfeltet til abonnentaftalen og klik på Send knap. Din adgangskode skal være mindst 8 tegn lang og skal indeholde mindst et lille bogstav, et stort bogstav, et numerisk tegn og et specialtegn.
   
7. Efter at have klikket Send, vil du blive logget ind på din nye Sandbox-konto. Du skal se et grønt advarselsfelt, der angiver, at din konto er blevet aktiveret.
   
8. Du kan logge ind på sandkassen ved at navigere til https://sandbox.ssl.com/login og indtastning af de legitimationsoplysninger, du oprettede ovenfor.
   
9. Du kan nu arbejde med Sandbox i en webbrowser ligesom du ville gøre i SSL.com's brugerportal, med den største forskel, at ordrer i Sandbox ikke er live og ikke involverer rigtige penge og certifikater. Sandkassen er derfor en fantastisk måde at eksperimentere med portalens funktionalitet uden risiko. Se vores brugerportal dokumentation når du arbejder med Sandbox i en webbrowser.
   

Oprettelse af en testordre i Sandbox-portalen

1. Når din Sandbox-konto er oprettet, kan du begynde at lave testordrer. For at komme i gang med at foretage testordrer i portalen skal du klikke på udviklingsværktøjer link, placeret under udviklere og integration overskrift.
   
2. Developer Tools vinduet åbnes. Start med at vælge den type certifikat, du vil bestille fra Produkt radioknapper, placeret under Formular indleveringsmetode overskrift. I dette tilfælde opretter vi en EV-kodesigneringsordre.
   
3. Derefter skal du rulle ned og vælge en tidsperiode (i dage) for ordren. Her går vi med 365 dage.
   
4. Når du er færdig med at vælge produkt og tidsperiode, skal du klikke på Opret testordre .
   
5. En dialogboks vises. Klik på OK.
   
6. Din testordre oprettes, og du vil blive returneret til listen over ordrer i portalen. Bemærk, at ordren er forud for "(TEST)," for at indikere, at det er en testordre, der er oprettet i sandkassen. Du kan fortsætte med at arbejde med denne ordre i Sandbox lige som om det var en rigtig ordre. (For mere information om at arbejde med ordrer i portalen, se venligst vores vejlede.)
   

Brug af Sandbox med SSL.coms SWS API

SSL.com s RESTful SWS API er et kraftfuldt værktøj til automatisering af certifikatbestilling og styring. Ved hjælp af Sandbox kan du grundigt teste dine API-opkald og scripts i et sikkert miljø, før du arbejder med rigtige certifikater (og rigtige penge!).

Grundlæggende

1. For at udføre API-opkald til Sandbox skal du blot bruge denne URL i dine scripts:

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

2. Når din automatisering er testet og klar, skal du skifte til produktions-API-URL:

   https://sws.sslpki.com/

Oprettelse af en testordre med API

1. Online-portalen indeholder en skabelon til en API-kommando til oprettelse af et certifikat. For at finde den skal du først klikke på udviklingsværktøjer link på dit betjeningspanel:
   
2. Rul derefter ned til API-opkaldsmetode.
   
3. Før du kan bruge kommandoen, skal du tilføje dine egne API-legitimationsoplysninger. Klip og indsæt API Opret SSL-certifikatkommando ind i en teksteditor:
   
   Bemærk: Kommando- og JSON-eksempler er blevet formateret med linjeskift for læsbarhed i denne vejledning. Et tilbageslagstegn (\) efterfulgt af en linjeskift giver dig mulighed for at bryde en lang kommando i flere linjer i en Linux / UNIX-terminal.

    

   curl -k -H "Accepter: application/json" \ -H "Indholdstype: application/json" \ -X POST \ -d "{\"account_key\":\"\",\"secret_key\": \"\",\"produkt\":\"106\",\"periode\":\"365\"}" \ https://sws-test.sslpki.com/certificates

4. For at få adgang til dine API-legitimationsoplysninger skal du vende tilbage til portalens dashboard og klikke på api-legitimationsoplysninger.

   

5. For at bruge kommandoen skal du bruge din konto nøgle og hemmelig nøgle. Du kan kopiere dem til udklipsholderen ved at klikke på ikonerne til højre for tasterne. Du kan også vælge og kopiere disse værdier direkte, men for den hemmelige nøgle skal du klikke på Klik for at se først.

   

6. Tilføj din kontonøgle og hemmelige nøgle til kommandoen som vist nedenfor:

   curl -k -H "Accepter: 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/certificates

7. Du kan nu indsætte kommandoen i en terminal og køre den. Kommandoen returnerer et JSON-objekt, der beskriver ordren.

   { "ref":"co-991f7pdt0", "registrant":{ "organisation":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":"ubrugt. venter på anmodning om certifikatsignering (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":{ "ref" :"co-991f7pdt0-0" } }

8. Tilbage til Mine Ordrer fanen i Sandbox-portalen for at se den nye testordre.
   
9. Du kan ændre den type certifikat, du bestiller ved at ændre produktnummer i kommandoen. Produktnumre vises på udviklingsværktøjer side:
   
10. For eksempel, hvis vi vil bestille et EV-kodesigneringscertifikat i stedet for et grundlæggende SSL /TLS certifikat, kan vi blot ændre \"product\":\"106\" til \"product\":\"360\" i vores API-kommando.
11. Vi kan også vælge en længere varighed ved at ændre \"period\":\"365\" til \"period\":\"730\". Så en kommando til et 730-dages EV-kodesigneringscertifikat ser sådan ud (selvfølgelig, i det virkelige liv vil du medtage dit eget account_key og secret_key.):

     

    curl -k -H "Accepter: 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/certificates

De næste trin

Der er meget mere, du kan gøre med SWS API i Sandbox. Vores introduktionsvejledning til API dækker certifikatordrer meget mere detaljeret. Du kan også hente pregenererede API-opkald til forskellige formål fra din Sandbox-konto portal. SSL.coms API-dokumentation er tilgængelig link..

Brug af sandkassen med SSL Manager

Hvis du bruger SSL Manager, SSL.coms Windows-applikation til bestilling og styring af digitalt certifikat, er det let at indstille det til at bruge Sandbox.

1. SSL ManagerHovedvinduet vises, hvis softwaren er i produktion or prøve mode. Skærmbillede nedenfor viser en nyligt installeret instans i produktionstilstand:

   

2. Skift til test mode ved at navigere til Indstillinger> SSL Manager API> SSL Manager API - test i menuen.
   
3. Klik på knappen OK knappen for at lukke dialogboksen.
   
4. SSL Manager er nu inde test mode og vil bruge Sandbox i stedet for produktions-API.
   
5. Log ind på din Sandbox-konto ved at vælge Konto> Kundelogin fra menuen.
   
6. Indtast din sandkasse Login og Adgangskode, og klik derefter på Login .
   
7. En dialogboks vises, der leder dig til at give adgang til kontoen i webportalen. Klik først på OK for at afvise dialogboksen.
   
8. Dernæst log ind på sandkassen i en webbrowser. Hvis du har oprettet flere hold i Sandbox, skal du sørge for, at det hold, du vil bruge, er indstillet til Nuværende hold.
   
9. Naviger til Mine Ordrer fanebladet, og klik derefter på SSL Manager Apps .
   
10. Find forekomsten af SSL Manager i listen og klik på knappen Verserende .
    
11. Klik OK for at bekræfte, at du vil tilføje SSL Manager instans til din konto.
    
12. Status for SSL Manager instans vises nu som Aktiv , og du kan nu bruge applikationen til at oprette testordrer i Sandbox. For alle detaljer om arbejde med ordrer og certifikater i SSL Manager, se venligst vores dokumentation.