Skip to content

Commit 26f1e18

Browse files
committed
RDoc-3504 Cloud -> Security - add a note about automatic rotation of the expiring portal-generated certficates
1 parent cf3135b commit 26f1e18

File tree

1 file changed

+28
-31
lines changed

1 file changed

+28
-31
lines changed

cloud/cloud-security.mdx

Lines changed: 28 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -15,31 +15,28 @@ import LanguageContent from "@site/src/components/LanguageContent";
1515
# Cloud: Security
1616
<Admonition type="note" title="">
1717

18-
RavenDB cloud products use several layers of security.
18+
*RavenDB Cloud* products use several layers of security. All instances are encrypted using *HTTPS* and *TLS* protocol version *1.2* or *1.3*. Servers and client applications authenticate each other using *X.509* certificates.
1919

20-
* All instances are encrypted using HTTPS and TLS protocol version 1.2 or 1.3.
21-
22-
* Servers and client applications authenticate each other using X.509 certificates.
23-
<Admonition type="info" title="">
24-
Note that a RavenDB cloud product **comes with an initial client certificate**.
25-
You need this certificate in order to access your RavenDB instances.
26-
</Admonition>
27-
28-
* You can choose [which IP addresses](../cloud/portal/cloud-portal-products-tab.mdx#manage-product-the-security-tab) your server can be contacted by.
29-
30-
* Your [mandatory backup](../cloud/cloud-backup-and-restore.mdx#the-mandatory-backup-routine) routines produce encrypted backup files.
31-
32-
* In this page:
33-
* [Using The Initial Client Certificate](cloud-security#using-the-initial-client-certificate)
34-
* [Using Additional Certificates](cloud-security#using-additional-certificates)
20+
* In this page:
21+
* [Using the initial client certificate](cloud-security#using-the-initial-client-certificate)
22+
* [Managing allowed IPs](cloud-security#managing-allowed-ips)
23+
* [Using additional certificates](cloud-security#using-additional-certificates)
3524
* [Enable MFA](../cloud/cloud-security.mdx#enable-mfa)
3625

3726
</Admonition>
38-
## Using The Initial Client Certificate
27+
28+
## Using the initial client certificate
3929

4030
A client certificate is automatically generated during the creation of your RavenDB cloud product.
4131
You will need to import this certificate to your browser in order to access your cloud instances.
42-
#### Download Certificate
32+
33+
<Admonition type="info" title="">
34+
Expiration for client certificates is set to **5** years by default.
35+
The certificate will be automatically regenerated **30 days** before its expiration date.
36+
**RavenDB Cloud** will notify you by email **60 days** before regeneration.
37+
</Admonition>
38+
39+
#### Download certificate
4340

4441
Go to the [Products tab](../cloud/portal/cloud-portal-products-tab.mdx) in the cloud [portal](../cloud/portal/cloud-portal.mdx)
4542
and click the **Download Certificate** button.
@@ -53,6 +50,17 @@ When the certificate import wizard is launched, click "Next" all the way through
5350
!["Certificate Import Wizard"](./assets/security-002-wizard.png)
5451
#### Access your product
5552

53+
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.
54+
In other cases (e.g. if you're using Firefox) you will have to import the certificate to your browser manually.
55+
56+
!["Server URLs"](./assets/migration-001-urls.png)
57+
58+
Once the certificate is imported, please make sure your IP address is on the [allowed IPs list](#managing-allowed-ips) and then click your cloud instance's URL.
59+
Your browser will prompt you to select a certificate. When you select the client certificate, your product's
60+
[management studio](../7.1/studio/overview) will launch.
61+
62+
## Managing allowed IPs
63+
5664
To access your product your IP address must be added to the `Allowed IPs` list.
5765
Allowed IPs entries are [CIDR ranges](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing#CIDR_notation)
5866
that define networks from which the connection is allowed.
@@ -61,7 +69,7 @@ that define networks from which the connection is allowed.
6169
or IP ranges.
6270
- Be aware that you will not be able to access your instance from locations that are not specified in the allowed IPs
6371
list.
64-
- You can **edit the list at any time** through the Portal.
72+
- You can **edit the list at any time** through the Cloud Portal.
6573
- Regardless of the allowed IPs setting, your RavenDB Cloud **instances will always require authentication** using X.509
6674
certificates for access. The allowed IPs list serves as an additional layer of security, but isn't the only one.
6775

@@ -79,18 +87,7 @@ If addresses in your list overlap, an error is going to be displayed upon produc
7987
Cross-instance communication **inside the cluster** is **not** subject to these restrictions.
8088
</Admonition>
8189

82-
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.
83-
In other cases (e.g. if you're using Firefox) you will have to import the certificate to your browser manually.
84-
85-
!["Server URLs"](./assets/migration-001-urls.png)
86-
87-
Once the certificate is imported, click your cloud instance's URL.
88-
Your browser will prompt you to select a certificate. When you select the client certificate, your product's
89-
[management studio](../7.1/studio/overview) will launch.
90-
91-
92-
93-
## Using Additional Certificates
90+
## Using additional certificates
9491

9592
Your initial [operator-level](../7.1/server/security/authorization/security-clearance-and-permissions#operator)
9693
certificate allows you to perform operations like creating and deleting databases, managing access to the cluster, and inspecting the cluster's state.

0 commit comments

Comments
 (0)