Web Services API

You must accept the End User Agreement before adding a Web Services API client to CC-SG. You can add up to five WS-API clients. See the CC-SG Web Services API Guide for details on using the API.

• To add a Web Services API:

1. Select Access > Add Web Services API. This option is available only for users with the CC Setup and Control Privilege.
2. Read the End User Agreement.
   • You can copy and paste the text to save it, or choose Secure Gateway > Print.
   • After you complete configuration, this agreement will also be available in the Access menu.
3. Click Accept. The New Web Services API Configuration window opens.
4. Type in the data requested about your web services client.
   • Web Services Client Name: Maximum 64 characters.
   • License Key: Your license key from Raritan. Each CC-SG unit must have a unique license key.
   • IP Address/Hostname: Maximum 64 characters.
   • HTTPS Web Services Port: Read-only field. CC-SG uses port 9443 when trust establishment is generated.
   • Licensed Vendor Name: Maximum 64 characters.
5. Generate a self-signed certificate.
   1. Encryption Mode: If Require AES Encryption between Client and Server is selected in the Administration > Security > Encryption screen, AES-128 is the default. If AES is not required, DES 3 is the default.
   2. Private Key Length: 2048 is the default.
   3. Validity Period (days): Maximum 4 numeric characters.
   4. Country Code: CSR tag is Country Name.
   5. State or Province: Maximum 128 characters. Type in the whole state or province name. Do not abbreviate.
   6. City/Locality: CSR tag is Locality Name. Maximum 128 characters.
   7. Registered Company Name: CSR tag is Organization Name. Maximum 64 characters.
   8. Division/Department Name: CSR tag is Organization Unit Name. Maximum 64 characters.
   9. Fully Qualified Domain Name: CSR tag is Common Name.
   10. Administrator Email Address: Type in the email address of the administrator who is responsible for the certificate request. Maximum 256 characters.
   11. Challenge Password: Maximum 64 characters.

       Note: The Challenge Password is used internally by CC-SG to generate the certificate. You do not need to remember it.

   12. Password: Enter a keystore password. Use this password to open the .P12 file that you will save in step 7. If you copy the generated certificate and import into your own keystore instead, you do not need to remember this keystore password.
6. Click Generate Certificate. The text appears in the Certificate box.
7. Click Save to File to save the certificate to a .P12 file. Or, copy the generated certificate and import it into your own keystore.
8. Click Add to save your changes.