{"elements":[{"id":7005,"title":"Autenticazione e ACL","body":"
\n
\n

Autenticazione JWT<\/h2>\n

DressAPI integra un sistema completo di autenticazione e controllo degli accessi che protegge ogni endpoint in modo granulare. Il framework supporta due modalità — token JWT per le API stateless e sessioni PHP per il CMS — e gestisce i permessi attraverso un meccanismo di ACL basato su ruoli, tabelle e operazioni CRUD.<\/p>\n

\"Gestione<\/div>\n\n

Login e Token<\/h3>\n
\n
Login Request<\/div>\ncurl<\/span> -X POST<\/span> https:\/\/api.example.com\/sign\n -d \"dusername=admin&dpassword=admin\"<\/span>\n <\/div>\n
\n
Response<\/div>\n{\n \"token\"<\/span>: \"eyJhbGciOiJIUzI1NiIs...\"<\/span>,\n \"user\"<\/span>: {\n \"id\"<\/span>: 1<\/span>,\n \"username\"<\/span>: \"admin\"<\/span>,\n \"role\"<\/span>: \"admin\"<\/span>\n }\n}\n <\/div>\n\n

Uso del token<\/h3>\n
\n
Authenticated Request<\/div>\ncurl<\/span>\n -H \"Authorization: Bearer YOUR_TOKEN\"<\/span>\n -X GET<\/span> https:\/\/api.example.com\/product\n <\/div>\n\n

Sessioni PHP (CMS)<\/h3>\n

Per le pagine HTML, l'autenticazione usa sessioni PHP standard. Viene attivata automaticamente quando il client richiede Accept: text\/html<\/code>. Per richieste JSON che necessitano sessione, aggiungere il campo nascosto site_mode=1<\/code>.<\/p>\n\n

Sistema ACL (Controllo Accessi)<\/h3>\n

Il sistema ACL è definito nel database tramite tabelle di sistema:<\/p>\n

\n \n \n \n
Tabella<\/th>Descrizione<\/th><\/tr>\n <\/thead>\n
_user<\/code><\/td>Utenti del sistema<\/td><\/tr>\n
_role<\/code><\/td>Ruoli disponibili<\/td><\/tr>\n
_user_role<\/code><\/td>Assegnazione ruoli agli utenti<\/td><\/tr>\n
_permission<\/code><\/td>Permessi CRUD per modulo\/ruolo<\/td><\/tr>\n <\/tbody>\n <\/table>\n <\/div>\n

Ogni risposta API include i permissions<\/code> dell'utente corrente per il modulo richiesto, permettendo al frontend di mostrare\/nascondere azioni.<\/p>\n\n

Configurazione sicurezza<\/h3>\n
\n
config.php - Costanti da personalizzare<\/div>\ndefine<\/span>('TOKEN_SECRET_KEY'<\/span>, 'la-tua-chiave-segreta'<\/span>); \/\/ Firma JWT<\/span>\ndefine<\/span>('TOKEN_DURATION'<\/span>, '2 months'<\/span>); \/\/ Durata token<\/span>\ndefine<\/span>('PWD_CRYPT'<\/span>, 'il-tuo-salt'<\/span>); \/\/ Salt password<\/span>\n <\/div>\n <\/div>\n<\/section>\n\n
\n ← Torna ai Tutorial<\/a>\n<\/section>","description":"JWT, sessioni e sistema permessi RBAC","meta_keywords":"","visible":"yes","status":"public","creation_date":"0000-00-00","id__user":1,"priority":0,"groupname":"TUTORIAL"}],"module":"pages","permissions":{"can_read":true},"main_item_title":"title","related_tables":[{"name":"Newsonpage","module":"newsonpage","FK":"id_cmspage","permissions":[]}],"page_info":{"table":"","key":"id","url":"\/pages","url_list":"\/pages","filters":{"id":["=","7005"]},"pagination":{"total_items":23,"page":1,"total_pages":2,"step":1,"items_per_page":20,"url_prev":"\/pages","url_next":"\/pages\/p\/2","url_tmpl":"\/pages\/p\/[[p]]","url_tmpl_with_order":"\/pages\/p\/[[p]]\/ob\/[[ob]]"},"order":{"field":"id","type":"DESC","url_tmpl":"\/pages\/p\/[[p]]"},"module":{"title":"Pages","description":"List of pages","name":"pages"},"current":{"title":"Pages","description":"List of pages","name":"pages","url":"\/tutorials\/autenticazione"}},"components":{"alert":{"alert1":[{"type":"warning","message":"OK COMPONENT!"},{"type":"danger","message":"ERROR COMPONENT!"}]}},"messages":[]}