GoGetSSL Renewal Prep
Overview
Renewals fail for boring reasons: the approver mailbox does not exist, the
CSR has the wrong common name or a 2048-bit key the client's policy forbids,
the product quoted does not cover the wildcard the client actually uses, or
the prepaid balance is short on the day. This skill checks each of those
with read-only GoGetSSL tools so the person placing the order in the
GoGetSSL client area gets it right first time.
This plugin cannot place, renew or reissue an order, resend a validation
email, or change a DCV method. Every tool used here is read tier and none is
admin-gated in Conduit.
Anti-triggers
Common Workflows
1. Start from the existing order
Call gogetssl_orders_get_status on the expiring order. Note:
- the product, so the renewal can match it
- the domains and SANs covered, so nothing is dropped
- the validation method used last time
end_date versus valid_till: if the order is still active, its reissue
flag allows a reissue, and the subscription runs past the certificate's
expiry, this is a reissue inside the paid period, and no purchase is
needed. Say when the subscription ends, because a renewal purchase is
still due at end_date
2. Pick and price the product
| Question |
Tool |
| Which products exist, and which support wildcard, SAN and which DCV methods? |
gogetssl_products_list |
| Brand, validation type (DV, OV, EV) and price per period |
gogetssl_products_list_ssl |
| Just the partner price per product and period |
gogetssl_products_list_prices |
| Warranty, free reissues, refund window, SAN and wildcard detail for one product |
gogetssl_products_get |
Match the validation type of the old certificate unless the client asked to
change it. Moving from OV to DV loses the organisation name in the
certificate, which some clients notice.
The prices returned are your partner cost, not what you charge the
client. Add your margin before quoting.
3. Confirm the email validation path
If the renewal will use email domain control validation, call
gogetssl_dcv_get_domain_emails with the bare domain (for example
contoso.com, no scheme, path or *.). It returns the addresses GoGetSSL
will accept, typically role addresses such as admin@ and hostmaster@ at
the domain. Use the list the tool returns rather than assuming.
Check that at least one of those mailboxes exists and that someone can read
it. If none does, plan on DNS (CNAME) or HTTP file validation instead, and
choose that method when the order is placed. This lookup is a read-only POST
and changes no order.
4. Check the CSR
If the client or their hosting provider supplied a CSR, pass the
-----BEGIN CERTIFICATE REQUEST----- block to gogetssl_csr_decode.
Compare the result against the order:
- common name matches the domain being renewed
- organisation and location are right for an OV or EV product
- SANs, if any, match what the client expects
- key size meets the client's policy
Never pass a private key. The tool refuses any input containing one, and
the plugin deliberately does not expose CSR generation because that returns
a private key. CSRs are limited to 4000 characters. This tool sends no
GoGetSSL credentials.
5. Check the balance
Call gogetssl_account_get_balance and compare it with the summed partner
prices of everything due. GoGetSSL takes payment from the prepaid balance,
so a short balance stops renewals. Also call gogetssl_orders_list_unpaid:
an unpaid order from an earlier attempt may already cover the domain.
Gotchas
gogetssl_dcv_get_domain_emails rejects wildcards. For a *.contoso.com
certificate, look up contoso.com.
- Prices come back per period. Multi-year subscriptions are usually cheaper
per year, but the certificate inside still has to be reissued as each one
expires. Check
gogetssl_products_get for the free reissue allowance.
- An LEI order is not a certificate. For LEI renewals, read the current
state with
gogetssl_lei_get_status (status, LEI code and validity dates);
the renewal itself is placed in the client area.
Related Skills
1---2name: gogetssl-renewal-prep3description: >4 Getting a GoGetSSL certificate renewal or reissue ready before anyone5 places it in the client area: choosing and pricing a product, checking6 wildcard and SAN support, confirming which approver email addresses email7 domain validation will accept, decoding the client's CSR to catch8 mistakes, and confirming the prepaid balance covers the renewals.9when_to_use: >-10 When an MSP is about to renew, replace or reissue a client certificate11 bought through GoGetSSL and wants the quote, validation path and CSR12 checked first. Use when: ssl renewal quote, certificate price, which ssl13 product, wildcard certificate cost, dcv approver email, domain validation14 email, check csr, decode csr, or enough balance to renew.15metadata:16 source: https://skillmd.com/skills/wyre-ai/gogetssl-renewal-prep17---1819# GoGetSSL Renewal Prep2021## Overview2223Renewals fail for boring reasons: the approver mailbox does not exist, the24CSR has the wrong common name or a 2048-bit key the client's policy forbids,25the product quoted does not cover the wildcard the client actually uses, or26the prepaid balance is short on the day. This skill checks each of those27with read-only GoGetSSL tools so the person placing the order in the28GoGetSSL client area gets it right first time.2930This plugin **cannot place, renew or reissue an order**, resend a validation31email, or change a DCV method. Every tool used here is read tier and none is32admin-gated in Conduit.3334## Anti-triggers3536- **Finding which certificates expire**: use37 [certificate-expiry](../certificate-expiry/SKILL.md) first, then come back38 here for each order that needs action.39- **Reconciling what renewals cost after the fact**: use40 [billing-reconciliation](../billing-reconciliation/SKILL.md).4142## Common Workflows4344### 1. Start from the existing order4546Call `gogetssl_orders_get_status` on the expiring order. Note:4748- the product, so the renewal can match it49- the domains and SANs covered, so nothing is dropped50- the validation method used last time51- `end_date` versus `valid_till`: if the order is still active, its reissue52 flag allows a reissue, and the subscription runs past the certificate's53 expiry, this is a **reissue** inside the paid period, and no purchase is54 needed. Say when the subscription ends, because a renewal purchase is55 still due at `end_date`5657### 2. Pick and price the product5859| Question | Tool |60|----------|------|61| Which products exist, and which support wildcard, SAN and which DCV methods? | `gogetssl_products_list` |62| Brand, validation type (DV, OV, EV) and price per period | `gogetssl_products_list_ssl` |63| Just the partner price per product and period | `gogetssl_products_list_prices` |64| Warranty, free reissues, refund window, SAN and wildcard detail for one product | `gogetssl_products_get` |6566Match the validation type of the old certificate unless the client asked to67change it. Moving from OV to DV loses the organisation name in the68certificate, which some clients notice.6970The prices returned are **your partner cost**, not what you charge the71client. Add your margin before quoting.7273### 3. Confirm the email validation path7475If the renewal will use email domain control validation, call76`gogetssl_dcv_get_domain_emails` with the bare domain (for example77`contoso.com`, no scheme, path or `*.`). It returns the addresses GoGetSSL78will accept, typically role addresses such as `admin@` and `hostmaster@` at79the domain. Use the list the tool returns rather than assuming.8081Check that at least one of those mailboxes exists and that someone can read82it. If none does, plan on DNS (CNAME) or HTTP file validation instead, and83choose that method when the order is placed. This lookup is a read-only POST84and changes no order.8586### 4. Check the CSR8788If the client or their hosting provider supplied a CSR, pass the89`-----BEGIN CERTIFICATE REQUEST-----` block to `gogetssl_csr_decode`.90Compare the result against the order:9192- common name matches the domain being renewed93- organisation and location are right for an OV or EV product94- SANs, if any, match what the client expects95- key size meets the client's policy9697Never pass a private key. The tool refuses any input containing one, and98the plugin deliberately does not expose CSR generation because that returns99a private key. CSRs are limited to 4000 characters. This tool sends no100GoGetSSL credentials.101102### 5. Check the balance103104Call `gogetssl_account_get_balance` and compare it with the summed partner105prices of everything due. GoGetSSL takes payment from the prepaid balance,106so a short balance stops renewals. Also call `gogetssl_orders_list_unpaid`:107an unpaid order from an earlier attempt may already cover the domain.108109## Gotchas110111- `gogetssl_dcv_get_domain_emails` rejects wildcards. For a `*.contoso.com`112 certificate, look up `contoso.com`.113- Prices come back per period. Multi-year subscriptions are usually cheaper114 per year, but the certificate inside still has to be reissued as each one115 expires. Check `gogetssl_products_get` for the free reissue allowance.116- An LEI order is not a certificate. For LEI renewals, read the current117 state with `gogetssl_lei_get_status` (status, LEI code and validity dates);118 the renewal itself is placed in the client area.119120## Related Skills121122- [certificate-expiry](../certificate-expiry/SKILL.md): find what needs renewing123- [billing-reconciliation](../billing-reconciliation/SKILL.md): balance and invoices124- [api-patterns](../api-patterns/SKILL.md): argument formats and errors