Beginning with release 3.0, Aspire uses an external MongoDB instance for connectors built with the new NoSQL Connector Framework. The database is used to keep crawl metadata and allow processing and scanning to be distributed. All MongoDB configuration is done in the settings.xml file.
<!-- noSql database provider for the 3.2 connector framework --> <noSQLConnectionProvider sslEnabled="false" sslInvalidHostNameAllowed="false"> <implementation>com.searchtechnologies.aspire:aspire-mongodb-provider</implementation> <servers>mongodb-host:27017</servers> </noSQLConnecitonProvider>
<!-- noSql database provider for the 3.2 connector framework --> <noSQLConnectionProvider sslEnabled="false" sslInvalidHostNameAllowed="false"> <namespace>myNamespace</namespace> <implementation>com.searchtechnologies.aspire:aspire-mongodb-provider</implementation> <servers>mongodb-host:27017</servers> </noSQLConnecitonProvider>
To connect to a multi-node MongoDB installation, you just need to provide a comma-separated list of hostname:port of the MongoDB nodes in the cluster.
Example:
<!-- noSql database provider for the 3.2 connector framework --> <noSQLConnectionProvider sslEnabled="false" sslInvalidHostNameAllowed="false"> <implementation>com.searchtechnologies.aspire:aspire-mongodb-provider</implementation> <servers>mongodb-host1:27017,mongodb-host2:27017,mongodb-host3:27017,mongodb-host4:27017</servers> </noSQLConnecitonProvider>
If you need to connect to a MongoDB configured to Use TLS/SSL you need to set the following attributes into the noSQLConnectionProvider tag:
Attribute | Value | Description |
---|---|---|
sslEnabled | true | Enables the ssl on the Aspire MongoDB client |
sslInvalidHostNameAllowed | true/false | Disables the hostname verification from the SSL validation |
For using TLS/SSL you need to make sure the Certificate Authority (CA) that signed the server certificate that MongoDB is using (server.pem) is a trusted certificate, or that its trust chain can lead to one. If you are using a self signed Certificate Authority to sign your server certificate, you need to add it into the java truststore.
To use a java truststore that you need the Certificate Authority certificate (.cert) and import it using the following command
$ keytool -import -trustcacerts -alias slc -file <your-CA-certificate.cert> -keystore truststore.jks -storepass <your-truststore-password> -noprompt
After importing it into a truststore you need to add it into the Aspire startup script, read Crawling via HTTPs for more instructions on how to add the truststore into the startup script.
Aspire 3.2.1 supports authenticating to MongoDB using X.509 or SCRAM. Based on the requirement will be necessary modify the settings.xml file.
Aspire 3.2.1 supports authenticating to MongoDB using SCRAM.
The Salted Challenge Response Authentication Mechanism (SCRAM) is a family of modern, password-based challenge–response authentication mechanisms providing authentication of a user to a server
To configure it, add the following to your settings.xml file:
<!-- noSql database provider for the 3.0 connector framework --> <noSQLConnectionProvider sslEnabled="true" sslInvalidHostNameAllowed="false"> <implementation>com.searchtechnologies.aspire:aspire-mongodb-provider</implementation> <servers>mongodb-host:27017</servers> <authentication> <scram> <username>aspireUser</username> <source>admin</source> <password>encrypted:302B58140B6ED1FBEBDC33A9263EF742</password> </scram> </authentication> </noSQLConnecitonProvider>
MongoDB provider will verify the supplied user credentials against:
For the correct Aspire behavior check that the user selected to authenticated have the roles:
How to check the roles of a user, using mongo.exe:
> use admin > db.getUser("aspireAdmin"); { "_id_": "admin.myUserAdmin", "user": "myUserAdmin", "db": "admin", "roles": [ { "role": "clusterAdmin", "db"": "admin" }, { "role": "readWriteAnyDatabase", "db": "admin" } ] } >
> use admin > db.createUser( { user: "myUserAdmin", pwd: "abc123", roles: [ { role: "clusterAdmin", db: "admin" }, { role: "readWriteAnyDatabase", db: "admin" } ] } )
4. Re-start the MongoDB
Configuration Example
systemLog: destination: file path: "/var/log/mongodb/mongod.log" logAppend: true storage:
Aspire 3.2 only supports authenticating to MongoDB using X.509.
The X.509 mechanism authenticates a user whose name is derived from the distinguished subject name of the X.509 certificate presented by the driver during SSL negotiation. This authentication method requires the use of SSL connections with certificate validation.
To configure it, add the following to your settings.xml file:
<!-- noSql database provider for the 3.2 connector framework --> <noSQLConnectionProvider sslEnabled="true" sslInvalidHostNameAllowed="false"> <implementation>com.searchtechnologies.aspire:aspire-mongodb-provider</implementation> <servers>mongodb-host:27017</servers> <x509username>CN=user,OU=OrgUnit,O=myOrg</x509username> </noSQLConnecitonProvider>
If you don't know what to use into the <x509username> field execute the following command using the x509 client certificate:
$ openssl x509 -in client.pem -inform PEM -subject -nameopt RFC2253 | grep subject subject= CN=aaguilar-lptp.search.local,OU=demouser,O=Search Technologies S.A.,ST=Limon,C=CR
For using x509 authentication you need to import the client x509 certificate into a java keystore for Aspire to be able to present it to the server for authentication. (The truststore should already be set in the startup script for self signed certificates)
For importing the x509 certificate (client.pem) into a java keystore you need to execute the following commands:
$ openssl pkcs12 -export -out client.pkcs12 -in client.pem Enter Export Password: <your-password-here> $ keytool -importkeystore -srckeystore client.pkcs12 -srcstoretype PKCS12 -destkeystore client.jks -deststoretype JKS Enter destination keystore password: Re-enter new password: <your-password-here> Enter source keystore password: <your-password-here> Entry for alias 1 successfully imported. Import command completed: 1 entries successfully imported, 0 entries failed or cancelled
After importing the client's certificate into a java keystore, you need to include it into the Aspire startup script (aspire.bat) :
-Djavax.net.ssl.keyStore=C:\pathToKeyStore\client.jks -Djavax.net.ssl.keyStorePassword=password
If you want to be extra safe and encrypt the URLs, IDs, or any other metadata stored in MongoDB, you can do by specifying the name of the fields to encrypt:
<!-- noSql database provider for the 3.2 connector framework --> <noSQLConnectionProvider sslEnabled="false" sslInvalidHostNameAllowed="false"> <implementation>com.searchtechnologies.aspire:aspire-mongodb-provider</implementation> <servers>mongodb-host:27017</servers> <encryptFields> <field>_id</field> <!-- Encrypts all the IDs --> <field>url</field> <!-- Encrypts the url fields --> <field>fetchUrl</field> <field>parentId</field> </encryptFields> </noSQLConnecitonProvider>