Aggiungi l'autenticazione a due fattori TOTP a ownCloud Infinite Scale con Keycloak

ownCloud Infinite Scale non offre un interruttore 2FA autonomo nella sua interfaccia utente. Per le password monouso basate sul tempo (TOTP), è necessario configurare un provider di identità OpenID Connect come Keycloak, richiedere agli utenti di registrare un autenticatore su tale provider e consentire a quest'ultimo di richiedere l'autenticazione durante l'accesso. Le impostazioni MFA di Infinite Scale sono destinate ai controlli a più fattori sui percorsi protetti; non creano un flusso di registrazione OTP.

Questa guida utilizza Keycloak come esempio di provider di identità. Le etichette esatte dei menu possono variare a seconda della versione di Keycloak. Gli screenshot seguenti sono illustrazioni dell'interfaccia, non acquisizioni di un server testato. La documentazione attuale di ownCloud 8.2 elenca OCIS_MFA_ENABLEDe OCIS_MFA_AUTH_LEVEL_NAMESper l'applicazione a livello di route, introdotta in Infinite Scale 7.3.0.

Scegliere il modello di applicazione più appropriato

Innanzitutto, bisogna decidere se gli utenti debbano inserire un secondo fattore di autenticazione a ogni nuovo accesso o solo quando raggiungono una sezione sensibile del servizio. Keycloak può richiedere il TOTP nel flusso di autenticazione del browser. Infinite Scale può richiedere un'autenticazione a più fattori per determinate route utilizzando il claim OIDC Authentication Context Class Reference (ACR). Risolvono problemi correlati ma differenti.

ApproccioAdattaCompromesso
Keycloak TOTP al momento dell'accessoOrganizzazioni che desiderano un secondo fattore per l'accesso tramite browserGli utenti necessitano di un'app di autenticazione e di un piano di recupero; le sessioni esistenti possono rimanere valide fino alla loro scadenza o fino a quando gli utenti non effettuano nuovamente l'accesso.
Autenticazione a più fattori con step-up su scala infinitaTeam che proteggono percorsi o azioni sui dati selezionatiRichiede un IdP che supporti l'autenticazione a più fattori e le attestazioni ACR, oltre a una configurazione corrispondente su entrambi i lati.
Chiave di sicurezza o password WebAuthnI team danno priorità all'autenticazione resistente al phishingLa registrazione, il supporto del dispositivo e il recupero dell'account richiedono pianificazione; si tratta di una scelta di secondo fattore diversa da TOTP.

Per un'implementazione TOTP semplice, inizia con il flusso di accesso tramite browser di Keycloak. Mantieni l'autenticazione a più fattori (MFA) come policy separata e specifica quando hai bisogno di controlli specifici per il percorso. Consulta la documentazione del proxy ownCloud su ACR e sull'autenticazione a più fattori per il comportamento lato server.

Prima di modificare il flusso di accesso

  • Verifica che Infinite Scale reindirizzi già gli accessi a Keycloak tramite OIDC. Configura e testa prima la connessione al provider di identità; l'autenticazione a più fattori (MFA) non risolverà un'integrazione SSO non funzionante.
  • Utilizza HTTPS per entrambi gli endpoint di accesso pubblici, mantieni sincronizzato l'orologio host di Keycloak e verifica che gli amministratori possano ancora raggiungere la console di Keycloak.
  • Scegliete il metodo di registrazione e comunicate un percorso di recupero prima di imporre il secondo fattore di autenticazione. Effettuate un test pilota con un account di prova e un piccolo gruppo.

Abilita la registrazione TOTP in Keycloak

  1. Configura i criteri OTP. Nel dominio corretto, apri Autenticazione e le impostazioni dei criteri OTP. Scegli un criterio OTP basato sul tempo. Assicurati che l'algoritmo, la lunghezza del codice e il periodo configurati siano compatibili con le app di autenticazione supportate dalla tua organizzazione. I codici TOTP scadono rapidamente, quindi la deriva dell'orologio del dispositivo può causare tentativi non riusciti.

Pagina di autenticazione Keycloak a scopo illustrativo che mostra una policy OTP basata sul tempo con impostazioni relative ad algoritmo, numero di cifre, finestra di previsione e periodo.

Illustrazione: Impostazioni dei criteri OTP di Keycloak per i codici temporizzati. Verifica i valori effettivi del tuo dominio prima di registrare gli utenti.

  1. Abilita Configura OTP. In Autenticazione > Azioni richieste , assicurati che Configura OTP sia abilitato. L'attivazione dell'azione predefinita può richiedere ai nuovi utenti di registrarsi. L'azione non viene assegnata automaticamente a tutti gli account esistenti.
  2. Registra gli utenti esistenti prima di implementare la funzionalità su larga scala. Assegna l'azione "Configura OTP" agli utenti pilota o chiedi loro di registrarsi tramite la console dell'account, quindi verifica che ciascuno possa effettuare un nuovo accesso. Per un'implementazione più ampia, pianifica come verranno inviati gli avvisi agli utenti rimanenti e come il personale di supporto ripristinerà l'accesso in caso di smarrimento del dispositivo.

Tabella esemplificativa delle azioni richieste da Keycloak con la configurazione dell'OTP abilitata e selezionata come azione predefinita per i nuovi utenti.

Illustrazione: La configurazione dell'OTP è abilitata come azione obbligatoria e predefinita; gli utenti esistenti necessitano comunque di un piano di registrazione.

Richiedi il secondo fattore nel flusso del browser

  1. Copia il flusso Browser predefinito. Nell'area Autenticazione > Flussi di Keycloak , duplica il flusso Browser predefinito e modifica la copia. Conservare una copia ti offre un metodo più sicuro per confrontare e ripristinare la policy.
  2. Richiedi l'OTP per il progetto pilota. Nel flusso copiato, configura il sotto-flusso condizionale di autenticazione a due fattori (2FA) e il modulo OTP in modo che gli utenti non possano completare l'autenticazione tramite browser basata su password senza il passaggio del secondo fattore. La guida di amministrazione di Keycloak descrive come richiedere l'OTP nel flusso condizionale; a un account senza credenziali OTP viene richiesto di configurarne una. Associa il flusso copiato come flusso del browser del realm solo dopo che il progetto pilota ha avuto successo.
  3. Prova un nuovo accesso. Utilizza una finestra di navigazione in incognito in modo che un cookie SSO esistente non nasconda la richiesta di accesso. Accedi con l'account di prova, scansiona il codice QR di configurazione con un'app di autenticazione, inserisci un codice corrente, quindi disconnettiti e accedi di nuovo. Verifica che l'accesso tramite browser non sia più completato solo con la password.

Esempio di flusso di Keycloak Browser con il sotto-flusso condizionale di autenticazione a due fattori (2FA) e il modulo OTP contrassegnato come obbligatorio.

Esempio: un flusso di navigazione che richiede un codice OTP. Implementatelo solo dopo aver testato la registrazione e il recupero dell'account.

Il flusso predefinito del browser di Keycloak può comportarsi in modo condizionale: gli utenti che non hanno registrato un secondo fattore di autenticazione potrebbero non visualizzare la richiesta di OTP a meno che il flusso non venga modificato. Consultare la Guida di amministrazione di Keycloak Server prima di modificare i requisiti del flusso, soprattutto se si utilizzano anche servizi di brokeraggio di identità, chiavi di accesso, client desktop o client per dispositivi mobili.

Opzionale: richiedi a Infinite Scale un'autenticazione a più fattori (MFA) su percorsi selezionati.

Per i controlli a livello di percorso, configurare il proxy e il frontend con impostazioni MFA corrispondenti. In una configurazione di distribuzione che accetta variabili d'ambiente, i nomi attuali della versione 8.2 includono:

OCIS_MFA_ENABLED: "true"
OCIS_MFA_AUTH_LEVEL_NAMES: "advanced"

Utilizza lo stesso valore ACR accettato che il tuo provider di identità inserisce nel token di accesso dopo l'autenticazione a più fattori (MFA) riuscita. Configura i percorsi protetti desiderati in base alla documentazione di distribuzione del proxy e del frontend, quindi ridistribuisci i servizi interessati. Questa impostazione è disabilitata per impostazione predefinita e non attiva, di per sé, TOTP né impone l'OTP per ogni accesso. Se un utente raggiunge un percorso protetto senza il livello MFA richiesto, Infinite Scale documenta una risposta 403 con un'intestazione X-OCIS-MFA-Required. Consulta il riferimento alla variabile d'ambiente MFA di ownCloud e la configurazione del servizio proxy .

Esempio di configurazione di distribuzione ownCloud Infinite Scale che mostra l'autenticazione a più fattori (MFA) abilitata e un livello di autenticazione ACR accettato.

Illustrazione: il nome corrente della variabile d'ambiente plurale per i livelli di autenticazione MFA accettati; il suo valore deve corrispondere alla dichiarazione ACR dell'IdP.

Verificare l'implementazione e preservare l'accesso di ripristino

Testa la policy con un utente normale, un utente non registrato, un amministratore e qualsiasi client desktop o mobile utilizzato dalla tua organizzazione. Verifica che un nuovo accesso tramite browser richieda il codice TOTP e che un codice valido venga accettato. Per la verifica a più livelli, richiedi una route protetta con una sessione che non ha completato l'autenticazione a più fattori (MFA), quindi verifica che la richiesta dell'IdP venga accettata e che la route funzioni dopo l'emissione del livello ACR richiesto.

Prima di richiedere l'OTP su tutto il dominio, è necessario predisporre una procedura di ripristino per l'amministratore. È importante documentare come reimpostare un autenticatore smarrito, mantenere l'accesso alla console del provider di identità ed evitare di affidarsi esclusivamente al telefono di una persona per accedere al servizio. Il TOTP è ampiamente supportato e facile da implementare, mentre WebAuthn offre una maggiore resistenza al phishing; la scelta dipende dai dispositivi, dalla capacità di supporto e dai controlli di ripristino effettivamente disponibili per gli utenti. La knowledge base di ownCloud identifica Keycloak come opzione per l'autenticazione a due fattori su scala illimitata.

Lascia un commento

Risoluzione dei problemi di connessione MySQL di ownCloud 10

Scopri se MySQL, PHP, le impostazioni dei socket o i permessi del database stanno bloccando ownCloud 10, quindi verifica una soluzione sicura.

Imposta un limite di scadenza preciso per i link pubblici di ownCloud.

Imposta un limite di scadenza preciso per i link pubblici di ownCloud.

Rendi obbligatoria la scadenza dei link pubblici in ownCloud Classic, imposta una durata massima e verifica le condivisioni esistenti che potrebbero richiedere una pulizia separata.

Aggiungi l'autenticazione a due fattori TOTP a ownCloud Infinite Scale con Keycloak

Aggiungi l'autenticazione a due fattori TOTP a ownCloud Infinite Scale con Keycloak

Abilita TOTP tramite Keycloak, registra gli utenti in modo sicuro e scopri quando si applicano le impostazioni MFA a livello di percorso di Infinite Scale.

Ripristina la sincronizzazione di ownCloud abbinando il client al tuo server

Verifica se il problema è dovuto a un'incompatibilità tra OC10 e 7.x o a un journal CSync danneggiato, quindi applica la soluzione corretta senza eliminare i file sincronizzati.

Metti ownCloud su HTTPS con Let's Encrypt e Nginx

Metti ownCloud su HTTPS con Let's Encrypt e Nginx

Scegli HTTP-01 o DNS-01, configura un proxy inverso ownCloud e verifica che Certbot rinnovi automaticamente i certificati HTTPS.

Collega ownCloud Infinite Scale a LDAP per l'accesso degli utenti.

Configura l'accesso LDAP di oCIS, allinea le ricerche di utenti e gruppi e verifica le impostazioni TLS e dello schema prima del rilascio.

Collega un bucket S3 a ownCloud 10 come spazio di archiviazione esterno.

Collega un bucket S3 a ownCloud 10 come spazio di archiviazione esterno.

Aggiungi un bucket Amazon S3 a ownCloud 10, prepara credenziali ed endpoint compatibili e verifica l'accesso senza confondere un punto di montaggio con lo storage primario.

Automatizza i dump del database di ownCloud con un'attività Cron notturna sicura.

Automatizza i dump del database di ownCloud con un'attività Cron notturna sicura.

Pianifica i dump protetti di MariaDB per ownCloud Server, gestisci la modalità di manutenzione in modo sicuro e verifica ogni backup prima di utilizzarlo.

Passare da ownCloud Classic a oCIS con una migrazione supportata

Pianifica una migrazione da ownCloud 10 a oCIS utilizzando l'app supportata, i comandi ordinati, i controlli di identità e un elenco chiaro dei dati che richiedono una gestione separata.

Brand ownCloud Classic 10 con un'app tema e CSS

Sostituisci i loghi di ownCloud Classic 10 e personalizza i colori dell'interfaccia web con un'app per temi, evitando al contempo problemi di aggiornamento e di verifica dell'integrità.