mirror of
https://github.com/the-djmaze/snappymail.git
synced 2026-08-25 10:09:20 +03:00
Merge f6a7ca2146 into c154d23cfe
This commit is contained in:
Kristofer Nilsson
GitHub
commit
f3c3344426
2 changed files with 754 additions and 270 deletions
|
|
@ -1,54 +1,91 @@
|
|||
(rl => {
|
||||
const client_id = rl.pluginSettingsGet('login-o365', 'client_id'),
|
||||
// https://learn.microsoft.com/en-us/entra/identity-platform/reply-url#query-parameter-support-in-redirect-uris
|
||||
query = rl.pluginSettingsGet('login-o365', 'personal') ? '' : '?',
|
||||
tenant = rl.pluginSettingsGet('login-o365', 'tenant'),
|
||||
login = () => {
|
||||
document.location = 'https://login.microsoftonline.com/'+tenant+'/oauth2/v2.0/authorize?' + (new URLSearchParams({
|
||||
response_type: 'code',
|
||||
client_id: client_id,
|
||||
redirect_uri: document.location.href.replace(/\/$/, '') + '/' + query + 'LoginO365',
|
||||
scope: [
|
||||
// Associate personal info
|
||||
'openid',
|
||||
'offline_access',
|
||||
'email',
|
||||
'profile',
|
||||
// Access IMAP and SMTP through OAUTH
|
||||
'https://graph.microsoft.com/IMAP.AccessAsUser.All',
|
||||
// 'https://graph.microsoft.com/Mail.ReadWrite'
|
||||
'https://graph.microsoft.com/Mail.Send'
|
||||
/* // Legacy:
|
||||
'https://outlook.office.com/SMTP.Send',
|
||||
'https://outlook.office.com/IMAP.AccessAsUser.All'
|
||||
*/
|
||||
].join(' '),
|
||||
state: 'o365', // + rl.settings.app('token') + localStorage.getItem('smctoken')
|
||||
// Force authorize screen, so we always get a refresh_token
|
||||
access_type: 'offline',
|
||||
prompt: 'consent'
|
||||
}));
|
||||
};
|
||||
((rl) => {
|
||||
const client_id = rl.pluginSettingsGet("login-o365", "client_id"),
|
||||
allowAnyDomain = !!rl.pluginSettingsGet("login-o365", "allow_any_domain"),
|
||||
isSupportedEmail = (email) => {
|
||||
email = (email || "").toLowerCase();
|
||||
if (!email.includes("@")) return false;
|
||||
if (allowAnyDomain) return true;
|
||||
return /@(outlook\.com|hotmail\.com|live\.com)$/.test(email);
|
||||
},
|
||||
startOAuth = (op, opts = {}) => {
|
||||
const email = (opts.email || "").toLowerCase();
|
||||
const name = opts.name || "";
|
||||
const returnHash = opts.return || "";
|
||||
|
||||
if (client_id) {
|
||||
addEventListener('sm-user-login', e => {
|
||||
if (event.detail.get('Email').includes('@hotmail.com')) {
|
||||
e.preventDefault();
|
||||
login();
|
||||
}
|
||||
});
|
||||
// Server mints a signed state + correct redirect_uri and returns full authUrl.
|
||||
rl.pluginRemoteRequest((iError, data) => {
|
||||
const url = data?.Result?.authUrl;
|
||||
if (!iError && url) {
|
||||
document.location = url;
|
||||
}
|
||||
}, "LoginO365AuthUrl", {
|
||||
op: op,
|
||||
email: email,
|
||||
name: name,
|
||||
return: returnHash,
|
||||
});
|
||||
};
|
||||
|
||||
addEventListener('rl-view-model', e => {
|
||||
if ('Login' === e.detail.viewModelTemplateID) {
|
||||
const
|
||||
container = e.detail.viewModelDom.querySelector('#plugin-Login-BottomControlGroup'),
|
||||
btn = Element.fromHTML('<button type="button">Outlook</button>'),
|
||||
div = Element.fromHTML('<div class="controls"></div>');
|
||||
btn.onclick = login;
|
||||
div.append(btn);
|
||||
container && container.append(div);
|
||||
}
|
||||
});
|
||||
}
|
||||
if (client_id) {
|
||||
addEventListener("sm-user-login", (e) => {
|
||||
const email = (e.detail.get("Email") || "").toLowerCase();
|
||||
if (isSupportedEmail(email)) {
|
||||
e.preventDefault();
|
||||
startOAuth("login", { email });
|
||||
}
|
||||
});
|
||||
|
||||
addEventListener("rl-view-model", (e) => {
|
||||
if ("Login" === e.detail.viewModelTemplateID) {
|
||||
const
|
||||
container = e.detail.viewModelDom.querySelector("#plugin-Login-BottomControlGroup"),
|
||||
btn = Element.fromHTML('<button type="button">Outlook</button>'),
|
||||
div = Element.fromHTML('<div class="controls"></div>');
|
||||
btn.onclick = () => {
|
||||
// Best-effort: try to read the email field if present.
|
||||
const input = e.detail.viewModelDom.querySelector('input[type="email"], input[name="Email"], input[name="email"], input');
|
||||
const email = (input?.value || "").toLowerCase();
|
||||
if (!email || isSupportedEmail(email)) {
|
||||
startOAuth("login", { email });
|
||||
}
|
||||
};
|
||||
div.append(btn);
|
||||
container && container.append(div);
|
||||
}
|
||||
|
||||
// "Add account" popup (Settings → Accounts → Add account)
|
||||
if ("PopupsAccount" === e.detail.viewModelTemplateID) {
|
||||
// Only for the "Add account" mode, not "Edit account".
|
||||
if (typeof e.detail.isNew === "function" && !e.detail.isNew()) {
|
||||
return;
|
||||
}
|
||||
const root = e.detail.viewModelDom;
|
||||
if (!root) return;
|
||||
|
||||
const footer = root.querySelector("footer");
|
||||
const form = root.querySelector("#accountform");
|
||||
const addButton = root.querySelector("button.buttonAddAccount");
|
||||
if (!footer || !form || !addButton) return;
|
||||
|
||||
// Avoid inserting duplicates when view model is re-rendered.
|
||||
if (root.querySelector(".plugin-o365-add-account")) return;
|
||||
|
||||
const btn = Element.fromHTML(
|
||||
'<button type="button" class="btn plugin-o365-add-account" style="margin-left: 6px;">Outlook</button>'
|
||||
);
|
||||
|
||||
btn.onclick = () => {
|
||||
const email = (form.querySelector('input[name="email"]')?.value || "").trim().toLowerCase();
|
||||
const name = (form.querySelector('input[name="name"]')?.value || "").trim();
|
||||
if (!email || !isSupportedEmail(email)) {
|
||||
return;
|
||||
}
|
||||
startOAuth("add", { email, name, return: document.location.hash || "#/settings/accounts" });
|
||||
};
|
||||
|
||||
// Put the button next to the default Add Account submit button.
|
||||
footer.insertBefore(btn, addButton.nextSibling);
|
||||
}
|
||||
});
|
||||
}
|
||||
})(window.rl);
|
||||
|
|
|
|||
|
|
@ -1,15 +1,20 @@
|
|||
<?php
|
||||
/**
|
||||
* Microsoft requires an Azure account that has an active subscription
|
||||
* I'm not going to pay, so feel free to fix this code yourself.
|
||||
* https://learn.microsoft.com/en-us/exchange/client-developer/legacy-protocols/how-to-authenticate-an-imap-pop-smtp-application-by-using-oauth
|
||||
* https://answers.microsoft.com/en-us/msoffice/forum/all/configuration-for-imap-pop-and-smtp-with-oauth-in/3db47d43-25ac-4e0b-b957-22585e6caf15
|
||||
*
|
||||
* https://portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/RegisteredApps
|
||||
*
|
||||
* SnappyMail login-o365 plugin
|
||||
* You need to register an app in Azure portal and add
|
||||
* a secret, redirect URIs and the following API permissions:
|
||||
* https://outlook.office.com/IMAP.AccessAsUser.All
|
||||
* https://outlook.office.com/SMTP.Send
|
||||
* openid offline_access email profile
|
||||
* https://learn.microsoft.com/en-us/entra/identity-platform/reply-url#query-parameter-support-in-redirect-uris
|
||||
* Azure: redirect_uri=https://{DOMAIN}/?LoginO365
|
||||
* Personal: redirect_uri=https://{DOMAIN}/LoginO365
|
||||
* Query: redirect_uri=https://{DOMAIN}/?LoginO365
|
||||
* Path: redirect_uri=https://{DOMAIN}/LoginO365
|
||||
*
|
||||
* If running behind nginx reverse proxy you might
|
||||
* need to add the following to your nginx config:
|
||||
* location = /LoginO365 {
|
||||
* return 302 /?LoginO365&$args;
|
||||
* }
|
||||
*/
|
||||
|
||||
use RainLoop\Model\MainAccount;
|
||||
|
|
@ -17,232 +22,674 @@ use RainLoop\Providers\Storage\Enumerations\StorageType;
|
|||
|
||||
class LoginO365Plugin extends \RainLoop\Plugins\AbstractPlugin
|
||||
{
|
||||
const
|
||||
NAME = 'Office365/Outlook OAuth2',
|
||||
VERSION = '0.3',
|
||||
RELEASE = '2024-09-29',
|
||||
REQUIRED = '2.36.1',
|
||||
CATEGORY = 'Login',
|
||||
DESCRIPTION = 'Office365/Outlook IMAP, Sieve & SMTP login using RFC 7628 OAuth2';
|
||||
const
|
||||
NAME = 'Office365/Outlook OAuth2',
|
||||
VERSION = '0.4',
|
||||
RELEASE = '2025-12-22',
|
||||
REQUIRED = '2.36.1',
|
||||
CATEGORY = 'Login',
|
||||
DESCRIPTION = 'Office365/Outlook IMAP, Sieve & SMTP login using RFC 7628 OAuth2';
|
||||
|
||||
// https://login.microsoftonline.com/{{tenant}}/v2.0/.well-known/openid-configuration
|
||||
const
|
||||
LOGIN_URI = 'https://login.microsoftonline.com/{{tenant}}/oauth2/v2.0/auth',
|
||||
TOKEN_URI = 'https://login.microsoftonline.com/{{tenant}}/oauth2/v2.0/token';
|
||||
// v2 endpoints
|
||||
const
|
||||
AUTH_URI = 'https://login.microsoftonline.com/{{tenant}}/oauth2/v2.0/authorize',
|
||||
TOKEN_URI = 'https://login.microsoftonline.com/{{tenant}}/oauth2/v2.0/token';
|
||||
|
||||
private static ?array $auth = null;
|
||||
/**
|
||||
* In-request cache of decrypted token bundles, keyed by lowercase email.
|
||||
* This avoids re-decrypting the same blob multiple times during a single request.
|
||||
*
|
||||
* Shape:
|
||||
* [
|
||||
* 'user@outlook.com' => ['access_token'=>..., 'refresh_token'=>..., 'expires'=>..., 'expires_in'=>...],
|
||||
* ...
|
||||
* ]
|
||||
*/
|
||||
private static array $auth = [];
|
||||
|
||||
public function Init() : void
|
||||
{
|
||||
$this->UseLangs(true);
|
||||
$this->addJs('LoginOAuth2.js');
|
||||
$this->addHook('imap.before-login', 'clientLogin');
|
||||
$this->addHook('smtp.before-login', 'clientLogin');
|
||||
$this->addHook('sieve.before-login', 'clientLogin');
|
||||
public function Init() : void
|
||||
{
|
||||
$this->UseLangs(true);
|
||||
$this->addJs('LoginOAuth2.js');
|
||||
$this->addHook('imap.before-login', 'clientLogin');
|
||||
$this->addHook('smtp.before-login', 'clientLogin');
|
||||
$this->addHook('sieve.before-login', 'clientLogin');
|
||||
|
||||
$this->addPartHook('LoginO365', 'ServiceLoginO365');
|
||||
$this->addPartHook('LoginO365', 'ServiceLoginO365');
|
||||
// Used by JS to obtain an auth URL with signed state (for both login + add-account flows).
|
||||
$this->addJsonHook('LoginO365AuthUrl', 'DoLoginO365AuthUrl');
|
||||
|
||||
// Prevent Disallowed Sec-Fetch Dest: document Mode: navigate Site: cross-site User: true
|
||||
$this->addHook('filter.http-paths', 'httpPaths');
|
||||
}
|
||||
// Prevent Disallowed Sec-Fetch Dest: document Mode: navigate Site: cross-site User: true
|
||||
$this->addHook('filter.http-paths', 'httpPaths');
|
||||
|
||||
public function httpPaths(array &$aPaths) : void
|
||||
{
|
||||
// Personal accounts workaround
|
||||
if (!empty($_SERVER['PATH_INFO']) && \str_ends_with($_SERVER['PATH_INFO'], 'LoginO365')) {
|
||||
$aPaths = ['LoginO365'];
|
||||
}
|
||||
// Cleanup: when an additional account is removed, also remove its encrypted refresh token bundle.
|
||||
$this->addHook('json.after-AccountDelete', 'afterAccountDelete');
|
||||
}
|
||||
|
||||
if (!empty($aPaths[0]) && 'LoginO365' === $aPaths[0]) {
|
||||
$oConfig = \RainLoop\Api::Config();
|
||||
$oConfig->Set('security', 'secfetch_allow',
|
||||
\trim($oConfig->Get('security', 'secfetch_allow', '') . ';site=cross-site', ';')
|
||||
);
|
||||
}
|
||||
}
|
||||
public function httpPaths(array &$aPaths) : void
|
||||
{
|
||||
if (!empty($_SERVER['PATH_INFO']) && \str_ends_with($_SERVER['PATH_INFO'], 'LoginO365')) {
|
||||
$aPaths = ['LoginO365'];
|
||||
}
|
||||
|
||||
public function ServiceLoginO365() : string
|
||||
{
|
||||
$oActions = \RainLoop\Api::Actions();
|
||||
$oHttp = $oActions->Http();
|
||||
$oHttp->ServerNoCache();
|
||||
if (!empty($aPaths[0]) && 'LoginO365' === $aPaths[0]) {
|
||||
$oConfig = \RainLoop\Api::Config();
|
||||
$oConfig->Set('security', 'secfetch_allow',
|
||||
\trim($oConfig->Get('security', 'secfetch_allow', '') . ';site=cross-site', ';')
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
try
|
||||
public function ServiceLoginO365() : string
|
||||
{
|
||||
$oActions = \RainLoop\Api::Actions();
|
||||
$oHttp = $oActions->Http();
|
||||
$oHttp->ServerNoCache();
|
||||
|
||||
try
|
||||
{
|
||||
if (isset($_GET['error'])) {
|
||||
throw new \RuntimeException("{$_GET['error']}: {$_GET['error_description']}");
|
||||
}
|
||||
if (!isset($_GET['code']) || empty($_GET['state']) || 'o365' !== $_GET['state']) {
|
||||
$oActions->Location(\RainLoop\Utils::WebPath());
|
||||
exit;
|
||||
}
|
||||
$oO365 = $this->o365Connector();
|
||||
if (!$oO365) {
|
||||
$oActions->Location(\RainLoop\Utils::WebPath());
|
||||
exit;
|
||||
}
|
||||
if (isset($_GET['error'])) {
|
||||
$desc = $_GET['error_description'] ?? '';
|
||||
throw new \RuntimeException("{$_GET['error']}: {$desc}");
|
||||
}
|
||||
|
||||
$iExpires = \time();
|
||||
$aResponse = $oO365->getAccessToken(
|
||||
\str_replace('{{tenant}}', $this->Config()->Get('plugin', 'tenant', 'common'), static::TOKEN_URI),
|
||||
'authorization_code',
|
||||
array(
|
||||
'code' => $_GET['code'],
|
||||
'redirect_uri' => $oHttp->GetFullUrl().'?LoginO365'
|
||||
)
|
||||
);
|
||||
if (200 != $aResponse['code']) {
|
||||
if (isset($aResponse['result']['error'])) {
|
||||
throw new \RuntimeException(
|
||||
$aResponse['code']
|
||||
. ': '
|
||||
. $aResponse['result']['error']
|
||||
. ' / '
|
||||
. $aResponse['result']['error_description']
|
||||
);
|
||||
}
|
||||
throw new \RuntimeException("HTTP: {$aResponse['code']}");
|
||||
}
|
||||
$aResponse = $aResponse['result'];
|
||||
if (empty($aResponse['access_token'])) {
|
||||
throw new \RuntimeException('access_token missing');
|
||||
}
|
||||
if (empty($aResponse['refresh_token'])) {
|
||||
throw new \RuntimeException('refresh_token missing');
|
||||
}
|
||||
// Must have code + state
|
||||
if (!isset($_GET['code']) || empty($_GET['state'])) {
|
||||
$oActions->Location(\RainLoop\Utils::WebPath());
|
||||
exit;
|
||||
}
|
||||
|
||||
$sAccessToken = $aResponse['access_token'];
|
||||
$iExpires += $aResponse['expires_in'];
|
||||
$oO365 = $this->o365Connector();
|
||||
if (!$oO365) {
|
||||
$oActions->Location(\RainLoop\Utils::WebPath());
|
||||
exit;
|
||||
}
|
||||
|
||||
$oO365->setAccessToken($sAccessToken);
|
||||
$aUserInfo = $oO365->fetch('https://graph.microsoft.com/oidc/userinfo');
|
||||
if (200 != $aUserInfo['code']) {
|
||||
throw new \RuntimeException("HTTP: {$aResponse['code']}");
|
||||
}
|
||||
$aUserInfo = $aUserInfo['result'];
|
||||
if (empty($aUserInfo['id'])) {
|
||||
throw new \RuntimeException('unknown id');
|
||||
}
|
||||
if (empty($aUserInfo['email'])) {
|
||||
throw new \RuntimeException('unknown email address');
|
||||
}
|
||||
$iNow = \time();
|
||||
|
||||
static::$auth = [
|
||||
'access_token' => $sAccessToken,
|
||||
'refresh_token' => $aResponse['refresh_token'],
|
||||
'expires_in' => $aResponse['expires_in'],
|
||||
'expires' => $iExpires
|
||||
];
|
||||
$redirectUri = $this->redirectUri();
|
||||
|
||||
$oPassword = new \SnappyMail\SensitiveString($aUserInfo['id']);
|
||||
$oAccount = $oActions->LoginProcess($aUserInfo['email'], $oPassword);
|
||||
// $oAccount = MainAccount::NewInstanceFromCredentials($oActions, $aUserInfo['email'], $aUserInfo['email'], $oPassword, true);
|
||||
if ($oAccount) {
|
||||
// $oActions->SetMainAuthAccount($oAccount);
|
||||
// $oActions->SetAuthToken($oAccount);
|
||||
$oActions->StorageProvider()->Put($oAccount, StorageType::SESSION, \RainLoop\Utils::GetSessionToken(),
|
||||
\SnappyMail\Crypt::EncryptToJSON(static::$auth, $oAccount->CryptKey())
|
||||
);
|
||||
}
|
||||
}
|
||||
catch (\Exception $oException)
|
||||
{
|
||||
$oActions->Logger()->WriteException($oException, \LOG_ERR);
|
||||
}
|
||||
$oActions->Location(\RainLoop\Utils::WebPath());
|
||||
exit;
|
||||
}
|
||||
$tenant = $this->Config()->Get('plugin', 'tenant', 'common');
|
||||
|
||||
public function configMapping() : array
|
||||
{
|
||||
return [
|
||||
\RainLoop\Plugins\Property::NewInstance('personal')
|
||||
->SetLabel('Use with personal accounts')
|
||||
->SetType(\RainLoop\Enumerations\PluginPropertyType::BOOL)
|
||||
->SetDefaultValue(true)
|
||||
->SetAllowedInJs()
|
||||
->SetDescription('Sign in users with personal Microsoft accounts such as Outlook.com (Hotmail)'),
|
||||
\RainLoop\Plugins\Property::NewInstance('client_id')
|
||||
->SetLabel('Client ID')
|
||||
->SetType(\RainLoop\Enumerations\PluginPropertyType::STRING)
|
||||
->SetAllowedInJs()
|
||||
->SetDescription('https://github.com/the-djmaze/snappymail/wiki/FAQ#o365'),
|
||||
\RainLoop\Plugins\Property::NewInstance('client_secret')
|
||||
->SetLabel('Client Secret')
|
||||
->SetType(\RainLoop\Enumerations\PluginPropertyType::STRING)
|
||||
->SetEncrypted(),
|
||||
\RainLoop\Plugins\Property::NewInstance('tenant_id')
|
||||
->SetLabel('Tenant ID')
|
||||
->SetType(\RainLoop\Enumerations\PluginPropertyType::STRING),
|
||||
\RainLoop\Plugins\Property::NewInstance('tenant')->SetLabel('Tenant')
|
||||
->SetType(\RainLoop\Enumerations\PluginPropertyType::SELECTION)
|
||||
->SetDefaultValue(['common','consumers','organizations'])
|
||||
->SetAllowedInJs()
|
||||
];
|
||||
}
|
||||
$state = (string) $_GET['state'];
|
||||
$statePayload = $this->verifyAndConsumeState($state);
|
||||
if (!$statePayload) {
|
||||
$oActions->Location(\RainLoop\Utils::WebPath());
|
||||
exit;
|
||||
}
|
||||
|
||||
public function clientLogin(\RainLoop\Model\Account $oAccount, \MailSo\Net\NetClient $oClient, \MailSo\Net\ConnectSettings $oSettings) : void
|
||||
{
|
||||
if ($oAccount instanceof MainAccount && \str_ends_with($oAccount->Email(), '@hotmail.com')) {
|
||||
$oActions = \RainLoop\Api::Actions();
|
||||
try {
|
||||
$aData = static::$auth ?: \SnappyMail\Crypt::DecryptFromJSON(
|
||||
$oActions->StorageProvider()->Get($oAccount, StorageType::SESSION, \RainLoop\Utils::GetSessionToken()),
|
||||
$oAccount->CryptKey()
|
||||
);
|
||||
} catch (\Throwable $oException) {
|
||||
// $oActions->Logger()->WriteException($oException, \LOG_ERR);
|
||||
return;
|
||||
}
|
||||
if (!empty($aData['expires']) && !empty($aData['access_token']) && !empty($aData['refresh_token'])) {
|
||||
if (\time() >= $aData['expires']) {
|
||||
$iExpires = \time();
|
||||
$oO365 = $this->o365Connector();
|
||||
if ($oO365) {
|
||||
$aRefreshTokenResponse = $oO365->getAccessToken(
|
||||
\str_replace('{{tenant}}', $this->Config()->Get('plugin', 'tenant', 'common'), static::TOKEN_URI),
|
||||
'refresh_token',
|
||||
array('refresh_token' => $aData['refresh_token'])
|
||||
);
|
||||
if (!empty($aRefreshTokenResponse['result']['access_token'])) {
|
||||
$aData['access_token'] = $aRefreshTokenResponse['result']['access_token'];
|
||||
$aResponse['expires'] = $iExpires + $aResponse['expires_in'];
|
||||
$oActions->StorageProvider()->Put($oAccount, StorageType::SESSION, \RainLoop\Utils::GetSessionToken(),
|
||||
\SnappyMail\Crypt::EncryptToJSON($aData, $oAccount->CryptKey())
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
$oSettings->passphrase = $aData['access_token'];
|
||||
\array_unshift($oSettings->SASLMechanisms, 'OAUTHBEARER', 'XOAUTH2');
|
||||
}
|
||||
}
|
||||
}
|
||||
$aTokenWrap = $oO365->getAccessToken(
|
||||
\str_replace('{{tenant}}', $tenant, static::TOKEN_URI),
|
||||
'authorization_code',
|
||||
[
|
||||
'code' => $_GET['code'],
|
||||
'redirect_uri' => $redirectUri
|
||||
]
|
||||
);
|
||||
|
||||
protected function o365Connector() : ?\OAuth2\Client
|
||||
{
|
||||
$client_id = \trim($this->Config()->Get('plugin', 'client_id', ''));
|
||||
$client_secret = \trim($this->Config()->getDecrypted('plugin', 'client_secret', ''));
|
||||
if ($client_id && $client_secret) {
|
||||
try
|
||||
{
|
||||
$oO365 = new \OAuth2\Client($client_id, $client_secret);
|
||||
$oActions = \RainLoop\Api::Actions();
|
||||
$sProxy = $oActions->Config()->Get('labs', 'curl_proxy', '');
|
||||
if (\strlen($sProxy)) {
|
||||
$oO365->setCurlOption(CURLOPT_PROXY, $sProxy);
|
||||
$sProxyAuth = $oActions->Config()->Get('labs', 'curl_proxy_auth', '');
|
||||
if (\strlen($sProxyAuth)) {
|
||||
$oO365->setCurlOption(CURLOPT_PROXYUSERPWD, $sProxyAuth);
|
||||
}
|
||||
}
|
||||
return $oO365;
|
||||
}
|
||||
catch (\Exception $oException)
|
||||
{
|
||||
$oActions->Logger()->WriteException($oException, \LOG_ERR);
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
}
|
||||
if (!\is_array($aTokenWrap) || !isset($aTokenWrap['code'])) {
|
||||
throw new \RuntimeException('Token request failed: ' . \json_encode($aTokenWrap));
|
||||
}
|
||||
if (200 !== (int)$aTokenWrap['code']) {
|
||||
$err = $aTokenWrap['result']['error'] ?? '';
|
||||
$desc = $aTokenWrap['result']['error_description'] ?? '';
|
||||
throw new \RuntimeException("Token HTTP {$aTokenWrap['code']}: {$err} / {$desc}");
|
||||
}
|
||||
|
||||
$aToken = $aTokenWrap['result'] ?? [];
|
||||
$accessToken = $aToken['access_token'] ?? '';
|
||||
$refreshToken = $aToken['refresh_token'] ?? '';
|
||||
$expiresIn = (int)($aToken['expires_in'] ?? 0);
|
||||
$idToken = $aToken['id_token'] ?? '';
|
||||
|
||||
if ($accessToken === '') {
|
||||
throw new \RuntimeException('access_token missing');
|
||||
}
|
||||
|
||||
if ($refreshToken === '') {
|
||||
throw new \RuntimeException('refresh_token missing');
|
||||
}
|
||||
if ($idToken === '') {
|
||||
// We rely on id_token to get email/sub without Graph.
|
||||
throw new \RuntimeException('id_token missing (add openid email profile scopes)');
|
||||
}
|
||||
|
||||
// Parse id_token (JWT) to get identity (sub + email)
|
||||
$claims = $this->decodeJwtPayload($idToken);
|
||||
if (!\is_array($claims)) {
|
||||
throw new \RuntimeException('Cannot decode id_token payload');
|
||||
}
|
||||
|
||||
$email = $claims['email'] ?? ($claims['preferred_username'] ?? ($claims['upn'] ?? ''));
|
||||
$sub = $claims['sub'] ?? '';
|
||||
|
||||
if ($sub === '') {
|
||||
throw new \RuntimeException('unknown id from id_token');
|
||||
}
|
||||
if ($email === '') {
|
||||
throw new \RuntimeException('unknown email address from id_token');
|
||||
}
|
||||
|
||||
if (!$this->isSupportedEmail(\strtolower($email))) {
|
||||
throw new \RuntimeException('Unsupported email domain for this plugin');
|
||||
}
|
||||
|
||||
$tokenBundle = [
|
||||
'access_token' => $accessToken,
|
||||
'refresh_token' => $refreshToken,
|
||||
'expires_in' => $expiresIn,
|
||||
'expires' => $iNow + $expiresIn
|
||||
];
|
||||
|
||||
$op = $statePayload['op'] ?? 'login';
|
||||
if ('add' === $op) {
|
||||
$oMainAccount = $oActions->getMainAccountFromToken(false);
|
||||
if (!$oMainAccount) {
|
||||
throw new \RuntimeException('Add-account flow requires logged in main account');
|
||||
}
|
||||
if (!empty($statePayload['main']) && $statePayload['main'] !== $oMainAccount->Email()) {
|
||||
throw new \RuntimeException('Add-account state does not match current main account');
|
||||
}
|
||||
|
||||
// Store token bundle encrypted with MAIN account crypt key (never store refresh_token unencrypted).
|
||||
// This is later used by imap/smtp/sieve.before-login for *additional* accounts.
|
||||
$this->storeAccountTokens($oMainAccount, $email, $tokenBundle);
|
||||
|
||||
// Create/validate an AdditionalAccount entry exactly like SnappyMail expects in "additionalaccounts".
|
||||
// We set the "password" to the OAuth subject (sub) as an opaque secret; the plugin will inject XOAUTH2.
|
||||
$oPassword = new \SnappyMail\SensitiveString($sub);
|
||||
$oAdditional = $oActions->LoginProcess($email, $oPassword, false);
|
||||
if (!$oAdditional instanceof \RainLoop\Model\AdditionalAccount) {
|
||||
throw new \RuntimeException('Failed to create additional account');
|
||||
}
|
||||
|
||||
$asciiEmail = \SnappyMail\IDN::emailToAscii($oAdditional->Email());
|
||||
if ($asciiEmail === $oMainAccount->Email()) {
|
||||
throw new \RuntimeException('Cannot add main account as additional');
|
||||
}
|
||||
|
||||
$aAccounts = $oActions->GetAccounts($oMainAccount);
|
||||
$aEntry = $oAdditional->asTokenArray($oMainAccount);
|
||||
if (!empty($statePayload['name']) && \is_string($statePayload['name'])) {
|
||||
$aEntry['name'] = \trim($statePayload['name']);
|
||||
} else if (isset($aAccounts[$asciiEmail]['name'])) {
|
||||
// Preserve previous custom label if re-adding/updating.
|
||||
$aEntry['name'] = (string) $aAccounts[$asciiEmail]['name'];
|
||||
}
|
||||
$aAccounts[$asciiEmail] = $aEntry;
|
||||
$oActions->SetAccounts($oMainAccount, $aAccounts);
|
||||
|
||||
// Cache for this request (used during LoginProcess() above and any subsequent logins).
|
||||
static::$auth[\strtolower($asciiEmail)] = $tokenBundle;
|
||||
|
||||
$returnHash = '';
|
||||
if (!empty($statePayload['return']) && \is_string($statePayload['return']) && \str_starts_with($statePayload['return'], '#')) {
|
||||
$returnHash = $statePayload['return'];
|
||||
}
|
||||
$oActions->Location(\RainLoop\Utils::WebPath() . $returnHash);
|
||||
exit;
|
||||
}
|
||||
|
||||
// Default: "login" flow (preserve existing behavior)
|
||||
static::$auth[\strtolower($email)] = $tokenBundle;
|
||||
|
||||
// SnappyMail uses password as opaque string; plugin injects XOAUTH2 later.
|
||||
$oPassword = new \SnappyMail\SensitiveString($sub);
|
||||
$oAccount = $oActions->LoginProcess($email, $oPassword);
|
||||
|
||||
if ($oAccount) {
|
||||
$oActions->StorageProvider()->Put(
|
||||
$oAccount,
|
||||
StorageType::SESSION,
|
||||
\RainLoop\Utils::GetSessionToken(),
|
||||
\SnappyMail\Crypt::EncryptToJSON($tokenBundle, $oAccount->CryptKey())
|
||||
);
|
||||
}
|
||||
}
|
||||
catch (\Throwable $e) {
|
||||
$oActions->Logger()->WriteException($e, \LOG_ERR);
|
||||
}
|
||||
|
||||
$oActions->Location(\RainLoop\Utils::WebPath());
|
||||
exit;
|
||||
}
|
||||
|
||||
public function configMapping() : array
|
||||
{
|
||||
return [
|
||||
\RainLoop\Plugins\Property::NewInstance('client_id')
|
||||
->SetLabel('Client ID')
|
||||
->SetType(\RainLoop\Enumerations\PluginPropertyType::STRING)
|
||||
->SetAllowedInJs(),
|
||||
\RainLoop\Plugins\Property::NewInstance('client_secret')
|
||||
->SetLabel('Client Secret')
|
||||
->SetType(\RainLoop\Enumerations\PluginPropertyType::STRING)
|
||||
->SetEncrypted(),
|
||||
\RainLoop\Plugins\Property::NewInstance('tenant')
|
||||
->SetLabel('Tenant')
|
||||
->SetType(\RainLoop\Enumerations\PluginPropertyType::SELECTION)
|
||||
->SetDefaultValue(['common','consumers','organizations'])
|
||||
->SetAllowedInJs(),
|
||||
\RainLoop\Plugins\Property::NewInstance('personal')
|
||||
// When true: redirect URI uses query parameter form "/?LoginO365" (Azure supports it).
|
||||
// When false: redirect URI uses path form "/LoginO365" (useful behind reverse proxies).
|
||||
->SetLabel('Use "/?LoginO365" redirect URI')
|
||||
->SetType(\RainLoop\Enumerations\PluginPropertyType::BOOL)
|
||||
->SetDefaultValue(false)
|
||||
->SetAllowedInJs(),
|
||||
\RainLoop\Plugins\Property::NewInstance('allow_any_domain')
|
||||
->SetLabel('Allow any domain (not only outlook.com/hotmail.com/live.com)')
|
||||
->SetType(\RainLoop\Enumerations\PluginPropertyType::BOOL)
|
||||
->SetDefaultValue(false)
|
||||
->SetAllowedInJs()
|
||||
];
|
||||
}
|
||||
|
||||
public function clientLogin(\RainLoop\Model\Account $oAccount, \MailSo\Net\NetClient $oClient, \MailSo\Net\ConnectSettings $oSettings) : void
|
||||
{
|
||||
$email = \strtolower($oAccount->Email());
|
||||
|
||||
if (!$this->isSupportedEmail($email)) {
|
||||
return;
|
||||
}
|
||||
|
||||
$oActions = \RainLoop\Api::Actions();
|
||||
|
||||
$aData = static::$auth[$email] ?? null;
|
||||
if (!$aData) {
|
||||
try {
|
||||
if ($oAccount instanceof MainAccount) {
|
||||
$blob = $oActions->StorageProvider()->Get(
|
||||
$oAccount,
|
||||
StorageType::SESSION,
|
||||
\RainLoop\Utils::GetSessionToken()
|
||||
);
|
||||
$aData = \SnappyMail\Crypt::DecryptFromJSON($blob, $oAccount->CryptKey());
|
||||
} else if ($oAccount instanceof \RainLoop\Model\AdditionalAccount) {
|
||||
$oMain = $oActions->getMainAccountFromToken(false);
|
||||
if (!$oMain) {
|
||||
return;
|
||||
}
|
||||
$blob = $oActions->StorageProvider()->Get(
|
||||
$oMain,
|
||||
StorageType::CONFIG,
|
||||
$this->tokenStorageKey($email)
|
||||
);
|
||||
$aData = \SnappyMail\Crypt::DecryptFromJSON($blob, $oMain->CryptKey());
|
||||
}
|
||||
} catch (\Throwable $e) {
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
if (empty($aData['access_token']) || empty($aData['refresh_token']) || empty($aData['expires'])) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Refresh if expired (or close to expiry)
|
||||
if (\time() >= ((int)$aData['expires'] - 30)) {
|
||||
$oO365 = $this->o365Connector();
|
||||
if ($oO365) {
|
||||
$tenant = $this->Config()->Get('plugin', 'tenant', 'common');
|
||||
$aRefreshWrap = $oO365->getAccessToken(
|
||||
\str_replace('{{tenant}}', $tenant, static::TOKEN_URI),
|
||||
'refresh_token',
|
||||
['refresh_token' => $aData['refresh_token']]
|
||||
);
|
||||
|
||||
if (\is_array($aRefreshWrap) && isset($aRefreshWrap['code']) && 200 === (int)$aRefreshWrap['code']) {
|
||||
$r = $aRefreshWrap['result'] ?? [];
|
||||
if (!empty($r['access_token'])) {
|
||||
$aData['access_token'] = $r['access_token'];
|
||||
}
|
||||
if (!empty($r['refresh_token'])) {
|
||||
$aData['refresh_token'] = $r['refresh_token'];
|
||||
}
|
||||
$expiresIn = (int)($r['expires_in'] ?? 0);
|
||||
if ($expiresIn > 0) {
|
||||
$aData['expires'] = \time() + $expiresIn;
|
||||
$aData['expires_in'] = $expiresIn;
|
||||
}
|
||||
|
||||
// Persist updated bundle (encrypted).
|
||||
if ($oAccount instanceof MainAccount) {
|
||||
$oActions->StorageProvider()->Put(
|
||||
$oAccount,
|
||||
StorageType::SESSION,
|
||||
\RainLoop\Utils::GetSessionToken(),
|
||||
\SnappyMail\Crypt::EncryptToJSON($aData, $oAccount->CryptKey())
|
||||
);
|
||||
} else if ($oAccount instanceof \RainLoop\Model\AdditionalAccount) {
|
||||
$oMain = $oActions->getMainAccountFromToken(false);
|
||||
if ($oMain) {
|
||||
$oActions->StorageProvider()->Put(
|
||||
$oMain,
|
||||
StorageType::CONFIG,
|
||||
$this->tokenStorageKey($email),
|
||||
\SnappyMail\Crypt::EncryptToJSON($aData, $oMain->CryptKey())
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
static::$auth[$email] = $aData;
|
||||
|
||||
// Inject XOAUTH2/OAUTHBEARER
|
||||
$oSettings->passphrase = $aData['access_token'];
|
||||
\array_unshift($oSettings->SASLMechanisms, 'OAUTHBEARER', 'XOAUTH2');
|
||||
}
|
||||
|
||||
/**
|
||||
* Server-side cleanup hook: after a successful AccountDelete, remove stored token bundle for that email.
|
||||
* This prevents leaving encrypted refresh tokens behind when an additional account is removed.
|
||||
*/
|
||||
public function afterAccountDelete(array &$aResponse) : void
|
||||
{
|
||||
if (empty($aResponse['Result'])) {
|
||||
return;
|
||||
}
|
||||
$oActions = \RainLoop\Api::Actions();
|
||||
$oMain = $oActions->getMainAccountFromToken(false);
|
||||
if (!$oMain) {
|
||||
return;
|
||||
}
|
||||
$email = \strtolower(\SnappyMail\IDN::emailToAscii(\trim((string) $oActions->GetActionParam('emailToDelete', ''))));
|
||||
if ($email && $this->isSupportedEmail($email)) {
|
||||
$oActions->StorageProvider()->Clear($oMain, StorageType::CONFIG, $this->tokenStorageKey($email));
|
||||
}
|
||||
}
|
||||
|
||||
protected function o365Connector() : ?\OAuth2\Client
|
||||
{
|
||||
$client_id = \trim($this->Config()->Get('plugin', 'client_id', ''));
|
||||
$client_secret = \trim($this->Config()->getDecrypted('plugin', 'client_secret', ''));
|
||||
|
||||
if ($client_id && $client_secret) {
|
||||
try {
|
||||
$oO365 = new \OAuth2\Client($client_id, $client_secret);
|
||||
|
||||
$oActions = \RainLoop\Api::Actions();
|
||||
$sProxy = $oActions->Config()->Get('labs', 'curl_proxy', '');
|
||||
if (\strlen($sProxy)) {
|
||||
$oO365->setCurlOption(CURLOPT_PROXY, $sProxy);
|
||||
$sProxyAuth = $oActions->Config()->Get('labs', 'curl_proxy_auth', '');
|
||||
if (\strlen($sProxyAuth)) {
|
||||
$oO365->setCurlOption(CURLOPT_PROXYUSERPWD, $sProxyAuth);
|
||||
}
|
||||
}
|
||||
|
||||
return $oO365;
|
||||
} catch (\Throwable $e) {
|
||||
\RainLoop\Api::Actions()->Logger()->WriteException($e, \LOG_ERR);
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
private function decodeJwtPayload(string $jwt) : ?array
|
||||
{
|
||||
$parts = \explode('.', $jwt);
|
||||
if (\count($parts) < 2) {
|
||||
return null;
|
||||
}
|
||||
$payload = $parts[1];
|
||||
$payload .= \str_repeat('=', (4 - (\strlen($payload) % 4)) % 4);
|
||||
$json = \base64_decode(\strtr($payload, '-_', '+/'));
|
||||
if ($json === false) {
|
||||
return null;
|
||||
}
|
||||
$data = \json_decode($json, true);
|
||||
return \is_array($data) ? $data : null;
|
||||
}
|
||||
|
||||
/**
|
||||
* JSON action called by JS to obtain an MS authorize URL with signed state.
|
||||
* This avoids exposing any signing secret to JS and keeps redirect_uri consistent with server logic.
|
||||
*/
|
||||
public function DoLoginO365AuthUrl() : array
|
||||
{
|
||||
$oActions = \RainLoop\Api::Actions();
|
||||
|
||||
$op = (string) $this->jsonParam('op', 'login');
|
||||
if (!\in_array($op, ['login', 'add'], true)) {
|
||||
return $this->jsonResponse(__FUNCTION__, false);
|
||||
}
|
||||
|
||||
$email = \strtolower(\trim((string) $this->jsonParam('email', '')));
|
||||
$name = \trim((string) $this->jsonParam('name', ''));
|
||||
$returnHash = (string) $this->jsonParam('return', '');
|
||||
|
||||
if ($returnHash && !\str_starts_with($returnHash, '#')) {
|
||||
$returnHash = '';
|
||||
}
|
||||
|
||||
// For add-account flow, require a logged-in main account (we must write to its additionalaccounts storage).
|
||||
$oMainAccount = null;
|
||||
if ('add' === $op) {
|
||||
$oMainAccount = $oActions->getMainAccountFromToken(false);
|
||||
if (!$oMainAccount) {
|
||||
return $this->jsonResponse(__FUNCTION__, false);
|
||||
}
|
||||
}
|
||||
|
||||
// Optional server-side guard: only permit supported consumer domains unless configured otherwise.
|
||||
if ($email && !$this->isSupportedEmail($email)) {
|
||||
return $this->jsonResponse(__FUNCTION__, false);
|
||||
}
|
||||
|
||||
$oConfig = $this->Config();
|
||||
$client_id = \trim($oConfig->Get('plugin', 'client_id', ''));
|
||||
if (!$client_id) {
|
||||
return $this->jsonResponse(__FUNCTION__, false);
|
||||
}
|
||||
|
||||
$nonce = $this->b64url(\random_bytes(16));
|
||||
// Store nonce server-side to prevent replay; consumed on callback.
|
||||
$oActions->StorageProvider()->Put(
|
||||
null,
|
||||
StorageType::NOBODY,
|
||||
$this->stateNonceKey($nonce),
|
||||
(string) \time()
|
||||
);
|
||||
|
||||
$payload = [
|
||||
'v' => 1,
|
||||
'op' => $op,
|
||||
'csrf' => \RainLoop\Utils::GetCsrfToken(),
|
||||
'nonce' => $nonce,
|
||||
'ts' => \time()
|
||||
];
|
||||
if ('add' === $op && $oMainAccount) {
|
||||
$payload['main'] = $oMainAccount->Email();
|
||||
if ($name) {
|
||||
$payload['name'] = \substr($name, 0, 100);
|
||||
}
|
||||
if ($returnHash) {
|
||||
$payload['return'] = \substr($returnHash, 0, 200);
|
||||
}
|
||||
}
|
||||
|
||||
$state = $this->signState($payload);
|
||||
$tenant = $oConfig->Get('plugin', 'tenant', 'common');
|
||||
$redirectUri = $this->redirectUri();
|
||||
|
||||
$params = [
|
||||
'response_type' => 'code',
|
||||
'client_id' => $client_id,
|
||||
'redirect_uri' => $redirectUri,
|
||||
'scope' => \implode(' ', [
|
||||
'openid',
|
||||
'offline_access',
|
||||
'email',
|
||||
'profile',
|
||||
'https://outlook.office.com/IMAP.AccessAsUser.All',
|
||||
'https://outlook.office.com/SMTP.Send',
|
||||
]),
|
||||
'state' => $state,
|
||||
// Helps MS UI prefill, but does not change server-side validation.
|
||||
];
|
||||
if ($email) {
|
||||
$params['login_hint'] = $email;
|
||||
}
|
||||
$authUrl = \str_replace('{{tenant}}', $tenant, static::AUTH_URI)
|
||||
. '?'
|
||||
. \http_build_query($params, '', '&', PHP_QUERY_RFC3986);
|
||||
|
||||
return $this->jsonResponse(__FUNCTION__, [
|
||||
'authUrl' => $authUrl
|
||||
]);
|
||||
}
|
||||
|
||||
private function isSupportedEmail(string $email) : bool
|
||||
{
|
||||
if ((bool)$this->Config()->Get('plugin', 'allow_any_domain', false)) {
|
||||
return \str_contains($email, '@');
|
||||
}
|
||||
return \str_ends_with($email, '@hotmail.com')
|
||||
|| \str_ends_with($email, '@outlook.com')
|
||||
|| \str_ends_with($email, '@live.com');
|
||||
}
|
||||
|
||||
/**
|
||||
* Build absolute base URL (works behind nginx reverse proxy).
|
||||
*/
|
||||
private function baseUrl() : string
|
||||
{
|
||||
$scheme = (!empty($_SERVER['HTTP_X_FORWARDED_PROTO']))
|
||||
? $_SERVER['HTTP_X_FORWARDED_PROTO']
|
||||
: ((!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ? 'https' : 'http');
|
||||
|
||||
$host = $_SERVER['HTTP_HOST'] ?? $_SERVER['SERVER_NAME'] ?? '';
|
||||
if (!$host) {
|
||||
throw new \RuntimeException('Cannot determine HTTP_HOST');
|
||||
}
|
||||
return $scheme . '://' . $host;
|
||||
}
|
||||
|
||||
/**
|
||||
* Redirect URI used for the Azure app registration.
|
||||
* When plugin.personal=true -> "/?LoginO365"
|
||||
* When plugin.personal=false -> "/LoginO365"
|
||||
*/
|
||||
private function redirectUri() : string
|
||||
{
|
||||
$base = \rtrim($this->baseUrl(), '/');
|
||||
$useQuery = (bool)$this->Config()->Get('plugin', 'personal', false);
|
||||
return $useQuery ? ($base . '/?LoginO365') : ($base . '/LoginO365');
|
||||
}
|
||||
|
||||
private function tokenStorageKey(string $emailLower) : string
|
||||
{
|
||||
// Stored under MAIN account StorageType::CONFIG (encrypted with main CryptKey).
|
||||
// Email is hashed to avoid path/encoding issues across storage backends.
|
||||
return 'login-o365.tokens.' . \sha1($emailLower);
|
||||
}
|
||||
|
||||
private function storeAccountTokens(MainAccount $oMainAccount, string $email, array $tokenBundle) : void
|
||||
{
|
||||
$emailLower = \strtolower(\SnappyMail\IDN::emailToAscii($email));
|
||||
\RainLoop\Api::Actions()->StorageProvider()->Put(
|
||||
$oMainAccount,
|
||||
StorageType::CONFIG,
|
||||
$this->tokenStorageKey($emailLower),
|
||||
\SnappyMail\Crypt::EncryptToJSON($tokenBundle, $oMainAccount->CryptKey())
|
||||
);
|
||||
}
|
||||
|
||||
private function stateNonceKey(string $nonce) : string
|
||||
{
|
||||
return 'login-o365.state.' . $nonce;
|
||||
}
|
||||
|
||||
private function b64url(string $bin) : string
|
||||
{
|
||||
return \rtrim(\strtr(\base64_encode($bin), '+/', '-_'), '=');
|
||||
}
|
||||
|
||||
private function b64urlDecode(string $b64url) /*: string|false*/
|
||||
{
|
||||
$pad = (4 - (\strlen($b64url) % 4)) % 4;
|
||||
return \base64_decode(\strtr($b64url . \str_repeat('=', $pad), '-_', '+/'), true);
|
||||
}
|
||||
|
||||
private function stateHmacKey() : string
|
||||
{
|
||||
// Uses the plugin client_secret (server-side only) as HMAC key.
|
||||
// This prevents any user-controlled tampering of the state payload.
|
||||
$key = \trim($this->Config()->getDecrypted('plugin', 'client_secret', ''));
|
||||
if (!$key) {
|
||||
// Fallback for misconfiguration; keeps behavior deterministic.
|
||||
$key = 'login-o365';
|
||||
}
|
||||
return $key;
|
||||
}
|
||||
|
||||
private function signState(array $payload) : string
|
||||
{
|
||||
$json = \json_encode($payload);
|
||||
if (!$json) {
|
||||
$json = '{}';
|
||||
}
|
||||
$payloadB64 = $this->b64url($json);
|
||||
$sig = \hash_hmac('sha256', $payloadB64, $this->stateHmacKey(), true);
|
||||
return $payloadB64 . '.' . $this->b64url($sig);
|
||||
}
|
||||
|
||||
/**
|
||||
* Verify signature + CSRF + nonce, then consumes nonce to prevent replay.
|
||||
* Returns decoded payload on success, null on failure.
|
||||
*/
|
||||
private function verifyAndConsumeState(string $state) : ?array
|
||||
{
|
||||
$parts = \explode('.', $state, 2);
|
||||
if (2 !== \count($parts)) {
|
||||
return null;
|
||||
}
|
||||
[$payloadB64, $sigB64] = $parts;
|
||||
$sig = $this->b64urlDecode($sigB64);
|
||||
if ($sig === false) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$expected = \hash_hmac('sha256', $payloadB64, $this->stateHmacKey(), true);
|
||||
if (!\hash_equals($expected, $sig)) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$payloadJson = $this->b64urlDecode($payloadB64);
|
||||
if ($payloadJson === false) {
|
||||
return null;
|
||||
}
|
||||
$payload = \json_decode($payloadJson, true);
|
||||
if (!\is_array($payload) || empty($payload['csrf']) || empty($payload['nonce']) || empty($payload['op'])) {
|
||||
return null;
|
||||
}
|
||||
|
||||
// Must match the current browser session.
|
||||
if ($payload['csrf'] !== \RainLoop\Utils::GetCsrfToken()) {
|
||||
return null;
|
||||
}
|
||||
|
||||
// Replay protection: nonce must exist server-side and is consumed once.
|
||||
$oActions = \RainLoop\Api::Actions();
|
||||
$key = $this->stateNonceKey((string) $payload['nonce']);
|
||||
$seen = $oActions->StorageProvider()->Get(null, StorageType::NOBODY, $key);
|
||||
if (!$seen) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$ts = (int) ($payload['ts'] ?? 0);
|
||||
if ($ts && \abs(\time() - $ts) > 900) { // 15 minutes
|
||||
// Expired: clear nonce to avoid accumulating stale entries.
|
||||
$oActions->StorageProvider()->Clear(null, StorageType::NOBODY, $key);
|
||||
return null;
|
||||
}
|
||||
|
||||
$oActions->StorageProvider()->Clear(null, StorageType::NOBODY, $key);
|
||||
|
||||
return $payload;
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue