The following endpoint supports domain-related actions.
https://{host}:{port}/<server.servlet.context-path>/v1/certificate-authorities/{caId}/domains/{domain}/actionsWhere:
{caId}is the Certificate Authority identifier. See below for CA-specific considerations on this endpoint.{domain}is the identifier of a domain added with the CA domains endpoint.
For example:
{ "action": { "properties": { "tagLocation": "store.example.com,example.com" }, "type": "ReverifyDomainAction", "verificationMethod": "dns" }}See below for a description of each parameter.
action.type
The identifier of the domain action. See below for the values supported by this parameter.
Value | Action |
|---|---|
ReverifyDomainAction | Verify a previously validated domain because the prior validation expired, failed, or must be refreshed to meet CA/Browser Forum or GlobalSign requirements. |
action.verificationMethod
The identifier of the domain verification method. See below for the values supported by this parameter.
Value | Verification |
|---|---|
dns | DNS‑based domain verification, GlobalSign requires a unique Domain Validation Code (DVC) in a DNS TXT record to confirm domain control. |
webServer | HTTP‑based verification, also called file‑based domain verification. GlobalSign requires a Domain Validation Code (DVC) on the web server to confirm domain control. |
action.properties.tagLocation
The location of the domain validation control number.
When providing multiple values, separate them with commas.
See below for sample values when verificationMethod is dns.
Value | Validated FQDN |
|---|---|
a.b.c.example.com,b.c.example.com,c.example.com,example.com | a.b.c.example.com |
store.example.com,example.com | store.example.com |
example.com | example.com |
See below for sample values when verificationMethod is webServer.
Value | Requested domains |
|---|---|
https://example.com/.well-known/pki-validation/gsdv.txt | *.example.comexample.com |
https://example.com/.well-known/pki-validation/gsdv.txt,https://sub.example.com/.well-known/pki-validation/gsdv.txt | *.sub.example.comsub.example.com |
https://example.com/.well-known/pki-validation/gsdv.txt,https://www.example.com/.well-known/pki-validation/gsdv.txt | *.www.example.comsub.example.com |