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 por meio de um DSN ou diretamente do driver, você não precisará 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-1SCRAM-SHA-256PLAIN(LDAP)GSSAPI(Kerberos)
Observação
Os mecanismos
SCRAM-SHA-1eSCRAM-SHA-256hash 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
PLAINenvia 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 do 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 driver
connector MySQL/ODBC
shell do MySQL
shell do MySQL
Observação
Instale a versão (64 bits ou 32 bits) do componente MySQL apropriada para seu sistema operacional.
Baixe o
mongosql_authinstalador .msi do componente de plugin-in e instale omongosql_authcomponente de plugin-in. O plugin é instalado em um dos seguintes diretórios, dependendo da sua versão do Windows:PlataformaLocalização padrãoWindows 32-bits
C:\Program Files (x86)\MySQL\MySQL Server 5.7\lib\pluginWindows 64-bits
C:\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 instalador MySQL 5.7.x e instale o MySQL Community Server, que inclui o shell MySQL.
Baixe a biblioteca de plugin
mongosql_authna página de versões.Após baixar, mova o arquivo
mongosql_auth.sopara:<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 instalador MySQL 5.7.x e instale o MySQL Community Server, que inclui o shell MySQL.
Baixe a biblioteca de plugin
mongosql_authna página de versões.Após baixar, mova o arquivo
mongosql_auth.sopara:<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-authpara 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.