
Biblioteca crypt estendida para descrypt, md5crypt, bcrypt e outros
libxcrypt é uma biblioteca moderna para hash unidirecional de senhas. Ela
suporta uma ampla variedade de métodos de hash modernos e históricos:
yescrypt, gost-yescrypt, sm3-yescrypt, scrypt, bcrypt, sha512crypt,
sha256crypt, sm3crypt, md5crypt, SunMD5, sha1crypt, NT, bsdicrypt,
bigcrypt e descrypt.
Ela fornece as interfaces tradicionais Unix crypt e crypt_r, bem
como um conjunto de interfaces estendidas pioneiras do Openwall Linux,
crypt_rn, crypt_ra, crypt_gensalt, crypt_gensalt_rn e
crypt_gensalt_ra.
libxcrypt destina-se a ser usada por login(1), passwd(1) e outros
programas semelhantes; ou seja, para gerar hash de um pequeno número de senhas durante
um diálogo de autenticação interativo com um humano. Ela não é
adequada para uso em aplicações de quebra de senhas em massa, ou em qualquer
outra situação em que a velocidade seja mais importante do que o tratamento cuidadoso de
dados sensíveis. No entanto, ela é destinada a ser rápida e leve
o suficiente para uso em servidores que precisam lidar com milhares de tentativas de login
por minuto.
libxcrypt é atualmente mantida por Björn Esser e Zack Weinberg. Muitas pessoas contribuíram para o código que compõe a libxcrypt, frequentemente sob a égide de um projeto diferente. Consulte os arquivos AUTHORS e THANKS para um conjunto completo de créditos.
libxcrypt como um todo é licenciada sob a GNU Lesser General Public License (versão 2.1, ou, a seu critério, qualquer versão posterior). No entanto, muitos arquivos individuais podem ser reutilizados sob licenças mais permissivas se separados da biblioteca. Consulte o arquivo LICENSING para um inventário abrangente de licenças, e COPYING.LIB para os termos da LGPL.
libxcrypt é atualmente mantida no Github: a URL do repositório canônico é https://github.com/besser82/libxcrypt. Por favor, registre relatos de bugs em https://github.com/besser82/libxcrypt/issues. Este também é o local apropriado para sugerir novos recursos, oferecer patches, etc. Todo o seu feedback é bem-vindo e eventualmente receberá uma resposta, mas este é um projeto de tempo livre para todos os atuais mantenedores, então por favor seja paciente.
Para compilar a partir de um lançamento em tarball, as ferramentas necessárias são o ambiente
de shell Unix padrão, um compilador C e Perl (versão 5.14 ou
posterior). Siga as instruções genéricas de compilação e instalação no
arquivo INSTALL. Existem várias opções de configuração específicas de pacote;
execute ./configure --help para mais detalhes sobre essas opções.
Execute man -l crypt.5 para mais detalhes sobre os algoritmos de hash que
podem ser habilitados ou desabilitados por --enable-hashes. Você pode fazer ambas as
coisas antes de compilar o software.
A compilação a partir de um checkout do Git requer adicionalmente o conjunto Autotools: autoconf, automake, libtool e pkg-config. Execute ./autogen.sh no nível superior da árvore de código-fonte e, em seguida, siga as instruções em INSTALL (que é criado por esse comando).
As versões mais antigas dos componentes do Autotools que se sabe funcionarem são: autoconf 2.69, automake 1.14, libtool 2.4.6, pkg-config 0.29. Se você testar com uma versão mais antiga de um destes e descobrir que funciona, por favor nos avise. Não estamos exigindo deliberadamente versões mais recentes; simplesmente não conseguimos testar convenientemente versões mais antigas por conta própria.
O libxcrypt deve ser compilável com qualquer compilador C compatível com ISO C1999, com uma exceção crítica: as macros de versionamento de símbolos em crypt-port.h só funcionam com compiladores que implementam certas extensões do GCC e do GNU Binutils (__attribute__((alias)), asm no estilo GCC e .symver).
Alguns recursos do C2011 são utilizados; a intenção não é usar nenhum deles sem um fallback, mas atualmente não testamos isso. Algumas APIs Unix POSIX e não padronizadas, porém amplamente difundidas, também são utilizadas; novamente, a intenção não é usar nenhuma delas sem um fallback, mas atualmente não testamos isso. Em particular, as funções crypt_gensalt podem nem sempre conseguir obter números aleatórios criptograficamente seguros do sistema operacional; se você chamar essas funções com um ponteiro nulo para o argumento "rbytes", esteja preparado para que elas falhem.
A partir de meados de 2018, o GCC e o LLVM não suportam otimização em tempo de link de bibliotecas que usam versionamento de símbolos. Se você compilar o libxcrypt com qualquer um desses compiladores, não use -flto. Consulte o bug 48200 do GCC para detalhes; o problema é muito semelhante para o LLVM. Como isso é, em sua raiz, um conjunto de recursos ausentes no compilador, esperamos que a otimização em tempo de link também não funcione em outros compiladores C, mas não testamos isso por conta própria.
Em sistemas baseados em Linux, por padrão o libxcrypt será compatível binariamente de forma retroativa com o libcrypt.so.1 fornecido como parte da GNU C Library. Isso significa que todos os executáveis binários existentes vinculados ao libcrypt da glibc devem funcionar sem modificação com o libcrypt.so.1 desta biblioteca. Nos esforçamos para fornecer exatamente as mesmas versões de símbolos que eram usadas pela glibc em várias arquiteturas de CPU, e para considerar a variedade de maneiras pelas quais as extensões Openwall foram aplicadas ao libcrypt da glibc por algumas distribuições Linux. (Por exemplo, são fornecidos links simbólicos de compatibilidade para o "libowcrypt" do SUSE.)
No entanto, o inverso não é verdadeiro: programas vinculados ao libxcrypt não funcionarão com o libcrypt da glibc. Além disso, programas que usam certas APIs legadas fornecidas pelo libcrypt da glibc (encrypt, encrypt_r, setkey, setkey_r e fcrypt) não podem ser compilados com o libxcrypt.