1
|
|
|
<?php |
2
|
|
|
|
3
|
|
|
/* |
4
|
|
|
* ***************************************************************************** |
5
|
|
|
* Contributions to this work were made on behalf of the GÉANT project, a |
6
|
|
|
* project that has received funding from the European Union’s Framework |
7
|
|
|
* Programme 7 under Grant Agreements No. 238875 (GN3) and No. 605243 (GN3plus), |
8
|
|
|
* Horizon 2020 research and innovation programme under Grant Agreements No. |
9
|
|
|
* 691567 (GN4-1) and No. 731122 (GN4-2). |
10
|
|
|
* On behalf of the aforementioned projects, GEANT Association is the sole owner |
11
|
|
|
* of the copyright in all material which was developed by a member of the GÉANT |
12
|
|
|
* project. GÉANT Vereniging (Association) is registered with the Chamber of |
13
|
|
|
* Commerce in Amsterdam with registration number 40535155 and operates in the |
14
|
|
|
* UK as a branch of GÉANT Vereniging. |
15
|
|
|
* |
16
|
|
|
* Registered office: Hoekenrode 3, 1102BR Amsterdam, The Netherlands. |
17
|
|
|
* UK branch address: City House, 126-130 Hills Road, Cambridge CB2 1PQ, UK |
18
|
|
|
* |
19
|
|
|
* License: see the web/copyright.inc.php file in the file structure or |
20
|
|
|
* <base_url>/copyright.php after deploying the software |
21
|
|
|
*/ |
22
|
|
|
|
23
|
|
|
namespace core\common; |
24
|
|
|
|
25
|
|
|
/** |
26
|
|
|
* This class contains a number of functions for talking to the outside world |
27
|
|
|
* @author Stefan Winter <[email protected]> |
28
|
|
|
* @author Tomasz Wolniewicz <[email protected]> |
29
|
|
|
* @author Maja Górecka-Wolniewicz <[email protected]> |
30
|
|
|
* |
31
|
|
|
* @package Developer |
32
|
|
|
*/ |
33
|
|
|
class OutsideComm extends Entity |
34
|
|
|
{ |
35
|
|
|
|
36
|
|
|
/** |
37
|
|
|
* downloads a file from the internet |
38
|
|
|
* @param string $url the URL to download |
39
|
|
|
* @param int $timeout the timeout to download |
40
|
|
|
* @return string|boolean the data we got back, or FALSE on failure |
41
|
|
|
*/ |
42
|
|
|
public static function downloadFile($url, $timeout=0) |
43
|
|
|
{ |
44
|
|
|
$loggerInstance = new \core\common\Logging(); |
45
|
|
|
if (!preg_match("/:\/\//", $url)) { |
46
|
|
|
$loggerInstance->debug(3, "The specified string does not seem to be a URL!"); |
47
|
|
|
return FALSE; |
48
|
|
|
} |
49
|
|
|
# we got a URL, download it |
50
|
|
|
if ($timeout > 0) { |
51
|
|
|
$download = @fopen($url, 'rb', false, stream_context_create(['http' => ['timeout' => $timeout]])); |
52
|
|
|
} else { |
53
|
|
|
$download = fopen($url, "rb"); |
54
|
|
|
} |
55
|
|
|
if ($download === FALSE) { |
56
|
|
|
$loggerInstance->debug(2, "Failed to open handle for $url \n"); |
57
|
|
|
return FALSE; |
58
|
|
|
} |
59
|
|
|
$data = stream_get_contents($download); |
60
|
|
|
if ($data === FALSE) { |
61
|
|
|
$loggerInstance->debug(2, "Failed to download the file from $url"); |
62
|
|
|
return FALSE; |
63
|
|
|
} |
64
|
|
|
return $data; |
65
|
|
|
} |
66
|
|
|
|
67
|
|
|
/** |
68
|
|
|
* create an email handle from PHPMailer for later customisation and sending |
69
|
|
|
* @return \PHPMailer\PHPMailer\PHPMailer |
70
|
|
|
*/ |
71
|
|
|
public static function mailHandle() |
72
|
|
|
{ |
73
|
|
|
// use PHPMailer to send the mail |
74
|
|
|
$mail = new \PHPMailer\PHPMailer\PHPMailer(); |
75
|
|
|
$mail->isSMTP(); |
76
|
|
|
$mail->Port = 587; |
77
|
|
|
$mail->SMTPSecure = 'tls'; |
78
|
|
|
$mail->Host = \config\Master::MAILSETTINGS['host']; |
79
|
|
|
if (\config\Master::MAILSETTINGS['user'] === NULL && \config\Master::MAILSETTINGS['pass'] === NULL) { |
80
|
|
|
$mail->SMTPAuth = false; |
81
|
|
|
} else { |
82
|
|
|
$mail->SMTPAuth = true; |
83
|
|
|
$mail->Username = \config\Master::MAILSETTINGS['user']; |
84
|
|
|
$mail->Password = \config\Master::MAILSETTINGS['pass']; |
85
|
|
|
} |
86
|
|
|
$mail->SMTPOptions = \config\Master::MAILSETTINGS['options']; |
87
|
|
|
// formatting nitty-gritty |
88
|
|
|
$mail->WordWrap = 72; |
89
|
|
|
$mail->isHTML(FALSE); |
90
|
|
|
$mail->CharSet = 'UTF-8'; |
91
|
|
|
$configuredFrom = \config\Master::APPEARANCE['from-mail']; |
92
|
|
|
$mail->From = $configuredFrom; |
93
|
|
|
// are we fancy? i.e. S/MIME signing? |
94
|
|
|
if (isset(\config\Master::MAILSETTINGS['certfilename'], \config\Master::MAILSETTINGS['keyfilename'], \config\Master::MAILSETTINGS['keypass'])) { |
95
|
|
|
$mail->sign(\config\Master::MAILSETTINGS['certfilename'], \config\Master::MAILSETTINGS['keyfilename'], \config\Master::MAILSETTINGS['keypass']); |
96
|
|
|
} |
97
|
|
|
return $mail; |
98
|
|
|
} |
99
|
|
|
|
100
|
|
|
const MAILDOMAIN_INVALID = -1000; |
101
|
|
|
const MAILDOMAIN_NO_MX = -1001; |
102
|
|
|
const MAILDOMAIN_NO_HOST = -1002; |
103
|
|
|
const MAILDOMAIN_NO_CONNECT = -1003; |
104
|
|
|
const MAILDOMAIN_NO_STARTTLS = 1; |
105
|
|
|
const MAILDOMAIN_STARTTLS = 2; |
106
|
|
|
|
107
|
|
|
/** |
108
|
|
|
* verifies whether a mail address is in an existing and STARTTLS enabled mail domain |
109
|
|
|
* |
110
|
|
|
* @param string $address the mail address to check |
111
|
|
|
* @return int status of the mail domain |
112
|
|
|
*/ |
113
|
|
|
public static function mailAddressValidSecure($address) |
114
|
|
|
{ |
115
|
|
|
$loggerInstance = new \core\common\Logging(); |
116
|
|
|
if (!filter_var($address, FILTER_VALIDATE_EMAIL)) { |
117
|
|
|
$loggerInstance->debug(4, "OutsideComm::mailAddressValidSecure: invalid mail address."); |
118
|
|
|
return OutsideComm::MAILDOMAIN_INVALID; |
119
|
|
|
} |
120
|
|
|
$domain = substr($address, strpos($address, '@') + 1); // everything after the @ sign |
121
|
|
|
// we can be sure that the @ was found (FILTER_VALIDATE_EMAIL succeeded) |
122
|
|
|
// but let's be explicit |
123
|
|
|
if ($domain === FALSE) { |
124
|
|
|
return OutsideComm::MAILDOMAIN_INVALID; |
125
|
|
|
} |
126
|
|
|
// does the domain have MX records? |
127
|
|
|
$mx = dns_get_record($domain, DNS_MX); |
128
|
|
|
if ($mx === FALSE) { |
129
|
|
|
$loggerInstance->debug(4, "OutsideComm::mailAddressValidSecure: no MX."); |
130
|
|
|
return OutsideComm::MAILDOMAIN_NO_MX; |
131
|
|
|
} |
132
|
|
|
$loggerInstance->debug(5, "Domain: $domain MX: " . /** @scrutinizer ignore-type */ print_r($mx, TRUE)); |
133
|
|
|
// create a pool of A and AAAA records for all the MXes |
134
|
|
|
$ipAddrs = []; |
135
|
|
|
foreach ($mx as $onemx) { |
136
|
|
|
$v4list = dns_get_record($onemx['target'], DNS_A); |
137
|
|
|
$v6list = dns_get_record($onemx['target'], DNS_AAAA); |
138
|
|
|
foreach ($v4list as $oneipv4) { |
139
|
|
|
$ipAddrs[] = $oneipv4['ip']; |
140
|
|
|
} |
141
|
|
|
foreach ($v6list as $oneipv6) { |
142
|
|
|
$ipAddrs[] = "[" . $oneipv6['ipv6'] . "]"; |
143
|
|
|
} |
144
|
|
|
} |
145
|
|
|
if (count($ipAddrs) == 0) { |
146
|
|
|
$loggerInstance->debug(4, "OutsideComm::mailAddressValidSecure: no mailserver hosts."); |
147
|
|
|
return OutsideComm::MAILDOMAIN_NO_HOST; |
148
|
|
|
} |
149
|
|
|
$loggerInstance->debug(5, "Domain: $domain Addrs: " . /** @scrutinizer ignore-type */ print_r($ipAddrs, TRUE)); |
150
|
|
|
// connect to all hosts. If all can't connect, return MAILDOMAIN_NO_CONNECT. |
151
|
|
|
// If at least one does not support STARTTLS or one of the hosts doesn't connect |
152
|
|
|
// , return MAILDOMAIN_NO_STARTTLS (one which we can't connect to we also |
153
|
|
|
// can't verify if it's doing STARTTLS, so better safe than sorry. |
154
|
|
|
$retval = OutsideComm::MAILDOMAIN_NO_CONNECT; |
155
|
|
|
$allWithStarttls = TRUE; |
156
|
|
|
foreach ($ipAddrs as $oneip) { |
157
|
|
|
$loggerInstance->debug(5, "OutsideComm::mailAddressValidSecure: connecting to $oneip."); |
158
|
|
|
$smtp = new \PHPMailer\PHPMailer\SMTP; |
159
|
|
|
if ($smtp->connect($oneip, 25)) { |
160
|
|
|
// host reached! so at least it's not a NO_CONNECT |
161
|
|
|
$loggerInstance->debug(4, "OutsideComm::mailAddressValidSecure: connected to $oneip."); |
162
|
|
|
$retval = OutsideComm::MAILDOMAIN_NO_STARTTLS; |
163
|
|
|
if ($smtp->hello('eduroam.org')) { |
164
|
|
|
$extensions = $smtp->getServerExtList(); // Scrutinzer is wrong; is not always null - contains server capabilities |
165
|
|
|
if (!is_array($extensions) || !array_key_exists('STARTTLS', $extensions)) { |
166
|
|
|
$loggerInstance->debug(4, "OutsideComm::mailAddressValidSecure: no indication for STARTTLS."); |
167
|
|
|
$allWithStarttls = FALSE; |
168
|
|
|
} |
169
|
|
|
} |
170
|
|
|
} else { |
171
|
|
|
// no connect: then we can't claim all targets have STARTTLS |
172
|
|
|
$allWithStarttls = FALSE; |
173
|
|
|
$loggerInstance->debug(5, "OutsideComm::mailAddressValidSecure: failed $oneip."); |
174
|
|
|
} |
175
|
|
|
} |
176
|
|
|
// did the state $allWithStarttls survive? Then up the response to |
177
|
|
|
// appropriate level. |
178
|
|
|
if ($retval == OutsideComm::MAILDOMAIN_NO_STARTTLS && $allWithStarttls) { |
179
|
|
|
$retval = OutsideComm::MAILDOMAIN_STARTTLS; |
180
|
|
|
} |
181
|
|
|
return $retval; |
182
|
|
|
} |
183
|
|
|
|
184
|
|
|
const SMS_SENT = 100; |
185
|
|
|
const SMS_NOTSENT = 101; |
186
|
|
|
const SMS_FRAGEMENTSLOST = 102; |
187
|
|
|
|
188
|
|
|
/** |
189
|
|
|
* Send SMS invitations to end users |
190
|
|
|
* |
191
|
|
|
* @param string $number the number to send to: with country prefix, but without the + sign ("352123456" for a Luxembourg example) |
192
|
|
|
* @param string $content the text to send |
193
|
|
|
* @return integer status of the sending process |
194
|
|
|
* @throws \Exception |
195
|
|
|
*/ |
196
|
|
|
public static function sendSMS($number, $content) |
197
|
|
|
{ |
198
|
|
|
$loggerInstance = new \core\common\Logging(); |
199
|
|
|
switch (\config\ConfAssistant::SMSSETTINGS['provider']) { |
200
|
|
|
case 'Nexmo': |
201
|
|
|
// taken from https://docs.nexmo.com/messaging/sms-api |
202
|
|
|
$url = 'https://rest.nexmo.com/sms/json?' . http_build_query( |
203
|
|
|
[ |
204
|
|
|
'api_key' => \config\ConfAssistant::SMSSETTINGS['username'], |
205
|
|
|
'api_secret' => \config\ConfAssistant::SMSSETTINGS['password'], |
206
|
|
|
'to' => $number, |
207
|
|
|
'from' => \config\ConfAssistant::CONSORTIUM['name'], |
208
|
|
|
'text' => $content, |
209
|
|
|
'type' => 'unicode', |
210
|
|
|
] |
211
|
|
|
); |
212
|
|
|
|
213
|
|
|
$ch = curl_init($url); |
214
|
|
|
if ($ch === FALSE) { |
215
|
|
|
$loggerInstance->debug(2, 'Problem with SMS invitation: unable to send API request with CURL!'); |
216
|
|
|
return OutsideComm::SMS_NOTSENT; |
217
|
|
|
} |
218
|
|
|
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); |
219
|
|
|
$response = curl_exec($ch); |
220
|
|
|
|
221
|
|
|
// we have set RETURNTRANSFER so anything except string means something went wrong |
222
|
|
|
if (!is_string($response)) { |
223
|
|
|
throw new \Exception("Error while sending API request with SMS: curl did not deliver a response string."); |
224
|
|
|
} |
225
|
|
|
$decoded_response = json_decode($response, true); |
226
|
|
|
$messageCount = $decoded_response['message-count']; |
227
|
|
|
|
228
|
|
|
curl_close($ch); |
229
|
|
|
if ($messageCount == 0) { |
230
|
|
|
$loggerInstance->debug(2, 'Problem with SMS invitation: no message was sent!'); |
231
|
|
|
return OutsideComm::SMS_NOTSENT; |
232
|
|
|
} |
233
|
|
|
$loggerInstance->debug(2, 'Total of ' . $messageCount . ' messages were attempted to send.'); |
234
|
|
|
|
235
|
|
|
$totalFailures = 0; |
236
|
|
|
foreach ($decoded_response['messages'] as $message) { |
237
|
|
|
if ($message['status'] == 0) { |
238
|
|
|
$loggerInstance->debug(2, $message['message-id'] . ": Success"); |
239
|
|
|
} else { |
240
|
|
|
$loggerInstance->debug(2, $message['message-id'] . ": Failed (failure code = " . $message['status'] . ")"); |
241
|
|
|
$totalFailures++; |
242
|
|
|
} |
243
|
|
|
} |
244
|
|
|
if ($messageCount == count($decoded_response['messages']) && $totalFailures == 0) { |
245
|
|
|
return OutsideComm::SMS_SENT; |
246
|
|
|
} |
247
|
|
|
return OutsideComm::SMS_FRAGEMENTSLOST; |
248
|
|
|
default: |
249
|
|
|
throw new \Exception("Unknown SMS Gateway provider!"); |
250
|
|
|
} |
251
|
|
|
} |
252
|
|
|
|
253
|
|
|
const INVITE_CONTEXTS = [ |
254
|
|
|
0 => "CO-ADMIN", |
255
|
|
|
1 => "NEW-FED", |
256
|
|
|
2 => "EXISTING-FED", |
257
|
|
|
]; |
258
|
|
|
|
259
|
|
|
/** |
260
|
|
|
* |
261
|
|
|
* @param string $targets one or more mail addresses, comma-separated |
262
|
|
|
* @param string $introtext introductory sentence (varies by situation) |
263
|
|
|
* @param string $newtoken the token to send |
264
|
|
|
* @param string $idpPrettyName the name of the IdP, in best-match language |
265
|
|
|
* @param \core\Federation $federation if not NULL, indicates that invitation comes from authorised fed admin of that federation |
266
|
|
|
* @param string $type the type of participant we're invited to |
267
|
|
|
* @return array |
268
|
|
|
* @throws \Exception |
269
|
|
|
*/ |
270
|
|
|
public static function adminInvitationMail($targets, $introtext, $newtoken, $idpPrettyName, $federation, $type) |
271
|
|
|
{ |
272
|
|
|
if (!in_array($introtext, OutsideComm::INVITE_CONTEXTS)) { |
273
|
|
|
throw new \Exception("Unknown invite mode!"); |
274
|
|
|
} |
275
|
|
|
if ($introtext == OutsideComm::INVITE_CONTEXTS[1] && $federation === NULL) { // comes from fed admin, so federation must be set |
276
|
|
|
throw new \Exception("Invitation from a fed admin, but we do not know the corresponding federation!"); |
277
|
|
|
} |
278
|
|
|
$prettyPrintType = ""; |
279
|
|
|
switch ($type) { |
280
|
|
|
case \core\IdP::TYPE_IDP: |
281
|
|
|
$prettyPrintType = Entity::$nomenclature_idp; |
282
|
|
|
break; |
283
|
|
|
case \core\IdP::TYPE_SP: |
284
|
|
|
$prettyPrintType = Entity::$nomenclature_hotspot; |
285
|
|
|
break; |
286
|
|
|
case \core\IdP::TYPE_IDPSP: |
287
|
|
|
$prettyPrintType = sprintf(_("%s and %s"), Entity::$nomenclature_idp, Entity::$nomenclature_hotspot); |
288
|
|
|
break; |
289
|
|
|
default: |
290
|
|
|
throw new \Exception("This is controlled vocabulary, impossible."); |
291
|
|
|
} |
292
|
|
|
Entity::intoThePotatoes(); |
293
|
|
|
$mail = OutsideComm::mailHandle(); |
294
|
|
|
new \core\CAT(); // makes sure Entity is initialised |
295
|
|
|
// we have a few stock intro texts on file |
296
|
|
|
$introTexts = [ |
297
|
|
|
OutsideComm::INVITE_CONTEXTS[0] => sprintf(_("a %s of the %s %s \"%s\" has invited you to manage the %s together with them."), Entity::$nomenclature_fed, \config\ConfAssistant::CONSORTIUM['display_name'], Entity::$nomenclature_participant, $idpPrettyName, Entity::$nomenclature_participant), |
298
|
|
|
OutsideComm::INVITE_CONTEXTS[1] => sprintf(_("a %s %s has invited you to manage the future %s \"%s\" (%s). The organisation will be a %s."), \config\ConfAssistant::CONSORTIUM['display_name'], Entity::$nomenclature_fed, Entity::$nomenclature_participant, $idpPrettyName, strtoupper($federation->tld), $prettyPrintType), |
299
|
|
|
OutsideComm::INVITE_CONTEXTS[2] => sprintf(_("a %s %s has invited you to manage the %s \"%s\". This is a %s."), \config\ConfAssistant::CONSORTIUM['display_name'], Entity::$nomenclature_fed, Entity::$nomenclature_participant, $idpPrettyName, $prettyPrintType), |
300
|
|
|
]; |
301
|
|
|
$validity = sprintf(_("This invitation is valid for 24 hours from now, i.e. until %s."), strftime("%x %X %Z", time() + 86400)); |
302
|
|
|
// need some nomenclature |
303
|
|
|
// are we on https? |
304
|
|
|
$proto = "http://"; |
305
|
|
|
if (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] == "on") { |
306
|
|
|
$proto = "https://"; |
307
|
|
|
} |
308
|
|
|
// then, send out the mail |
309
|
|
|
$message = _("Hello,") . "\n\n" . wordwrap($introTexts[$introtext] . " " . $validity, 72) . "\n\n"; |
310
|
|
|
// default means we don't have a Reply-To. |
311
|
|
|
$replyToMessage = wordwrap(_("manually. Please do not reply to this mail; this is a send-only address.")); |
312
|
|
|
|
313
|
|
|
if ($federation !== NULL) { |
314
|
|
|
// see if we are supposed to add a custom message |
315
|
|
|
$customtext = $federation->getAttributes('fed:custominvite'); |
316
|
|
|
if (count($customtext) > 0) { |
317
|
|
|
$message .= wordwrap(sprintf(_("Additional message from your %s administrator:"), Entity::$nomenclature_fed), 72) . "\n---------------------------------" . |
318
|
|
|
wordwrap($customtext[0]['value'], 72) . "\n---------------------------------\n\n"; |
319
|
|
|
} |
320
|
|
|
// and add Reply-To already now |
321
|
|
|
foreach ($federation->listFederationAdmins() as $fedadmin_id) { |
322
|
|
|
$fedadmin = new \core\User($fedadmin_id); |
323
|
|
|
$mailaddrAttrib = $fedadmin->getAttributes("user:email"); |
324
|
|
|
$nameAttrib = $fedadmin->getAttributes("user:realname"); |
325
|
|
|
$name = $nameAttrib[0]['value'] ?? sprintf(_("%s administrator"), Entity::$nomenclature_fed); |
326
|
|
|
if (count($mailaddrAttrib) > 0) { |
327
|
|
|
$mail->addReplyTo($mailaddrAttrib[0]['value'], $name); |
328
|
|
|
$replyToMessage = wordwrap(sprintf(_("manually. If you reply to this mail, you will reach your %s administrators."), Entity::$nomenclature_fed), 72); |
329
|
|
|
} |
330
|
|
|
} |
331
|
|
|
} |
332
|
|
|
$productname = \config\Master::APPEARANCE['productname']; |
333
|
|
|
$consortium = \config\ConfAssistant::CONSORTIUM['display_name']; |
334
|
|
|
$message .= wordwrap(sprintf(_("To enlist as an administrator for that %s, please click on the following link:"), Entity::$nomenclature_participant), 72) . "\n\n" . |
335
|
|
|
$proto . $_SERVER['SERVER_NAME'] . \config\Master::PATHS['cat_base_url'] . "admin/action_enrollment.php?token=$newtoken\n\n" . |
336
|
|
|
wordwrap(sprintf(_("If clicking the link doesn't work, you can also go to the %s Administrator Interface at"), $productname), 72) . "\n\n" . |
337
|
|
|
$proto . $_SERVER['SERVER_NAME'] . \config\Master::PATHS['cat_base_url'] . "admin/\n\n" . |
338
|
|
|
_("and enter the invitation token") . "\n\n" . |
339
|
|
|
$newtoken . "\n\n$replyToMessage\n\n" . |
340
|
|
|
wordwrap(_("Do NOT forward the mail before the token has expired - or the recipients may be able to consume the token on your behalf!"), 72) . "\n\n" . |
341
|
|
|
wordwrap(sprintf(_("We wish you a lot of fun with the %s."), $productname), 72) . "\n\n" . |
342
|
|
|
sprintf(_("Sincerely,\n\nYour friendly folks from %s Operations"), $consortium); |
343
|
|
|
|
344
|
|
|
|
345
|
|
|
// who to whom? |
346
|
|
|
$mail->FromName = \config\Master::APPEARANCE['productname'] . " Invitation System"; |
347
|
|
|
|
348
|
|
|
if (isset(\config\Master::APPEARANCE['invitation-bcc-mail']) && \config\Master::APPEARANCE['invitation-bcc-mail'] !== NULL) { |
349
|
|
|
$mail->addBCC(\config\Master::APPEARANCE['invitation-bcc-mail']); |
350
|
|
|
} |
351
|
|
|
|
352
|
|
|
// all addresses are wrapped in a string, but PHPMailer needs a structured list of addressees |
353
|
|
|
// sigh... so convert as needed |
354
|
|
|
// first split multiple into one if needed |
355
|
|
|
$recipients = explode(", ", $targets); |
356
|
|
|
|
357
|
|
|
$secStatus = TRUE; |
358
|
|
|
$domainStatus = TRUE; |
359
|
|
|
|
360
|
|
|
// fill the destinations in PHPMailer API |
361
|
|
|
foreach ($recipients as $recipient) { |
362
|
|
|
$mail->addAddress($recipient); |
363
|
|
|
$status = OutsideComm::mailAddressValidSecure($recipient); |
364
|
|
|
if ($status < OutsideComm::MAILDOMAIN_STARTTLS) { |
365
|
|
|
$secStatus = FALSE; |
366
|
|
|
} |
367
|
|
|
if ($status < 0) { |
368
|
|
|
$domainStatus = FALSE; |
369
|
|
|
} |
370
|
|
|
} |
371
|
|
|
Entity::outOfThePotatoes(); |
372
|
|
|
if (!$domainStatus) { |
373
|
|
|
return ["SENT" => FALSE, "TRANSPORT" => FALSE]; |
374
|
|
|
} |
375
|
|
|
|
376
|
|
|
// what do we want to say? |
377
|
|
|
Entity::intoThePotatoes(); |
378
|
|
|
$mail->Subject = sprintf(_("%s: you have been invited to manage an %s"), \config\Master::APPEARANCE['productname'], Entity::$nomenclature_participant); |
379
|
|
|
Entity::outOfThePotatoes(); |
380
|
|
|
$mail->Body = $message; |
381
|
|
|
return ["SENT" => $mail->send(), "TRANSPORT" => $secStatus]; |
382
|
|
|
} |
383
|
|
|
|
384
|
|
|
/** |
385
|
|
|
* sends a POST with some JSON inside |
386
|
|
|
* |
387
|
|
|
* @param string $url the URL to POST to |
388
|
|
|
* @param array $dataArray the data to be sent in PHP array representation |
389
|
|
|
* @return array the JSON response, decoded into PHP associative array |
390
|
|
|
* @throws \Exception |
391
|
|
|
*/ |
392
|
|
|
public static function postJson($url, $dataArray) |
393
|
|
|
{ |
394
|
|
|
$loggerInstance = new Logging(); |
395
|
|
|
$ch = \curl_init($url); |
396
|
|
|
if ($ch === FALSE) { |
397
|
|
|
$loggerInstance->debug(2, "Unable to POST JSON request: CURL init failed!"); |
398
|
|
|
return json_decode(json_encode(FALSE), TRUE); |
399
|
|
|
} |
400
|
|
|
\curl_setopt_array($ch, array( |
401
|
|
|
CURLOPT_POST => TRUE, |
402
|
|
|
CURLOPT_RETURNTRANSFER => TRUE, |
403
|
|
|
CURLOPT_POSTFIELDS => json_encode($dataArray), |
404
|
|
|
CURLOPT_FRESH_CONNECT => TRUE, |
405
|
|
|
)); |
406
|
|
|
$response = \curl_exec($ch); |
407
|
|
|
if (!is_string($response)) { // With RETURNTRANSFER, TRUE is not a valid return |
408
|
|
|
throw new \Exception("the POST didn't work!"); |
409
|
|
|
} |
410
|
|
|
return json_decode($response, TRUE); |
411
|
|
|
} |
412
|
|
|
|
413
|
|
|
/** |
414
|
|
|
* aborts code execution if a required mail address is invalid |
415
|
|
|
* |
416
|
|
|
* @param mixed $newmailaddress input string, possibly one or more mail addresses |
417
|
|
|
* @return array mail addresses that passed validation |
418
|
|
|
*/ |
419
|
|
|
public static function exfiltrateValidAddresses($newmailaddress) |
420
|
|
|
{ |
421
|
|
|
$validator = new \web\lib\common\InputValidation(); |
422
|
|
|
$addressSegments = explode(",", $newmailaddress); |
423
|
|
|
$confirmedMails = []; |
424
|
|
|
if ($addressSegments === FALSE) { |
425
|
|
|
return []; |
426
|
|
|
} |
427
|
|
|
foreach ($addressSegments as $oneAddressCandidate) { |
428
|
|
|
$candidate = trim($oneAddressCandidate); |
429
|
|
|
if ($validator->email($candidate) !== FALSE) { |
430
|
|
|
$confirmedMails[] = $candidate; |
431
|
|
|
} |
432
|
|
|
} |
433
|
|
|
if (count($confirmedMails) == 0) { |
434
|
|
|
return []; |
435
|
|
|
} |
436
|
|
|
return $confirmedMails; |
437
|
|
|
} |
438
|
|
|
/** |
439
|
|
|
* performs an HTTP request. Currently unused, will be for external CA API calls. |
440
|
|
|
* |
441
|
|
|
* @param string $url the URL to send the request to |
442
|
|
|
* @param array $postValues POST values to send |
443
|
|
|
* @return string the returned HTTP content |
444
|
|
|
|
445
|
|
|
public static function PostHttp($url, $postValues) { |
446
|
|
|
$options = [ |
447
|
|
|
'http' => ['header' => 'Content-type: application/x-www-form-urlencoded\r\n', "method" => 'POST', 'content' => http_build_query($postValues)] |
448
|
|
|
]; |
449
|
|
|
$context = stream_context_create($options); |
450
|
|
|
return file_get_contents($url, false, $context); |
451
|
|
|
} |
452
|
|
|
* |
453
|
|
|
*/ |
454
|
|
|
} |
455
|
|
|
|