Files
breadcrumb-the-shire/core/Service/Access/RoleAuthorizationPolicy.php

119 lines
4.4 KiB
PHP
Raw Permalink Normal View History

<?php
namespace MintyPHP\Service\Access;
class RoleAuthorizationPolicy implements AuthorizationPolicyInterface
{
use AuthorizationPolicyContextTrait;
public const ABILITY_ADMIN_ROLES_VIEW = 'admin.roles.view';
public const ABILITY_ADMIN_ROLES_CREATE = 'admin.roles.create';
public const ABILITY_ADMIN_ROLES_EDIT_CONTEXT = 'admin.roles.edit.context';
public const ABILITY_ADMIN_ROLES_EDIT_SUBMIT = 'admin.roles.edit.submit';
public const ABILITY_ADMIN_ROLES_DELETE = 'admin.roles.delete';
public function __construct(
private readonly PermissionService $permissionService
) {
}
public function supports(string $ability): bool
{
return in_array($ability, [
self::ABILITY_ADMIN_ROLES_VIEW,
self::ABILITY_ADMIN_ROLES_CREATE,
self::ABILITY_ADMIN_ROLES_EDIT_CONTEXT,
self::ABILITY_ADMIN_ROLES_EDIT_SUBMIT,
self::ABILITY_ADMIN_ROLES_DELETE,
], true);
}
public function authorize(string $ability, array $context = []): AuthorizationDecision
{
return match ($ability) {
self::ABILITY_ADMIN_ROLES_VIEW => $this->authorizeAdminRolesView($context),
self::ABILITY_ADMIN_ROLES_CREATE => $this->authorizeAdminRolesCreate($context),
self::ABILITY_ADMIN_ROLES_EDIT_CONTEXT => $this->authorizeAdminRolesEditContext($context),
self::ABILITY_ADMIN_ROLES_EDIT_SUBMIT => $this->authorizeAdminRolesEditSubmit($context),
self::ABILITY_ADMIN_ROLES_DELETE => $this->authorizeAdminRolesDelete($context),
default => AuthorizationDecision::deny(500, 'authorization_ability_not_supported'),
};
}
private function authorizeAdminRolesView(array $context): AuthorizationDecision
{
$actorUserId = $this->actorUserId($context);
if (!$this->hasPermission($actorUserId, PermissionService::ROLES_VIEW)) {
return AuthorizationDecision::deny(403, 'forbidden');
}
return AuthorizationDecision::allow([
'capabilities' => [
'can_view_page' => true,
'can_create_role' => $this->hasPermission($actorUserId, PermissionService::ROLES_CREATE),
],
]);
}
private function authorizeAdminRolesCreate(array $context): AuthorizationDecision
{
$actorUserId = $this->actorUserId($context);
if (!$this->hasPermission($actorUserId, PermissionService::ROLES_CREATE)) {
return AuthorizationDecision::deny(403, 'forbidden');
}
refactor(creates-batch): migrate roles/permissions/tenants-create (step 10) Cluster-7 batch-replay of the departments-create pilot (step 9). All three remaining create actions follow the same shape with minor domain-specific variations. Each migration touches one action and one policy: * roles-create + RoleAuthorizationPolicy::authorizeAdminRolesCreate — policy previously returned bare allow() with no capabilities; now emits ['can_view_page' => true]. Action passes viewAuthFlags: []. * permissions-create + PermissionAuthorizationPolicy::authorizeAdminPermissionsCreate — same pattern as roles-create. * tenants-create + TenantAuthorizationPolicy::authorizeAdminTenantsCreate — policy already emitted can_manage_sso + can_manage_custom_fields; can_view_page is added as the first capability. Action passes viewAuthFlags: ['can_manage_sso', 'can_manage_custom_fields'] and materializes both booleans from the aggregator capabilities. All three policy updates are tautological — every actor that survives the deny() branches in each policy can by definition see the page. View, Create, and EditContext now share a consistent capability shape across all four core master-data domains (departments, roles, permissions, tenants). Three drift decisions reproduced: * notFoundFlashScopeKey is N/A (no model lookup in create flows). * t() consistency: Flash::success('Role created' / 'Permission created' / 'Tenant created') now flow through t(). * Defensive scope consumption: $canManageAllTenants reads $tenantScope['scope'] === 'all' as a resilient hook even where the policy emits no manage-all flag (roles/permissions are global, tenants-create has no filter logic). Inline comments document the intentional non-consumption of $tenantScope['ids']. Two contract-test pattern updates (AuthzAdminMasterDataContractTest + AuthzAdminTenantsContractTest) shift the assertion targets from AuthorizationService::class to actionCreateContext( — semantically equivalent because the aggregator wraps the same authorize call internally. ActionContextCsrfPairingContractTest now covers nine callers (five edits + four creates) and stays green. Helper file core/Support/helpers/action_context.php is 0-diff for the seventh consecutive migration. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-26 15:00:05 +02:00
return AuthorizationDecision::allow([
'capabilities' => [
'can_view_page' => true,
],
]);
}
private function authorizeAdminRolesEditContext(array $context): AuthorizationDecision
{
$actorUserId = $this->actorUserId($context);
$targetRoleId = (int) ($context['target_role_id'] ?? 0);
if ($actorUserId <= 0 || $targetRoleId <= 0) {
return AuthorizationDecision::deny(403, 'forbidden');
}
if (!$this->hasPermission($actorUserId, PermissionService::ROLES_VIEW)) {
return AuthorizationDecision::deny(403, 'forbidden');
}
return AuthorizationDecision::allow([
'capabilities' => [
'can_view_page' => true,
'can_edit_role' => $this->hasPermission($actorUserId, PermissionService::ROLES_UPDATE),
'can_delete_role' => $this->hasPermission($actorUserId, PermissionService::ROLES_DELETE),
],
]);
}
private function authorizeAdminRolesEditSubmit(array $context): AuthorizationDecision
{
$contextDecision = $this->authorizeAdminRolesEditContext($context);
if (!$contextDecision->isAllowed()) {
return $contextDecision;
}
$capabilities = $this->capabilitiesFromDecision($contextDecision);
if (!($capabilities['can_edit_role'] ?? false)) {
return AuthorizationDecision::deny(403, 'forbidden');
}
return AuthorizationDecision::allow(['capabilities' => $capabilities]);
}
private function authorizeAdminRolesDelete(array $context): AuthorizationDecision
{
$actorUserId = $this->actorUserId($context);
if (!$this->hasPermission($actorUserId, PermissionService::ROLES_DELETE)) {
return AuthorizationDecision::deny(403, 'forbidden');
}
return AuthorizationDecision::allow();
}
}