PUQ Mautic

SSL Manager - SSL Certificates

PUQcloud Panel

Order Now | Download | FAQ

Overview

The SSL Certificates section is your single place to issue, renew, import, and store SSL/TLS certificates.

Each certificate page is split into two columns:

Where to find it: Settings → SSL Manager → SSL Certificates


What you can do

The private key is encrypted in the database and visible only on the certificate’s page.


Certificates list

The list shows:


Create a certificate (step-by-step)

  1. Click + Create in SSL Certificates.

  2. Fill in:

    • Domain — primary domain (CN).

    • Certificate Authority — select a CA profile (e.g., Let’s Encrypt / ZeroSSL).

    • Aliases — SAN domains, one per line (optional).

  3. Click Save — this only saves form data (no keys or certificate yet).

  4. Click Generate CSR:

    • The system creates the CSR and Private Key (they do not exist before this step).

    • The private key is encrypted in DB; it is only visible on this page.

  5. Status switches to Pending. The panel shows instructions to create a CNAME for _acme-challenge.<domain> pointing into your tech zone (e.g., acme.puqcloud.com).

  6. Once the CNAME resolves, issuance starts automatically. When finished, the card turns Active and shows all metadata/PEMs.


Certificate page — left column fields

Top block (editable in Draft)
Domain & Organization
CA / Crypto / Metadata
Actions

In Draft, the upper part of the left column is editable; after issuance, many fields become read-only.


Workflow: statuses & transitions

  1. Draft

    • Edit primary fields (domain, SANs, email, ToS, auto-renew threshold).

    • Save only stores data; no key/CSR is created.

  2. Generate CSR

    • Creates CSR and Private Key (encrypted; visible only on this page).

    • Crypto fields/PEM blocks appear.

  3. Pending (CNAME → tech zone)

    • The panel displays the exact CNAME instruction for _acme-challenge.<domain> → into your tech zone.

    • As soon as the CNAME resolves, the panel continues issuance (DNS-01).

  4. Active

    • Certificate is issued; Certificate PEM is available; a success panel shows “Certificate is active!”.

    • Days Remaining and Auto Renew operate; crypto/metadata are filled.

  5. Expired / Error / Revoked

    • Expired — reissue/renew required.

    • Error — check logs/CA setup/DNS path.

    • Revoked — revoked per CA policy.


Auto-renewal


Importing an existing certificate (if used)

  1. Open SSL Certificates → + Import (or equivalent).

  2. Paste CRT / Private Key / CA Bundle in PEM.

  3. Save and verify validity/expiry.

  4. Configure Auto Renew manually if needed (imports are usually not tied to ACME).


Key security


Troubleshooting

Symptom Likely cause Fix
Stuck in Pending CNAME not resolving / wrong target Verify _acme-challenge.<domain> name and target in tech zone; wait for TTL.
Issuance doesn’t start CSR not generated Click Generate CSR, then follow CNAME steps.
No “Certificate is active!” after CNAME DCV incomplete / CA error Check logs; ensure the tech zone is publicly resolvable.
Auto-renew doesn’t trigger Bad Auto Renew Days or broken CNAME Use a sensible threshold (e.g., 7) and verify CNAME/tech zone.
PEM mismatch on import Key/cert pair doesn’t match Import the correct pair or reissue.


Revision #4
Created 7 November 2025 15:12:54 by Yuliia Noha
Updated 13 November 2025 13:43:49 by Yuliia Noha