Deleting Certificates

Use the remove operation to remove one or more certificates within one repository, whether it is a particular site repository or Administrator's repository.

In this chapter:

Request Packet Structure

Response Packet Structure

Samples

 

Request Packet Structure

A request XML packet that deletes certificate should include the remove operation node:

<packet>
<certificate>
   <remove>
   ...
   </remove>
</certificate>
</packet>

 

The remove node does not have a separate type, it is nested within type CertificateActionRequest (certificate_input.xsd). The remove node has the following graphical representation:

Remarks

1. The filter node allows specifying multiple certificate names, which gives you opportunity to delete several certificates within one remove operation.

<packet>
<certificate>
<remove>
   <filter>
      <name>cert_1</name>
      <name>cert_2</name>
      <name>cert_3</name>
      <name>cert_4</name>
   </filter>
    ...
</remove>
</certificate>
</packet>

 

2. With a single remove operation, you can delete certificates from only one repository which is defined with required webspace or admin node. In other words, you should use either webspace node, or admin node within remove operation nodes:

<packet>
<certificate>
<remove>
   <filter> ... </filter>
   <webspace>site1.com</webspace>
</remove>
</certificate>
</packet>

 

or

<packet>
<certificate>
<remove>
   <filter> ... </filter>
   <admin/>
</remove>
</certificate>
</packet>

 

3. With one packet, you can remove multiple different certificates from any of the repositories you own. To do this, use the required number of remove nodes in the packet:

<packet>
<certificate>
<remove>
 ...
</remove>

<remove>
 ...
</remove>
</certificate>
</packet>

Important: When creating request packets, put nodes and elements in the order they follow in the packet structure.

 

 

Response Packet Structure

The remove node of the output XML packet is structured as follows:

 

 

Samples

Removing certificate

This packet removes certificate called common from repository of webspace doe.de.

<packet>
<certificate>
<remove>
   <filter>
      <name>common</name>
   </filter>
   <webspace>doe.de</webspace>
</remove>
</certificate>
</packet>

Response:

<packet version="1.4.2.0">
<certificate>
<remove>
   <result>
      <status>ok</status>
   </result>
</remove>
</certificate>
</packet>
Removing several certificates

This packet removes three certificates: general, personal, sample.

Certificate general is installed to the Administrator's repository. Certificates personal and sample are installed to the repository of webspace johndoe.org.

<packet>
<certificate>
<remove>
   <filter>
      <name>general</name>
   </filter>
   <admin/>
</remove>
<remove>
   <filter>
      <name>personal</name>
      <name>sample</name>
   </filter>
      <webspace>johndoe.org</webspace>
</remove>
</certificate>
</packet>

Response:

<packet version="1.4.2.0">
<certificate>
<remove>
   <result>
      <status>ok</status>
   </result>
</remove>
<remove>
   <result>
      <status>ok</status>
   </result>
   <result>
      <status>ok</status>
   </result>
</remove>
</certificate>
</packet>