]> git.mxchange.org Git - friendica.git/blob - mod/dfrn_confirm.php
provide a way to disable mailbox integration
[friendica.git] / mod / dfrn_confirm.php
1 <?php
2
3 /*
4  * Module: dfrn_confirm
5  * Purpose: Friendship acceptance for DFRN contacts
6  *
7  * There are two possible entry points and three scenarios.
8  *
9  *   1. A form was submitted by our user approving a friendship that originated elsewhere.
10  *      This may also be called from dfrn_request to automatically approve a friendship.
11  *
12  *   2. We may be the target or other side of the conversation to scenario 1, and will 
13  *      interact with that process on our own user's behalf.
14  *   
15  */
16
17 function dfrn_confirm_post(&$a,$handsfree = null) {
18
19         if(is_array($handsfree)) {
20
21                 /**
22                  * We were called directly from dfrn_request due to automatic friend acceptance.
23                  * Any $_POST parameters we may require are supplied in the $handsfree array.
24                  *
25                  */
26
27                 $node = $handsfree['node'];
28                 $a->interactive = false; // notice() becomes a no-op since nobody is there to see it
29
30         }
31         else {
32                 if($a->argc > 1)
33                         $node = $a->argv[1];
34         }
35
36                 /**
37                  *
38                  * Main entry point. Scenario 1. Our user received a friend request notification (perhaps 
39                  * from another site) and clicked 'Approve'. 
40                  * $POST['source_url'] is not set. If it is, it indicates Scenario 2.
41                  *
42                  * We may also have been called directly from dfrn_request ($handsfree != null) due to 
43                  * this being a page type which supports automatic friend acceptance. That is also Scenario 1
44                  * since we are operating on behalf of our registered user to approve a friendship.
45                  *
46                  */
47
48         if(! x($_POST,'source_url')) {
49
50                 $uid = ((is_array($handsfree)) ? $handsfree['uid'] : local_user());
51
52                 if(! $uid) {
53                         notice( t('Permission denied.') . EOL );
54                         return;
55                 }       
56
57                 $user = q("SELECT * FROM `user` WHERE `uid` = %d LIMIT 1",
58                         intval($uid)
59                 );
60
61                 if(! $user) {
62                         notice( t('Profile not found.') . EOL );
63                         return;
64                 }       
65
66
67                 // These data elements may come from either the friend request notification form or $handsfree array.
68
69                 if(is_array($handsfree)) {
70                         logger('dfrn_confirm: Confirm in handsfree mode');
71                         $dfrn_id   = $handsfree['dfrn_id'];
72                         $intro_id  = $handsfree['intro_id'];
73                         $duplex    = $handsfree['duplex'];
74                 }
75                 else {
76                         $dfrn_id  = ((x($_POST,'dfrn_id'))    ? notags(trim($_POST['dfrn_id'])) : "");
77                         $intro_id = ((x($_POST,'intro_id'))   ? intval($_POST['intro_id'])      : 0 );
78                         $duplex   = ((x($_POST,'duplex'))     ? intval($_POST['duplex'])        : 0 );
79                         $cid      = ((x($_POST,'contact_id')) ? intval($_POST['contact_id'])    : 0 );
80                 }
81
82                 /**
83                  *
84                  * Ensure that dfrn_id has precedence when we go to find the contact record.
85                  * We only want to search based on contact id if there is no dfrn_id, 
86                  * e.g. for OStatus network followers.
87                  *
88                  */
89
90                 if(strlen($dfrn_id))
91                         $cid = 0;
92
93                 logger('dfrn_confirm: Confirming request for dfrn_id (issued) ' . $dfrn_id);
94                 if($cid)
95                         logger('dfrn_confirm: Confirming follower with contact_id: ' . $cid);
96
97
98                 /**
99                  *
100                  * The other person will have been issued an ID when they first requested friendship.
101                  * Locate their record. At this time, their record will have both pending and blocked set to 1. 
102                  * There won't be any dfrn_id if this is a network follower, so use the contact_id instead.
103                  *
104                  */
105
106                 $r = q("SELECT * FROM `contact` WHERE ( ( `issued-id` != '' AND `issued-id` = '%s' ) OR ( `id` = %d AND `id` != 0 ) ) AND `uid` = %d LIMIT 1",
107                         dbesc($dfrn_id),
108                         intval($cid),
109                         intval($uid)
110                 );
111
112                 if(! count($r)) {
113                         logger('dfrn_confirm: Contact not found in DB.'); 
114                         notice( t('Contact not found.') . EOL );
115                         return;
116                 }
117
118                 $contact = $r[0];
119
120                 $contact_id   = $contact['id'];
121                 $relation     = $contact['rel'];
122                 $site_pubkey  = $contact['site-pubkey'];
123                 $dfrn_confirm = $contact['confirm'];
124                 $aes_allow    = $contact['aes_allow'];
125
126                 $network = ((strlen($contact['issued-id'])) ? 'dfrn' : 'stat');
127
128                 if($network === 'dfrn') {
129
130                         /**
131                          *
132                          * Generate a key pair for all further communications with this person.
133                          * We have a keypair for every contact, and a site key for unknown people.
134                          * This provides a means to carry on relationships with other people if 
135                          * any single key is compromised. It is a robust key. We're much more 
136                          * worried about key leakage than anybody cracking it.  
137                          *
138                          */
139
140                         $res = openssl_pkey_new(array(
141                                 'digest_alg' => 'sha1',
142                                 'private_key_bits' => 4096,
143                                 'encrypt_key' => false )
144                         );
145
146                         $private_key = '';
147
148                         openssl_pkey_export($res, $private_key);
149
150                         $pubkey = openssl_pkey_get_details($res);
151                         $public_key = $pubkey["key"];
152
153                         // Save the private key. Send them the public key.
154
155                         $r = q("UPDATE `contact` SET `prvkey` = '%s' WHERE `id` = %d AND `uid` = %d LIMIT 1",
156                                 dbesc($private_key),
157                                 intval($contact_id),
158                                 intval($uid) 
159                         );
160
161                         $params = array();
162
163                         /**
164                          *
165                          * Per the DFRN protocol, we will verify both ends by encrypting the dfrn_id with our 
166                          * site private key (person on the other end can decrypt it with our site public key).
167                          * Then encrypt our profile URL with the other person's site public key. They can decrypt
168                          * it with their site private key. If the decryption on the other end fails for either
169                          * item, it indicates tampering or key failure on at least one site and we will not be 
170                          * able to provide a secure communication pathway.
171                          *
172                          * If other site is willing to accept full encryption, (aes_allow is 1 AND we have php5.3 
173                          * or later) then we encrypt the personal public key we send them using AES-256-CBC and a 
174                          * random key which is encrypted with their site public key.  
175                          *
176                          */
177
178                         $src_aes_key = random_string();
179
180                         $result = '';
181                         openssl_private_encrypt($dfrn_id,$result,$user[0]['prvkey']);
182
183                         $params['dfrn_id'] = bin2hex($result);
184                         $params['public_key'] = $public_key;
185
186
187                         $my_url = $a->get_baseurl() . '/profile/' . $user[0]['nickname'];
188
189                         openssl_public_encrypt($my_url, $params['source_url'], $site_pubkey);
190                         $params['source_url'] = bin2hex($params['source_url']);
191
192                         if($aes_allow && function_exists('openssl_encrypt')) {
193                                 openssl_public_encrypt($src_aes_key, $params['aes_key'], $site_pubkey);
194                                 $params['aes_key'] = bin2hex($params['aes_key']);
195                                 $params['public_key'] = bin2hex(openssl_encrypt($public_key,'AES-256-CBC',$src_aes_key));
196                         }
197
198                         $params['dfrn_version'] = DFRN_PROTOCOL_VERSION ;
199                         if($duplex == 1)
200                                 $params['duplex'] = 1;
201
202                         logger('dfrn_confirm: Confirm: posting data to ' . $dfrn_confirm . ': ' . print_r($params,true), LOGGER_DATA);
203
204                         /**
205                          *
206                          * POST all this stuff to the other site.
207                          * Temporarily raise the network timeout to 120 seconds because the default 60
208                          * doesn't always give the other side quite enough time to decrypt everything.
209                          *
210                          */
211
212                         $a->config['system']['curl_timeout'] = 120;
213
214                         $res = post_url($dfrn_confirm,$params);
215
216                         logger('dfrn_confirm: Confirm: received data: ' . $res, LOGGER_DATA);
217
218                         // Now figure out what they responded. Try to be robust if the remote site is 
219                         // having difficulty and throwing up errors of some kind. 
220
221                         $leading_junk = substr($res,0,strpos($res,'<?xml'));
222
223                         $res = substr($res,strpos($res,'<?xml'));
224                         if(! strlen($res)) {
225
226                                         // No XML at all, this exchange is messed up really bad.
227                                         // We shouldn't proceed, because the xml parser might choke,
228                                         // and $status is going to be zero, which indicates success.
229                                         // We can hardly call this a success.  
230         
231                                 notice( t('Response from remote site was not understood.') . EOL);
232                                 return;
233                         }
234
235                         if(strlen($leading_junk) && get_config('system','debugging')) {
236         
237                                         // This might be more common. Mixed error text and some XML.
238                                         // If we're configured for debugging, show the text. Proceed in either case.
239
240                                 notice( t('Unexpected response from remote site: ') . EOL . $leading_junk . EOL );
241                         }
242
243                         $xml = parse_xml_string($res);
244                         $status = (int) $xml->status;
245                         $message = unxmlify($xml->message);   // human readable text of what may have gone wrong.
246                         switch($status) {
247                                 case 0:
248                                         notice( t("Confirmation completed successfully.") . EOL);
249                                         if(strlen($message))
250                                                 notice( t('Remote site reported: ') . $message . EOL);
251                                         break;
252                                 case 1:
253                                         // birthday paradox - generate new dfrn-id and fall through.
254                                         $new_dfrn_id = random_string();
255                                         $r = q("UPDATE contact SET `issued-id` = '%s' WHERE `id` = %d AND `uid` = %d LIMIT 1",
256                                                 dbesc($new_dfrn_id),
257                                                 intval($contact_id),
258                                                 intval($uid) 
259                                         );
260
261                                 case 2:
262                                         notice( t("Temporary failure. Please wait and try again.") . EOL);
263                                         if(strlen($message))
264                                                 notice( t('Remote site reported: ') . $message . EOL);
265                                         break;
266
267
268                                 case 3:
269                                         notice( t("Introduction failed or was revoked.") . EOL);
270                                         if(strlen($message))
271                                                 notice( t('Remote site reported: ') . $message . EOL);
272                                         break;
273                                 }
274
275                         if(($status == 0) && ($intro_id)) {
276         
277                                 // Success. Delete the notification.
278         
279                                 $r = q("DELETE FROM `intro` WHERE `id` = %d AND `uid` = %d LIMIT 1",
280                                         intval($intro_id),
281                                         intval($uid)
282                                 );
283                                 
284                         }
285
286                         if($status != 0) 
287                                 return;
288                 }
289
290
291                 /*
292                  *
293                  * We have now established a relationship with the other site.
294                  * Let's make our own personal copy of their profile photo so we don't have
295                  * to always load it from their site.
296                  *
297                  * We will also update the contact record with the nature and scope of the relationship.
298                  *
299                  */
300
301                 require_once("Photo.php");
302
303                 $photos = import_profile_photo($contact['photo'],$uid,$contact_id);
304                 
305                 logger('dfrn_confirm: confirm - imported photos');
306
307                 if($network === 'dfrn') {
308
309                         $new_relation = REL_VIP;
310                         if(($relation == REL_FAN) || ($duplex))
311                                 $new_relation = REL_BUD;
312
313                         if(($relation == REL_FAN) && ($duplex))
314                                 $duplex = 0;
315
316                         $r = q("UPDATE `contact` SET `photo` = '%s', 
317                                 `thumb` = '%s',
318                                 `micro` = '%s', 
319                                 `rel` = %d, 
320                                 `name-date` = '%s', 
321                                 `uri-date` = '%s', 
322                                 `avatar-date` = '%s', 
323                                 `blocked` = 0, 
324                                 `pending` = 0,
325                                 `duplex` = %d,
326                                 `network` = 'dfrn' WHERE `id` = %d LIMIT 1
327                         ",
328                                 dbesc($photos[0]),
329                                 dbesc($photos[1]),
330                                 dbesc($photos[2]),
331                                 intval($new_relation),
332                                 dbesc(datetime_convert()),
333                                 dbesc(datetime_convert()),
334                                 dbesc(datetime_convert()),
335                                 intval($duplex),
336                                 intval($contact_id)
337                         );
338                 }
339                 else {  
340                         // $network !== 'dfrn'
341
342                         $notify = '';
343                         $poll   = '';
344
345                         $arr = lrdd($contact['url']);
346                         if(count($arr)) {
347                                 foreach($arr as $link) {
348                                         if($link['@attributes']['rel'] === 'salmon')
349                                                 $notify = $link['@attributes']['href'];
350                                         if($link['@attributes']['rel'] === NAMESPACE_FEED)
351                                                 $poll = $link['@attributes']['href'];
352                                 }
353                         }
354
355                         $r = q("DELETE FROM `intro` WHERE `id` = %d AND `uid` = %d LIMIT 1",
356                                 intval($intro_id),
357                                 intval($uid)
358                         );
359
360
361                         $r = q("UPDATE `contact` SET `photo` = '%s', 
362                                 `thumb` = '%s',
363                                 `micro` = '%s', 
364                                 `name-date` = '%s', 
365                                 `uri-date` = '%s', 
366                                 `avatar-date` = '%s', 
367                                 `notify` = '%s',
368                                 `poll` = '%s',
369                                 `blocked` = 0, 
370                                 `pending` = 0,
371                                 `network` = 'stat'
372                                 WHERE `id` = %d LIMIT 1
373                         ",
374                                 dbesc($photos[0]),
375                                 dbesc($photos[1]),
376                                 dbesc($photos[2]),
377                                 dbesc(datetime_convert()),
378                                 dbesc(datetime_convert()),
379                                 dbesc(datetime_convert()),
380                                 dbesc($notify),
381                                 dbesc($poll),
382                                 intval($contact_id)
383                         );                      
384                 }
385
386                 if($r === false)
387                                 notice( t('Unable to set contact photo.') . EOL);
388
389                 // reload contact info
390
391                 $r = q("SELECT * FROM `contact` WHERE `id` = %d LIMIT 1",
392                         intval($contact_id)
393                 );
394                 if(count($r))
395                         $contact = $r[0];
396                 else
397                         $contact = null;
398
399                 // Send a new friend post if we are allowed to...
400
401                 $r = q("SELECT `hide-friends` FROM `profile` WHERE `uid` = %d AND `is-default` = 1 LIMIT 1",
402                         intval($uid)
403                 );
404                 if((count($r)) && ($r[0]['hide-friends'] == 0) && (is_array($contact)) &&  isset($new_relation) && ($new_relation == REL_BUD)) {
405
406                         require_once('include/items.php');
407
408                         $self = q("SELECT * FROM `contact` WHERE `self` = 1 AND `uid` = %d LIMIT 1",
409                                 intval($uid)
410                         );
411
412                         if(count($self)) {
413
414                                 $arr = array();
415                                 $arr['uri'] = $arr['parent-uri'] = item_new_uri($a->get_hostname(), $uid); 
416                                 $arr['uid'] = $uid;
417                                 $arr['contact-id'] = $self[0]['id'];
418                                 $arr['wall'] = 1;
419                                 $arr['type'] = 'wall';
420                                 $arr['gravity'] = 0;
421                                 $arr['author-name'] = $arr['owner-name'] = $self[0]['name'];
422                                 $arr['author-link'] = $arr['owner-link'] = $self[0]['url'];
423                                 $arr['author-avatar'] = $arr['owner-avatar'] = $self[0]['thumb'];
424                                 $arr['verb'] = ACTIVITY_FRIEND;
425                                 $arr['object-type'] = ACTIVITY_OBJ_PERSON;
426                                 $arr['body'] = '[url=' . $self[0]['url'] . ']' . $self[0]['name'] . '[/url] ' . t('is now friends with')
427                                         . ' [url=' . $contact['url'] . ']' . $contact['name'] . '[/url]' . "\n\n\n" 
428                                         . ' [url=' . $contact['url'] . ']' . '[img]' . $contact['thumb'] . '[/img][/url]';
429
430                                 $arr['object'] = '<object><type>' . ACTIVITY_OBJ_PERSON . '</type><title>' . $contact['name'] . '</title>'
431                                         . '<id>' . $contact['url'] . '/' . $contact['name'] . '</id>';
432                                 $arr['object'] .= '<link>' . xmlify('<link rel="alternate" type="text/html" href="' . $contact['url'] . '" />' . "\n");
433                                 $arr['object'] .= xmlify('<link rel="photo" type="image/jpeg" href="' . $contact['thumb'] . '" />' . "\n");
434                                 $arr['object'] .= '</link></object>' . "\n";
435                                 $arr['last-child'] = 1;
436
437                                 $arr['allow_cid'] = $user[0]['allow_cid'];
438                                 $arr['allow_gid'] = $user[0]['allow_gid'];
439                                 $arr['deny_cid']  = $user[0]['deny_cid'];
440                                 $arr['deny_gid']  = $user[0]['deny_gid'];
441
442                                 $i = item_store($arr);
443                                 if($i)
444                                 proc_run('php',"include/notifier.php","activity","$i");
445
446                         }
447
448                 }
449                 // Let's send our user to the contact editor in case they want to
450                 // do anything special with this new friend.
451
452                 if($handsfree === null)
453                         goaway($a->get_baseurl() . '/contacts/' . intval($contact_id));
454                 else
455                         return;  
456                 //NOTREACHED
457         }
458
459         /**
460          *
461          *
462          * End of Scenario 1. [Local confirmation of remote friend request].
463          *
464          * Begin Scenario 2. This is the remote response to the above scenario.
465          * This will take place on the site that originally initiated the friend request.
466          * In the section above where the confirming party makes a POST and 
467          * retrieves xml status information, they are communicating with the following code.
468          *
469          */
470
471         if(x($_POST,'source_url')) {
472
473                 // We are processing an external confirmation to an introduction created by our user.
474
475                 $public_key = ((x($_POST,'public_key'))   ? $_POST['public_key']           : '');
476                 $dfrn_id    = ((x($_POST,'dfrn_id'))      ? hex2bin($_POST['dfrn_id'])     : '');
477                 $source_url = ((x($_POST,'source_url'))   ? hex2bin($_POST['source_url'])  : '');
478                 $aes_key    = ((x($_POST,'aes_key'))      ? $_POST['aes_key']              : '');
479                 $duplex     = ((x($_POST,'duplex'))       ? intval($_POST['duplex'])       : 0 );
480                 $version_id = ((x($_POST,'dfrn_version')) ? (float) $_POST['dfrn_version'] : 2.0);
481         
482                 logger('dfrn_confirm: requestee contacted: ' . $node);
483
484                 logger('dfrn_confirm: request: POST=' . print_r($_POST,true), LOGGER_DATA);
485
486                 // If $aes_key is set, both of these items require unpacking from the hex transport encoding.
487
488                 if(x($aes_key)) {
489                         $aes_key = hex2bin($aes_key);
490                         $public_key = hex2bin($public_key);
491                 }
492
493                 // Find our user's account
494
495                 $r = q("SELECT * FROM `user` WHERE `nickname` = '%s' LIMIT 1",
496                         dbesc($node));
497
498                 if(! count($r)) {
499                         $message = sprintf(t('No user record found for \'%s\' '), $node);
500                         xml_status(3,$message); // failure
501                         // NOTREACHED
502                 }
503
504                 $my_prvkey = $r[0]['prvkey'];
505                 $local_uid = $r[0]['uid'];
506
507
508                 if(! strstr($my_prvkey,'BEGIN RSA PRIVATE KEY')) {
509                         $message = t('Our site encryption key is apparently messed up.');
510                         xml_status(3,$message);
511                 }
512
513                 // verify everything
514
515                 $decrypted_source_url = "";
516                 openssl_private_decrypt($source_url,$decrypted_source_url,$my_prvkey);
517
518
519                 if(! strlen($decrypted_source_url)) {
520                         $message = t('Empty site URL was provided or URL could not be decrypted by us.');
521                         xml_status(3,$message);
522                         // NOTREACHED
523                 }
524
525                 $ret = q("SELECT * FROM `contact` WHERE `url` = '%s' AND `uid` = %d LIMIT 1",
526                         dbesc($decrypted_source_url),
527                         intval($local_uid)
528                 );
529
530                 if(! count($ret)) {
531                         // this is either a bogus confirmation (?) or we deleted the original introduction.
532                         $message = t('Contact record was not found for you on our site.');
533                         xml_status(3,$message);
534                         return; // NOTREACHED 
535                 }
536
537                 $relation = $ret[0]['rel'];
538
539                 // Decrypt all this stuff we just received
540
541                 $foreign_pubkey = $ret[0]['site-pubkey'];
542                 $dfrn_record    = $ret[0]['id'];
543
544                 $decrypted_dfrn_id = "";
545                 openssl_public_decrypt($dfrn_id,$decrypted_dfrn_id,$foreign_pubkey);
546
547                 if(strlen($aes_key)) {
548                         $decrypted_aes_key = "";
549                         openssl_private_decrypt($aes_key,$decrypted_aes_key,$my_prvkey);
550                         $dfrn_pubkey = openssl_decrypt($public_key,'AES-256-CBC',$decrypted_aes_key);
551                 }
552                 else {
553                         $dfrn_pubkey = $public_key;
554                 }
555
556                 $r = q("SELECT * FROM `contact` WHERE `dfrn-id` = '%s' LIMIT 1",
557                         dbesc($decrypted_dfrn_id)
558                 );
559                 if(count($r)) {
560                         $message = t('The ID provided by your system is a duplicate on our system. It should work if you try again.');
561                         xml_status(1,$message); // Birthday paradox - duplicate dfrn-id
562                         // NOTREACHED
563                 }
564
565                 $r = q("UPDATE `contact` SET `dfrn-id` = '%s', `pubkey` = '%s' WHERE `id` = %d LIMIT 1",
566                         dbesc($decrypted_dfrn_id),
567                         dbesc($dfrn_pubkey),
568                         intval($dfrn_record)
569                 );
570                 if(! count($r)) {
571                         $message = t('Unable to set your contact credentials on our system.');
572                         xml_status(3,$message);
573                 }
574
575                 // We're good but now we have to scrape the profile photo and send notifications.
576
577
578
579                 $r = q("SELECT `photo` FROM `contact` WHERE `id` = %d LIMIT 1",
580                         intval($dfrn_record));
581
582                 if(count($r))
583                         $photo = $r[0]['photo'];
584                 else
585                         $photo = $a->get_baseurl() . '/images/default-profile.jpg';
586                                 
587                 require_once("Photo.php");
588
589                 $photos = import_profile_photo($photo,$local_uid,$dfrn_record);
590
591                 logger('dfrn_confirm: request - photos imported');
592
593                 $new_relation = REL_FAN;
594                 if(($relation == REL_VIP) || ($duplex))
595                         $new_relation = REL_BUD;
596
597                 if(($relation == REL_VIP) && ($duplex))
598                         $duplex = 0;
599
600                 $r = q("UPDATE `contact` SET 
601                         `photo` = '%s', 
602                         `thumb` = '%s', 
603                         `micro` = '%s',
604                         `rel` = %d, 
605                         `name-date` = '%s', 
606                         `uri-date` = '%s', 
607                         `avatar-date` = '%s', 
608                         `blocked` = 0, 
609                         `pending` = 0,
610                         `duplex` = %d, 
611                         `network` = 'dfrn' WHERE `id` = %d LIMIT 1
612                 ",
613                         dbesc($photos[0]),
614                         dbesc($photos[1]),
615                         dbesc($photos[2]),
616                         intval($new_relation),
617                         dbesc(datetime_convert()),
618                         dbesc(datetime_convert()),
619                         dbesc(datetime_convert()),
620                         intval($duplex),
621                         intval($dfrn_record)
622                 );
623                 if($r === false) {    // indicates schema is messed up or total db failure
624                         $message = t('Unable to update your contact profile details on our system');
625                         xml_status(3,$message);
626                 }
627
628                 // Otherwise everything seems to have worked and we are almost done. Yay!
629                 // Send an email notification
630
631                 logger('dfrn_confirm: request: info updated');
632
633                 $r = q("SELECT * FROM `contact` LEFT JOIN `user` ON `contact`.`uid` = `user`.`uid`
634                         WHERE `contact`.`id` = %d LIMIT 1",
635                         intval($dfrn_record)
636                 );
637                 if((count($r)) && ($r[0]['notify-flags'] & NOTIFY_CONFIRM)) {
638
639                         $tpl = (($new_relation == REL_BUD) 
640                                 ? load_view_file('view/friend_complete_eml.tpl')
641                                 : load_view_file('view/intro_complete_eml.tpl'));
642                 
643                         $email_tpl = replace_macros($tpl, array(
644                                 '$sitename' => $a->config['sitename'],
645                                 '$siteurl' =>  $a->get_baseurl(),
646                                 '$username' => $r[0]['username'],
647                                 '$email' => $r[0]['email'],
648                                 '$fn' => $r[0]['name'],
649                                 '$dfrn_url' => $r[0]['url'],
650                                 '$uid' => $newuid )
651                         );
652         
653                         $res = mail($r[0]['email'], sprintf( t("Connection accepted at %s") , $a->config['sitename']),
654                                 $email_tpl,
655                                 'From: ' . t('Administrator') . '@' . $_SERVER['SERVER_NAME'] . "\n"
656                                 . 'Content-type: text/plain; charset=UTF-8' . "\n"
657                                 . 'Content-transfer-encoding: 8bit' );
658
659                         if(!$res) {
660                                 // pointless throwing an error here and confusing the person at the other end of the wire.
661                         }
662                 }
663                 xml_status(0); // Success
664                 return; // NOTREACHED
665
666                         ////////////////////// End of this scenario ///////////////////////////////////////////////
667         }
668
669         // somebody arrived here by mistake or they are fishing. Send them to the homepage.
670
671         goaway($a->get_baseurl());
672         // NOTREACHED
673
674 }