Differential D19952 Diff 47693 src/applications/metamta/receiver/PhabricatorMailReceiver.php

Changeset View

Standalone View

src/applications/metamta/receiver/PhabricatorMailReceiver.php

	<?php			<?php

	abstract class PhabricatorMailReceiver extends Phobject {			abstract class PhabricatorMailReceiver extends Phobject {

	private $applicationEmail;			private $viewer;
				private $sender;

	public function setApplicationEmail(			final public function setViewer(PhabricatorUser $viewer) {
	PhabricatorMetaMTAApplicationEmail $email) {			$this->viewer = $viewer;
	$this->applicationEmail = $email;
	return $this;			return $this;
	}			}

	public function getApplicationEmail() {			final public function getViewer() {
	return $this->applicationEmail;			return $this->viewer;
				}

				final public function setSender(PhabricatorUser $sender) {
				$this->sender = $sender;
				return $this;
				}

				final public function getSender() {
				return $this->sender;
	}			}

	abstract public function isEnabled();			abstract public function isEnabled();
	abstract public function canAcceptMail(PhabricatorMetaMTAReceivedMail $mail);			abstract public function canAcceptMail(
				PhabricatorMetaMTAReceivedMail $mail,
				PhutilEmailAddress $target);

	abstract protected function processReceivedMail(			abstract protected function processReceivedMail(
	PhabricatorMetaMTAReceivedMail $mail,			PhabricatorMetaMTAReceivedMail $mail,
	PhabricatorUser $sender);			PhutilEmailAddress $target);

	final public function receiveMail(			final public function receiveMail(
	PhabricatorMetaMTAReceivedMail $mail,			PhabricatorMetaMTAReceivedMail $mail,
	PhabricatorUser $sender) {			PhutilEmailAddress $target) {
	$this->processReceivedMail($mail, $sender);			$this->processReceivedMail($mail, $target);
	}

	public function getViewer() {
	return PhabricatorUser::getOmnipotentUser();
	}

	public function validateSender(
	PhabricatorMetaMTAReceivedMail $mail,
	PhabricatorUser $sender) {

	$failure_reason = null;
	if ($sender->getIsDisabled()) {
	$failure_reason = pht(
	'Your account (%s) is disabled, so you can not interact with '.
	'Phabricator over email.',
	$sender->getUsername());
	} else if ($sender->getIsStandardUser()) {
	if (!$sender->getIsApproved()) {
	$failure_reason = pht(
	'Your account (%s) has not been approved yet. You can not interact '.
	'with Phabricator over email until your account is approved.',
	$sender->getUsername());
	} else if (PhabricatorUserEmail::isEmailVerificationRequired() &&
	!$sender->getIsEmailVerified()) {
	$failure_reason = pht(
	'You have not verified the email address for your account (%s). '.
	'You must verify your email address before you can interact '.
	'with Phabricator over email.',
	$sender->getUsername());
	}
	}

	if ($failure_reason) {
	throw new PhabricatorMetaMTAReceivedMailProcessingException(
	MetaMTAReceivedMailStatus::STATUS_DISABLED_SENDER,
	$failure_reason);
	}
	}

	/**
	* Identifies the sender's user account for a piece of received mail. Note
	* that this method does not validate that the sender is who they say they
	* are, just that they've presented some credential which corresponds to a
	* recognizable user.
	*/
	public function loadSender(PhabricatorMetaMTAReceivedMail $mail) {
	$raw_from = $mail->getHeader('From');
	$from = self::getRawAddress($raw_from);

	$reasons = array();

	// Try to find a user with this email address.
	$user = PhabricatorUser::loadOneWithEmailAddress($from);
	if ($user) {
	return $user;
	} else {
	$reasons[] = pht(
	'This email was sent from "%s", but that address is not recognized by '.
	'Phabricator and does not correspond to any known user account.',
	$raw_from);
	}

	// If we don't know who this user is, load or create an external user
	// account for them if we're configured for it.
	$email_key = 'phabricator.allow-email-users';
	$allow_email_users = PhabricatorEnv::getEnvConfig($email_key);
	if ($allow_email_users) {
	$from_obj = new PhutilEmailAddress($from);
	$xuser = id(new PhabricatorExternalAccountQuery())
	->setViewer($this->getViewer())
	->withAccountTypes(array('email'))
	->withAccountDomains(array($from_obj->getDomainName(), 'self'))
	->withAccountIDs(array($from_obj->getAddress()))
	->requireCapabilities(
	array(
	PhabricatorPolicyCapability::CAN_VIEW,
	PhabricatorPolicyCapability::CAN_EDIT,
	))
	->loadOneOrCreate();
	return $xuser->getPhabricatorUser();
	} else {
	// NOTE: Currently, we'll always drop this mail (since it's headed to
	// an unverified recipient). See T12237. These details are still useful
	// because they'll appear in the mail logs and Mail web UI.

	$reasons[] = pht(
	'Phabricator is also not configured to allow unknown external users '.
	'to send mail to the system using just an email address.');
	$reasons[] = pht(
	'To interact with Phabricator, add this address ("%s") to your '.
	'account.',
	$raw_from);
	}

	if ($this->getApplicationEmail()) {
	$application_email = $this->getApplicationEmail();
	$default_user_phid = $application_email->getConfigValue(
	PhabricatorMetaMTAApplicationEmail::CONFIG_DEFAULT_AUTHOR);

	if ($default_user_phid) {
	$user = id(new PhabricatorUser())->loadOneWhere(
	'phid = %s',
	$default_user_phid);
	if ($user) {
	return $user;
	}

	$reasons[] = pht(
	'Phabricator is misconfigured: the application email '.
	'"%s" is set to user "%s", but that user does not exist.',
	$application_email->getAddress(),
	$default_user_phid);
	}
	}

	$reasons = implode("\n\n", $reasons);

	throw new PhabricatorMetaMTAReceivedMailProcessingException(
	MetaMTAReceivedMailStatus::STATUS_UNKNOWN_SENDER,
	$reasons);
	}

	/**
	* Reduce an email address to its canonical form. For example, an address
	* like:
	*
	* "Abraham Lincoln" < ALincoln@example.com >
	*
	* ...will be reduced to:
	*
	* alincoln@example.com
	*
	* @param string Email address in noncanonical form.
	* @return string Canonical email address.
	*/
	public static function getRawAddress($address) {
	$address = id(new PhutilEmailAddress($address))->getAddress();
	return trim(phutil_utf8_strtolower($address));
	}			}

	}			}