Advertencia
Descargo de responsabilidad
Esta página se proporciona solo con fines de prueba y los certificados son solo para fines de prueba.
El siguiente tutorial proporciona algunos pasos básicos para crear certificados de prueba X.509.
No uses estos certificados para producción. En su lugar, siga sus políticas de seguridad.
Para obtener información sobre OpenSSL, consulte la oficial OpenSSL Docs. Aunque este tutorial utiliza OpenSSL, el material no debe considerarse como una referencia autorizada sobre OpenSSL.
Requisito previo
El procedimiento descrito en esta página usa el certificado de autoridad intermedia de prueba y las claves mongodb-test-ia.crt y mongodb-test-ia.key creadas en Apéndice A - Certificado CA de OpenSSL para pruebas.
Procedimiento
El siguiente procedimiento describe los pasos para crear certificados de prueba para clientes de MongoDB. Para obtener los pasos para crear certificados de prueba para los servidores de MongoDB, consulta Apéndice B - Certificados de servidor de OpenSSL para pruebas.
A. Crea el archivo de configuración de OpenSSL
Crea un archivo de configuración de prueba
openssl-test-client.cnfpara tu cliente con el siguiente contenido:# NOT FOR PRODUCTION USE. OpenSSL configuration file for testing. [ req ]default_bits = 4096default_keyfile = myTestClientCertificateKey.pem ## The default private key file name.default_md = sha256distinguished_name = req_dnreq_extensions = v3_req [ v3_req ]subjectKeyIdentifier = hashbasicConstraints = CA:FALSEkeyUsage = critical, digitalSignature, keyEnciphermentnsComment = "OpenSSL Generated Certificate for TESTING only. NOT FOR PRODUCTION USE."extendedKeyUsage = serverAuth, clientAuthsubjectAltName = @alt_names [ alt_names ]DNS.1 = testclient.example.com ## Replace with the valid DNS name for the clientDNS.2 = localhost ## Optional additional valuesIP.1 = 192.168.1.10 ## Replace with the client IP address [ req_dn ]countryName = Country Name (2 letter code)countryName_default =countryName_min = 2countryName_max = 2 stateOrProvinceName = State or Province Name (full name)stateOrProvinceName_default = TestClientCertificateStatestateOrProvinceName_max = 64 localityName = Locality Name (eg, city)localityName_default = TestClientCertificateLocalitylocalityName_max = 64 organizationName = Organization Name (eg, company)organizationName_default = TestClientCertificateOrgorganizationName_max = 64 organizationalUnitName = Organizational Unit Name (eg, section)organizationalUnitName_default = TestClientCertificateOrgUnitorganizationalUnitName_max = 64commonName = Common Name (eg, YOUR name)commonName_max = 64Nota
El Nombre Alternativo del Sujeto (SAN) es el estándar moderno preferido para definir nombres de host válidos, direcciones IP y otros sujetos del certificado. Aunque se especifica un valor de Nombre Común (CN), CN es secundario a SAN en los estándares modernos de TLS. El servidor de MongoDB solo utiliza el CN para la coincidencia de nombres de host si el SAN se omite por completo.
opcional. Puedes actualizar los valores por defecto del nombre distinguido (DN).
Importante
Asegúrate de que los certificados de cliente difieran de los certificados de servidor con respecto a al menos uno de los siguientes atributos: organización (
O), la unidad organizativa (OU) o el componente de dominio (DC).
B. Genera el archivo PEM de test para el cliente
Crea el archivo de clave test
mongodb-test-client.key.openssl genrsa -out mongodb-test-client.key 4096Cree la prueba solicitud de firma de certificado
mongodb-test-client.csr. Cuando se le soliciten valores de Nombre Distinguido, ingrese los valores apropiados para su certificado de prueba:Importante
El sujeto del certificado del cliente debe diferenciarse del sujeto del certificado del servidor en al menos uno de los siguientes atributos: Organización (O), Unidad Organizativa (OU) o Componente de Dominio (DC).
openssl req -new -key mongodb-test-client.key -out mongodb-test-client.csr -config openssl-test-client.cnfCree el test certificado de cliente
mongodb-test-client.crt.openssl x509 -sha256 -req -days 365 -in mongodb-test-client.csr -CA mongodb-test-ia.crt -CAkey mongodb-test-ia.key -CAcreateserial -out mongodb-test-client.crt -extfile openssl-test-client.cnf -extensions v3_reqCree el archivo PEM de prueba para el cliente.
cat mongodb-test-client.crt mongodb-test-client.key > test-client.pemPuede usar el archivo PEM de prueba para configurar
mongoshpara TLS/SSL pruebas. Por ejemplo, para conectarse a unmongodo a unmongos:Ejemplo
Incluya las siguientes opciones para el cliente:
mongosh --tls --host <serverHost> --tlsCertificateKeyFile test-client.pem --tlsCAFile test-ca.pem- En macOS,
Si estás probando con el Llavero de sistema para gestionar certificados, crea un archivo PKCS 12 para añadir al Llavero de sistema en lugar de un archivo PEM:
openssl pkcs12 -export -out test-client.pfx -inkey mongodb-test-client.key -in mongodb-test-client.crt -certfile mongodb-test-ia.crtUna vez agregado a Acceso a llaveros, en lugar de especificar el archivo de clave del certificado, puede usar el
--tlsCertificateSelectorpara especificar el certificado que se va a usar. Si el archivo CA también se encuentra en Acceso a Llaveros, puede omitir--tlsCAFile, como en el siguiente ejemplo:mongosh --tls --tlsCertificateSelector subject="<TestClientCertificateCommonName>"Para añadir certificados al Acceso a Llaveros, consulta la documentación oficial sobre Acceso a Llaveros.