Files
inbuxa-server/crates/jmap/src/api/auth.rs
T
jcoffey-dev 1b3ec64862 inbuxa:ProtocolPolicy over JMAP
The switch is now reachable. /get and /set on a server-level singleton,
wired through jmap-proto the way inbuxa:AiLimits is: object, method names,
request and response variants, reference resolution and evaluation.

/set does not write the policy. It hands what was asked to
Server::set_protocol_policy, which applies the locks, moves the listener
objects and opens or closes their sockets, and reports what happened. So
the method cannot drift from what the switch actually does.

Two properties exist for the screen rather than the server. lockedProtocols
serves LP-21's locked set, so the selector renders SMTP and JMAP locked
from what the server says instead of a list the front end carries -- and
unlocking later needs no admin release. wouldClose answers LP-16: exactly
which listeners turning the switch on would close, by name and port, before
anything happens. It is computed against a hypothetical disabled policy, so
it reads the same whichever way the switch is set, and the registry is only
asked when the property was requested.

savedListeners, changedAt, changedBy and both of those are the server's to
say; a client that sets one gets invalidProperties naming it. closeSubmission
is different: locked, not immutable, so it is overruled rather than refused
and the response hands back what was really stored (false). JMAP already has
the place for that, the value beside an updated id.

Permissions reuse SysNetworkListenerGet and SysNetworkListenerUpdate rather
than adding to a schema-generated enum -- the same choice AiLimits made with
the classifier's. It also reads right: this takes listeners away and puts
them back, so whoever may edit a listener may turn the switch.

changedBy stores the account id, not the name, which survives a rename.

Still no screen, no sign-in refusal (LP-6) and no event (LP-8).
2026-09-20 15:38:32 -07:00

431 lines
20 KiB
Rust

/*
* SPDX-FileCopyrightText: 2020 Stalwart Labs LLC <[email protected]>
*
* SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-SEL
*
* Modified by Coffey Labs in 2026 for INBUXA.
*/
use common::auth::AccessToken;
use jmap_proto::{
method::set::SetRequest,
object::JmapObject,
request::{
CopyRequestMethod, GetRequestMethod, ParseRequestMethod, QueryChangesRequestMethod,
QueryRequestMethod, RequestMethod, SetRequestMethod, method::MethodObject,
reference::MaybeResultReference,
},
};
use registry::schema::enums::Permission;
use types::{collection::Collection, id::Id};
pub trait JmapAuthorization {
fn assert_is_member(&self, account_id: Id) -> trc::Result<&Self>;
fn assert_has_jmap_permission(
&self,
request: &RequestMethod,
object: MethodObject,
) -> trc::Result<()>;
fn assert_has_access(&self, to_account_id: Id, to_collection: Collection)
-> trc::Result<&Self>;
}
impl JmapAuthorization for AccessToken {
fn assert_is_member(&self, account_id: Id) -> trc::Result<&Self> {
if self.is_member(account_id.document_id()) {
Ok(self)
} else {
Err(trc::JmapEvent::Forbidden
.into_err()
.details(format!("You are not an owner of account {}", account_id)))
}
}
fn assert_has_access(
&self,
to_account_id: Id,
to_collection: Collection,
) -> trc::Result<&Self> {
if self.has_access(to_account_id.document_id(), to_collection) {
Ok(self)
} else {
Err(trc::JmapEvent::Forbidden.into_err().details(format!(
"You do not have access to account {}",
to_account_id
)))
}
}
fn assert_has_jmap_permission(
&self,
request: &RequestMethod,
object: MethodObject,
) -> trc::Result<()> {
let permission = match request {
RequestMethod::Get(m) => match &m {
GetRequestMethod::Email(_) => Permission::JmapEmailGet,
GetRequestMethod::Mailbox(_) => Permission::JmapMailboxGet,
GetRequestMethod::Thread(_) => Permission::JmapThreadGet,
GetRequestMethod::Identity(_) => Permission::JmapIdentityGet,
GetRequestMethod::EmailSubmission(_) => Permission::JmapEmailSubmissionGet,
GetRequestMethod::PushSubscription(_) => Permission::JmapPushSubscriptionGet,
GetRequestMethod::Sieve(_) => Permission::JmapSieveScriptGet,
GetRequestMethod::VacationResponse(_) => Permission::JmapVacationResponseGet,
// inbuxa: Fastmail's MaskedEmail (ME-18)
GetRequestMethod::MaskedEmail(_) => Permission::SysMaskedEmailGet,
// inbuxa: deleted accounts (UD-17)
GetRequestMethod::DeletedAccount(_) => Permission::SysAccountGet,
// inbuxa: AI call limits, with the classifier's permissions
GetRequestMethod::AiLimits(_) => Permission::SysSpamLlmGet,
// inbuxa: legacy protocols off. It takes listeners away and
// puts them back, so it takes the listener's permissions
GetRequestMethod::ProtocolPolicy(_) => Permission::SysNetworkListenerGet,
GetRequestMethod::Principal(_) => Permission::JmapPrincipalGet,
GetRequestMethod::Quota(_) => Permission::JmapQuotaGet,
GetRequestMethod::Blob(_) => Permission::JmapBlobGet,
GetRequestMethod::AddressBook(_) => Permission::JmapAddressBookGet,
GetRequestMethod::ContactCard(_) => Permission::JmapContactCardGet,
GetRequestMethod::FileNode(_) => Permission::JmapFileNodeGet,
GetRequestMethod::PrincipalAvailability(_) => {
Permission::JmapPrincipalGetAvailability
}
GetRequestMethod::Calendar(_) => Permission::JmapCalendarGet,
GetRequestMethod::CalendarEvent(_) => Permission::JmapCalendarEventGet,
GetRequestMethod::CalendarEventNotification(_) => {
Permission::JmapCalendarEventNotificationGet
}
GetRequestMethod::ParticipantIdentity(_) => Permission::JmapParticipantIdentityGet,
GetRequestMethod::ShareNotification(_) => Permission::JmapShareNotificationGet,
GetRequestMethod::Registry(_) => {
let MethodObject::Registry(object_type) = object else {
unreachable!()
};
// inbuxa: MT-2: server-level objects are out of a tenant's reach
assert_tenant_reach(
self,
inbuxa_features::tenancy::reach::can_read(object_type),
)?;
object_type.get_permission()
}
},
RequestMethod::Set(m) => {
return match &m {
SetRequestMethod::Email(s) => validate_set(
s,
self,
Permission::JmapEmailCreate,
Permission::JmapEmailUpdate,
Permission::JmapEmailDestroy,
),
SetRequestMethod::Mailbox(s) => validate_set(
s,
self,
Permission::JmapMailboxCreate,
Permission::JmapMailboxUpdate,
Permission::JmapMailboxDestroy,
),
SetRequestMethod::Identity(s) => validate_set(
s,
self,
Permission::JmapIdentityCreate,
Permission::JmapIdentityUpdate,
Permission::JmapIdentityDestroy,
),
SetRequestMethod::EmailSubmission(s) => validate_set(
s,
self,
Permission::JmapEmailSubmissionCreate,
Permission::JmapEmailSubmissionUpdate,
Permission::JmapEmailSubmissionDestroy,
),
SetRequestMethod::PushSubscription(s) => validate_set(
s,
self,
Permission::JmapPushSubscriptionCreate,
Permission::JmapPushSubscriptionUpdate,
Permission::JmapPushSubscriptionDestroy,
),
SetRequestMethod::Sieve(s) => validate_set(
s,
self,
Permission::JmapSieveScriptCreate,
Permission::JmapSieveScriptUpdate,
Permission::JmapSieveScriptDestroy,
),
// inbuxa: Fastmail's MaskedEmail (ME-18)
SetRequestMethod::MaskedEmail(s) => validate_set(
s,
self,
Permission::SysMaskedEmailCreate,
Permission::SysMaskedEmailUpdate,
Permission::SysMaskedEmailDestroy,
),
// inbuxa: deleted accounts; a restore creates the account again (UD-17)
SetRequestMethod::DeletedAccount(s) => validate_set(
s,
self,
Permission::SysAccountCreate,
Permission::SysAccountCreate,
Permission::SysAccountDestroy,
),
// inbuxa: AI call limits, with the classifier's permissions
SetRequestMethod::AiLimits(s) => validate_set(
s,
self,
Permission::SysSpamLlmUpdate,
Permission::SysSpamLlmUpdate,
Permission::SysSpamLlmUpdate,
),
// inbuxa: legacy protocols off, with the listener's
SetRequestMethod::ProtocolPolicy(s) => validate_set(
s,
self,
Permission::SysNetworkListenerUpdate,
Permission::SysNetworkListenerUpdate,
Permission::SysNetworkListenerUpdate,
),
SetRequestMethod::VacationResponse(s) => validate_set(
s,
self,
Permission::JmapVacationResponseCreate,
Permission::JmapVacationResponseUpdate,
Permission::JmapVacationResponseDestroy,
),
SetRequestMethod::AddressBook(s) => validate_set(
s,
self,
Permission::JmapAddressBookCreate,
Permission::JmapAddressBookUpdate,
Permission::JmapAddressBookDestroy,
),
SetRequestMethod::ContactCard(s) => validate_set(
s,
self,
Permission::JmapContactCardCreate,
Permission::JmapContactCardUpdate,
Permission::JmapContactCardDestroy,
),
SetRequestMethod::FileNode(s) => validate_set(
s,
self,
Permission::JmapFileNodeCreate,
Permission::JmapFileNodeUpdate,
Permission::JmapFileNodeDestroy,
),
SetRequestMethod::ShareNotification(s) => validate_set(
s,
self,
Permission::JmapShareNotificationCreate,
Permission::JmapShareNotificationUpdate,
Permission::JmapShareNotificationDestroy,
),
SetRequestMethod::Calendar(s) => validate_set(
s,
self,
Permission::JmapCalendarCreate,
Permission::JmapCalendarUpdate,
Permission::JmapCalendarDestroy,
),
SetRequestMethod::CalendarEvent(s) => validate_set(
s,
self,
Permission::JmapCalendarEventCreate,
Permission::JmapCalendarEventUpdate,
Permission::JmapCalendarEventDestroy,
),
SetRequestMethod::CalendarEventNotification(s) => validate_set(
s,
self,
Permission::JmapCalendarEventNotificationCreate,
Permission::JmapCalendarEventNotificationUpdate,
Permission::JmapCalendarEventNotificationDestroy,
),
SetRequestMethod::ParticipantIdentity(s) => validate_set(
s,
self,
Permission::JmapParticipantIdentityCreate,
Permission::JmapParticipantIdentityUpdate,
Permission::JmapParticipantIdentityDestroy,
),
SetRequestMethod::Registry(s) => {
let MethodObject::Registry(object_type) = object else {
unreachable!()
};
// inbuxa: MT-2, MT-12: server-level objects are out of a tenant's reach
assert_tenant_reach(
self,
inbuxa_features::tenancy::reach::can_write(object_type),
)?;
let set_permissions = object_type.set_permission();
validate_set(
s,
self,
set_permissions[0],
set_permissions[1],
set_permissions[2],
)
}
};
}
RequestMethod::Changes(_) => match object {
MethodObject::Email => Permission::JmapEmailChanges,
MethodObject::Mailbox => Permission::JmapMailboxChanges,
MethodObject::Thread => Permission::JmapThreadChanges,
MethodObject::Identity => Permission::JmapIdentityChanges,
MethodObject::EmailSubmission => Permission::JmapEmailSubmissionChanges,
MethodObject::Quota => Permission::JmapQuotaChanges,
MethodObject::ContactCard => Permission::JmapContactCardChanges,
MethodObject::FileNode => Permission::JmapFileNodeChanges,
MethodObject::Calendar => Permission::JmapCalendarChanges,
MethodObject::CalendarEvent => Permission::JmapCalendarEventChanges,
MethodObject::CalendarEventNotification => {
Permission::JmapCalendarEventNotificationChanges
}
MethodObject::ParticipantIdentity => Permission::JmapParticipantIdentityChanges,
MethodObject::ShareNotification => Permission::JmapShareNotificationChanges,
MethodObject::Principal => Permission::JmapPrincipalChanges,
MethodObject::AddressBook => Permission::JmapAddressBookChanges,
MethodObject::Core
| MethodObject::Blob
| MethodObject::PushSubscription
| MethodObject::SearchSnippet
| MethodObject::VacationResponse
| MethodObject::SieveScript
| MethodObject::MaskedEmail
| MethodObject::DeletedAccount
| MethodObject::AiLimits
| MethodObject::ProtocolPolicy => Permission::JmapEmailChanges,
// inbuxa: x:MaskedEmail/changes reads what /get reads
MethodObject::Registry(object_type) => object_type.get_permission(),
},
RequestMethod::Copy(m) => match &m {
CopyRequestMethod::Email(_) => Permission::JmapEmailCopy,
CopyRequestMethod::Blob(_) => Permission::JmapBlobCopy,
CopyRequestMethod::ContactCard(_) => Permission::JmapContactCardCopy,
CopyRequestMethod::CalendarEvent(_) => Permission::JmapCalendarEventCopy,
CopyRequestMethod::FileNode(_) => Permission::JmapFileNodeCopy,
},
RequestMethod::ImportEmail(_) => Permission::JmapEmailImport,
RequestMethod::Parse(m) => match &m {
ParseRequestMethod::Email(_) => Permission::JmapEmailParse,
ParseRequestMethod::ContactCard(_) => Permission::JmapContactCardParse,
ParseRequestMethod::CalendarEvent(_) => Permission::JmapCalendarEventParse,
},
RequestMethod::QueryChanges(m) => match m {
QueryChangesRequestMethod::Email(_) => Permission::JmapEmailQueryChanges,
QueryChangesRequestMethod::Mailbox(_) => Permission::JmapMailboxQueryChanges,
QueryChangesRequestMethod::EmailSubmission(_) => {
Permission::JmapEmailSubmissionQueryChanges
}
QueryChangesRequestMethod::Principal(_) => Permission::JmapPrincipalQueryChanges,
QueryChangesRequestMethod::Quota(_) => Permission::JmapQuotaQueryChanges,
QueryChangesRequestMethod::ContactCard(_) => {
Permission::JmapContactCardQueryChanges
}
QueryChangesRequestMethod::FileNode(_) => Permission::JmapFileNodeQueryChanges,
QueryChangesRequestMethod::CalendarEvent(_) => {
Permission::JmapCalendarEventQueryChanges
}
QueryChangesRequestMethod::CalendarEventNotification(_) => {
Permission::JmapCalendarEventNotificationQueryChanges
}
QueryChangesRequestMethod::ShareNotification(_) => {
Permission::JmapShareNotificationQueryChanges
}
},
RequestMethod::Query(m) => match m {
QueryRequestMethod::Email(_) => Permission::JmapEmailQuery,
QueryRequestMethod::Mailbox(_) => Permission::JmapMailboxQuery,
QueryRequestMethod::EmailSubmission(_) => Permission::JmapEmailSubmissionQuery,
QueryRequestMethod::Sieve(_) => Permission::JmapSieveScriptQuery,
QueryRequestMethod::Principal(_) => Permission::JmapPrincipalQuery,
QueryRequestMethod::Quota(_) => Permission::JmapQuotaQuery,
QueryRequestMethod::AddressBook(_) => Permission::JmapAddressBookGet,
QueryRequestMethod::ContactCard(_) => Permission::JmapContactCardQuery,
QueryRequestMethod::FileNode(_) => Permission::JmapFileNodeQuery,
QueryRequestMethod::Calendar(_) => Permission::JmapCalendarGet,
QueryRequestMethod::CalendarEvent(_) => Permission::JmapCalendarEventQuery,
QueryRequestMethod::CalendarEventNotification(_) => {
Permission::JmapCalendarEventNotificationQuery
}
QueryRequestMethod::ShareNotification(_) => Permission::JmapShareNotificationQuery,
QueryRequestMethod::Registry(_) => {
let MethodObject::Registry(object_type) = object else {
unreachable!()
};
// inbuxa: MT-2: server-level objects are out of a tenant's reach
assert_tenant_reach(
self,
inbuxa_features::tenancy::reach::can_read(object_type),
)?;
object_type.query_permission()
}
},
RequestMethod::SearchSnippet(_) => Permission::JmapSearchSnippetGet,
RequestMethod::ValidateScript(_) => Permission::JmapSieveScriptValidate,
RequestMethod::LookupBlob(_) => Permission::JmapBlobLookup,
RequestMethod::UploadBlob(_) => Permission::JmapBlobUpload,
RequestMethod::Echo(_) => Permission::JmapCoreEcho,
RequestMethod::Error(_) => return Ok(()),
};
if self.has_permission(permission) {
Ok(())
} else {
Err(trc::JmapEvent::Forbidden
.into_err()
.details("You are not authorized to perform this action"))
}
}
}
// inbuxa: MT-2
fn assert_tenant_reach(access_token: &AccessToken, reachable: bool) -> trc::Result<()> {
if reachable || access_token.tenant_id().is_none() {
Ok(())
} else {
Err(trc::JmapEvent::Forbidden
.into_err()
.details("You are not authorized to perform this action"))
}
}
fn validate_set<T: JmapObject>(
set: &SetRequest<'_, T>,
access_token: &AccessToken,
create_permission: Permission,
update_permission: Permission,
destroy_permission: Permission,
) -> trc::Result<()> {
let can_create = access_token.has_permission(create_permission);
let can_update = access_token.has_permission(update_permission);
let can_destroy = access_token.has_permission(destroy_permission);
if can_create && can_update && can_destroy {
Ok(())
} else if !can_create && !can_update && !can_destroy {
Err(trc::JmapEvent::Forbidden
.into_err()
.details("You are not authorized to create, update or destroy objects of this type"))
} else if !can_create && set.create.as_ref().is_some_and(|objs| !objs.is_empty()) {
Err(trc::JmapEvent::Forbidden
.into_err()
.details("You are not authorized to create objects of this type"))
} else if !can_update && set.update.as_ref().is_some_and(|objs| !objs.is_empty()) {
Err(trc::JmapEvent::Forbidden
.into_err()
.details("You are not authorized to update objects of this type"))
} else if !can_destroy
&& set.destroy.as_ref().is_some_and(|objs| match objs {
MaybeResultReference::Value(v) => !v.is_empty(),
MaybeResultReference::Reference(_) => true,
})
{
Err(trc::JmapEvent::Forbidden
.into_err()
.details("You are not authorized to destroy objects of this type"))
} else {
Ok(())
}
}