Cloud: Security

RavenDB cloud products use several layers of security.

Using The Initial Client Certificate

A client certificate is automatically generated during the creation of your RavenDB cloud product.
You will need to import this certificate to your browser in order to access your cloud instances.

Download Certificate

Go to the Products tab in the cloud portal and click the Download Certificate button.

"Download Certificate"

Install the certificate

Extract the certificate package, open the extracted files' folder, and double-click the .pfx file that requires no password.
When the certificate import wizard is launched, click "Next" all the way through the wizard.

"Certificate Import Wizard"

Access your product

To access your product your IP address must be added to the Allowed IPs list. Allowed IPs entries are CIDR ranges that define networks from which the connection is allowed.

  • You can set Allowed IPs to, which would allow access from any location, or you can specify certain IPs or IP ranges.
  • Be aware that you will not be able to access your instance from locations that are not specified in the allowed IPs list.
  • You can edit the list at any time through the Portal.
  • Regardless of the allowed IPs setting, your RavenDB Cloud instances will always require authentication using X.509 certificates for access. The allowed IPs list serves as an additional layer of security, but isn't the only one.

Azure products do not permit overlapping of addresses in the Allowed IPs list.
If addresses in your list overlap, an error is going to be displayed upon product creation. E.g. -

- Listing both and is **not permitted**.
- Listing and any other address is **not permitted**.
- Listing both and **is permitted**.  

Cross-instance communication inside the cluster is not subject to these restrictions.

If you're using Chrome on Windows, you will now be able to access your RavenDB cloud instance. You may need to restart your browser.
In other cases (e.g. if you're using Firefox) you will have to import the certificate to your browser manually.

"Server URLs"

Once the certificate is imported, click your cloud instance's URL.
Your browser will prompt you to select a certificate. When you select the client certificate, your product's management studio will launch.

Using Additional Certificates

Your initial operator-level certificate allows you to perform operations like creating and deleting databases, managing access to the cluster, and inspecting the cluster's state.
Operations like adding and removing cluster nodes are left for your products administrators.

We recommend that you generate and use different certificates for your client applications, for maximum security.

If your instance runs on a burstable CPU, especially if it is a low-end one, RavenDB may take a while to generate certificates and spend a lot of your CPU credits in the process.
We therefore recommend that you generate your certificates off-cloud and import them to your cloud instance.

To generate additional operator or user certificates:

  • Go to the server management studio, and click the Manage Certificates button.
    "Manage Certificates"
  • Click Generate client certificate
    "Generate Client Certificate"

Enable MFA

Multi-Factor Authentication (MFA) enhances account security by requiring multiple forms of verification. MFA significantly reduces the risk of unauthorized access, even if email account credentials are compromised.

Components of Multi-Factor Authentication:

  • Authenticator Application: This involves using a mobile app to generate one-time codes for login verification. These codes are time-sensitive and provide an additional layer of security beyond passwords.
  • Recovery Codes: Recovery codes are pre-generated, single-use codes that users can use to access their accounts if they lose access to their primary authentication methods. It's crucial to store these codes securely in case they are needed for account recovery.
  • Recovery Phone Number: Adding a recovery phone number provides an additional method for account recovery. In case of access issues. Support request needs to be made in order to use this method.

By utilizing these components of MFA, users can significantly enhance the security of their accounts and mitigate the risk of unauthorized access.

To enable Multi-Factor Authentication either visit the enable-authenticator page or open your RavenDB Cloud Profile page and click the Add authenticator app button. "Add authenticator app"

This will take you to the configuration page.

"Configure authenticator app"

Configure authenticator app

  • Scan the provided QR code or enter the provided text code into an authentication app of your choice.
  • Type in the 2FA code generated by your authentication app.
  • Type in a recovery phone number.

After verifying, you will be provided with recovery codes. Save them in a secure place.

MFA is now enabled on your account.