Amministrazione
Single sign-on e SCIM
Collegare l'identity provider SAML 2.0 di un'organizzazione (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping) oppure, su un server self-hosted, direttamente Active Directory, verificarne i domini email, richiedere il single sign-on, associare i gruppi ai ruoli e creare account con SCIM 2.0.
In questa pagina
- Concetti
- Come usarlo
- Verificare un dominio email
- Collegare l'identity provider
- Attivare il single sign-on
- Rendere obbligatorio il single sign-on
- Eseguire il provisioning degli account con SCIM
- Quando il certificato dell'identity provider cambia
- Accesso aziendale per più organizzazioni (self-hosted)
- Accesso ai progetti del reparto (self-hosted)
- Regole di accesso
- Attributi
- SCIM
- Configurare il proprio identity provider
- Directory aziendale (Active Directory / LDAP)
- Limiti e note sulla sicurezza
Un'organizzazione può consentire ai suoi membri di accedere a Holarch con il loro account di lavoro. Holarch è il service provider; l'identity provider dell'organizzazione (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping Identity o qualsiasi provider SAML 2.0) verifica la loro identità. L'identity provider può anche creare, aggiornare e disattivare account Holarch tramite SCIM 2.0.
Il single sign-on viene configurato da un amministratore dell'organizzazione in Impostazioni organizzazione → l'organizzazione → Accesso e autenticazione → Single sign-on. Funziona nel servizio ospitato e sui server self-hosted, non nell'app desktop. Un server self-hosted ha bisogno di accesso in uscita per verificare un dominio (una ricerca DNS) e per leggere i metadati da un URL. Un server self-hosted può anche verificare direttamente gli account aziendali con Active Directory o un'altra directory LDAP, senza identity provider: vedere Directory aziendale (Active Directory / LDAP).
Nota: il single sign-on e il provisioning SCIM fanno parte del piano Team (quello dell'organizzazione). Le organizzazioni che li usavano prima della versione 2.29.0 li mantengono. Senza il piano, le impostazioni vengono conservate, ma i membri accedono con la loro password (Password dimenticata? ne imposta una), Google o Microsoft, e le richieste SCIM vengono rifiutate.
Concetti
| Termine | Significato |
|---|---|
| Dominio verificato | Un dominio email (come example.com) di cui l'organizzazione ha dimostrato il controllo con un record DNS TXT. Il single sign-on e SCIM funzionano solo per gli indirizzi nei domini verificati. Un dominio può essere verificato da una sola organizzazione. |
| Identity provider (IdP) | Il servizio che autentica i membri: il suo entity ID (emittente), il suo URL di accesso e il suo certificato di firma. |
| Service provider (SP) | Holarch, per questa organizzazione. Ogni organizzazione ha il proprio entity ID, URL ACS e URL dei metadati. |
| Membri gestiti | Membri dell'organizzazione il cui indirizzo email è in un dominio verificato e che non sono amministratori dell'organizzazione. A loro si applica Richiedi il single sign-on. |
| Token SCIM | Un segreto che l'identity provider usa per chiamare l'API SCIM di Holarch per questa organizzazione. Non è legato a una persona. |
Come usarlo
Verificare un dominio email
- Aprire Impostazioni organizzazione, selezionare l'organizzazione, aprire Accesso e autenticazione e trovare Single sign-on.
- In Domini email, inserire il dominio degli indirizzi dei membri e scegliere Aggiungi dominio.
- Pubblicare il record TXT mostrato: il nome
_holarch-challenge.<domain>con il valoreholarch-domain-verification=…. - Scegliere Verifica. Le modifiche DNS possono richiedere alcuni minuti per propagarsi; verificare di nuovo finché il dominio non mostra Verificato.
Aggiungere ogni dominio usato dai membri (ad esempio example.com ed eng.example.com). Fino a 20 domini per organizzazione.
Collegare l'identity provider
- Nel proprio identity provider, creare un'applicazione SAML 2.0 (vedere le sezioni sui provider sotto) con i valori indicati in Identity provider in Holarch:
- Entity ID (audience):
https://app.holarch.app/api/auth/saml/<organization id>/metadata - URL ACS (URL di risposta):
https://app.holarch.app/api/auth/saml/<organization id>/acs - URL dei metadati: lo stesso dell'entity ID; i provider che importano i metadati SP possono usarlo.
- Entity ID (audience):
- Copiare l'XML dei metadati del provider o il suo URL dei metadati nella casella in alto e scegliere Leggi metadati. Holarch compila entity ID, URL di accesso e certificato. Oppure inserirli a mano.
- In Attributi e ruoli, impostare i nomi degli attributi se il provider ne usa di insoliti (vedere Attributi), il Ruolo dei nuovi membri e, facoltativamente, Gruppi e ruoli.
- Scegliere Salva identity provider e inserire la password.
Attivare il single sign-on
- Spuntare Single sign-on per questa organizzazione. Richiede un identity provider salvato e un dominio verificato.
- Dare ai membri il Link di accesso per i membri, oppure indicare loro di scegliere Accedi con single sign-on nella schermata di accesso e inserire l'indirizzo email di lavoro.
- Provare prima con un solo membro.
Al primo accesso di un membro, Holarch crea l'account (confermato, senza password) e lo aggiunge all'organizzazione, anche quando la registrazione richiede un invito. Quando esiste già un account con quell'indirizzo, il single sign-on viene collegato a esso e il suo titolare riceve un'email.
Rendere obbligatorio il single sign-on
Spuntare Richiedi il single sign-on per i membri nei domini verificati quando il single sign-on funziona.
- I membri gestiti accedono allora solo tramite l'identity provider. L'accesso con password, passkey, Google e Microsoft risponde che l'organizzazione richiede il single sign-on, con un pulsante che porta lì. Le loro sessioni attuali aperte con altri metodi di accesso terminano subito.
- Gli amministratori dell'organizzazione non sono obbligati: mantengono la loro password o passkey con l'accesso in due passaggi, così possono correggere una configurazione dell'identity provider non funzionante (accesso di emergenza). Mantenere almeno due amministratori dell'organizzazione.
- I membri il cui indirizzo è fuori dai domini verificati (collaboratori esterni) non sono interessati.
- Una reimpostazione della password imposta comunque la nuova password ma non fa accedere il membro; questi accede poi tramite l'identity provider.
- I token API e le app collegate dei membri gestiti continuano a funzionare. Disattivare l'account tramite SCIM per terminarli.
Eseguire il provisioning degli account con SCIM
- In Provisioning (SCIM 2.0), scegliere Crea token SCIM e inserire la password.
- Copiare il token e l'URL di base (
https://app.holarch.app/scim/v2) nelle impostazioni di provisioning dell'identity provider. Holarch mostra il token una sola volta. - Attivare nel provider la creazione, l'aggiornamento e la disattivazione degli utenti.
Fino a 5 token per organizzazione. Revoca termina subito un token.
Quando il certificato dell'identity provider cambia
- Incollare il nuovo certificato sotto quello vecchio (sono consentiti due certificati) e salvare.
- Passare nel provider al nuovo certificato.
- Rimuovere il vecchio certificato e salvare di nuovo.
L'elenco dei certificati mostra il soggetto, la data di scadenza e l'impronta di ogni certificato.
Accesso aziendale per più organizzazioni (self-hosted)
Un dominio email appartiene a una sola organizzazione. Quando un'azienda gestisce un'organizzazione per reparto su un server self-hosted, una sola organizzazione (di solito quella dell'IT) verifica il dominio aziendale, collega l'identity provider e attiva il single sign-on. Le altre organizzazioni associano poi i gruppi dell'identity provider ai propri ruoli:
- In Impostazioni organizzazione → Accesso e autenticazione → Single sign-on del reparto, trovare Accesso aziendale. Indica l'organizzazione che gestisce l'accesso aziendale.
- In Gruppi e ruoli, scrivere un'associazione per riga, ad esempio
packs-engineers = memberepacks-leads = admin, e scegliere Salva gruppi. - Facoltativo: aggiungere dopo una virgola l'accesso ai progetti del reparto del gruppo, ad esempio
packs-contractors = member, viewer. Vedere Accesso ai progetti del reparto.
A ogni accesso tramite l'accesso aziendale, una persona in un gruppo associato entra in quell'organizzazione con quel ruolo, oppure vi diventa amministratore dell'organizzazione. L'accesso non rimuove né abbassa mai nessuno (i gruppi SCIM sì: vedere Gruppi SCIM e reparti); gli amministratori dell'organizzazione rimuovono le persone in Impostazioni organizzazione. L'identity provider deve inviare i gruppi (Attributo gruppi dell'accesso aziendale).
Gli amministratori dell'organizzazione che gestisce l'accesso aziendale controllano l'accesso per ogni indirizzo del dominio. Limitare quell'organizzazione alle persone che gestiscono l'identity provider.
Accesso ai progetti del reparto (self-hosted)
Ogni associazione di gruppo può anche indicare quanto ottengono le sue persone sui progetti condivisi con l'intera organizzazione (Condividi → Organizzazioni): viewer, reviewer o editor (predefinito). Il ruolo di una persona su un progetto di questo tipo è il più basso tra il ruolo della condivisione e l'accesso più alto tra i suoi gruppi associati in quell'organizzazione. Ad esempio, con un progetto condiviso come Editor e packs-contractors = member, viewer, un collaboratore esterno lo visualizza; chi è sia in packs-contractors sia in packs-engineers = member lo modifica. La regola vale qualunque sia la provenienza dei gruppi: single sign-on aziendale, gruppi SCIM e directory aziendale. I progetti condivisi direttamente con una persona non ne sono toccati, e un membro aggiunto a mano (in nessun gruppo associato) ottiene il ruolo della condivisione. Cambiare l'accesso di un gruppo vale subito per tutte le persone che ha inserito.
Postazioni editor. La licenza limita gli editor; lettori e revisori sono gratuiti. Quando l'accesso Editor di un gruppo renderebbe qualcuno editor e non c'è una postazione libera, quella persona ottiene invece Lettore e l'accesso funziona comunque. Impostazioni organizzazione e Amministrazione → Directory aziendale mostrano quante persone sono trattenute a Lettore; la pagina Directory aziendale elenca ogni editor la cui postazione deriva da un gruppo e ogni persona trattenuta. Quando si liberano postazioni, le persone trattenute ottengono Editor al controllo successivo, a partire dall'appartenenza più vecchia.
Server su una rete chiusa. Quando il server non può consultare il DNS pubblico, un amministratore del sito può scegliere Segna come verificato accanto a un dominio non verificato invece di pubblicare il record TXT. Il dominio continua ad appartenere a una sola organizzazione e la modifica viene registrata nel registro di audit.
Regole di accesso
Holarch controlla rigorosamente ogni risposta dell'identity provider. Un accesso viene rifiutato quando:
- l'asserzione non è firmata con un certificato configurato, o è firmata con SHA-1;
- l'emittente, l'audience (l'entity ID dell'organizzazione), la destinazione o il destinatario (l'URL ACS) non corrispondono;
- l'asserzione non è ancora valida o è scaduta (sono consentiti 2 minuti di differenza dell'orologio);
- risponde a un accesso non avviato nello stesso browser, o a uno già usato (ogni accesso parte una volta e scade dopo 10 minuti);
- la stessa asserzione arriva una seconda volta (replay);
- l'indirizzo email manca o è fuori dai domini verificati dell'organizzazione;
- l'account è disabilitato.
La schermata di accesso indica allora cosa non ha funzionato, e il registro di controllo dell'organizzazione lo registra come auth.sso-failed.
L'accesso dal portale dell'identity provider (avviato dall'IdP, quando i membri partono dalla dashboard delle app del provider) è disattivato per impostazione predefinita, perché una risposta di questo tipo non è legata a un accesso avviato dal browser. Attivare Consenti l'accesso dal portale dell'identity provider solo quando i membri ne hanno bisogno. La protezione dal replay e tutti gli altri controlli si applicano comunque.
Accesso in due passaggi
Per impostazione predefinita un single sign-on è il primo passaggio. Gli account con l'accesso in due passaggi attivo confermano comunque una passkey o un codice, e l'impostazione Richiedi l'accesso in due passaggi dell'organizzazione lo chiede comunque ai membri.
Con Considera attendibile l'accesso a più fattori dell'identity provider attivo, un accesso la cui asserzione riporta un'autenticazione a più fattori non richiede il secondo passaggio di Holarch, e soddisfa l'obbligo dei due passaggi di questa organizzazione per quella sessione (non quello di altre organizzazioni). Holarch accetta come a più fattori questi contesti di autenticazione:
| Contesto di autenticazione | Inviato da |
|---|---|
https://refeds.org/profile/mfa | Molti provider, se configurati in tal senso |
http://schemas.microsoft.com/claims/multipleauthn | Microsoft Entra ID |
urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract (e …MobileTwoFactorUnregistered) | Okta e altri |
urn:oasis:names:tc:SAML:2.0:ac:classes:TimeSyncToken | Codice monouso |
urn:oasis:names:tc:SAML:2.0:ac:classes:Smartcard e …SmartcardPKI | Smart card |
Conta anche il claim http://schemas.microsoft.com/claims/authnmethodsreferences di Entra ID con multipleauthn. Un accesso con la sola password presso l'identity provider non è a più fattori, anche con l'attendibilità attiva.
Attributi
| Holarch | Nomi di attributo predefiniti (viene usato il primo presente) |
|---|---|
| Email (obbligatorio) | email, mail, emailaddress, http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress, urn:oid:0.9.2342.19200300.100.1.3, il NameID quando è un indirizzo email, altrimenti il claim UPN (http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn) |
| Nome | displayName, name, http://schemas.microsoft.com/identity/claims/displayname, il claim WS-Federation name, oppure nome e cognome (givenName/firstName, sn/surname/lastName e le loro forme di claim) |
| Gruppi | L'attributo indicato in Attributo gruppi, ad esempio groups. Se non ne è indicato nessuno: groups, memberOf, Role, il http://schemas.xmlsoap.org/claims/Group di AD FS, http://schemas.microsoft.com/ws/2008/06/identity/claims/role, …/claims/groupsid e …/claims/groups |
L'account viene trovato tramite il NameID dell'identity provider (formato persistente, email, nome qualificato del dominio Windows o un altro formato). Senza NameID (AD FS non ne invia, a meno che una regola di claim non lo emetta), l'indirizzo email identifica l'account. Quando il NameID cambia ma l'indirizzo email resta, l'account viene ricollegato.
I nomi dei gruppi vengono confrontati senza distinzione tra maiuscole e minuscole. Un nome qualificato dal dominio come CORP\Packs Engineers corrisponde anche a un'associazione per Packs Engineers, e un SID di gruppo (S-1-5-21-…) corrisponde a un'associazione scritta con quel SID.
Gruppi e ruoli
Scrivere una corrispondenza per riga: holarch-admins = admin o engineering = member. A ogni accesso, un membro in un gruppo associato ad admin diventa amministratore dell'organizzazione; altrimenti un membro in un gruppo associato diventa membro. I membri che non sono in alcun gruppo associato mantengono il loro ruolo. L'ultimo amministratore dell'organizzazione non viene mai declassato.
SCIM
L'API SCIM segue RFC 7643 e RFC 7644 su https://app.holarch.app/scim/v2 con Authorization: Bearer hsc_….
| Endpoint | Che cosa fa |
|---|---|
GET /ServiceProviderConfig, /ResourceTypes, /Schemas | Descrive il servizio |
GET /Users | Elenca gli utenti dell'organizzazione con provisioning e i membri nei suoi domini verificati; filter con eq su userName, externalId, id, emails.value o emails[type eq "work"].value; startIndex e count |
POST /Users | Crea un utente (o collega un account esistente con quell'indirizzo) e lo aggiunge all'organizzazione |
GET, PUT, PATCH /Users/<id> | Legge, sostituisce o modifica un utente: userName, name, displayName, emails, externalId, active |
DELETE /Users/<id> | Disattiva l'utente e dimentica l'ID esterno |
/Groups | Server self-hosted: elencare, creare, leggere, sostituire, modificare (PATCH su members, displayName, externalId, nei formati di Okta e Microsoft Entra ID) ed eliminare gruppi; filter con eq su displayName, externalId o id; excludedAttributes=members. Vedere Gruppi SCIM e reparti. Servizio ospitato: un elenco vuoto, modifiche rifiutate; associare invece i gruppi ai ruoli nel single sign-on. |
- Si possono creare o modificare solo indirizzi nei domini verificati dell'organizzazione.
- La disattivazione (
active: false, oDELETE) rimuove la persona dall'organizzazione, disabilita l'account, termina tutte le sue sessioni e revoca i suoi token API e le app collegate. La riattivazione abilita l'account e ripristina il suo ruolo nell'organizzazione. Un account disabilitato da Holarch (ad esempio dopo un abuso) resta disabilitato. - Gli attributi dell'estensione Enterprise vengono accettati e ignorati.
- Ogni token può effettuare 600 richieste al minuto. Ogni modifica viene registrata nel registro di controllo dell'organizzazione (scim.create, scim.deactivate e così via).
Gruppi SCIM e reparti (self-hosted)
Su un server self-hosted, l'identity provider può inviare i propri gruppi all'endpoint SCIM dell'organizzazione che detiene il dominio aziendale. Le impostazioni Gruppi e ruoli dei reparti in Accesso aziendale decidono poi chi appartiene a quale reparto, con quale ruolo. Un'unica associazione serve entrambi: l'accesso tramite il single sign-on aziendale e i gruppi SCIM.
- Una persona aggiunta a un gruppo associato entra in quell'organizzazione con il ruolo associato; un cambio di gruppo cambia il ruolo.
- Se viene rimossa da tutti i gruppi associati, una persona lascia le organizzazioni in cui l'avevano aggiunta i gruppi.
- Le appartenenze aggiunte in altro modo (da un amministratore dell'organizzazione, un invito, un'importazione o un accesso) non vengono mai rimosse né abbassate dai gruppi; i gruppi possono solo elevarle ad amministratore dell'organizzazione. Quando un amministratore dell'organizzazione cambia a mano il ruolo di un membro, da quel momento l'appartenenza è gestita da lui.
- L'ultimo amministratore di un'organizzazione non viene mai rimosso né abbassato.
- Cambiare Gruppi e ruoli di un reparto vale subito per tutte le persone nei gruppi.
- I membri dei gruppi devono essere utenti che questo token crea o gestisce; gli altri id vengono ignorati.
- La disattivazione di un utente funziona come prima; i suoi reparti seguono i suoi gruppi.
- Ogni modifica viene registrata: scim.group-create, scim.group-update e scim.group-delete nel registro di audit dell'organizzazione aziendale, e ogni modifica di appartenenza nel registro del reparto.
Configurare il proprio identity provider
Okta
- Applications → Create App Integration → SAML 2.0.
- Single sign-on URL: l'URL ACS. Lasciare spuntato Use this for Recipient URL and Destination URL. Audience URI (SP Entity ID): l'entity ID.
- Name ID format:
EmailAddressoPersistent. Application username: Email. - Attribute statements:
email→user.email,displayName→user.displayName. Group attribute statements (facoltativo):groups, con il filtro necessario. - Completare, poi copiare il Metadata URL dalla scheda Sign On in Holarch e scegliere Leggi metadati.
- Per SCIM: nella scheda General dell'app, abilitare SCIM provisioning; in Provisioning, SCIM connector base URL è l'URL di base, Unique identifier field
userName, Authentication Mode HTTP Header con il token SCIM; abilitare Create Users, Update User Attributes e Deactivate Users.
Microsoft Entra ID
- Enterprise applications → New application → Create your own application (non della raccolta), poi Single sign-on → SAML.
- Identifier (Entity ID): l'entity ID. Reply URL (Assertion Consumer Service URL): l'URL ACS.
- Attributes & Claims: il claim
emailaddresspredefinito funziona; aggiungere un claim di gruppo se si associano gruppi. - In SAML Certificates, copiare l'App Federation Metadata Url in Holarch e scegliere Leggi metadati.
- Per considerare attendibile l'accesso a più fattori di Entra, richiedere l'MFA in un criterio di accesso condizionale per l'app; Entra invia allora
multipleauthn. - Per SCIM: Provisioning → Automatic; Tenant URL è l'URL di base e Secret Token il token SCIM. Test Connection, poi avviare il provisioning.
Microsoft AD FS
AD FS (Active Directory Federation Services, Windows Server 2016 o successivo) fa accedere le persone dall'Active Directory locale. Nella console AD FS Management:
- Relying Party Trusts → Add Relying Party Trust → Claims aware → Import data about the relying party published online, e inserire l'URL dei metadati di Holarch. Se il server AD FS non raggiunge Holarch, salvare i metadati come file e scegliere Import data about the relying party from a file. Nome visualizzato: Holarch.
- Access control policy: Permit everyone, oppure Permit everyone and require MFA (vedere il passaggio 6).
- Aprire Edit Claim Issuance Policy → Add Rule → Send LDAP Attributes as Claims del trust, archivio attributi Active Directory:
| Attributo LDAP | Tipo di claim in uscita |
|---|---|
| E-Mail-Addresses | E-Mail Address |
| Display-Name | Nome |
| Token-Groups – Unqualified Names | Gruppo |
Usare invece Token-Groups – Qualified by Domain Name quando due domini hanno gruppi con lo stesso nome; Token-Groups as SIDs (tipo di claim Group SID) quando i nomi dei gruppi cambiano. Holarch legge i claim Group, Role e Group SID senza un Attributo gruppi.
AD FS invia il pre-Windows 2000 name di ogni gruppo (sAMAccountName), non il nome visualizzato né il cn, e include il gruppo primario (di solito Domain Users). Associare i gruppi con quel nome o con il SID. Su un server con la directory aziendale collegata, Amministrazione → Directory aziendale → Prova un utente mostra entrambi per ciascun gruppo di una persona.
- Facoltativo, un NameID stabile: Add Rule → Transform an Incoming Claim, in ingresso E-Mail Address (o UPN), in uscita Name ID, formato Email (o Persistent Identifier). Senza di esso Holarch identifica l'account tramite l'indirizzo email.
- In Properties → Advanced del trust, mantenere SHA-256. Lasciare vuota la scheda Encryption: Holarch non decifra le asserzioni e la connessione è https. AD FS firma l'asserzione per impostazione predefinita (
SamlResponseSignatureAssertionOnly), cosa che Holarch richiede. - Copiare
https://<your AD FS host>/FederationMetadata/2007-06/FederationMetadata.xmlnell'URL dei metadati di Holarch e scegliere Leggi metadati. Compila l'entity ID (http://<host>/adfs/services/trust), l'URL di accesso (https://<host>/adfs/ls/) e il certificato di firma dei token. Per considerare attendibile l'accesso a più fattori di AD FS, richiedere l'MFA nella policy di controllo degli accessi e attivare Considera attendibile l'accesso a più fattori dell'identity provider; AD FS invia allorahttp://schemas.microsoft.com/claims/multipleauthn.
Su un server self-hosted l'URL dei metadati può essere un indirizzo interno (https://adfs.corp.example.com/…, un IP privato) e il suo certificato viene verificato con la CA aziendale in tls/ldap-ca.pem oltre che con le CA attendibili del sistema. Il certificato di firma dei token di AD FS si rinnova ogni anno: Holarch mostra la data di scadenza; scegliere di nuovo Leggi metadati quando AD FS aggiunge quello nuovo (durante la sovrapposizione vengono mantenuti entrambi). AD FS non ha SCIM; con una directory aziendale su un server self-hosted, Holarch verifica gli account da sé (vedere sotto).
Google Workspace
- Admin console → Apps → Web and mobile apps → Add app → Add custom SAML app.
- Copiare gli IdP metadata (scaricarli, poi incollare l'XML in Holarch).
- ACS URL: l'URL ACS. Entity ID: l'entity ID. Name ID format:
EMAIL, Name ID: Basic Information › Primary email. - Attribute mapping: Primary email →
email; First name →givenName; Last name →sn. Group membership →groups(facoltativo). - Impostare l'app su ON for everyone (o per un'unità organizzativa).
- Google Workspace non invia un contesto di autenticazione MFA; lasciare disattivato Considera attendibile l'accesso a più fattori dell'identity provider. Il provisioning SCIM di Google funziona solo con le app della raccolta; creare invece gli account tramite single sign-on.
Ping Identity
- PingOne: Applications → Add Application → SAML Application (PingFederate: una connessione SP).
- Importare l'URL dei metadati di Holarch, o inserire l'URL ACS e l'Entity ID.
- Attribute mapping:
saml_subject→ Email Address; aggiungereemailedisplayName. - Copiare l'URL dei metadati dell'IdP in Holarch e scegliere Leggi metadati.
- Per SCIM: provisioning PingOne con una connessione SCIM; l'URL di base e l'autenticazione OAuth 2 Bearer Token con il token SCIM.
Directory aziendale (Active Directory / LDAP)
Su un server self-hosted, le persone possono accedere con nome utente e password aziendali, verificati dalla directory dell'azienda: Active Directory (i suoi domain controller) o un'altra directory LDAP come OpenLDAP o FreeIPA. Non serve un identity provider. Un amministratore del sito lo configura in Amministrazione → Directory aziendale; il file .env del server può fornire i valori iniziali (HOLARCH_LDAP_*, SIGN-IN.md della consegna self-hosted). Non è disponibile nel servizio ospitato.
Configurare la directory aziendale
Scegliere prima il Tipo di directory in alto in Amministrazione → Directory aziendale: Active Directory o Altra directory LDAP (OpenLDAP, FreeIPA, …). In entrambi i casi è una sola connessione; il tipo determina quali ricerche dei gruppi sono offerte, i valori che Usa valori predefiniti di Active Directory o Usa valori predefiniti LDAP inseriscono nel modulo, e i suggerimenti e gli esempi. Cambiarlo sostituisce un filtro utenti o una ricerca dei gruppi ancora al valore predefinito dell'altro tipo e mantiene un filtro scritto personalmente. La pagina ricava il tipo dalle impostazioni salvate (gruppi annidati o un filtro di Active Directory significano Active Directory).
- Creare un account di servizio di sola lettura nella directory (ad esempio
svc-holarch). Inserirne il nome in Account di bind e la password nel file.envdel server comeHOLARCH_LDAP_BIND_PASSWORD, poi riavviare il server. La password non viene mai mostrata in Amministrazione. - In Server della directory, inserire ogni domain controller o server LDAP come
ldaps://dc1.corp.example.com(porta 636), uno per riga; vengono provati in ordine.ldap://host:389funziona solo con Usa StartTLS attivo. L'LDAP non cifrato viene rifiutato, così una password non attraversa mai la rete in chiaro. Usare il nome host di ogni server come compare nel suo certificato. - Inserire il certificato della CA che ha emesso i certificati dei server in Certificato CA (PEM) oppure in
tls/ldap-ca.pemsul server. Vuoto significa le CA attendibili del sistema. - Inserire il DN di base (
DC=corp,DC=example,DC=com, odc=example,dc=comin un'altra directory LDAP) e i Domini email consentiti. - Scegliere Prova connessione. Si collega con i valori del modulo, senza salvare, e indica il problema quando qualcosa non riesce (nessun server ha risposto, certificato, account di bind, DN di base).
- In Prova un utente, inserire un nome utente per vedere cosa troverebbe l'accesso: l'indirizzo email, se l'account è attivo, i suoi gruppi e le organizzazioni in cui entrerebbe. La password è facoltativa; viene verificata una volta e mai memorizzata.
- Attivare Consenti l'accesso con gli account aziendali e scegliere Salva. La schermata di accesso mostra allora Accedi con l'account aziendale (o il proprio Testo del pulsante).
Active Directory: il Filtro utenti predefinito trova gli utenti attivi per sAMAccountName, userPrincipalName o mail, così le persone possono digitare jsmith, [email protected] o CORP\jsmith. Gli account disattivati sono esclusi. Ricerca dei gruppi offre Active Directory, con gruppi annidati (il valore predefinito) e Attributo memberOf (solo gruppi diretti).
Altra directory LDAP: Usa valori predefiniti LDAP inserisce (&(objectClass=inetOrgPerson)(|(uid={username})(mail={username}))) in Filtro utenti, così le persone digitano il proprio uid o indirizzo email; qualsiasi filtro funziona con {username} dove va il nome digitato. Ricerca dei gruppi offre Attributo memberOf (OpenLDAP con l'overlay memberof, FreeIPA, 389 Directory Server) e Gruppi che elencano la persona come membro (groupOfNames e groupOfUniqueNames; DN di base dei gruppi indica dove si trovano). I gruppi annidati non contano.
Reparti dai gruppi della directory
I gruppi della directory inseriscono le persone nelle organizzazioni con le stesse impostazioni Gruppi e ruoli in Accesso aziendale usate per SAML (vedere Accesso aziendale per più organizzazioni): nel riquadro Single sign-on di ogni organizzazione, associare i gruppi ai ruoli, ad esempio Packs Engineers = member e Packs Leads = admin. I nomi vengono confrontati senza distinzione tra maiuscole e minuscole; funziona anche il DN di un gruppo e, in Active Directory, il suo SID. Active Directory, con gruppi annidati conta una persona in un gruppo anche tramite altri gruppi contenuti in esso.
A ogni accesso e a ogni controllo periodico, una persona in un gruppo associato entra in quell'organizzazione con quel ruolo e con l'accesso ai progetti del reparto del gruppo. Un'appartenenza data dalla directory viene rimossa quando la persona lascia tutti i gruppi associati a essa; le appartenenze aggiunte a mano restano (la directory può elevare un membro ad amministratore dell'organizzazione, ma non lo abbassa mai). L'ultimo amministratore dell'organizzazione non viene mai rimosso.
Chi può accedere
- L'account deve essere attivo nella directory: gli account disattivati, bloccati e scaduti vengono rifiutati, come pure quelli la cui password è scaduta o deve essere cambiata al prossimo accesso.
- La voce della directory deve avere un indirizzo email in un dominio consentito. Il primo accesso crea l'account Holarch, oppure collega l'account esistente con quell'indirizzo. Un account già collegato a un'altra voce della directory non viene rilevato.
- Richiedi l'accesso aziendale per gli account collegati impedisce agli account collegati di accedere con una password Holarch. Gli amministratori del sito mantengono la propria password, così un'interruzione della directory non blocca mai tutti fuori.
- Le password errate sospendono l'accesso per quell'account aziendale per 15 minuti dopo Tentativi falliti prima di una pausa (predefinito 3), qualunque forma del nome sia stata digitata (
jsmith,[email protected],CORP\jsmith). Mantenerlo sotto la soglia di blocco del dominio, così Holarch non blocca mai un account aziendale. Nomi utente sconosciuti e password errate ricevono la stessa risposta, in un tempo pressoché uguale.
Controllo periodico
Ogni Controlla gli account ogni minuti (predefinito 15), il server consulta ogni account collegato che ha una sessione attiva o detiene appartenenze dalla directory. Una persona che è stata disattivata, bloccata, rimossa dalla directory, o la cui password è scaduta o deve essere cambiata al prossimo accesso (spesso una reimpostazione da parte di un amministratore dopo una sospetta compromissione) viene disconnessa ovunque e perde le appartenenze date dalla directory; i cambi di gruppo aggiornano le appartenenze. Un account bloccato riottiene le appartenenze al primo accesso dopo lo sblocco. Quando la directory non è raggiungibile, non cambia nulla. Quando manca la maggior parte degli account controllati (ad esempio dopo un DN di base errato), non viene terminato nulla e Amministrazione mostra l'avviso. Controlla ora esegue subito il controllo. Amministrazione mostra il risultato dell'ultimo controllo.
Ogni controllo consulta anche i membri di ogni gruppo associato (i gruppi annidati contano con Active Directory, con gruppi annidati) e crea gli account per le persone che non ne hanno ancora uno, con le stesse regole dell'accesso (attivo, un dominio email consentito, nessuna acquisizione di un account collegato altrove). Non viene inviata alcuna email; la persona accede con l'account aziendale quando le serve Holarch per la prima volta ed è già nei propri reparti, quindi i progetti si possono condividere con lei prima di allora. Un controllo crea al massimo 200 account; Amministrazione mostra quanti altri attendono il controllo successivo. I gruppi indicati solo tramite SID non vengono consultati in questo modo; le loro persone vengono inserite all'accesso.
Accesso in due passaggi con la directory aziendale
L'accesso aziendale è il primo passaggio. Le organizzazioni che richiedono l'accesso in due passaggi chiedono comunque il secondo passaggio di Holarch (una passkey o un codice), e gli account con l'accesso in due passaggi attivo lo confermano comunque. Attivare Considera l'accesso aziendale come accesso in due passaggi solo quando l'account aziendale stesso richiede un secondo fattore; soddisfa allora il requisito di accesso in due passaggi di ogni organizzazione per quella sessione.
Ogni accesso tramite directory, rifiuto e modifica delle impostazioni è nel registro di audit (admin.directory-save, admin.directory-test, directory.account-ended) e nei record di accesso di ogni account. Le password non vengono mai registrate.
Limiti e note sulla sicurezza
Limite: il single sign-on usa il binding HTTP-Redirect verso l'identity provider e HTTP-POST di ritorno a Holarch. Le richieste di autenticazione firmate e cifrate, le asserzioni cifrate e il single logout non sono supportati. I gruppi SCIM sono supportati solo sui server self-hosted (Gruppi SCIM e reparti). La directory aziendale fa accedere con nome utente e password (simple bind su TLS); Kerberos e l'accesso integrato di Windows non sono supportati.
- Le modifiche alle impostazioni richiedono una verifica recente della password, vengono inviate via email a tutti gli amministratori dell'organizzazione e vengono registrate nel registro di controllo (sso.saml-save, sso.enable, sso.require, sso.domain-verify, scim.token-create…).
- Gli URL dei metadati devono usare https sull'internet pubblica (su un server self-hosted sono consentiti anche indirizzi interni); Holarch li recupera una volta, quando si sceglie Leggi metadati.
- I token SCIM vengono memorizzati solo come hash.