Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 18 Next »

SSL Certificate API

The SSL Certificate API supports enrolling new certificate requests, renewing existing certificates and collecting certificates. See the SSL Certificate API documentation for details.

Client Certificate API

TODO: Add additional paragraphs describing the high level functions of any other available certificate APIs.

Reporting API

Allows the Administrator to get Activity Log Report, Client Certificates Report, SSL Certificates Report, Discovery Scan Log Report, Discovery Scan Detail Report and the Latest Discovery Scan Log Report.

See https://support.comodo.com/index.php?_m=downloads&_a=viewdownload&downloaditemid=113

Technology

The Comodo APIs may be accessed with a SOAP client. For example, see the demo python client contributed by Jason Phelps from the University of Texas.

Support

Email support for the API is available at cmapi@comodo.com, Monday through Friday, 4 AM - 8 PM Eastern Time. See the Certificate Service support page for a detailed listing of all support options. You may need to also copy your request to csmsupport@comodo.com; see 'Known Issues' below.

Documentation

PDF documentation for the SSL Certificate API and the Client Certificate API are linked on the repository page. Comodo also provides online API documentation.

Status Codes

The SSL and Client APIs share a common set of status codes. If you stumble onto an undocumented status code or error condition, please file a bug with Comodo. It would benefit other API users if you also documented your experiences here on this wiki page.

TODO: Add a link to the Bug tracking system.

Basic information about the possible error codes is provided in the Comodo API documentation but some of the error codes can have multiple causes. Additional anecdotal details may be provided here as a community reference.

  • -14 = An unknown error occurred! Check that the login_uri parameter of your authData object is set to 'InCommon'.
  • -32 = The two phrase should be the same! Check your revocation phrase ('phrase' parameter). It appears that it cannot be left as empty string.
  • -37 - (Undocumented). This has been confirmed to be a bug by Comodo support. See 'Known Issues', below.

Known Issues

  • As of 4/18 cmapi@comodo.com does not yet issue a support ticket when emailed. csmsupport@comodo.com have been helpful in answering questions in the meantime.
  • Undocumented error -37 returned by the SSL API. This will be corrected in the next (unscheduled) release. This issue only affects the SSL Certificate API, and not SMIME. (Per support ticket NJP-793886)

Community

InCommon maintains an email list, inc-cert@incommon.org, as a place for community members to share experiences, discuss possible system enhancements, and see how other campuses handle various issues and tasks. We encourage you to join this list. To do so, send an email to sympa@incommon.org with the following in the subject line: sub inc-cert FirstName LastName.

No files shared here yet.
  • No labels