Holarch

Administração

Login único e SCIM

Conecte o provedor de identidade SAML 2.0 de uma organização (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping), ou diretamente o Active Directory de um servidor auto-hospedado, verifique os domínios de e-mail dela, exija o login único, mapeie grupos para funções e provisione contas com SCIM 2.0.

Como usá-lo →

Nesta página
  1. Conceitos
  2. Como usá-lo
    1. Verificar um domínio de e-mail
    2. Conectar o provedor de identidade
    3. Ativar o login único
    4. Exigir o login único
    5. Provisionar contas com SCIM
    6. Quando o certificado do provedor de identidade muda
    7. Login da empresa para várias organizações (auto-hospedado)
    8. Acesso aos projetos do departamento (auto-hospedado)
  3. Regras de entrada
    1. Autenticação em duas etapas
  4. Atributos
    1. Grupos para funções
  5. SCIM
    1. Grupos SCIM e departamentos (auto-hospedado)
  6. Configurar o seu provedor de identidade
    1. Okta
    2. Microsoft Entra ID
    3. Microsoft AD FS
    4. Google Workspace
    5. Ping Identity
  7. Diretório da empresa (Active Directory / LDAP)
    1. Configurar o diretório da empresa
    2. Departamentos a partir de grupos do diretório
    3. Quem pode entrar
    4. Verificação periódica
    5. Autenticação em duas etapas com o diretório da empresa
  8. Limites e observações de segurança

Uma organização pode permitir que os membros entrem no Holarch com a conta de trabalho. O Holarch é o provedor de serviço; o provedor de identidade da sua organização (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping Identity ou qualquer provedor SAML 2.0) verifica quem eles são. O provedor de identidade também pode criar, atualizar e desativar contas do Holarch por meio do SCIM 2.0.

O login único é configurado por um admin da organização em Ajustes da organização → a organização → Acesso e entrada → Login único. Funciona no serviço hospedado e em servidores auto-hospedados, não no aplicativo desktop. Um servidor auto-hospedado precisa de acesso de saída para verificar um domínio (uma consulta DNS) e para ler metadados de uma URL. Um servidor auto-hospedado também pode verificar contas corporativas ele mesmo com o Active Directory ou outro diretório LDAP, sem provedor de identidade: veja Diretório da empresa (Active Directory / LDAP).

Nota: o login único e o provisionamento SCIM fazem parte do plano Team (o da organização). As organizações que os usavam antes da versão 2.29.0 os mantêm. Sem o plano, os ajustes são mantidos, mas os membros entram com a senha (Esqueceu sua senha? define uma), com o Google ou a Microsoft, e as solicitações SCIM são recusadas.

Conceitos

TermoSignificado
Domínio verificadoUm domínio de e-mail (como example.com) que a organização provou controlar com um registro TXT no DNS. O login único e o SCIM só funcionam para endereços em domínios verificados. Um domínio pode ser verificado por uma única organização.
Provedor de identidade (IdP)O serviço que faz a entrada dos seus membros: o ID da entidade dele (emissor), a URL de entrada e o certificado de assinatura.
Provedor de serviço (SP)O Holarch, para esta organização. Cada organização tem o próprio ID de entidade, URL do ACS e URL dos metadados.
Membros gerenciadosMembros da organização cujo endereço de e-mail está em um domínio verificado e que não são admins da organização. Exigir login único se aplica a eles.
Token SCIMUm segredo que o provedor de identidade usa para chamar a API SCIM do Holarch para esta organização. Não está ligado a uma pessoa.

Como usá-lo

Verificar um domínio de e-mail

  1. Abra os Ajustes da organização, selecione a organização, abra Acesso e entrada e encontre Login único.
  2. Em Domínios de e-mail, digite o domínio dos endereços dos seus membros e escolha Adicionar domínio.
  3. Publique o registro TXT mostrado: o nome _holarch-challenge.<domain> com o valor holarch-domain-verification=….
  4. Escolha Checar. As alterações de DNS podem levar alguns minutos para chegar; cheque de novo até o domínio mostrar Verificado.

Adicione todos os domínios que os seus membros usam (por exemplo example.com e eng.example.com). Até 20 domínios por organização.

Conectar o provedor de identidade

  1. No seu provedor de identidade, crie um aplicativo SAML 2.0 (veja as seções dos provedores abaixo) com os valores em Provedor de identidade no Holarch:
    • ID da entidade (audience): https://app.holarch.app/api/auth/saml/<organization id>/metadata
    • URL do ACS (URL de resposta): https://app.holarch.app/api/auth/saml/<organization id>/acs
    • URL dos metadados: a mesma do ID da entidade; os provedores que importam metadados do SP podem usá-la.
  2. Copie o XML de metadados do provedor ou a URL de metadados dele para a caixa no topo e escolha Ler metadados. O Holarch preenche o ID da entidade, a URL de entrada e o certificado. Ou digite-os você mesmo.
  3. Em Atributos e funções, defina os nomes de atributos se o seu provedor usa nomes incomuns (veja Atributos), a Função dos novos membros e, opcionalmente, Grupos para funções.
  4. Escolha Salvar provedor de identidade e digite a sua senha.

Ativar o login único

  1. Marque Login único para esta organização. Ele precisa de um provedor de identidade salvo e de um domínio verificado.
  2. Dê aos membros o Link de entrada para membros, ou diga a eles que escolham Entrar com login único na tela de entrada e digitem o endereço de e-mail de trabalho.
  3. Teste primeiro com um membro.

Na primeira entrada de um membro, o Holarch cria a conta (confirmada, sem senha) e a adiciona à organização, também enquanto o cadastro exige convite. Quando já existe uma conta com esse endereço, o login único é vinculado a ela e o titular recebe um e-mail.

Exigir o login único

Marque Exigir login único para membros dos domínios verificados depois que o login único funcionar.

  • Os membros gerenciados passam a entrar só pelo provedor de identidade. A entrada por senha, chave de acesso, Google e Microsoft responde que a organização exige login único, com um botão que leva até lá. As sessões atuais deles por outros métodos de entrada terminam na hora.
  • Os admins da organização não são obrigados: eles mantêm a senha ou a chave de acesso com autenticação em duas etapas, para poderem corrigir uma configuração quebrada do provedor de identidade (acesso de emergência). Mantenha pelo menos dois admins da organização.
  • Os membros cujo endereço está fora dos domínios verificados (colaboradores externos) não são afetados.
  • Uma redefinição de senha ainda define a nova senha, mas não faz a entrada do membro; ele então entra pelo provedor de identidade.
  • Os tokens de API e os aplicativos conectados dos membros gerenciados continuam funcionando. Desative a conta por SCIM para encerrá-los.

Provisionar contas com SCIM

  1. Em Provisionamento (SCIM 2.0), escolha Criar token SCIM e digite a sua senha.
  2. Copie o token e a URL base (https://app.holarch.app/scim/v2) para os ajustes de provisionamento do seu provedor de identidade. O Holarch mostra o token uma vez.
  3. Ative no provedor a criação, a atualização e a desativação de usuários.

Até 5 tokens por organização. Revogar encerra um token na hora.

Quando o certificado do provedor de identidade muda

  1. Cole o novo certificado sob o antigo (são permitidos dois certificados) e salve.
  2. Mude o provedor para o novo certificado.
  3. Remova o certificado antigo e salve de novo.

A lista de certificados mostra o assunto, a data de expiração e a impressão digital de cada certificado.

Login da empresa para várias organizações (auto-hospedado)

Um domínio de e-mail pertence a uma organização. Quando uma empresa tem uma organização por departamento em um servidor auto-hospedado, uma organização (geralmente a de TI) verifica o domínio da empresa, conecta o provedor de identidade e ativa o login único. As outras organizações então mapeiam grupos do provedor de identidade para as suas próprias funções:

  1. Nos Ajustes da organização → Acesso e entrada → Login único do departamento, localize Login da empresa. Ele indica a organização que opera o login da empresa.
  2. Em Grupos para funções, escreva um mapeamento por linha, por exemplo packs-engineers = member e packs-leads = admin, e escolha Salvar grupos.
  3. Opcional: adicione o acesso aos projetos do departamento do grupo depois de uma vírgula, por exemplo packs-contractors = member, viewer. Veja Acesso aos projetos do departamento.

A cada login pelo login da empresa, uma pessoa em um grupo mapeado entra nessa organização com essa função ou se torna admin da organização ali. O login nunca remove nem rebaixa ninguém (os grupos SCIM podem: veja Grupos SCIM e departamentos); os admins da organização removem pessoas nos Ajustes da organização. O provedor de identidade precisa enviar os grupos (Atributo de grupos do login da empresa).

Os admins da organização que opera o login da empresa controlam o login de todos os endereços do domínio. Restrinja essa organização às pessoas que operam o provedor de identidade.

Acesso aos projetos do departamento (auto-hospedado)

Cada mapeamento de grupo também pode dizer quanto as suas pessoas recebem nos projetos compartilhados com a organização inteira (Compartilhar → Organizações): viewer, reviewer ou editor (o padrão). A função de uma pessoa em um projeto desses é a menor entre a função do compartilhamento e o acesso mais alto entre os grupos mapeados dela ali. Por exemplo, com um projeto compartilhado como Editor e packs-contractors = member, viewer, um prestador de serviço o visualiza; alguém que está em packs-contractors e em packs-engineers = member o edita. A regra vale qualquer que seja a origem dos grupos: login único da empresa, grupos SCIM e o diretório da empresa. Projetos compartilhados diretamente com uma pessoa não são afetados, e um membro adicionado manualmente (em nenhum grupo mapeado) recebe a função do compartilhamento. Alterar o acesso de um grupo vale na hora para todos que ele colocou.

Licenças de editor. A licença limita os editores; leitores e revisores são gratuitos. Quando o acesso de Editor de um grupo tornaria alguém editor e não há licença livre, essa pessoa recebe Leitor, e o login continua funcionando. Os Ajustes da organização e Admin → Diretório da empresa mostram quantas pessoas estão retidas em Leitor; a página Diretório da empresa lista cada editor cuja licença vem de um grupo, e cada pessoa retida. Quando licenças se liberam, as pessoas retidas recebem Editor na próxima verificação, por ordem de associação mais antiga.

Servidores em uma rede fechada. Quando o servidor não consegue consultar o DNS público, um administrador do site pode escolher Marcar como verificado ao lado de um domínio não verificado em vez de publicar o registro TXT. O domínio continua pertencendo a uma única organização, e a mudança é registrada no log de auditoria.

Regras de entrada

O Holarch confere rigorosamente cada resposta do provedor de identidade. Uma entrada é recusada quando:

  • a asserção não está assinada com um certificado configurado, ou está assinada com SHA-1;
  • o emissor, a audiência (o ID da entidade da organização), o destino ou o destinatário (a URL do ACS) não correspondem;
  • a asserção ainda não é válida ou expirou (são permitidos 2 minutos de diferença de relógio);
  • ela responde a uma entrada que não foi iniciada no mesmo navegador, ou a uma que já foi usada (cada entrada começa uma vez e expira após 10 minutos);
  • a mesma asserção chega uma segunda vez (repetição);
  • o endereço de e-mail falta ou está fora dos domínios verificados da organização;
  • a conta está desativada.

A tela de entrada então diz o que deu errado, e o log de auditoria da organização o registra como auth.sso-failed.

A entrada pelo portal do provedor de identidade (iniciada pelo IdP, quando os membros começam pelo painel de aplicativos do provedor) fica desativada por padrão, porque uma resposta assim não está ligada a uma entrada que o navegador iniciou. Ative Permitir entrada pelo portal do provedor de identidade só quando os seus membros precisarem. A proteção contra repetição e todas as outras verificações continuam valendo.

Autenticação em duas etapas

Por padrão, um login único é a primeira etapa. As contas com autenticação em duas etapas ativada ainda confirmam uma chave de acesso ou um código, e o ajuste Exigir autenticação em duas etapas da organização continua pedindo isso aos membros.

Com Confiar na entrada com vários fatores do provedor de identidade ativado, uma entrada cuja asserção informa autenticação multifator não precisa da segunda etapa do Holarch, e atende à exigência de duas etapas desta organização para essa sessão (não à de outras organizações). O Holarch aceita estes contextos de autenticação como multifator:

Contexto de autenticaçãoEnviado por
https://refeds.org/profile/mfaMuitos provedores, quando configurados para isso
http://schemas.microsoft.com/claims/multipleauthnMicrosoft Entra ID
urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract (e …MobileTwoFactorUnregistered)Okta e outros
urn:oasis:names:tc:SAML:2.0:ac:classes:TimeSyncTokenCódigo de uso único
urn:oasis:names:tc:SAML:2.0:ac:classes:Smartcard e …SmartcardPKICartões inteligentes

A declaração http://schemas.microsoft.com/claims/authnmethodsreferences do Entra ID com multipleauthn também conta. Uma entrada só com senha no provedor de identidade não é multifator, mesmo com a confiança ativada.

Atributos

HolarchNomes de atributos padrão (é usado o primeiro presente)
E-mail (obrigatório)email, mail, emailaddress, http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress, urn:oid:0.9.2342.19200300.100.1.3, o NameID quando é um endereço de e-mail ou, senão, a claim UPN (http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn)
NomedisplayName, name, http://schemas.microsoft.com/identity/claims/displayname, a declaração name do WS-Federation, ou nome e sobrenome (givenName/firstName, sn/surname/lastName e as formas de declaração deles)
GruposO atributo que você indicar em Atributo de grupos, por exemplo groups. Sem nenhum indicado: groups, memberOf, Role, o http://schemas.xmlsoap.org/claims/Group do AD FS, http://schemas.microsoft.com/ws/2008/06/identity/claims/role, …/claims/groupsid e …/claims/groups

A conta é encontrada pelo NameID do provedor de identidade (formato persistente, de e-mail, de nome qualificado de domínio do Windows ou outro). Sem NameID (o AD FS não envia nenhum, a menos que uma regra de claim o emita), o endereço de e-mail identifica a conta. Quando o NameID muda, mas o endereço de e-mail continua o mesmo, a conta é revinculada.

Os nomes de grupo são comparados sem diferenciar maiúsculas de minúsculas. Um nome qualificado por domínio como CORP\Packs Engineers também corresponde a um mapeamento para Packs Engineers, e um SID de grupo (S-1-5-21-…) corresponde a um mapeamento escrito com esse SID.

Grupos para funções

Escreva um mapeamento por linha: holarch-admins = admin ou engineering = member. A cada entrada, um membro de um grupo mapeado para admin se torna admin da organização; caso contrário, um membro de um grupo mapeado se torna membro. Os membros sem nenhum grupo mapeado mantêm a função. O último admin da organização nunca é rebaixado.

SCIM

A API SCIM segue as RFC 7643 e RFC 7644 em https://app.holarch.app/scim/v2 com Authorization: Bearer hsc_….

EndpointO que ele faz
GET /ServiceProviderConfig, /ResourceTypes, /SchemasDescrever o serviço
GET /UsersListar os usuários provisionados da organização e os membros dos domínios verificados dela; filter com eq em userName, externalId, id, emails.value ou emails[type eq "work"].value; startIndex e count
POST /UsersCriar um usuário (ou vincular uma conta existente com esse endereço) e adicioná-lo à organização
GET, PUT, PATCH /Users/<id>Ler, substituir ou alterar um usuário: userName, name, displayName, emails, externalId, active
DELETE /Users/<id>Desativar o usuário e esquecer o ID externo
/GroupsServidores auto-hospedados: listar, criar, ler, substituir, alterar (PATCH em members, displayName, externalId, nos formatos do Okta e do Microsoft Entra ID) e excluir grupos; filter com eq em displayName, externalId ou id; excludedAttributes=members. Veja Grupos SCIM e departamentos. Serviço hospedado: uma lista vazia, alterações recusadas; em vez disso, mapeie grupos para funções no login único.
  • Só endereços dos domínios verificados da organização podem ser criados ou alterados.
  • Desativar (active: false, ou DELETE) remove a pessoa da organização, desativa a conta, encerra todas as sessões dela e revoga os tokens de API e os aplicativos conectados. Reativar habilita a conta e restaura a função dela na organização. Uma conta que o Holarch desativou (por exemplo após abuso) continua desativada.
  • Os atributos da extensão Enterprise são aceitos e ignorados.
  • Cada token pode fazer 600 solicitações por minuto. Toda alteração é registrada no log de auditoria da organização (scim.create, scim.deactivate e assim por diante).

Grupos SCIM e departamentos (auto-hospedado)

Em um servidor auto-hospedado, o provedor de identidade pode enviar os seus grupos ao endpoint SCIM da organização que detém o domínio da empresa. Os Grupos para funções dos departamentos em Login da empresa decidem então quem pertence a qual departamento, com qual função. Um único mapeamento serve para os dois: o login pelo login único da empresa e os grupos SCIM.

  • Uma pessoa adicionada a um grupo mapeado entra nessa organização com a função mapeada; uma mudança de grupo altera a função.
  • Removida de todos os grupos mapeados, a pessoa sai das organizações em que os grupos a colocaram.
  • Associações adicionadas de outra forma (por um admin da organização, um convite, uma importação ou um login) nunca são removidas nem rebaixadas pelos grupos; os grupos só podem elevá-las a admin da organização. Quando um admin da organização altera manualmente a função de um membro, a associação passa a ser dele a partir de então.
  • O último admin de uma organização nunca é removido nem rebaixado.
  • Alterar os Grupos para funções de um departamento vale na hora para todos nos grupos.
  • Os membros de grupo precisam ser usuários que este token provisiona ou gerencia; outros ids são ignorados.
  • Desativar um usuário funciona como antes; os departamentos dele acompanham os grupos dele.
  • Toda mudança é registrada: scim.group-create, scim.group-update e scim.group-delete no log de auditoria da organização da empresa, e cada mudança de associação no log do departamento.

Configurar o seu provedor de identidade

Okta

  1. Applications → Create App Integration → SAML 2.0.
  2. Single sign-on URL: a URL do ACS. Mantenha Use this for Recipient URL and Destination URL marcado. Audience URI (SP Entity ID): o ID da entidade.
  3. Name ID format: EmailAddress ou Persistent. Application username: Email.
  4. Attribute statements: email → user.email, displayName → user.displayName. Group attribute statements (opcional): groups, com o filtro de que você precisar.
  5. Conclua e depois copie a Metadata URL da aba Sign On para o Holarch e escolha Ler metadados.
  6. Para SCIM: na aba General do aplicativo, habilite SCIM provisioning; em Provisioning, SCIM connector base URL é a URL base, Unique identifier field é userName, Authentication Mode é HTTP Header com o token SCIM; habilite Create Users, Update User Attributes e Deactivate Users.

Microsoft Entra ID

  1. Enterprise applications → New application → Create your own application (fora da galeria) e depois Single sign-on → SAML.
  2. Identifier (Entity ID): o ID da entidade. Reply URL (Assertion Consumer Service URL): a URL do ACS.
  3. Attributes & Claims: a declaração padrão emailaddress funciona; adicione uma declaração de grupo se você mapear grupos.
  4. Em SAML Certificates, copie a App Federation Metadata Url para o Holarch e escolha Ler metadados.
  5. Para confiar na entrada multifator do Entra, exija MFA em uma política de Conditional Access para o aplicativo; o Entra então envia multipleauthn.
  6. Para SCIM: Provisioning → Automatic; Tenant URL é a URL base e Secret Token é o token SCIM. Test Connection e depois inicie o provisionamento.

Microsoft AD FS

O AD FS (Active Directory Federation Services, Windows Server 2016 ou posterior) faz o login de pessoas do seu Active Directory local. No console AD FS Management:

  1. Relying Party Trusts → Add Relying Party Trust → Claims aware → Import data about the relying party published online e informe a URL dos metadados do Holarch. Se o servidor AD FS não conseguir alcançar o Holarch, salve os metadados como arquivo e escolha Import data about the relying party from a file. Nome de exibição: Holarch.
  2. Access control policy: Permit everyone ou Permit everyone and require MFA (veja a etapa 6).
  3. Abra Edit Claim Issuance Policy → Add Rule → Send LDAP Attributes as Claims da confiança, repositório de atributos Active Directory:
Atributo LDAPTipo de claim de saída
E-Mail-AddressesE-Mail Address
Display-NameNome
Token-Groups – Unqualified NamesGrupo

Use Token-Groups – Qualified by Domain Name quando dois domínios têm grupos com o mesmo nome; Token-Groups as SIDs (tipo de claim Group SID) quando os nomes de grupo mudam. O Holarch lê as claims Group, Role e Group SID sem um Atributo de grupos.

O AD FS envia o pre-Windows 2000 name de cada grupo (sAMAccountName), não o nome de exibição nem o cn, e inclui o grupo primário (geralmente Domain Users). Mapeie os grupos por esse nome ou pelo SID. Em um servidor com o diretório da empresa conectado, Admin → Diretório da empresa → Testar um usuário lista os dois para cada grupo de uma pessoa.

  1. Opcional, um NameID estável: Add Rule → Transform an Incoming Claim, de entrada E-Mail Address (ou UPN), de saída Name ID, formato Email (ou Persistent Identifier). Sem ele, o Holarch identifica a conta pelo endereço de e-mail.
  2. Em Properties → Advanced da confiança, mantenha SHA-256. Deixe a aba Encryption vazia: o Holarch não descriptografa asserções, e a conexão é https. O AD FS assina a asserção por padrão (SamlResponseSignature AssertionOnly), o que o Holarch exige.
  3. Copie https://<your AD FS host>/FederationMetadata/2007-06/FederationMetadata.xml para a URL dos metadados do Holarch e escolha Ler metadados. Isso preenche o ID da entidade (http://<host>/adfs/services/trust), a URL de login (https://<host>/adfs/ls/) e o certificado de assinatura de tokens. Para confiar na entrada com vários fatores do AD FS, exija MFA na política de controle de acesso e ative Confiar na entrada com vários fatores do provedor de identidade; o AD FS então envia http://schemas.microsoft.com/claims/multipleauthn.

Em um servidor auto-hospedado, a URL dos metadados pode ser um endereço interno (https://adfs.corp.example.com/…, um IP privado), e o certificado dela é verificado em relação à CA da empresa em tls/ldap-ca.pem, além das CAs confiáveis do sistema. O certificado de assinatura de tokens do AD FS é renovado todo ano: o Holarch mostra a data de validade; use Ler metadados de novo quando o AD FS adicionar o novo (os dois são mantidos durante a sobreposição). O AD FS não tem SCIM; com um diretório da empresa em um servidor auto-hospedado, o Holarch verifica as contas ele mesmo (abaixo).

Google Workspace

  1. Admin console → Apps → Web and mobile apps → Add app → Add custom SAML app.
  2. Copie os IdP metadata (baixe-os e depois cole o XML no Holarch).
  3. ACS URL: a URL do ACS. Entity ID: o ID da entidade. Name ID format: EMAIL, Name ID: Basic Information › Primary email.
  4. Attribute mapping: Primary email → email; First name → givenName; Last name → sn. Group membership → groups (opcional).
  5. Ative o aplicativo com ON for everyone (ou para uma unidade organizacional).
  6. O Google Workspace não envia um contexto de autenticação MFA; deixe Confiar na entrada com vários fatores do provedor de identidade desativado. O provisionamento SCIM do Google só funciona com aplicativos da galeria; em vez disso, crie as contas pelo login único.

Ping Identity

  1. PingOne: Applications → Add Application → SAML Application (PingFederate: uma conexão de SP).
  2. Importe a URL dos metadados do Holarch, ou digite a URL do ACS e o ID da entidade.
  3. Attribute mapping: saml_subject → Email Address; adicione email e displayName.
  4. Copie a URL de metadados do IdP para o Holarch e escolha Ler metadados.
  5. Para SCIM: provisionamento do PingOne com uma conexão SCIM; a URL base e a autenticação OAuth 2 Bearer Token com o token SCIM.

Diretório da empresa (Active Directory / LDAP)

Em um servidor auto-hospedado, as pessoas podem entrar com o nome de usuário e a senha corporativos, verificados pelo diretório da empresa: Active Directory (seus controladores de domínio) ou outro diretório LDAP, como OpenLDAP ou FreeIPA. Nenhum provedor de identidade é necessário. Um administrador do site configura isso em Admin → Diretório da empresa; o .env do servidor pode fornecer os valores iniciais (HOLARCH_LDAP_*, SIGN-IN.md do pacote auto-hospedado). Não é oferecido no serviço hospedado.

Configurar o diretório da empresa

Primeiro escolha o Tipo de diretório no alto de Admin → Diretório da empresa: Active Directory ou Outro diretório LDAP (OpenLDAP, FreeIPA, …). É uma só conexão em ambos os casos; o tipo decide quais consultas de grupos são oferecidas, os valores que Usar padrões do Active Directory ou Usar padrões do LDAP colocam no formulário, e as dicas e os exemplos. Mudá-lo substitui um filtro de usuários ou uma consulta de grupos que ainda esteja no padrão do outro tipo e mantém um filtro escrito por você. A página deduz o tipo das configurações salvas (grupos aninhados ou um filtro do Active Directory significam Active Directory).

  1. Crie uma conta de serviço somente leitura no diretório (por exemplo svc-holarch). Coloque o nome dela em Conta de bind e a senha no .env do servidor como HOLARCH_LDAP_BIND_PASSWORD e depois reinicie o servidor. A senha nunca é mostrada no Admin.
  2. Em Servidores de diretório, informe cada controlador de domínio ou servidor LDAP como ldaps://dc1.corp.example.com (porta 636), um por linha; eles são tentados em ordem. ldap://host:389 só funciona com Usar StartTLS ativado. LDAP sem criptografia é recusado, para que uma senha nunca atravesse a rede sem criptografia. Use o nome de host de cada servidor como aparece no certificado dele.
  3. Coloque o certificado da CA que emitiu os certificados dos servidores em Certificado da CA (PEM) ou em tls/ldap-ca.pem no servidor. Vazio significa as CAs confiáveis do sistema.
  4. Informe o DN base (DC=corp,DC=example,DC=com, ou dc=example,dc=com em outro diretório LDAP) e os Domínios de e-mail permitidos.
  5. Escolha Testar conexão. Ele conecta com os valores do formulário, sem salvar, e indica o problema quando algo falha (nenhum servidor respondeu, certificado, conta de bind, DN base).
  6. Em Testar um usuário, informe um nome de usuário para ver o que o login encontraria: o endereço de e-mail, se a conta está ativa, os grupos dela e as organizações em que ela entraria. A senha é opcional; ela é verificada uma vez e nunca armazenada.
  7. Ative Permitir login com contas corporativas e escolha Salvar. A tela de login passa a mostrar Entrar com conta corporativa (ou o seu Texto do botão).

Active Directory: o Filtro de usuários padrão encontra usuários ativos por sAMAccountName, userPrincipalName ou mail, então as pessoas podem digitar jsmith, [email protected] ou CORP\jsmith. Contas desativadas ficam de fora. Consulta de grupos oferece Active Directory, com grupos aninhados (o padrão) e Atributo memberOf (só grupos diretos).

Outro diretório LDAP: Usar padrões do LDAP coloca (&(objectClass=inetOrgPerson)(|(uid={username})(mail={username}))) em Filtro de usuários, então as pessoas digitam seu uid ou endereço de e-mail; qualquer filtro funciona com {username} onde entra o nome digitado. Consulta de grupos oferece Atributo memberOf (OpenLDAP com o overlay memberof, FreeIPA, 389 Directory Server) e Grupos que listam a pessoa como membro (groupOfNames e groupOfUniqueNames; DN base dos grupos diz onde eles estão). Grupos aninhados não contam.

Departamentos a partir de grupos do diretório

Os grupos do diretório colocam as pessoas em organizações com os mesmos Grupos para funções em Login da empresa que o SAML (veja Login da empresa para várias organizações): na caixa Login único de cada organização, mapeie grupos para funções, por exemplo Packs Engineers = member e Packs Leads = admin. Os nomes são comparados sem diferenciar maiúsculas de minúsculas; o DN de um grupo também funciona e, no Active Directory, o SID. Active Directory, com grupos aninhados conta uma pessoa em um grupo também por meio de outros grupos dentro dele.

A cada login e a cada verificação periódica, uma pessoa em um grupo mapeado entra nessa organização com essa função e com o acesso aos projetos do departamento do grupo. Uma associação dada pelo diretório é removida quando a pessoa sai de todos os grupos mapeados para ela; associações adicionadas manualmente permanecem (o diretório pode elevar um membro a admin da organização ali, mas nunca o rebaixa). O último admin da organização nunca é removido.

Quem pode entrar

  • A conta precisa estar ativa no diretório: contas desativadas, bloqueadas e expiradas são recusadas, assim como contas cuja senha expirou ou precisa ser alterada no próximo logon.
  • A entrada do diretório precisa ter um endereço de e-mail em um domínio permitido. O primeiro login cria a conta Holarch ou vincula a conta existente com esse endereço. Uma conta já vinculada a outra entrada do diretório não é assumida.
  • Exigir login corporativo para contas vinculadas impede que contas vinculadas entrem com uma senha do Holarch. Os administradores do site mantêm a senha, para que uma falha do diretório nunca deixe todos sem acesso.
  • Senhas erradas pausam o login dessa conta corporativa por 15 minutos depois de Tentativas com falha antes de uma pausa (padrão 3), qualquer que seja a forma do nome digitada (jsmith, [email protected], CORP\jsmith). Mantenha esse valor abaixo do limite de bloqueio do domínio, para que o Holarch nunca bloqueie uma conta corporativa. Nomes de usuário desconhecidos e senhas erradas recebem a mesma resposta, em aproximadamente o mesmo tempo.

Verificação periódica

A cada Verificar contas a cada minutos (padrão 15), o servidor consulta cada conta vinculada que está conectada ou tem associações vindas do diretório. Uma pessoa que foi desativada, bloqueada, removida do diretório ou cuja senha expirou ou precisa ser alterada no próximo logon (muitas vezes uma redefinição feita por um administrador após suspeita de comprometimento) é desconectada em todos os lugares e perde as associações que o diretório deu; mudanças de grupo atualizam as associações. Uma conta bloqueada recupera as associações no próximo login depois de ser desbloqueada. Quando o diretório não pode ser alcançado, nada muda. Quando a maioria das contas verificadas está ausente (por exemplo, depois de um DN base errado), nada é encerrado e o Admin mostra o alerta. Verificar agora executa a verificação na hora. O Admin mostra o resultado da última verificação.

Cada verificação também consulta os membros de todos os grupos mapeados (grupos aninhados contam com Active Directory, com grupos aninhados) e cria contas para pessoas que ainda não têm uma, com as mesmas regras do login (ativa, um domínio de e-mail permitido, nenhuma tomada de uma conta vinculada em outro lugar). Nenhum e-mail é enviado; a pessoa entra com a conta corporativa quando precisar do Holarch pela primeira vez e já está nos seus departamentos, então os projetos podem ser compartilhados com ela antes disso. Uma verificação cria no máximo 200 contas; o Admin mostra quantas mais aguardam a próxima verificação. Grupos indicados só por SID não são consultados dessa forma; as pessoas deles são colocadas no login.

Autenticação em duas etapas com o diretório da empresa

O login da empresa é a primeira etapa. Organizações que exigem autenticação em duas etapas continuam pedindo a segunda etapa do Holarch (uma chave de acesso ou um código), e contas com a autenticação em duas etapas ativada continuam a confirmá-la. Ative Considerar o login corporativo como autenticação em duas etapas somente quando a própria conta corporativa exigir um segundo fator; ele então atende à exigência de duas etapas de todas as organizações nessa sessão.

Todo login pelo diretório, toda recusa e toda mudança de configuração ficam no log de auditoria (admin.directory-save, admin.directory-test, directory.account-ended) e nos registros de login de cada conta. As senhas nunca são registradas.

Limites e observações de segurança

Limite: o login único usa o binding HTTP-Redirect para o provedor de identidade e HTTP-POST de volta para o Holarch. Solicitações de autenticação assinadas e criptografadas, asserções criptografadas e logout único não são compatíveis. Os grupos SCIM são compatíveis somente em servidores auto-hospedados (Grupos SCIM e departamentos). O diretório da empresa faz o login com nome de usuário e senha (bind simples via TLS); Kerberos e o login integrado do Windows não são compatíveis.

  • As alterações nos ajustes precisam de uma confirmação de senha recente, são enviadas por e-mail a todos os admins da organização e são registradas no log de auditoria (sso.saml-save, sso.enable, sso.require, sso.domain-verify, scim.token-create…).
  • As URLs de metadados precisam usar https na internet pública (em um servidor auto-hospedado, endereços internos também são permitidos); o Holarch as busca uma vez, quando você escolhe Ler metadados.
  • Os tokens SCIM são guardados só como hash.