Habilitar a autenticação do Ative Directory sobre SMB para clientes Linux que acessam Arquivos do Azure

Para obter mais informações sobre opções e considerações com suporte, consulte Visão geral das opções de autenticação baseada em identidade dos Arquivos do Azure para acesso SMB.

Os Arquivos do Azure dão suporte à autenticação baseada em identidade sobre o SMB (Server Message Block) para máquinas virtuais (VMs) Linux usando o protocolo de autenticação Kerberos por meio dos seguintes métodos:

• Serviços de Domínio Ative Directory (AD DS) locais
• Microsoft Entra Domain Services

Para usar a primeira opção (AD DS), você deve sincronizar seu AD DS com o ID do Microsoft Entra usando o Microsoft Entra Connect.

Nota

Este artigo usa o Ubuntu para as etapas de exemplo. Configurações semelhantes funcionarão para máquinas RHEL e SLES, permitindo que você monte compartilhamentos de arquivos do Azure usando o Ative Directory.

Aplica-se a

Tipo de partilhas de ficheiros	SMB	NFS
Partilhas de ficheiros Standard (GPv2), LRS/ZRS
Partilhas de ficheiros Standard (GPv2), GRS/GZRS
Partilhas de ficheiros Premium (FileStorage), LRS/ZRS

Limitações do cliente Linux SMB

Você não pode usar a autenticação baseada em identidade para montar compartilhamentos de arquivos do Azure em clientes Linux no momento da inicialização usando fstab entradas porque o cliente não pode obter o tíquete Kerberos com antecedência suficiente para montar no momento da inicialização. No entanto, você pode usar uma fstab entrada e especificar a noauto opção. Isso não montará o compartilhamento no momento da inicialização, mas permitirá que um usuário monte convenientemente o compartilhamento de arquivos depois de fazer login usando um comando de montagem simples sem todos os parâmetros. Você também pode usar autofs para montar o compartilhamento após o acesso.

Pré-requisitos

Antes de habilitar a autenticação do AD sobre SMB para compartilhamentos de arquivos do Azure, verifique se você concluiu os pré-requisitos a seguir.

• Uma VM Linux (Ubuntu 18.04+ ou uma VM RHEL ou SLES equivalente) em execução no Azure. A VM deve ter pelo menos uma interface de rede na VNET contendo os Serviços de Domínio Microsoft Entra ou uma VM Linux local com AD DS sincronizada com a ID do Microsoft Entra.
• Credenciais de usuário root ou usuário para uma conta de usuário local que tenha direitos sudo completos (para este guia, localadmin).
• A VM do Linux não deve ter ingressado em nenhum domínio do AD. Se ele já faz parte de um domínio, ele precisa primeiro sair desse domínio antes de poder ingressar nesse domínio.
• Um locatário do Microsoft Entra totalmente configurado, com o usuário do domínio já configurado.

Instalar o pacote samba não é estritamente necessário, mas ele lhe dá algumas ferramentas úteis e traz outros pacotes automaticamente, como samba-common e smbclient. Execute os seguintes comandos para instalá-lo. Se lhe forem solicitados valores de entrada durante a instalação, deixe-os em branco.

sudo apt update -y
sudo apt install samba winbind libpam-winbind libnss-winbind krb5-config krb5-user keyutils cifs-utils

A wbinfo ferramenta faz parte da suíte de samba. Ele pode ser útil para fins de autenticação e depuração, como verificar se o controlador de domínio está acessível, verificar a que domínio uma máquina está associada e encontrar informações sobre os usuários.

Certifique-se de que o host Linux mantém o tempo sincronizado com o servidor de domínio. Consulte a documentação da sua distribuição Linux. Para algumas distros, você pode fazer isso usando systemd-timesyncd. Edite /etc/systemd/timesyncd.conf com seu editor de texto favorito para incluir o seguinte:

[Time]
NTP=onpremaadint.com
FallbackNTP=ntp.ubuntu.com

Em seguida, reinicie o serviço:

sudo systemctl restart systemd-timesyncd.service

Habilitar a autenticação Kerberos do AD

Siga estas etapas para habilitar a autenticação Kerberos do AD. Esta documentação do Samba pode ser útil como referência.

Verifique se o servidor de domínio está acessível e detetável

1. Certifique-se de que os servidores DNS fornecidos contêm os endereços IP do servidor de domínio.

systemd-resolve --status

Global 
          DNSSEC NTA: 10.in-addr.arpa
                      16.172.in-addr.arpa
                      168.192.in-addr.arpa
                      17.172.in-addr.arpa
                      18.172.in-addr.arpa
                      19.172.in-addr.arpa
                      20.172.in-addr.arpa
                      21.172.in-addr.arpa
                      22.172.in-addr.arpa
                      23.172.in-addr.arpa
                      24.172.in-addr.arpa
                      25.172.in-addr.arpa
                      26.172.in-addr.arpa
                      27.172.in-addr.arpa
                      28.172.in-addr.arpa
                      29.172.in-addr.arpa
                      30.172.in-addr.arpa
                      31.172.in-addr.arpa
                      corp
                      d.f.ip6.arpa
                      home
                      internal
                      intranet
                      lan
                      local
                      private
                      test 

Link 2 (eth0) 
      Current Scopes: DNS 
       LLMNR setting: yes 
MulticastDNS setting: no 
      DNSSEC setting: no 
    DNSSEC supported: no 
         DNS Servers: 10.0.2.5 
                      10.0.2.4 
                      10.0.0.41
          DNS Domain: domain1.contoso.com 

2. Se o comando funcionou, ignore as etapas a seguir e prossiga para a próxima seção.

3. Se não funcionou, certifique-se de que os endereços IP do servidor de domínio estão fazendo ping.

ping 10.0.2.5

PING 10.0.2.5 (10.0.2.5) 56(84) bytes of data.
64 bytes from 10.0.2.5: icmp_seq=1 ttl=128 time=0.898 ms
64 bytes from 10.0.2.5: icmp_seq=2 ttl=128 time=0.946 ms

^C 

--- 10.0.2.5 ping statistics --- 
2 packets transmitted, 2 received, 0% packet loss, time 1002ms
rtt min/avg/max/mdev = 0.898/0.922/0.946/0.024 ms

4. Se o ping não funcionar, volte aos pré-requisitos e verifique se sua VM está em uma VNET que tenha acesso ao locatário do Microsoft Entra.

5. Se os endereços IP estiverem executando ping mas os servidores DNS não forem descobertos automaticamente, você poderá adicionar os servidores DNS manualmente. Edite /etc/netplan/50-cloud-init.yaml com o seu editor de texto favorito.

# This file is generated from information provided by the datasource.  Changes
# to it will not persist across an instance reboot.  To disable cloud-init's
# network configuration capabilities, write a file
# /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg with the following:
# network: {config: disabled}
network:
    ethernets:
        eth0:
            dhcp4: true
            dhcp4-overrides:
                route-metric: 100
            dhcp6: false
            match:
                macaddress: 00:22:48:03:6b:c5
            set-name: eth0
            nameservers:
                addresses: [10.0.2.5, 10.0.2.4]
    version: 2

Em seguida, aplique as alterações:

sudo netplan --debug apply 

6. Winbind assume que o servidor DHCP mantém os registros DNS do domínio atualizados. No entanto, isso não é verdade para o DHCP do Azure. Para configurar o cliente para fazer atualizações DDNS, use este guia para criar um script de rede. Aqui está um exemplo de script que vive em /etc/dhcp/dhclient-exit-hooks.d/ddns-update.

#!/bin/sh 

# only execute on the primary nic
if [ "$interface" != "eth0" ]
then
    return
fi 

# When you have a new IP, perform nsupdate
if [ "$reason" = BOUND ] || [ "$reason" = RENEW ] ||
   [ "$reason" = REBIND ] || [ "$reason" = REBOOT ]
then
   host=`hostname -f`
   nsupdatecmds=/var/tmp/nsupdatecmds
     echo "update delete $host a" > $nsupdatecmds
     echo "update add $host 3600 a $new_ip_address" >> $nsupdatecmds
     echo "send" >> $nsupdatecmds

     nsupdate $nsupdatecmds
fi 

Conecte-se aos Serviços de Domínio do Microsoft Entra e verifique se os serviços são detetáveis

1. Certifique-se de que você é capaz de executar ping no servidor de domínio pelo nome de domínio.

ping contosodomain.contoso.com

PING contosodomain.contoso.com (10.0.2.4) 56(84) bytes of data.
64 bytes from pwe-oqarc11l568.internal.cloudapp.net (10.0.2.4): icmp_seq=1 ttl=128 time=1.41 ms
64 bytes from pwe-oqarc11l568.internal.cloudapp.net (10.0.2.4): icmp_seq=2 ttl=128 time=1.02 ms
64 bytes from pwe-oqarc11l568.internal.cloudapp.net (10.0.2.4): icmp_seq=3 ttl=128 time=0.740 ms
64 bytes from pwe-oqarc11l568.internal.cloudapp.net (10.0.2.4): icmp_seq=4 ttl=128 time=0.925 ms 

^C 

--- contosodomain.contoso.com ping statistics ---
4 packets transmitted, 4 received, 0% packet loss, time 3016ms
rtt min/avg/max/mdev = 0.740/1.026/1.419/0.248 ms 

2. Certifique-se de que consegue descobrir os serviços do Microsoft Entra na rede.

nslookup
> set type=SRV
> _ldap._tcp.contosodomain.contoso.com.

Server:         127.0.0.53
Address:        127.0.0.53#53

Non-authoritative answer: 

_ldap._tcp.contosodomain.contoso.com service = 0 100 389 pwe-oqarc11l568.contosodomain.contoso.com.
_ldap._tcp.contosodomain.contoso.com service = 0 100 389 hxt4yo--jb9q529.contosodomain.contoso.com. 

Configurar nome de host e nome de domínio totalmente qualificado (FQDN)

1. Usando seu editor de texto, atualize o arquivo com o FQDN final (depois de ingressar no domínio) e o alias para o /etc/hosts host. O endereço IP não importa por enquanto, porque esta linha será usada principalmente para traduzir nome de host curto para FQDN. Para obter mais detalhes, consulte Configurando o Samba como um membro do domínio.

127.0.0.1       contosovm.contosodomain.contoso.com contosovm
#cmd=sudo vim /etc/hosts   
#then enter this value instead of localhost "ubuntvm.contosodomain.contoso.com UbuntuVM" 

2. Agora, seu nome de host deve resolver. Você pode ignorar o endereço IP que ele resolve por enquanto. O nome de host curto deve ser resolvido para o FQDN.

getent hosts contosovm

127.0.0.1       contosovm.contosodomain.contoso.com contosovm

dnsdomainname

contosodomain.contoso.com

hostname -f

contosovm.contosodomain.contoso.com 

Nota

Algumas distros exigem que você execute o comando para que o hostnamectl nome do host -f seja atualizado:

hostnamectl set-hostname contosovm.contosodomain.contoso.com

Configurar krb5.conf

1. Configure /etc/krb5.conf para que o centro de distribuição de chaves Kerberos (KDC) com o servidor de domínio possa ser contatado para autenticação. Para obter mais informações, consulte a documentação do MIT Kerberos. Aqui está um arquivo de exemplo /etc/krb5.conf .

[libdefaults]
        default_realm = CONTOSODOMAIN.CONTOSO.COM
        dns_lookup_realm = false
        dns_lookup_kdc = true

Configurar o smb.conf

1. Identifique o caminho para o smb.conf.

sudo smbd -b | grep "CONFIGFILE"

   CONFIGFILE: /etc/samba/smb.conf

2. Altere a configuração do SMB para atuar como um membro do domínio. Para obter mais informações, consulte Configurando o samba como um membro do domínio. Aqui está um arquivo de exemplo smb.conf .

Nota

Este exemplo é para os Serviços de Domínio Microsoft Entra, para os quais recomendamos a configuração backend = rid ao configurar o idmap. Os usuários locais do AD DS podem preferir escolher um back-end idmap diferente.

[global]
   workgroup = CONTOSODOMAIN
   security = ADS
   realm = CONTOSODOMAIN.CONTOSO.COM

   winbind refresh tickets = Yes
   vfs objects = acl_xattr
   map acl inherit = Yes
   store dos attributes = Yes

   dedicated keytab file = /etc/krb5.keytab
   kerberos method = secrets and keytab

   winbind use default domain = Yes 

   load printers = No
   printing = bsd
   printcap name = /dev/null
   disable spoolss = Yes

   log file = /var/log/samba/log.%m
   log level = 1

   idmap config * : backend = tdb
   idmap config * : range = 3000-7999

   idmap config CONTOSODOMAIN : backend = rid
   idmap config CONTOSODOMAIN : range = 10000-999999

   template shell = /bin/bash
   template homedir = /home/%U 

3. Força winbind para recarregar o arquivo de configuração alterado.

sudo smbcontrol all reload-config

Associar o domínio

1. Use o comando para associar o net ads join host ao domínio dos Serviços de Domínio Microsoft Entra. Se o comando gerar um erro, consulte Solução de problemas de membros do domínio samba para resolver o problema.

sudo net ads join -U contososmbadmin    # user  - garead

Enter contososmbadmin's password:

Using short domain name -- CONTOSODOMAIN
Joined 'CONTOSOVM' to dns domain 'contosodomain.contoso.com' 

2. Certifique-se de que o registo DNS existe para este anfitrião no servidor de domínio.

nslookup contosovm.contosodomain.contoso.com 10.0.2.5

Server:         10.0.2.5
Address:        10.0.2.5#53

Name:   contosovm.contosodomain.contoso.com
Address: 10.0.0.8

Se os usuários estiverem ativamente fazendo logon em máquinas cliente ou VMs e acessando os compartilhamentos de arquivos do Azure, você precisará configurar nsswitch.conf e configurar o PAM para winbind. Se o acesso for limitado a aplicativos representados por uma conta de usuário ou conta de computador que precisam de autenticação Kerberos para acessar o compartilhamento de arquivos, você pode ignorar essas etapas.

Configurar nsswitch.conf

1. Agora que o host está associado ao domínio, você precisa colocar bibliotecas winbind nos locais a serem procurados ao procurar usuários e grupos. Faça isso atualizando as entradas passwd e group no nsswitch.conf. Use seu editor de texto para editar /etc/nsswitch.conf e adicionar as seguintes entradas:

passwd:         compat systemd winbind
group:          compat systemd winbind

2. Habilite o serviço winbind para iniciar automaticamente na reinicialização.

sudo systemctl enable winbind

Synchronizing state of winbind.service with SysV service script with /lib/systemd/systemd-sysv-install.
Executing: /lib/systemd/systemd-sysv-install enable winbind

3. Em seguida, reinicie o serviço.

sudo systemctl restart winbind
sudo systemctl status winbind

winbind.service - Samba Winbind Daemon
   Loaded: loaded (/lib/systemd/system/winbind.service; enabled; vendor preset: enabled)
   Active: active (running) since Fri 2020-04-24 09:34:31 UTC; 10s ago
     Docs: man:winbindd(8)
           man:samba(7)
           man:smb.conf(5)
 Main PID: 27349 (winbindd)
   Status: "winbindd: ready to serve connections..."
    Tasks: 2 (limit: 4915)
   CGroup: /system.slice/winbind.service
           ├─27349 /usr/sbin/winbindd --foreground --no-process-group
           └─27351 /usr/sbin/winbindd --foreground --no-process-group

Apr 24 09:34:31 contosovm systemd[1]: Starting Samba Winbind Daemon...
Apr 24 09:34:31 contosovm winbindd[27349]: [2020/04/24 09:34:31.724211,  0] ../source3/winbindd/winbindd_cache.c:3170(initialize_winbindd_cache)
Apr 24 09:34:31 contosovm winbindd[27349]:   initialize_winbindd_cache: clearing cache and re-creating with version number 2
Apr 24 09:34:31 contosovm winbindd[27349]: [2020/04/24 09:34:31.725486,  0] ../lib/util/become_daemon.c:124(daemon_ready)
Apr 24 09:34:31 contosovm systemd[1]: Started Samba Winbind Daemon.
Apr 24 09:34:31 contosovm winbindd[27349]:   STATUS=daemon 'winbindd' finished starting up and ready to serve connections 

4. Certifique-se de que os usuários e grupos do domínio são descobertos.

getent passwd contososmbadmin

contososmbadmin:*:12604:10513::/home/contososmbadmin:/bin/bash

getent group 'domain users'

domain users:x:10513: 

Se as opções acima não funcionarem, verifique se o controlador de domínio está acessível usando a ferramenta wbinfo:

wbinfo --ping-dc

Configurar o PAM para winbind

1. Você precisa colocar winbind na pilha de autenticação para que os usuários do domínio sejam autenticados por meio do winbind configurando o PAM (Pluggable Authentication Module) para winbind. O segundo comando garante que o homedir seja criado para um usuário de domínio após o primeiro login neste sistema.

sudo pam-auth-update --enable winbind
sudo pam-auth-update --enable mkhomedir 

2. Verifique se a configuração de autenticação do PAM tem os seguintes argumentos em /etc/pam.d/common-auth:

grep pam_winbind.so /etc/pam.d/common-auth

auth    [success=1 default=ignore]      pam_winbind.so krb5_auth krb5_ccache_type=FILE cached_login try_first_pass 

3. Agora você deve ser capaz de fazer login neste sistema como o usuário do domínio, seja através de ssh, su ou qualquer outro meio de autenticação.

su - contososmbadmin
Password:

Creating directory '/home/contososmbadmin'.
contososmbadmin@contosovm:~$ pwd
/home/contososmbadmin
contososmbadmin@contosovm:~$ id
uid=12604(contososmbadmin) gid=10513(domain users) groups=10513(domain users),10520(group policy creator owners),10572(denied rodc password replication group),11102(dnsadmins),11104(aad dc administrators),11164(group-readwrite),11165(fileshareallaccess),12604(contososmbadmin) 

Verificar configuração

Para verificar se a máquina cliente está associada ao domínio, procure o FQDN do cliente no controlador de domínio e localize a entrada DNS listada para este cliente específico. Em muitos casos, <dnsserver> é o mesmo que o nome de domínio ao qual o cliente está associado.

nslookup <clientname> <dnsserver>

Em seguida, use o klist comando para exibir os tíquetes no cache Kerberos. Deve haver uma entrada começando com que se pareça com krbtgt :

krbtgt/CONTOSODOMAIN.CONTOSO.COM@CONTOSODOMAIN.CONTOSO.COM

Se você não configurou o PAM para winbind, klist talvez não mostre a entrada do tíquete. Neste caso, você pode autenticar manualmente o usuário para obter os ingressos:

wbinfo -K contososmbadmin

Você também pode executar o comando como parte de um script:

wbinfo -K 'contososmbadmin%SUPERSECRETPASSWORD'

Montar a partilha de ficheiros

Depois de habilitar a autenticação Kerberos do AD (ou Microsoft Entra ID) e ingressar no domínio de sua VM Linux, você poderá montar o compartilhamento de arquivos.

Para obter instruções detalhadas de montagem, consulte Montar o compartilhamento de arquivos do Azure sob demanda com montagem.

Use a seguinte opção de montagem adicional com todos os modelos de controle de acesso para habilitar a segurança Kerberos: sec=krb5

Nota

Esse recurso suporta apenas um modelo de controle de acesso imposto pelo servidor usando ACLs NT sem bits de modo. As ferramentas Linux que atualizam ACLs NT são mínimas, portanto, atualize ACLs através do Windows. Atualmente, não há suporte para modelos de controle de acesso imposto pelo cliente () e controle de acesso traduzido pelo cliente (modefromsid,idsfromsidcifsacl).

Outras opções de montagem

Montagem de utilizador único versus montagem multiutilizador

Em um caso de uso de montagem de usuário único, o ponto de montagem é acessado por um único usuário do domínio do AD e não é compartilhado com outros usuários do domínio. Cada acesso ao arquivo acontece no contexto do usuário cujas credenciais krb5 foram usadas para montar o compartilhamento de arquivos. Qualquer usuário no sistema local que acessar o ponto de montagem representará esse usuário.

Em um caso de uso de montagem multiusuário, ainda há um único ponto de montagem, mas vários usuários do AD podem acessar esse mesmo ponto de montagem. Em cenários em que vários usuários no mesmo cliente acessarão o mesmo compartilhamento e o sistema estiver configurado para Kerberos e montado com sec=krb5, considere usar a multiuser opção mount.

Permissões de arquivo

As permissões de arquivo são importantes, especialmente se os clientes Linux e Windows acessarem o compartilhamento de arquivos. Para converter permissões de arquivo em DACLs em arquivos, use uma opção de montagem padrão, como file_mode=,dir_mode=<><>. As permissões de arquivo especificadas como file_mode e dir_mode só são impostas dentro do cliente. O servidor impõe o controle de acesso com base no descritor de segurança do arquivo ou diretório.

Propriedade do ficheiro

A propriedade do arquivo é importante, especialmente se os clientes Linux e Windows acessarem o compartilhamento de arquivos. Escolha uma das seguintes opções de montagem para converter UID/GID de propriedade de arquivo em SID proprietário/grupo na DACL de arquivo:

• Use um padrão como uid=,gid=<><>
• Configurar o mapeamento UID/GID via RFC2307 e Ative Directory (nss_winbind ou nss_sssd)

Coerência do cache de atributos de arquivo

O desempenho é importante, mesmo que os atributos de arquivo nem sempre sejam precisos. O valor padrão para actimeo é 1 (segundo), o que significa que os atributos de arquivo são buscados novamente do servidor se os atributos armazenados em cache tiverem mais de 1 segundo de idade. Aumentar o valor para 60 significa que os atributos são armazenados em cache por pelo menos 1 minuto. Para a maioria dos casos de uso, recomendamos o uso de um valor de 30 para esta opção (actimeo=30).

Para kernels mais recentes, considere definir os recursos do actimeo de forma mais granular. Você pode usar acdirmax para cache de revalidação de entrada de diretório e acregmax para armazenar metadados de arquivo em cache, por exemplo, acdirmax=60,acregmax=5.

Próximos passos

Para obter mais informações sobre como montar um compartilhamento de arquivos SMB no Linux, consulte:

• Montar partilha de ficheiros do Azure SMB no Linux