Le schermate mostrano l’interfaccia in inglese.
Questa guida accompagna l'amministratore attraverso tutte le impostazioni di accesso, gli attributi utente, i gruppi, gli account, la registrazione locale, l'accesso temporaneo come altro utente, le chiavi API, i servizi SSO e la schermata personale Sicurezza e accesso.
Gli esempi sono stati creati su un'installazione pulita SQLite. Gli account, i gruppi e le chiavi mostrati qui esistono solo a scopo di documentazione. I segreti e i valori degli attributi personali sono stati rimossi dagli screenshot. Nella produzione, utilizza i tuoi nomi, domini, durate e regole di privilegio minimo.
Contenuto
- Impostazioni di accesso
- Attributi utente
- Gruppi
- Utenti e account locali
- Accesso locale e registrazione
- Accesso temporaneo come altro utente
- API chiavi
- Flusso di lavoro comune SSO
- SAML
- SAMLproxy
- CAS
- OIDC
- OAuth2
- Profilo personale: sicurezza e accesso
- Elenco di controllo per la verifica e la sicurezza
1. Impostazioni di accesso
Apri Impostazioni → Utenti → Impostazioni di accesso. Questa pagina abilita i metodi di autenticazione per l'applicazione. L'abilitazione di un provider rende disponibile solo la sua configurazione e il suo menu; ogni singolo profilo deve comunque essere salvato, attivato, testato e mappato correttamente.
Panoramica delle impostazioni di accesso
Interruttori principali
- Accesso locale abilita l'autenticazione del nome utente e della password memorizzata da Simbioza.
- SimpleSAMLphp, CAS, OIDC e OAuth2 abilitano i gruppi di profili SSO corrispondenti.
- L'accesso locale break-glass mantiene disponibile un percorso amministrativo diretto separato quando l'accesso locale normale è disabilitato. Proteggi quell'account con una password univoca complessa e utilizzala solo per il ripristino.
- Durata dell'accesso è un limite di inattività espresso in giorni (1–365), rinnovato mentre l'utente che ha effettuato l'accesso rimane attivo. Utilizza un periodo più breve sui dispositivi amministrativi e condivisi.
"Profilo attivo" non equivale al segno di spunta verde. Attivo significa che il profilo può essere utilizzato. Il segno di spunta verde e lo stato Testato e operativo vengono visualizzati solo dopo che il test del fornitore ha avuto esito positivo e le mappature richieste sono valide. Un profilo attivo potrebbe essere ancora non operativo.
2. Attributi dell'utente
Apri Attributi utente. Il modello normalmente include e-mail, nome e cognome. Aggiungi un attributo quando l'applicazione deve memorizzare un valore esterno al profilo di base, ad esempio un'istituzione, un dipartimento, una matricola del dipendente o un ruolo di directory esterna.
Aggiunta di un attributo
- Immettere un nome macchina stabile in lettere minuscole senza spazi, ad esempio
affiliation. - Fornire etichette croate e inglesi separate.
- Scegli il tipo di dati e configura Obbligatorio , Registrazione , Profilo e Attivo in modo indipendente.
- Salvalo. Il nuovo campo diventa disponibile nei profili utente e in ogni tabella di mappatura dei profili SSO.
La Mappatura collega un campo del modello Simbioza al nome esatto dell'attributo restituito dal provider. I nomi degli attributi sono esatti: mail , givenName e given_name sono campi diversi. Prima prova, controlla i nomi restituiti e solo dopo inserisci le mappature. Una mappatura SSO non aggiunge automaticamente il campo al modulo di registrazione pubblico.
Quali campi sono inclusi nell'autoregistrazione? L'amministratore lo sceglie per attributo. La Registrazione controlla se un campo appare nel modulo pubblico, mentre Obbligatorio rifiuta un valore vuoto nei contesti in cui quel campo partecipa. Quando entrambe le impostazioni sono abilitate, il campo è obbligatorio durante l'autoregistrazione. Un attributo obbligatorio deve avere anche una mappatura SSO valida affinché un test del profilo del provider diventi operativo. In questo esempio, affiliation memorizza l'istituzione fornita da un fornitore e appare nel profilo, quindi è intenzionalmente esclusa dalla registrazione.
3. Gruppi
I gruppi raccolgono gli utenti e portano le autorizzazioni. Il gruppo Amministratore è un gruppo di sistema protetto e non deve essere utilizzato come un normale gruppo aziendale. Crea gruppi separati con privilegi minimi per dipartimenti, progetti o ruoli.
Gruppi di sistema e di esempio nell'interfaccia inglese.\
- Scegli Aggiungi gruppo (il pulsante più), inserisci un Nome gruppo riconoscibile e seleziona Attivo.
- Scegli Salva gruppi. Questa schermata non contiene una descrizione o autorizzazioni per i contenuti.
- Aggiungi o rimuovi l'appartenenza al gruppo dai dettagli di ciascun utente.
- Concedi al gruppo le autorizzazioni richieste nelle impostazioni di un'area di lavoro, pagina, calendario o sondaggio. L'appartenenza a SSO può anche seguire regole basate su un attributo mappato.
Risultato: il gruppo esiste e può essere selezionato durante l'assegnazione delle autorizzazioni. Crearlo da solo non apre il contenuto ai suoi membri.
Per disattivare temporaneamente un gruppo non di sistema, deseleziona Attivo e salva. Per eliminarlo definitivamente, scegli Elimina gruppo. Nella schermata di conferma controlla il nome e le conseguenze indicate per le appartenenze e le regole di mappatura, quindi conferma l’eliminazione oppure annulla. Gli account utente rimangono. Un nome vuoto non elimina più un gruppo. Prima di confermare, verifica dove il gruppo consente l’accesso ai contenuti. Un nuovo gruppo con lo stesso nome ha un’altra identità e non ripristina le appartenenze o le autorizzazioni precedenti. I gruppi di sistema non possono essere eliminati.
4. Utenti e account locali
Apri Impostazioni → Utenti → Utenti per trovare gli account, controllarne lo stato e gestire l'iscrizione e l'accesso.
Creazione di un utente locale
- Seleziona Nuovo utente .
- Inserisci un identificatore di accesso univoco, un nome visualizzato e un indirizzo e-mail.
- Scegli la fonte di autenticazione locale e assegna una password temporanea complessa.
- Richiedi la modifica della password al primo accesso.
- Assegnare solo i gruppi richiesti; l'accesso come amministratore non deve essere l'impostazione predefinita.
Nella pagina dei dettagli, verifica l'attività dell'account, l'origine di autenticazione, le identità esterne collegate e le appartenenze ai gruppi. La disattivazione è solitamente più sicura dell'eliminazione perché preserva la traccia di controllo. Non sostituire mai manualmente l'identificatore di soggetto stabile di un provider esterno.
5. Accesso locale e registrazione
Accesso locale controlla l'autoregistrazione. Mantienilo disabilitato per i sistemi chiusi e crea account in modo amministrativo o tramite SSO attendibile. Se abilitata, la registrazione crea un account ordinario attivo e fa accedere l'utente. Non invia un'e-mail di verifica né dimostra la proprietà dell'indirizzo inserito. Per un sistema chiuso, mantieni la registrazione disabilitata e utilizza gli account creati dall'amministratore o un provider SSO attendibile. Pubblicare un'apposita informativa sulla privacy prima di accettare le registrazioni. Il modulo pubblico include solo gli attributi utente la cui opzione Registrazione è abilitata; pertanto il campo Istituzione SSO-only non viene visualizzato qui.
Dopo il test, ripristinare lo stato di produzione previsto. Le password devono essere univoche, sufficientemente lunghe e archiviate in un gestore di password. Gli amministratori non devono mai chiedere agli utenti la password attuale.
6. Accesso temporaneo come altro utente
Accedi come utente apre temporaneamente l'applicazione nel contesto dell'utente selezionato. Usalo per verificare autorizzazioni e visualizzazione, non per svolgere operazioni di lavoro per conto dell'utente.
L'accesso temporaneo come altro utente non verifica l'autenticazione SSO effettiva, MFA o i criteri del servizio di accesso. A questo scopo usa la verifica del profilo oppure un account di prova dedicato.
7. Chiavi API
Queste schermate sono disponibili quando il modulo API è installato e abilitato. Una chiave API funge da proprietario. Gli ambiti possono solo ridurre le autorizzazioni esistenti del proprietario; non possono concedere autorizzazioni di cui il proprietario non dispone. Utilizzare una chiave separata per integrazione, un'etichetta descrittiva, la durata pratica più breve e il set di ambiti più piccolo.
Emissione diretta delle chiavi
- Seleziona il proprietario e solo gli ambiti richiesti.
- Imposta una data di scadenza e, se necessario, un indirizzo IP consentito o una restrizione di rete.
- Crea la chiave e copia subito il segreto in un luogo di conservazione sicuro.
- Il segreto viene mostrato solo una volta. In caso di smarrimento revocare la chiave ed emetterne una nuova.
Richiesta dell'utente e approvazione dell'amministratore
Un utente può richiedere una chiave dal profilo personale e spiegarne lo scopo. L'amministratore esamina il proprietario, gli ambiti, la durata e la giustificazione, quindi approva o rifiuta la richiesta. Dopo l'approvazione l'utente potrà rivelare il segreto una sola volta nel profilo personale. Quando Notifiche è abilitato, anche una notifica in-app punta a quella schermata. Né la notifica né l'e-mail devono contenere il segreto.
8. Flusso di lavoro comune SSO
- Registra l'applicazione presso il provider e inserisci solo gli endpoint, l'ID client e il segreto necessari.
- Salva il profilo attivo. I segreti esistenti non vengono mai visualizzati durante la modifica; lasciando vuoto il campo segreto si mantiene il valore lato server.
- Seleziona Prova profilo prima di indovinare le mappature. Completa un login reale per raccogliere gli attributi effettivi del provider.
- Associa soggetto, identificatore di accesso, nome visualizzato e campi utente ai nomi restituiti.
- Prova di nuovo. Solo Testato e operativo insieme a un segno di spunta verde conferma un profilo completo.
Domini consentiti
L'elenco limita l'accesso ai domini dell'organizzazione. Inserisci un dominio per riga o un elenco separato da virgole. example.org consente quel dominio e i suoi sottodomini; un suffisso come hr consente identificatori il cui dominio termina con .hr . Un elenco vuoto non impone alcuna restrizione di dominio.
Attributo origine dominio deve essere l'attributo reale del provider contenente un valore come user@example.org o un dominio. È obbligatorio solo quando l'elenco dei domini consentiti è popolato. Non utilizzare un nome visualizzato o un altro valore modificabile.
Indirizzi di richiamata pubblici
Il provider deve restituire il browser all'URL pubblico della stessa installazione. Includere una sottodirectory quando ne viene utilizzata una: per un'applicazione in https://simbioza.example.org/simbioza, immettere il valore completo come URL di base pubblico. Non è l'indirizzo interno PHP-FPM, il contenitore o il database. Registra gli URL di richiamata esatti mostrati dal profilo.
9. SAML
Un profilo SAML dipende da un SimpleSAMLphp installato separatamente e correttamente configurato. Il caricatore automatico, l'origine di autenticazione SP, i certificati, i metadati e gli URL di ritorno devono già funzionare. Il percorso di vendor/autoload.php e il nome dell'origine di autenticazione devono corrispondere all'installazione.
10. SAML proxy e profili secondari
Un'istanza proxy rappresenta una sorgente di autenticazione SimpleSAMLphp che può esporre più servizi a monte. La scheda Default definisce il percorso autoload condiviso, la sorgente di autenticazione e la mappatura di base. Le schede secondarie ereditano le impostazioni di collegamento condivise, mantenendo le proprie mappature degli attributi.
Un proxy non ha domini consentiti o campi di attributi di origine del dominio. Questo è intenzionale: i provider upstream possono restituire identificatori e domini diversi. Applica le restrizioni al proxy o al provider upstream, non tramite una regola di dominio condivisa Simbioza.
Predefinito / AAI@EduHR
11. CAS
Un profilo CAS necessita dell'URL di base del server e dei relativi endpoint di accesso, convalida e disconnessione. Se viene utilizzata una catena di CA privata, fornire un percorso del certificato leggibile. Non disabilitare mai la convalida TLS per aggirare una configurazione del certificato errata.
12. OIDC
OIDC utilizza un ID client e un segreto, un'autorizzazione, un token, informazioni utente e, facoltativamente, endpoint di fine sessione. L'ambito deve includere openid , seguito solo dai dati obbligatori come profile e email . URL di base di reindirizzamento pubblico è l'indirizzo di base pubblico completo di questa installazione, inclusa una sottodirectory ove presente.
Utilizza un parametro di accesso forzato come max_age=0 solo quando il provider lo supporta e Forza accesso è abilitato. Altrimenti lascialo vuoto per preservare una sessione SSO esistente valida.
13. OAuth2
OAuth2 utilizza endpoint di autorizzazione, token e informazioni utente oltre agli ambiti richiesti per i dati utente. Se il provider supporta OpenID Connect, preferisci OIDC perché standardizza la convalida dell'identità e del token. OAuth2 Il logout può richiedere un endpoint dedicato, un nome di parametro di reindirizzamento o un suggerimento; inserire solo i valori richiesti dalla documentazione del provider.
14. Profilo personale: sicurezza e accesso
Apri Profilo personale dal menu utente. La sezione principale mostra l'identità e gli attributi personalizzati. Sicurezza e accesso visualizza l'appartenenza al gruppo, lo stato della password locale, gli accessi esterni collegati e le richieste di chiave API.
Collega un account esterno solo mentre controlli entrambe le identità. Rimuovi i collegamenti sconosciuti o non utilizzati, ma verifica prima che sia disponibile un altro metodo di accesso. Modifica le password locali tramite questo modulo sicuro, mai tramite e-mail o un messaggio dell'amministratore.
15. Verifica e checklist di sicurezza
- Mantieni disponibile almeno un accesso amministrativo controllato; conserva l'account di emergenza separato dal normale uso quotidiano.
- Per ogni profilo SSO, verifica gli URL di richiamata esatti, i certificati TLS, gli ambiti minimi e la rotazione dei segreti.
- Non accettare una casella di controllo attiva come prova. Richiedere lo stato operativo verde dopo il test ripetuto.
- Il soggetto deve essere un identificatore immutabile del servizio di accesso. Identificatore di accesso ed email possono cambiare e non sono sempre adatti come identificatori principali.
- Testare le restrizioni del dominio sia con un account di prova consentito che con uno negato.
- Esamina regolarmente gli amministratori, le appartenenze ai gruppi, gli accessi esterni collegati, le chiavi API attive e le richieste in sospeso.
- Non inserire mai password, segreti client, token, segreti API o attributi personali non elaborati in screenshot, documentazione, ticket o controllo del codice sorgente.
- Dopo il test, rimuovi o disattiva gli account e le chiavi della documentazione che non sono più necessari.
Dopo aver salvato, prova un accesso normale e un account negato. Conferma che ogni utente veda solo il contenuto e le azioni assegnate ai propri gruppi.
Comments
0There are no comments yet.
You must sign in to add a comment.