Add certificates using Postman API

You can add and update certificates through an API request using the Postman app.

To add or update certificates, do as follows:

1. Turn on API configuration, and enter the IP addresses from which you want to send the API requests.
2. Upload the certificate and private key files to Postman and send an XML request.

Allow API access

Allow configuration using the API, and enter the IP address from which you want to allow access.

1. Go to Backup and firmware > API.
2. Select API configuration.

3. For Allowed IP address, enter the IP address from which you'll make the API request and click the add button.

   Here's an example:

   

   To find your IP address, go to Log viewer and select Admin in the drop-down list. The source IP address shows the IP address with which you're accessing the web admin console.

4. Click Apply.

Post a certificate using Postman

Send a post request with the certificate, private key files, and the XML request using the Postman desktop app.

1. Download the Postman desktop app compatible with your operating system.

   By default, the app uses your computer's configuration (including the IP address) to send API requests.

2. On your computer, store the certificate and the private key files in the following folder:

   C:/Users/[yourname]/Postman/files

3. Open the Postman app and click New in your workspace.

   

4. Click HTTP Request.

   

5. Click Save.

   

6. Enter a Request name, select a collection, and click Save.

   Alternatively, click New folder to create a collection.

   

7. Select POST in the drop-down list and enter the following URL:

   https://[Firewall IP address]:[Port]/webconsole/APIController

   

8. Select Body and then select form-data.

   

9. Specify the certificate as follows:

   1. Under Key, enter a name for the certificate and select File from the drop-down list.

      

   2. Under Value, click Select files and select the certificate file you stored on your computer.

      

10. Specify the private key as follows:

    1. Enter a name for the private key and select File from the drop-down list.
    2. Under Value, click Select files and select the private key file you stored on your computer.

11. Specify the request as follows:

    1. Under Key, enter reqxml.
    2. Under Value, enter the following request:

    <Request><Login><Username>xxxxx</Username><Password>xxxxx</Password></Login><Set><Certificate transactionid="10"><Name>TestCertificate</Name><Action>UploadCertificate</Action><CertificateFormat>pem</CertificateFormat><CertificateFile>TestCertificate.pem</CertificateFile><PrivateKeyFile>TestCertificate.key</PrivateKeyFile></Certificate></Set></Request>
    

    You can enter a transaction ID if you want to identify the request. In this example, the transaction ID is set to 10. See the above request.

    Note

    Sophos Firewall uses a Set request rather than the Post request Postman uses.

    

12. Click Send.

    

13. Scroll down and click Body to see the status of the request.

    

14. On the web admin console of Sophos Firewall, go to Certificates > Certificates and check if the certificate is listed.

More resources

• API
• Allow API access to administrators
• Import export