3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.4 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2013 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2013
37 * This class handles all SOAP client requests.
40 * @copyright CiviCRM LLC (c) 2004-2013
44 class CRM_Utils_SoapServer
{
47 * Number of seconds we should let a soap process idle
50 static $soap_timeout = 0;
53 * Cache the actual UF Class
58 * Class constructor. This caches the real user framework class locally,
59 * so we can use it for authentication and validation.
61 * @param string $uf The userframework class
63 public function __construct() {
64 // any external program which call SoapServer is responsible for
65 // creating and attaching the session
66 $args = func_get_args();
67 $this->ufClass
= array_shift($args);
71 * Simple ping function to test for liveness.
73 * @param string $var The string to be echoed
78 public function ping($var) {
79 $session = CRM_Core_Session
::singleton();
80 $key = $session->get('key');
81 $session->set('key', $var);
82 return "PONG: $var ($key)";
88 * @param string $key The soap key generated by authenticate()
93 public function verify($key) {
94 $session = CRM_Core_Session
::singleton();
96 $soap_key = $session->get('soap_key');
99 if ($key !== sha1($soap_key)) {
100 throw new SoapFault('Client', 'Invalid key');
104 if (self
::$soap_timeout &&
105 $t > ($session->get('soap_time') + self
::$soap_timeout)
107 throw new SoapFault('Client', 'Expired key');
110 /* otherwise, we're ok. update the timestamp */
112 $session->set('soap_time', $t);
116 * Authentication wrapper to the UF Class
118 * @param string $name Login name
119 * @param string $pass Password
121 * @return string The SOAP Client key
125 public function authenticate($name, $pass, $loadCMSBootstrap = FALSE) {
126 require_once (str_replace('_', DIRECTORY_SEPARATOR
, $this->ufClass
) . '.php');
128 if ($this->ufClass
== 'CRM_Utils_System_Joomla'){
129 $loadCMSBootstrap = true;
132 $className = $this->ufClass
;
133 $result =& $className::authenticate($name, $pass, $loadCMSBootstrap );
135 if (empty($result)) {
136 throw new SoapFault('Client', 'Invalid login');
139 $session = CRM_Core_Session
::singleton();
140 $session->set('soap_key', $result[2]);
141 $session->set('soap_time', time());
143 return sha1($result[2]);
147 public function mailer_event_bounce($key, $job, $queue, $hash, $body) {
151 'time_stamp' => date('YmdHis'),
152 'event_queue_id' => $queue,
157 return civicrm_api('Mailing', 'event_bounce', $params);
160 public function mailer_event_unsubscribe($key, $job, $queue, $hash) {
164 'time_stamp' => date('YmdHis'),
165 'org_unsubscribe' => 0,
166 'event_queue_id' => $queue,
170 return civicrm_api('MailingGroup', 'event_unsubscribe', $params);
173 public function mailer_event_domain_unsubscribe($key, $job, $queue, $hash) {
177 'time_stamp' => date('YmdHis'),
178 'org_unsubscribe' => 1,
179 'event_queue_id' => $queue,
183 return civicrm_api('MailingGroup', 'event_domain_unsubscribe', $params);
186 public function mailer_event_resubscribe($key, $job, $queue, $hash) {
190 'time_stamp' => date('YmdHis'),
191 'org_unsubscribe' => 0,
192 'event_queue_id' => $queue,
196 return civicrm_api('MailingGroup', 'event_resubscribe', $params);
199 public function mailer_event_subscribe($key, $email, $domain, $group) {
203 'group_id' => $group,
206 return civicrm_api('MailingGroup', 'event_subscribe', $params);
209 public function mailer_event_confirm($key, $contact, $subscribe, $hash) {
212 'contact_id' => $contact,
213 'subscribe_id' => $subscribe,
214 'time_stamp' => date('YmdHis'),
215 'event_subscribe_id' => $subscribe,
219 return civicrm_api('Mailing', 'event_confirm', $params);
222 public function mailer_event_reply($key, $job, $queue, $hash, $bodyTxt, $rt, $bodyHTML = NULL, $fullEmail = NULL) {
226 'event_queue_id' => $queue,
228 'bodyTxt' => $bodyTxt,
230 'bodyHTML' => $bodyHTML,
231 'fullEmail' => $fullEmail,
232 'time_stamp' => date('YmdHis'),
235 return civicrm_api('Mailing', 'event_reply', $params);
238 public function mailer_event_forward($key, $job, $queue, $hash, $email) {
242 'event_queue_id' => $queue,
247 return civicrm_api('Mailing', 'event_forward', $params);
250 public function get_contact($key, $params) {
252 $params['version'] = 3;
253 return civicrm_api('contact', 'get', $params);