emilsoftware-utilities 2.0.0-dev.22 → 2.0.0-dev.23

package/dist/accessi-module/federated-auth/FederatedAuthController.js

@@ -0,0 +1,307 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var FederatedAuthController_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FederatedAuthController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const Utilities_1 = require("../../Utilities");
+const BaseResponse_1 = require("../Dtos/BaseResponse");
+const FederatedIdentityDtos_1 = require("../Dtos/FederatedIdentityDtos");
+const jwt_strategy_1 = require("../jwt/jwt.strategy");
+const accessControl_1 = require("../security/accessControl");
+const FederatedAuthService_1 = require("./FederatedAuthService");
+/**
+ * Master-only administration API. Authentication itself is intentionally not
+ * exposed over HTTP: the hosting backend validates its SSO and calls
+ * FederatedAuthService.authenticate({ provider, subject }) directly.
+ */
+let FederatedAuthController = FederatedAuthController_1 = class FederatedAuthController {
+    constructor(federatedAuthService) {
+        this.federatedAuthService = federatedAuthService;
+    }
+    getProviders(request, res) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                (0, accessControl_1.ensureSuperUser)((0, accessControl_1.getAuthenticatedAccessiUser)(request));
+                return Utilities_1.RestUtilities.sendBaseResponse(res, yield this.federatedAuthService.getProviders());
+            }
+            catch (error) {
+                return this.sendError(res, error);
+            }
+        });
+    }
+    createProvider(request, body, res) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                (0, accessControl_1.ensureSuperUser)((0, accessControl_1.getAuthenticatedAccessiUser)(request));
+                return Utilities_1.RestUtilities.sendBaseResponse(res, yield this.federatedAuthService.createProvider(body), common_1.HttpStatus.CREATED);
+            }
+            catch (error) {
+                return this.sendError(res, error);
+            }
+        });
+    }
+    updateProvider(request, provider, body, res) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                (0, accessControl_1.ensureSuperUser)((0, accessControl_1.getAuthenticatedAccessiUser)(request));
+                return Utilities_1.RestUtilities.sendBaseResponse(res, yield this.federatedAuthService.updateProvider(provider, body));
+            }
+            catch (error) {
+                return this.sendError(res, error);
+            }
+        });
+    }
+    getIdentities(request, codiceUtente, res) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                (0, accessControl_1.ensureSuperUser)((0, accessControl_1.getAuthenticatedAccessiUser)(request));
+                return Utilities_1.RestUtilities.sendBaseResponse(res, yield this.federatedAuthService.getUserIdentities(codiceUtente));
+            }
+            catch (error) {
+                return this.sendError(res, error);
+            }
+        });
+    }
+    linkIdentity(request, codiceUtente, body, res) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                (0, accessControl_1.ensureSuperUser)((0, accessControl_1.getAuthenticatedAccessiUser)(request));
+                const identity = yield this.federatedAuthService.linkIdentity(codiceUtente, body, body.note);
+                return Utilities_1.RestUtilities.sendBaseResponse(res, identity, common_1.HttpStatus.CREATED);
+            }
+            catch (error) {
+                return this.sendError(res, error);
+            }
+        });
+    }
+    createUser(request, body, res) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                (0, accessControl_1.ensureSuperUser)((0, accessControl_1.getAuthenticatedAccessiUser)(request));
+                const identity = yield this.federatedAuthService.createManagedFederatedUser(body.user, body, body.passwordLoginEnabled === true, body.note);
+                return Utilities_1.RestUtilities.sendBaseResponse(res, identity, common_1.HttpStatus.CREATED);
+            }
+            catch (error) {
+                return this.sendError(res, error);
+            }
+        });
+    }
+    setPasswordPolicy(request, codiceUtente, body, res) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                (0, accessControl_1.ensureSuperUser)((0, accessControl_1.getAuthenticatedAccessiUser)(request));
+                yield this.federatedAuthService.setPasswordLoginEnabled(codiceUtente, body.passwordLoginEnabled);
+                return Utilities_1.RestUtilities.sendOKMessage(res, 'Policy di autenticazione aggiornata.');
+            }
+            catch (error) {
+                return this.sendError(res, error);
+            }
+        });
+    }
+    disableIdentity(request, identityKey, res) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                (0, accessControl_1.ensureSuperUser)((0, accessControl_1.getAuthenticatedAccessiUser)(request));
+                yield this.federatedAuthService.disableIdentity(identityKey);
+                return Utilities_1.RestUtilities.sendOKMessage(res, 'Identita SSO disabilitata.');
+            }
+            catch (error) {
+                return this.sendError(res, error);
+            }
+        });
+    }
+    deleteIdentity(request, codiceUtente, identityKey, res) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                (0, accessControl_1.ensureSuperUser)((0, accessControl_1.getAuthenticatedAccessiUser)(request));
+                yield this.federatedAuthService.deleteIdentity(codiceUtente, identityKey);
+                return Utilities_1.RestUtilities.sendOKMessage(res, 'Collegamento SSO eliminato definitivamente.');
+            }
+            catch (error) {
+                return this.sendError(res, error);
+            }
+        });
+    }
+    updateIdentity(request, identityKey, body, res) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                (0, accessControl_1.ensureSuperUser)((0, accessControl_1.getAuthenticatedAccessiUser)(request));
+                yield this.federatedAuthService.updateIdentity(identityKey, body);
+                return Utilities_1.RestUtilities.sendOKMessage(res, 'Collegamento SSO aggiornato.');
+            }
+            catch (error) {
+                return this.sendError(res, error);
+            }
+        });
+    }
+    sendError(res, error) {
+        const status = error instanceof common_1.HttpException ? error.getStatus() : common_1.HttpStatus.INTERNAL_SERVER_ERROR;
+        return Utilities_1.RestUtilities.sendErrorMessage(res, error, FederatedAuthController_1.name, status);
+    }
+};
+exports.FederatedAuthController = FederatedAuthController;
+__decorate([
+    (0, swagger_1.ApiOperation)({ summary: 'Elenca i provider SSO censiti', operationId: 'getFederatedProviders', description: 'Riservato a superutente. Restituisce solo catalogo e stato Accessi; issuer, secret e configurazioni SSO restano nel backend.' }),
+    (0, swagger_1.ApiOkResponse)({ type: FederatedIdentityDtos_1.FederatedProviderListResponse }),
+    (0, common_1.Get)('providers'),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], FederatedAuthController.prototype, "getProviders", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({ summary: 'Censisce un provider SSO', operationId: 'createFederatedProvider', description: 'Riservato a superutente. La chiave provider deve corrispondere alla configurazione stabile del backend; non salvare segreti, issuer o token.' }),
+    (0, swagger_1.ApiBody)({ type: FederatedIdentityDtos_1.CreateFederatedProviderRequest }),
+    (0, swagger_1.ApiCreatedResponse)({ type: FederatedIdentityDtos_1.FederatedProviderResponse }),
+    (0, common_1.Post)('providers'),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Body)()),
+    __param(2, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, FederatedIdentityDtos_1.CreateFederatedProviderRequest, Object]),
+    __metadata("design:returntype", Promise)
+], FederatedAuthController.prototype, "createProvider", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({ summary: 'Aggiorna o disabilita un provider SSO', operationId: 'updateFederatedProvider', description: 'Riservato a superutente. La chiave provider è immutabile: disabilitarla blocca nuovi login SSO ma conserva i collegamenti storici.' }),
+    (0, swagger_1.ApiParam)({ name: 'provider', example: 'azure-ad-acme-produzione', description: 'Chiave stabile del provider censito.' }),
+    (0, swagger_1.ApiBody)({ type: FederatedIdentityDtos_1.UpdateFederatedProviderRequest }),
+    (0, swagger_1.ApiOkResponse)({ type: FederatedIdentityDtos_1.FederatedProviderResponse }),
+    (0, common_1.Patch)('providers/:provider'),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Param)('provider')),
+    __param(2, (0, common_1.Body)()),
+    __param(3, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, FederatedIdentityDtos_1.UpdateFederatedProviderRequest, Object]),
+    __metadata("design:returntype", Promise)
+], FederatedAuthController.prototype, "updateProvider", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({ summary: 'Elenca le identita SSO di un utente', operationId: 'getFederatedIdentities', description: 'Riservato a superutente. Non restituisce token esterni o claim del provider.' }),
+    (0, swagger_1.ApiParam)({ name: 'codiceUtente', example: 123 }),
+    (0, swagger_1.ApiOkResponse)({ type: FederatedIdentityDtos_1.FederatedIdentityListResponse }),
+    (0, swagger_1.ApiResponse)({ status: 403, type: BaseResponse_1.ErrorResponse }),
+    (0, common_1.Get)('users/:codiceUtente/identities'),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Param)('codiceUtente', common_1.ParseIntPipe)),
+    __param(2, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Number, Object]),
+    __metadata("design:returntype", Promise)
+], FederatedAuthController.prototype, "getIdentities", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({ summary: 'Associa un SSO gia verificato a un utente esistente', operationId: 'linkFederatedIdentity', description: 'Il master deve fornire un provider e subject ottenuti da una verifica SSO lato backend; questo endpoint non verifica token esterni.' }),
+    (0, swagger_1.ApiParam)({ name: 'codiceUtente', example: 123 }),
+    (0, swagger_1.ApiBody)({ type: FederatedIdentityDtos_1.CreateFederatedIdentityRequest }),
+    (0, swagger_1.ApiCreatedResponse)({ type: FederatedIdentityDtos_1.FederatedIdentityResponse }),
+    (0, common_1.Post)('users/:codiceUtente/identities'),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Param)('codiceUtente', common_1.ParseIntPipe)),
+    __param(2, (0, common_1.Body)()),
+    __param(3, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Number, FederatedIdentityDtos_1.CreateFederatedIdentityRequest, Object]),
+    __metadata("design:returntype", Promise)
+], FederatedAuthController.prototype, "linkIdentity", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({ summary: 'Crea un utente gestito e SSO-only', operationId: 'createFederatedUser', description: 'Riservato a superutente. L utente nasce confermato, con identita collegata e senza password salvo opt-in esplicito.' }),
+    (0, swagger_1.ApiBody)({ type: FederatedIdentityDtos_1.CreateFederatedUserRequest }),
+    (0, swagger_1.ApiCreatedResponse)({ type: FederatedIdentityDtos_1.FederatedIdentityResponse }),
+    (0, swagger_1.ApiResponse)({ status: 400, type: BaseResponse_1.ErrorResponse, description: 'Provider o subject non validi.' }),
+    (0, swagger_1.ApiResponse)({ status: 404, type: BaseResponse_1.ErrorResponse, description: 'Provider SSO non censito.' }),
+    (0, swagger_1.ApiResponse)({ status: 409, type: BaseResponse_1.ErrorResponse, description: 'Email o identità SSO già associate a un utente.' }),
+    (0, swagger_1.ApiResponse)({ status: 503, type: BaseResponse_1.ErrorResponse, description: 'Schema Accessi non aggiornato.' }),
+    (0, swagger_1.ApiResponse)({ status: 500, type: BaseResponse_1.ErrorResponse, description: 'Errore inatteso durante il provisioning; la risposta contiene FEDERATED_USER_PROVISIONING_FAILED.' }),
+    (0, common_1.Post)('users'),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Body)()),
+    __param(2, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, FederatedIdentityDtos_1.CreateFederatedUserRequest, Object]),
+    __metadata("design:returntype", Promise)
+], FederatedAuthController.prototype, "createUser", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({ summary: 'Abilita o disabilita il login con password', operationId: 'setPasswordLoginPolicy', description: 'Con false il login locale restituisce PASSWORD_LOGIN_DISABLED; le identita SSO attive restano utilizzabili.' }),
+    (0, swagger_1.ApiParam)({ name: 'codiceUtente', example: 123 }),
+    (0, swagger_1.ApiBody)({ type: FederatedIdentityDtos_1.SetPasswordLoginPolicyRequest }),
+    (0, swagger_1.ApiOkResponse)({ type: BaseResponse_1.ActionResponse }),
+    (0, common_1.Patch)('users/:codiceUtente/password-login'),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Param)('codiceUtente', common_1.ParseIntPipe)),
+    __param(2, (0, common_1.Body)()),
+    __param(3, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Number, FederatedIdentityDtos_1.SetPasswordLoginPolicyRequest, Object]),
+    __metadata("design:returntype", Promise)
+], FederatedAuthController.prototype, "setPasswordPolicy", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({ summary: 'Disabilita un identita SSO', operationId: 'disableFederatedIdentity', description: 'Soft delete: l associazione resta tracciata ma non puo piu autenticare.' }),
+    (0, swagger_1.ApiParam)({ name: 'identityKey', description: 'SHA-256 restituito dagli endpoint di elenco o creazione.' }),
+    (0, swagger_1.ApiOkResponse)({ type: BaseResponse_1.ActionResponse }),
+    (0, common_1.Delete)('identities/:identityKey'),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Param)('identityKey')),
+    __param(2, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, Object]),
+    __metadata("design:returntype", Promise)
+], FederatedAuthController.prototype, "disableIdentity", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({ summary: 'Elimina definitivamente un collegamento SSO', operationId: 'deleteFederatedIdentityPermanently', description: 'Riservato a superutente. Rimuove il collegamento provider e subject dall’utente, senza eliminare l’utente Accessi.' }),
+    (0, swagger_1.ApiParam)({ name: 'codiceUtente', example: 123 }),
+    (0, swagger_1.ApiParam)({ name: 'identityKey', description: 'SHA-256 del collegamento da eliminare.' }),
+    (0, swagger_1.ApiOkResponse)({ type: BaseResponse_1.ActionResponse }),
+    (0, swagger_1.ApiResponse)({ status: 404, type: BaseResponse_1.ErrorResponse, description: 'Collegamento assente o non appartenente all’utente.' }),
+    (0, common_1.Delete)('users/:codiceUtente/identities/:identityKey'),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Param)('codiceUtente', common_1.ParseIntPipe)),
+    __param(2, (0, common_1.Param)('identityKey')),
+    __param(3, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Number, String, Object]),
+    __metadata("design:returntype", Promise)
+], FederatedAuthController.prototype, "deleteIdentity", null);
+__decorate([
+    (0, swagger_1.ApiOperation)({ summary: 'Aggiorna un collegamento SSO', operationId: 'updateFederatedIdentity', description: 'Consente di modificare nota e stato attivo del collegamento. identityKey e una chiave tecnica, non un token SSO.' }),
+    (0, swagger_1.ApiParam)({ name: 'identityKey', description: 'SHA-256 restituito dagli endpoint di elenco o creazione.' }),
+    (0, swagger_1.ApiBody)({ type: FederatedIdentityDtos_1.UpdateFederatedIdentityRequest }),
+    (0, swagger_1.ApiOkResponse)({ type: BaseResponse_1.ActionResponse }),
+    (0, common_1.Patch)('identities/:identityKey'),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Param)('identityKey')),
+    __param(2, (0, common_1.Body)()),
+    __param(3, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, FederatedIdentityDtos_1.UpdateFederatedIdentityRequest, Object]),
+    __metadata("design:returntype", Promise)
+], FederatedAuthController.prototype, "updateIdentity", null);
+exports.FederatedAuthController = FederatedAuthController = FederatedAuthController_1 = __decorate([
+    (0, swagger_1.ApiTags)('Federated authentication'),
+    (0, swagger_1.ApiBearerAuth)(),
+    (0, common_1.UseGuards)(jwt_strategy_1.JwtSimpleGuard),
+    (0, common_1.Controller)('accessi/federated-auth'),
+    __metadata("design:paramtypes", [FederatedAuthService_1.FederatedAuthService])
+], FederatedAuthController);
+//# sourceMappingURL=FederatedAuthController.js.map

package/dist/accessi-module/federated-auth/FederatedAuthController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FederatedAuthController.js","sourceRoot":"","sources":["../../../src/accessi-module/federated-auth/FederatedAuthController.ts"],"names":[],"mappings":"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","sourcesContent":["import { Body, Controller, Delete, Get, HttpException, HttpStatus, Param, ParseIntPipe, Patch, Post, Req, Res, UseGuards } from '@nestjs/common';\nimport { ApiBearerAuth, ApiBody, ApiCreatedResponse, ApiOkResponse, ApiOperation, ApiParam, ApiResponse, ApiTags } from '@nestjs/swagger';\nimport { Request, Response } from 'express';\nimport { RestUtilities } from '../../Utilities';\nimport { ActionResponse, ErrorResponse } from '../Dtos/BaseResponse';\nimport { CreateFederatedIdentityRequest, CreateFederatedProviderRequest, CreateFederatedUserRequest, FederatedIdentityListResponse, FederatedIdentityResponse, FederatedProviderListResponse, FederatedProviderResponse, SetPasswordLoginPolicyRequest, UpdateFederatedIdentityRequest, UpdateFederatedProviderRequest } from '../Dtos/FederatedIdentityDtos';\nimport { JwtSimpleGuard } from '../jwt/jwt.strategy';\nimport { ensureSuperUser, getAuthenticatedAccessiUser } from '../security/accessControl';\nimport { FederatedAuthService } from './FederatedAuthService';\n\n/**\n * Master-only administration API. Authentication itself is intentionally not\n * exposed over HTTP: the hosting backend validates its SSO and calls\n * FederatedAuthService.authenticate({ provider, subject }) directly.\n */\n@ApiTags('Federated authentication')\n@ApiBearerAuth()\n@UseGuards(JwtSimpleGuard)\n@Controller('accessi/federated-auth')\nexport class FederatedAuthController {\n  constructor(private readonly federatedAuthService: FederatedAuthService) {}\n\n  @ApiOperation({ summary: 'Elenca i provider SSO censiti', operationId: 'getFederatedProviders', description: 'Riservato a superutente. Restituisce solo catalogo e stato Accessi; issuer, secret e configurazioni SSO restano nel backend.' })\n  @ApiOkResponse({ type: FederatedProviderListResponse })\n  @Get('providers')\n  async getProviders(@Req() request: Request, @Res() res: Response) {\n    try {\n      ensureSuperUser(getAuthenticatedAccessiUser(request));\n      return RestUtilities.sendBaseResponse(res, await this.federatedAuthService.getProviders());\n    } catch (error) {\n      return this.sendError(res, error);\n    }\n  }\n\n  @ApiOperation({ summary: 'Censisce un provider SSO', operationId: 'createFederatedProvider', description: 'Riservato a superutente. La chiave provider deve corrispondere alla configurazione stabile del backend; non salvare segreti, issuer o token.' })\n  @ApiBody({ type: CreateFederatedProviderRequest })\n  @ApiCreatedResponse({ type: FederatedProviderResponse })\n  @Post('providers')\n  async createProvider(@Req() request: Request, @Body() body: CreateFederatedProviderRequest, @Res() res: Response) {\n    try {\n      ensureSuperUser(getAuthenticatedAccessiUser(request));\n      return RestUtilities.sendBaseResponse(res, await this.federatedAuthService.createProvider(body), HttpStatus.CREATED);\n    } catch (error) {\n      return this.sendError(res, error);\n    }\n  }\n\n  @ApiOperation({ summary: 'Aggiorna o disabilita un provider SSO', operationId: 'updateFederatedProvider', description: 'Riservato a superutente. La chiave provider è immutabile: disabilitarla blocca nuovi login SSO ma conserva i collegamenti storici.' })\n  @ApiParam({ name: 'provider', example: 'azure-ad-acme-produzione', description: 'Chiave stabile del provider censito.' })\n  @ApiBody({ type: UpdateFederatedProviderRequest })\n  @ApiOkResponse({ type: FederatedProviderResponse })\n  @Patch('providers/:provider')\n  async updateProvider(@Req() request: Request, @Param('provider') provider: string, @Body() body: UpdateFederatedProviderRequest, @Res() res: Response) {\n    try {\n      ensureSuperUser(getAuthenticatedAccessiUser(request));\n      return RestUtilities.sendBaseResponse(res, await this.federatedAuthService.updateProvider(provider, body));\n    } catch (error) {\n      return this.sendError(res, error);\n    }\n  }\n\n  @ApiOperation({ summary: 'Elenca le identita SSO di un utente', operationId: 'getFederatedIdentities', description: 'Riservato a superutente. Non restituisce token esterni o claim del provider.' })\n  @ApiParam({ name: 'codiceUtente', example: 123 })\n  @ApiOkResponse({ type: FederatedIdentityListResponse })\n  @ApiResponse({ status: 403, type: ErrorResponse })\n  @Get('users/:codiceUtente/identities')\n  async getIdentities(@Req() request: Request, @Param('codiceUtente', ParseIntPipe) codiceUtente: number, @Res() res: Response) {\n    try {\n      ensureSuperUser(getAuthenticatedAccessiUser(request));\n      return RestUtilities.sendBaseResponse(res, await this.federatedAuthService.getUserIdentities(codiceUtente));\n    } catch (error) {\n      return this.sendError(res, error);\n    }\n  }\n\n  @ApiOperation({ summary: 'Associa un SSO gia verificato a un utente esistente', operationId: 'linkFederatedIdentity', description: 'Il master deve fornire un provider e subject ottenuti da una verifica SSO lato backend; questo endpoint non verifica token esterni.' })\n  @ApiParam({ name: 'codiceUtente', example: 123 })\n  @ApiBody({ type: CreateFederatedIdentityRequest })\n  @ApiCreatedResponse({ type: FederatedIdentityResponse })\n  @Post('users/:codiceUtente/identities')\n  async linkIdentity(@Req() request: Request, @Param('codiceUtente', ParseIntPipe) codiceUtente: number, @Body() body: CreateFederatedIdentityRequest, @Res() res: Response) {\n    try {\n      ensureSuperUser(getAuthenticatedAccessiUser(request));\n      const identity = await this.federatedAuthService.linkIdentity(codiceUtente, body, body.note);\n      return RestUtilities.sendBaseResponse(res, identity, HttpStatus.CREATED);\n    } catch (error) {\n      return this.sendError(res, error);\n    }\n  }\n\n  @ApiOperation({ summary: 'Crea un utente gestito e SSO-only', operationId: 'createFederatedUser', description: 'Riservato a superutente. L utente nasce confermato, con identita collegata e senza password salvo opt-in esplicito.' })\n  @ApiBody({ type: CreateFederatedUserRequest })\n  @ApiCreatedResponse({ type: FederatedIdentityResponse })\n  @ApiResponse({ status: 400, type: ErrorResponse, description: 'Provider o subject non validi.' })\n  @ApiResponse({ status: 404, type: ErrorResponse, description: 'Provider SSO non censito.' })\n  @ApiResponse({ status: 409, type: ErrorResponse, description: 'Email o identità SSO già associate a un utente.' })\n  @ApiResponse({ status: 503, type: ErrorResponse, description: 'Schema Accessi non aggiornato.' })\n  @ApiResponse({ status: 500, type: ErrorResponse, description: 'Errore inatteso durante il provisioning; la risposta contiene FEDERATED_USER_PROVISIONING_FAILED.' })\n  @Post('users')\n  async createUser(@Req() request: Request, @Body() body: CreateFederatedUserRequest, @Res() res: Response) {\n    try {\n      ensureSuperUser(getAuthenticatedAccessiUser(request));\n      const identity = await this.federatedAuthService.createManagedFederatedUser(body.user, body, body.passwordLoginEnabled === true, body.note);\n      return RestUtilities.sendBaseResponse(res, identity, HttpStatus.CREATED);\n    } catch (error) {\n      return this.sendError(res, error);\n    }\n  }\n\n  @ApiOperation({ summary: 'Abilita o disabilita il login con password', operationId: 'setPasswordLoginPolicy', description: 'Con false il login locale restituisce PASSWORD_LOGIN_DISABLED; le identita SSO attive restano utilizzabili.' })\n  @ApiParam({ name: 'codiceUtente', example: 123 })\n  @ApiBody({ type: SetPasswordLoginPolicyRequest })\n  @ApiOkResponse({ type: ActionResponse })\n  @Patch('users/:codiceUtente/password-login')\n  async setPasswordPolicy(@Req() request: Request, @Param('codiceUtente', ParseIntPipe) codiceUtente: number, @Body() body: SetPasswordLoginPolicyRequest, @Res() res: Response) {\n    try {\n      ensureSuperUser(getAuthenticatedAccessiUser(request));\n      await this.federatedAuthService.setPasswordLoginEnabled(codiceUtente, body.passwordLoginEnabled);\n      return RestUtilities.sendOKMessage(res, 'Policy di autenticazione aggiornata.');\n    } catch (error) {\n      return this.sendError(res, error);\n    }\n  }\n\n  @ApiOperation({ summary: 'Disabilita un identita SSO', operationId: 'disableFederatedIdentity', description: 'Soft delete: l associazione resta tracciata ma non puo piu autenticare.' })\n  @ApiParam({ name: 'identityKey', description: 'SHA-256 restituito dagli endpoint di elenco o creazione.' })\n  @ApiOkResponse({ type: ActionResponse })\n  @Delete('identities/:identityKey')\n  async disableIdentity(@Req() request: Request, @Param('identityKey') identityKey: string, @Res() res: Response) {\n    try {\n      ensureSuperUser(getAuthenticatedAccessiUser(request));\n      await this.federatedAuthService.disableIdentity(identityKey);\n      return RestUtilities.sendOKMessage(res, 'Identita SSO disabilitata.');\n    } catch (error) {\n      return this.sendError(res, error);\n    }\n  }\n\n  @ApiOperation({ summary: 'Elimina definitivamente un collegamento SSO', operationId: 'deleteFederatedIdentityPermanently', description: 'Riservato a superutente. Rimuove il collegamento provider e subject dall’utente, senza eliminare l’utente Accessi.' })\n  @ApiParam({ name: 'codiceUtente', example: 123 })\n  @ApiParam({ name: 'identityKey', description: 'SHA-256 del collegamento da eliminare.' })\n  @ApiOkResponse({ type: ActionResponse })\n  @ApiResponse({ status: 404, type: ErrorResponse, description: 'Collegamento assente o non appartenente all’utente.' })\n  @Delete('users/:codiceUtente/identities/:identityKey')\n  async deleteIdentity(@Req() request: Request, @Param('codiceUtente', ParseIntPipe) codiceUtente: number, @Param('identityKey') identityKey: string, @Res() res: Response) {\n    try {\n      ensureSuperUser(getAuthenticatedAccessiUser(request));\n      await this.federatedAuthService.deleteIdentity(codiceUtente, identityKey);\n      return RestUtilities.sendOKMessage(res, 'Collegamento SSO eliminato definitivamente.');\n    } catch (error) {\n      return this.sendError(res, error);\n    }\n  }\n\n  @ApiOperation({ summary: 'Aggiorna un collegamento SSO', operationId: 'updateFederatedIdentity', description: 'Consente di modificare nota e stato attivo del collegamento. identityKey e una chiave tecnica, non un token SSO.' })\n  @ApiParam({ name: 'identityKey', description: 'SHA-256 restituito dagli endpoint di elenco o creazione.' })\n  @ApiBody({ type: UpdateFederatedIdentityRequest })\n  @ApiOkResponse({ type: ActionResponse })\n  @Patch('identities/:identityKey')\n  async updateIdentity(@Req() request: Request, @Param('identityKey') identityKey: string, @Body() body: UpdateFederatedIdentityRequest, @Res() res: Response) {\n    try {\n      ensureSuperUser(getAuthenticatedAccessiUser(request));\n      await this.federatedAuthService.updateIdentity(identityKey, body);\n      return RestUtilities.sendOKMessage(res, 'Collegamento SSO aggiornato.');\n    } catch (error) {\n      return this.sendError(res, error);\n    }\n  }\n\n  private sendError(res: Response, error: unknown) {\n    const status = error instanceof HttpException ? error.getStatus() : HttpStatus.INTERNAL_SERVER_ERROR;\n    return RestUtilities.sendErrorMessage(res, error, FederatedAuthController.name, status);\n  }\n}\n"]}

package/dist/accessi-module/federated-auth/FederatedAuthService.d.ts

@@ -0,0 +1,94 @@
+import { OnModuleInit } from '@nestjs/common';
+import type { AccessiOptions } from '../AccessiModule';
+import { RegisterRequest } from '../Dtos/RegisterRequest';
+import { AuthService } from '../Services/AuthService/AuthService';
+import { UserService } from '../Services/UserService/UserService';
+import { FederatedAuthenticationResult, FederatedIdentity, FederatedProvider, VerifiedFederatedIdentity } from './FederatedAuthTypes';
+/**
+ * Maps externally verified identities to Accessi users and issues the usual
+ * Accessi JWT. It deliberately has no provider SDK dependency: validating an
+ * Azure, Google, Apple, SAML, or custom token is always the hosting backend's job.
+ */
+export declare class FederatedAuthService implements OnModuleInit {
+    private readonly options;
+    private readonly userService;
+    private readonly authService;
+    constructor(options: AccessiOptions, userService: UserService, authService: AuthService);
+    /** Await the same schema barrier as the module updater; never race two DDL implementations. */
+    onModuleInit(): Promise<void>;
+    /** Returns true only when the host application opted in to federated authentication. */
+    isEnabled(): boolean;
+    /**
+     * Exchanges a backend-verified identity for the same login result and JWT
+     * emitted by the local password endpoint. No raw external token is accepted.
+     */
+    authenticate(identity: VerifiedFederatedIdentity): Promise<FederatedAuthenticationResult>;
+    /** Links an external identity to an existing Accessi user. It never changes that user's password policy. */
+    linkIdentity(codiceUtente: number, identity: VerifiedFederatedIdentity, note?: string): Promise<FederatedIdentity>;
+    /** Creates a confirmed Accessi user, associates an SSO identity and defaults the new user to SSO-only. */
+    createManagedFederatedUser(registrationData: RegisterRequest, identity: VerifiedFederatedIdentity, passwordLoginEnabled?: boolean, note?: string): Promise<FederatedIdentity>;
+    /**
+     * Allows self-provisioning only when explicitly enabled. The caller must have
+     * verified the external identity and decide which profile fields are trusted.
+     */
+    registerSelfServiceFederatedUser(registrationData: RegisterRequest, identity: VerifiedFederatedIdentity): Promise<FederatedIdentity>;
+    /** Returns all linked identities for administration; disabled identities are included. */
+    getUserIdentities(codiceUtente: number): Promise<FederatedIdentity[]>;
+    /** Returns the complete provider catalog, including inactive providers, for superuser administration. */
+    getProviders(): Promise<FederatedProvider[]>;
+    /** Registers a provider key that must match the backend's SSO configuration exactly. */
+    createProvider(input: {
+        provider: string;
+        description: string;
+        note?: string;
+    }): Promise<FederatedProvider>;
+    /** Updates provider metadata or disables the provider without removing its identity history. */
+    /**
+     * Aggiorna metadati amministrativi del catalogo. La chiave provider e immutabile perche parte dell'identita
+     * persistita e deve coincidere esattamente con la configurazione del backend validante.
+     */
+    updateProvider(providerValue: string, update: {
+        description?: string;
+        active?: boolean;
+        note?: string;
+    }): Promise<FederatedProvider>;
+    /** Enables or disables all local password authentication for one user. */
+    /**
+     * Imposta la policy di login locale. `false` non rimuove password ne identita SSO: blocca solo il percorso
+     * email/password, che restituisce `PASSWORD_LOGIN_DISABLED`. L'assenza della riga mantiene il default legacy `true`.
+     */
+    setPasswordLoginEnabled(codiceUtente: number, enabled: boolean): Promise<void>;
+    /** Returns the effective local password policy. Users without a policy row retain the historic enabled default. */
+    /** Restituisce la policy effettiva; utenti precedenti alla migrazione restano abilitati alla password. */
+    isPasswordLoginEnabled(codiceUtente: number): Promise<boolean>;
+    /** Soft-disables a linked identity without deleting operational history. */
+    /** Disabilita logicamente un collegamento SSO conservando audit e possibilita di successiva riattivazione. */
+    disableIdentity(identityKey: string): Promise<void>;
+    /** Permanently removes one identity link from its owning user after administrative confirmation. */
+    /**
+     * Elimina fisicamente un collegamento SSO soltanto dopo aver verificato che appartenga all'utente indicato.
+     * Non elimina mai l'utente Accessi, password, ruoli o grant associati.
+     */
+    deleteIdentity(codiceUtente: number, identityKey: string): Promise<void>;
+    /** Aggiorna lo stato o la nota di un collegamento SSO usando la sua chiave tecnica amministrativa. */
+    /** Aggiorna stato o nota amministrativa senza modificare provider e subject, che identificano la persona. */
+    updateIdentity(identityKey: string, update: {
+        active?: boolean;
+        note?: string;
+    }): Promise<void>;
+    /** Explicit administrative schema reconciliation, shared with the standard updater. */
+    ensureSchema(): Promise<void>;
+    private findIdentity;
+    private assertUserExists;
+    private assertEnabled;
+    /** Validates the opaque SHA-256 key used only by administrative identity endpoints. */
+    private assertIdentityKey;
+    private normalizeIdentity;
+    private normalizeProvider;
+    private normalizeDescription;
+    private assertProviderActive;
+    private findProvider;
+    private getIdentityKey;
+    private toIdentity;
+    private toProvider;
+}