]>
Commit | Line | Data |
---|---|---|
f6072b06 AG |
1 | --- |
2 | layout: "statuscake" | |
3 | page_title: "StatusCake: statuscake_ssl" | |
4 | sidebar_current: "docs-statuscake-ssl" | |
5 | description: |- | |
6 | The statuscake_ssl resource allows StatusCake ssl tests to be managed by Terraform. | |
7 | --- | |
8 | ||
9 | # statuscake\_ssl | |
10 | ||
11 | The ssl resource allows StatusCake ssl tests to be managed by Terraform. | |
12 | ||
13 | ## Example Usage | |
14 | ||
15 | ```hcl | |
16 | resource "statuscake_ssl" "google" { | |
17 | domain = "https://www.google.com" | |
18 | contact_groups_c = "3,12" | |
19 | checkrate = 3600 | |
20 | alert_at = "18,71,344" | |
21 | alert_reminder = true | |
22 | alert_expiry = true | |
23 | alert_broken = false | |
24 | alert_mixed = true | |
25 | } | |
26 | ``` | |
27 | ||
28 | ## Argument Reference | |
29 | ||
30 | The following arguments are supported: | |
31 | ||
32 | * `domain` - (Required) URL to check, has to start with https:// | |
33 | * `contact_groups_c` - (Required) Contactgroup IDs, separated by a comma. Can be an empty string | |
34 | * `checkrate` - (Required) Checkrate in seconds. Accepted: [300, 600, 1800, 3600, 86400, 2073600] | |
35 | * `alert_at` - (Required) When you wish to receive reminders. Must be exactly 3 numeric values seperated by commas | |
36 | * `alert_reminder` - (Required) Set to true to enable reminder alerts. False to disable. Also see alert_at | |
37 | * `alert_expiry` - (Required) Set to true to enable expiration alerts. False to disable | |
38 | * `alert_broken` - (Required) Set to true to enable broken alerts. False to disable | |
39 | * `alert_mixed` - (Required) Set to true to enable mixed content alerts. False to disable | |
40 | ||
41 | ## Attributes Reference | |
42 | ||
43 | The following attribute is exported: | |
44 | ||
45 | * `ssl_id` - A unique identifier for the ssl test. | |
46 | * `issuer_cn` - | |
47 | * `paused` - Whether the test has been paused (Administrative only) | |
48 | * `cert_score` - Certificate score in % | |
49 | * `cipher_score` - Cipher strength in % | |
50 | * `cert_status` - Certificate status | |
51 | * `cipher` - Cipher code (SSL spec) | |
52 | * `valid_from_utc` - Certificate Validity Start (In UTC/GMT+0) | |
53 | * `valid_until_utc` - Certificate Validity End (In UTC/GMT+0) | |
54 | * `mixed_content` - Mixed content if present. Empty array if not. | |
55 | * `last_reminder` - The last reminder to be detected (days) | |
56 | * `last_updated_utc` - When the certificate has last been updated (Either by user action or by testing) | |
57 | * `flags` : | |
58 | * `is_extended` : Certificate has an Extended Validation certificate | |
59 | * `has_pfs` : Certificate has Perfect Forward Secrecy enabled | |
60 | * `is_broken` : Certificate has errors | |
61 | * `is_expired` : Certificate is expired | |
62 | * `is_missing` : Certificate not present | |
63 | * `is_revoked` : Certificate has been revoked by CA | |
64 | * `is_mixed` : Website contains Mixed Content | |
65 | ||
66 | ## Import | |
67 | ||
68 | StatusCake ssl tests can be imported using the ssl id, e.g. | |
69 | ||
70 | ``` | |
71 | tf import statuscake_ssl.example 123 | |
72 | ``` |