|
1
|
|
|
<?php |
|
2
|
|
|
|
|
3
|
|
|
namespace Cloudflare\Zone; |
|
4
|
|
|
|
|
5
|
|
|
use Cloudflare\Api; |
|
6
|
|
|
|
|
7
|
|
|
/** |
|
8
|
|
|
* CloudFlare API wrapper |
|
9
|
|
|
* |
|
10
|
|
|
* Custom SSL for a Zone |
|
11
|
|
|
* |
|
12
|
|
|
* @author James Bell <[email protected]> |
|
13
|
|
|
* |
|
14
|
|
|
* @version 1 |
|
15
|
|
|
*/ |
|
16
|
|
|
class CustomSSL extends Api |
|
17
|
|
|
{ |
|
18
|
|
|
/** |
|
19
|
|
|
* List SSL configurations (permission needed: #ssl:edit) |
|
20
|
|
|
* List, search, sort, and filter all of your custom SSL certificates |
|
21
|
|
|
* |
|
22
|
|
|
* @param string $zone_identifier API item identifier tag |
|
23
|
|
|
* @param string|null $status Status of the zone's custom SSL |
|
24
|
|
|
* @param int|null $page Page number of paginated results |
|
25
|
|
|
* @param int|null $per_page Number of zones per page |
|
26
|
|
|
* @param string|null $order Field to order certificates by (status, issuer, priority, expires_on) |
|
27
|
|
|
* @param string|null $direction Direction to order domains (asc, desc) |
|
28
|
|
|
* @param string|null $match Whether to match all search requirements or at least one (any) (any, all) |
|
29
|
|
|
*/ |
|
30
|
|
|
public function list_certificates($zone_identifier, $status = null, $page = null, $per_page = null, $order = null, $direction = null, $match = null) |
|
31
|
|
|
{ |
|
32
|
|
|
$data = [ |
|
33
|
|
|
'status' => $status, |
|
34
|
|
|
'page' => $page, |
|
35
|
|
|
'per_page' => $per_page, |
|
36
|
|
|
'order' => $order, |
|
37
|
|
|
'direction' => $direction, |
|
38
|
|
|
'match' => $match, |
|
39
|
|
|
]; |
|
40
|
|
|
|
|
41
|
|
|
return $this->get('zones/'.$zone_identifier.'/custom_certificates', $data); |
|
42
|
|
|
} |
|
43
|
|
|
|
|
44
|
|
|
/** |
|
45
|
|
|
* Create SSL configuration (permission needed: #ssl:edit) |
|
46
|
|
|
* Upload a new SSL certificate for a zone |
|
47
|
|
|
* |
|
48
|
|
|
* @param string $zone_identifier API item identifier tag |
|
49
|
|
|
* @param string $certificate The zone's private key |
|
50
|
|
|
* @param string $private_key The zone's SSL certificate or certificate and the intermediate(s) |
|
51
|
|
|
* @param string|null $bundle_method A ubiquitous bundle is a bundle that has a higher probability of being verified everywhere, |
|
52
|
|
|
* even by clients using outdated or unusual trust stores. An optimal bundle is a bundle with the shortest chain and newest |
|
53
|
|
|
* intermediates. A forced method attempt to use the certificate/chain as defined by the input "ubiquitous" |
|
54
|
|
|
*/ |
|
55
|
|
|
public function create($zone_identifier, $certificate, $private_key, $bundle_method = null) |
|
56
|
|
|
{ |
|
57
|
|
|
$data = [ |
|
58
|
|
|
'certificate' => $certificate, |
|
59
|
|
|
'private_key' => $private_key, |
|
60
|
|
|
'bundle_method' => $bundle_method, |
|
61
|
|
|
]; |
|
62
|
|
|
|
|
63
|
|
|
return $this->post('zones/'.$zone_identifier.'/custom_certificates', $data); |
|
64
|
|
|
} |
|
65
|
|
|
|
|
66
|
|
|
/** |
|
67
|
|
|
* SSL configuration details (permission needed: #ssl:read) |
|
68
|
|
|
* |
|
69
|
|
|
* @param string $zone_identifier API item identifier tag |
|
70
|
|
|
* @param string $identifier |
|
71
|
|
|
*/ |
|
72
|
|
|
public function details($zone_identifier, $identifier) |
|
73
|
|
|
{ |
|
74
|
|
|
return $this->get('zones/'.$zone_identifier.'/custom_certificates/'.$identifier); |
|
75
|
|
|
} |
|
76
|
|
|
|
|
77
|
|
|
/** |
|
78
|
|
|
* Create a Keyless SSL configuration (permission needed: #ssl:edit) |
|
79
|
|
|
* |
|
80
|
|
|
* @param string $zone_identifier API item identifier tag |
|
81
|
|
|
* @param string $identifier |
|
82
|
|
|
* @param string $private_key The zone's SSL certificate or certificate and the intermediate(s) |
|
83
|
|
|
* @param string $certificate The zone's private key |
|
84
|
|
|
* @param string|null $bundle_method A ubiquitous bundle is a bundle that has a higher probability of being verified everywhere, |
|
85
|
|
|
* even by clients using outdated or unusual trust stores. An optimal bundle is a bundle with the shortest chain and newest |
|
86
|
|
|
* intermediates. A forced method attempt to use the certificate/chain as defined by the input "ubiquitous" |
|
87
|
|
|
*/ |
|
88
|
|
|
public function update($zone_identifier, $identifier, $private_key, $certificate, $bundle_method = null) |
|
|
|
|
|
|
89
|
|
|
{ |
|
90
|
|
|
$data = [ |
|
91
|
|
|
'certificate' => $certificate, |
|
92
|
|
|
'private_key' => $private_key, |
|
93
|
|
|
'bundle_method' => $bundle_method, |
|
94
|
|
|
]; |
|
95
|
|
|
|
|
96
|
|
|
return $this->patch('zones/'.$zone_identifier.'/custom_certificates/'.$identifier, $data); |
|
97
|
|
|
} |
|
98
|
|
|
|
|
99
|
|
|
/** |
|
100
|
|
|
* Re-prioritize SSL certificates (permission needed: #ssl:edit) |
|
101
|
|
|
* If a zone has multiple SSL certificates, you can set the order in which they should be used during a request. |
|
102
|
|
|
* |
|
103
|
|
|
* @param string $zone_identifier API item identifier tag |
|
104
|
|
|
* @param array $certificates Array of ordered certificates. |
|
105
|
|
|
*/ |
|
106
|
|
|
public function prioritize($zone_identifier, array $certificates) |
|
107
|
|
|
{ |
|
108
|
|
|
$data = [ |
|
109
|
|
|
'certificates' => $certificates, |
|
110
|
|
|
]; |
|
111
|
|
|
|
|
112
|
|
|
return $this->put('zones/'.$zone_identifier.'/custom_certificates/prioritize', $data); |
|
113
|
|
|
} |
|
114
|
|
|
|
|
115
|
|
|
/** |
|
116
|
|
|
* Delete an SSL certificate (permission needed: #ssl:edit) |
|
117
|
|
|
* |
|
118
|
|
|
* @param string $zone_identifier API item identifier tag |
|
119
|
|
|
* @param string $identifier |
|
120
|
|
|
*/ |
|
121
|
|
|
public function delete_ssl($zone_identifier, $identifier) |
|
122
|
|
|
{ |
|
123
|
|
|
return $this->delete('zones/'.$zone_identifier.'/custom_certificates/'.$identifier); |
|
124
|
|
|
} |
|
125
|
|
|
} |
|
126
|
|
|
|
jamesryanbell /
cloudflare
Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.
You can also find more detailed suggestions in the “Code” section of your repository.