El servidor de MongoDB admite la escucha de conexiones cifradas y no cifradas TLS/SSL en el mismo puerto TCP. Esto permite las actualizaciones de los clústeres de MongoDB para usar conexiones cifradas TLS/SSL.
Nota
MongoDB deshabilita el soporte para el cifrado TLS 1.0 y TLS 1.1 en sistemas donde TLS 1.2+ está disponible.
Procedimiento (usando tls configuraciones)
Importante
Una descripción completa de los certificados TLS/SSL, PKI (Infraestructura de Llave Pública) y la Autoridad de Certificación está fuera del alcance de este documento. Esta página asume conocimientos previos de TLS/SSL, así como el acceso a certificados válidos.
Para actualizar de un clúster de MongoDB que no utiliza cifrado TLS/SSL a uno que utiliza solo cifrado TLS/SSL, utiliza el siguiente proceso de actualización continua.
Nota
Los procedimientos en esta sección usan la configuración/opción tls. Para procedimientos que utilizan sus alias ssl, consulta Procedimiento (usando la configuración ssl).
Los ajustes/opciones de tls proporcionan una funcionalidad idéntica a las opciones de ssl ya que MongoDB siempre ha admitido TLS 1.0 y posteriores.
Para cada nodo de un clúster, inicie el nodo con la opción de línea de comandos
--tlsModeo la opción de archivo de configuraciónnet.tls.modeestablecida enallowTLS. La configuraciónallowTLSpermite que el nodo acepte tanto conexiones entrantes TLS/SSL como no TLS/no SSL. Sus conexiones a otros servidores no emplean TLS/SSL. Incluya otras opciones de TLS/SSL [1] así como cualquier otra opción necesaria para su configuración específica.Nota
mongodymongosse enlazan a localhost por defecto. Si los miembros de la implementación se ejecutan en hosts diferentes o si se desea que clientes remotos se conecten a la implementación, se debe especificar--bind_iponet.bindIp.Por ejemplo:
mongod --replSet <name> --tlsMode allowTLS --tlsCertificateKeyFile <TLS/SSL certificate and key file> --tlsCAFile <path to root CA PEM file> <additional options>Para especificar estas opciones en el archivo de configuración, incluye la siguiente configuración en el archivo:
net: tls: mode: allowTLS certificateKeyFile: <path to TLS/SSL certificate and key PEM file> CAFile: <path to root CA PEM file>Actualice todos los nodos del clúster a estas configuraciones.
Cambie todos los clientes para que usen TLS/SSL. Consulte Conectarse a un set de réplicas habilitado para TLS.
Para cada nodo de un clúster, utilizar el comando
setParameterpara actualizartlsModeapreferTLS. [2] ConpreferTLScomo sunet.tls.mode, el nodo acepta conexiones entrantes TLS/SSL y no TLS/SSL, y sus conexiones a otros servidores utilizan TLS/SSL. Por ejemplo:db.adminCommand( { setParameter: 1, tlsMode: "preferTLS" } )Actualice todos los nodos del clúster a estas configuraciones.
En este punto, todas las conexiones deben estar utilizando TLS/SSL.
Para cada nodo del clúster, utilizar el comando
setParameterpara actualizartlsModearequireTLS. [2] ConrequireTLScomo sunet.tls.mode, el nodo rechazará cualquier conexión que no sea TLS/SSL. Por ejemplo:db.adminCommand( { setParameter: 1, tlsMode: "requireTLS" } )Después de la actualización de todos los nodos, editar el archivo de configuración con las configuraciones TLS/SSL apropiadas para garantizar que, tras reinicios posteriores, el clúster utilice TLS/SSL.
Procedimiento (usando ssl configuraciones)
Importante
Una descripción completa de los certificados TLS/SSL, PKI (Infraestructura de Llave Pública) y la Autoridad de Certificación está fuera del alcance de este documento. Esta página asume conocimientos previos de TLS/SSL, así como el acceso a certificados válidos.
Para actualizar de un clúster de MongoDB que no utiliza cifrado TLS/SSL a uno que utiliza solo cifrado TLS/SSL, utiliza el siguiente proceso de actualización continua.
Nota
Los procedimientos de esta sección utilizan la configuración/opción ssl. Para los procedimientos que utilizan sus alias tls, consulte Actualizar un clúster para usar TLS/SSL.
Los ajustes/opciones de tls proporcionan una funcionalidad idéntica a las opciones de ssl ya que MongoDB siempre ha admitido TLS 1.0 y posteriores.
Para cada nodo de un clúster, inicie el nodo con la opción de línea de comandos
--sslModeo la opción de archivo de configuraciónnet.ssl.modeestablecida enallowSSL. La configuraciónallowSSLpermite que el nodo acepte conexiones entrantes tanto TLS/SSL como no TLS/no SSL. Sus conexiones a otros servidores no emplean TLS/SSL. Incluya otras opciones de TLS/SSL [1], así como cualquier otra opción necesaria para su configuración específica.Nota
mongodymongosse enlazan a localhost por defecto. Si los miembros de la implementación se ejecutan en hosts diferentes o si se desea que clientes remotos se conecten a la implementación, se debe especificar--bind_iponet.bindIp.Por ejemplo:
mongod --replSet <name> --sslMode allowSSL --sslPEMKeyFile <path to TLS/SSL Certificate and key PEM file> --sslCAFile <path to root CA PEM file> <additional options>Para especificar estas opciones en el archivo de configuración, incluye la siguiente configuración en el archivo:
net: ssl: mode: <allowSSL> PEMKeyFile: <path to TLS/SSL certificate and key PEM file> CAFile: <path to root CA PEM file>Actualice todos los nodos del clúster a estas configuraciones.
Cambie todos los clientes para que usen TLS/SSL. Consulte Conectarse a un set de réplicas habilitado para TLS.
Para cada nodo de un clúster, utilizar el comando
setParameterpara actualizarsslModeapreferSSL. [2] ConpreferSSLcomonet.ssl.mode, el nodo acepta conexiones entrantes TLS/SSL y no TLS/SSL, y sus conexiones a otros servidores utilizan TLS/SSL. Por ejemplo:db.adminCommand( { setParameter: 1, sslMode: "preferSSL" } )Actualice todos los nodos del clúster a estas configuraciones.
En este punto, todas las conexiones deben estar utilizando TLS/SSL.
Para cada nodo del clúster, utilizar el comando
setParameterpara actualizarsslModearequireSSL. [2] ConrequireSSLcomo sunet.ssl.mode, el nodo rechaza cualquier conexión que no sea TLS/SSL. Por ejemplo:db.adminCommand( { setParameter: 1, sslMode: "requireSSL" } )Después de la actualización de todos los nodos, editar el archivo de configuración con las configuraciones TLS/SSL apropiadas para garantizar que, tras reinicios posteriores, el clúster utilice TLS/SSL.
| [2] | (1, 2, 3, 4) Como alternativa al uso del comando setParameter, también puede reiniciar los nodos con las opciones y los valores TLS/SSL adecuados. |
| [1] | (1, 2) Se pueden usar los almacenes de certificados SSL del sistema para Windows y macOS. Para utilizar el almacén de certificados SSL del sistema, se debe usar:
Al utilizar el almacén de certificados SSL del sistema, se emplea OCSP (Protocolo de estado de certificados en línea) para validar el estado de revocación de los certificados. |