Plugin de autenticação C
O plugin -in de autenticação do MongoDB está incorporado no MongoDB BI Connector ODBC Driver. Se a sua ferramenta de BI se conectar usando o MongoDB BI Connector ODBC Driver através de um DSN ou do driver diretamente, você não precisa instalar o plugin -in de autenticação separadamente. Instale o plugin -in de autenticação autônomo se sua ferramenta BI não usar um driver ODBC e aceitar plug-ins de autenticação, como o shell MySQL.
O plugin mongosql_auth
permite que um cliente se autentique com um BI Connector e uma implantação do MongoDB em execução com a autenticação habilitada usando um dos seguintes mecanismo de autenticação:
SCRAM-SHA-1
SCRAM-SHA-256
PLAIN
(LDAP)GSSAPI
(Kerberos)
Observação
Os mecanismos
SCRAM-SHA-1
eSCRAM-SHA-256
hash das senhas no plugin do cliente; no entanto, todos os outros dados estão em texto não criptografado. Se possível, use com conexões criptografadas.O mecanismo
PLAIN
envia a senha em texto não criptografado. Use conexões criptografadas com o mecanismoPLAIN
.
Plataformas suportadas
O plugin é criado e testado nas seguintes plataformas:
Windows 2008 R2 (32 e 64 bits)
macOS 10.12 (64 bits)
Ubuntu 14.04 (64 bits)
RHEL 7.0 (64 bits)
Importante
Ambiente de teste
O plugin C Authentication foi desenvolvido em relação ao MySQL 5.7.X Community Edition (64-bit) e testado com o MySQL 5.7.X Community Edition e a versão mais recente do MongoDB Connector for BI. O plugin não é compatível com MySQL Server ou Connector/ODBC driver versão 8 e posterior.
Instalando o plug-in
Baixe o instalador MySQL 5.7.x. O produto necessário a ser instalado depende do seu método de conexão:
Método de conexãoComponente MySQL necessárioDSN (conjunto de dados Name) usando o connector MySQL/ODBC driverconnector MySQL/ODBCshell do MySQLshell do MySQLObservação
Instale a versão (64 bits ou 32 bits) do componente MySQL apropriada para seu sistema operacional.
Baixe o
mongosql_auth
instalador .msi do componente de plug-in e instale omongosql_auth
componente de plug-in . O plugin é instalado em um dos seguintes diretórios, dependendo da sua versão do Windows:PlataformaLocalização padrãoWindows 32-bitsC:\Program Files (x86)\MySQL\MySQL Server 5.7\lib\plugin
Windows 64-bitsC:\Program Files\MySQL\MySQL Server 5.7\lib\plugin
Observação
Usuários do macOS Catalina:
O plugin -in de autenticação C usa OpenSSL v1.0. Se você tiver o OpenSSL v1.1 ou superior instalado, deverá fazer o downgrade para o v1.0 para usar o plugin -in de autenticação C. Você pode fazer isso com o seguinte comando:
brew install https://raw.githubusercontent.com/Homebrew/homebrew-core/30fd2b68feb458656c2da2b91e577960b11c42f4/Formula/openssl.rb
Se você tiver as duas versões 1.0 e 1.1 do OpenSSL instaladas, crie um link simbólico para a versão 1.0 a partir do /usr/local/opt/openssl
e remova o link simbólico para v1.1.
Baixe o MySQL 5.7 instalador .x e instale o MySQL servidor MongoDB da comunidade , que inclui o MySQL shell.
Baixar
mongosql_auth
a biblioteca de plugin -ins da página de versões.Após baixar, mova o arquivo
mongosql_auth.so
para:<mysql-home>/lib/plugin/
diretório.A localização padrão do
<mysql-home>
varia de acordo com a plataforma.Para descobrir a localização do diretório de plugin -ins, execute o seguinte na linha de comando:
mysql_config --plugindir
- OU -
Um diretório de sua escolha se você fornecer a opção
plugin-dir=<your-install-dir>
para seu cliente MySQL .
Baixe o MySQL 5.7 instalador .x e instale o MySQL servidor MongoDB da comunidade , que inclui o MySQL shell.
Baixar
mongosql_auth
a biblioteca de plugin -ins da página de versões.Após baixar, mova o arquivo
mongosql_auth.so
para:<mysql-home>/lib/plugin/
diretório.A localização padrão do
<mysql-home>
varia de acordo com a plataforma.Para descobrir a localização do diretório de plugin -ins, execute o seguinte na linha de comando:
mysql_config --plugindir
- OU -
Um diretório de sua escolha se você fornecer a opção
plugin-dir=<your-install-dir>
para seu cliente MySQL .
Usando o Plugin para Autenticação
Antes de usar o plugin de autenticação, você deve configurar usuários autenticados para o MongoDB. Para obter mais informações sobre a criação de usuários autenticados, consulte Habilitar autenticação. Se você estiver usando o BI Connector hospedado no Atlas, consulte Configurar usuários do banco de dados.
O procedimento para usar a biblioteca de plug-ins de autenticação C varia dependendo do seu cliente SQL. O plug-in C Authentication pode ser usado por um dos seguintes métodos:
DSN (conjunto de dados) utilizando o driver MySQL connector/ODBC. Para obter mais informações, consulte Criar um DSN do Sistema.
A opção
--default-auth
para o MySQL Shell. Para obter mais informações, consulte Conectar do cliente MySQL.
Esse plugin é compatível com as versões de 32 ou 64 bits do shell do MySQL e do driver MySQL connector/ODBC. O diretório de instalação difere dependendo da versão que você instala.