-
Notifications
You must be signed in to change notification settings - Fork 34
Fix sharedinclude content in current #406
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
18 changes: 18 additions & 0 deletions
18
source/includes/include-fixes/compatibility-table-legend.rst
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,18 @@ | ||
Compatibility Table Legend | ||
++++++++++++++++++++++++++ | ||
|
||
.. list-table:: | ||
:header-rows: 1 | ||
:stub-columns: 1 | ||
:class: compatibility | ||
|
||
* - Icon | ||
- Explanation | ||
|
||
* - ✓ | ||
- All features are supported. | ||
* - ⊛ | ||
- The Driver version will work with the MongoDB version, but not all | ||
new MongoDB features are supported. | ||
* - No mark | ||
- The Driver version is not tested with the MongoDB version. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,90 @@ | ||
================= | ||
In-Use Encryption | ||
================= | ||
|
||
.. contents:: On this page | ||
:local: | ||
:backlinks: none | ||
:depth: 2 | ||
:class: singlecol | ||
|
||
Overview | ||
-------- | ||
|
||
You can use the {+driver-short+} to encrypt specific document fields by using a | ||
set of features called **in-use encryption**. In-use encryption allows | ||
your application to encrypt data *before* sending it to MongoDB | ||
and query documents with encrypted fields. | ||
|
||
In-use encryption prevents unauthorized users from viewing plaintext | ||
data as it is sent to MongoDB or while it is in an encrypted database. To | ||
enable in-use encryption in an application and authorize it to decrypt | ||
data, you must create encryption keys that only your application can | ||
access. Only applications that have access to your encryption | ||
keys can access the decrypted, plaintext data. If an attacker gains | ||
access to the database, they can only see the encrypted ciphertext data | ||
because they lack access to the encryption keys. | ||
|
||
You might use in-use encryption to encrypt fields in your MongoDB | ||
documents that contain the following types of sensitive data: | ||
|
||
- Credit card numbers | ||
- Addresses | ||
- Health information | ||
- Financial information | ||
- Any other sensitive or personally identifiable information (PII) | ||
|
||
MongoDB offers the following features to enable in-use encryption: | ||
|
||
- :ref:`Queryable Encryption <subsection-qe>` | ||
- :ref:`Client-side Field Level Encryption <subsection-csfle>` | ||
|
||
.. _subsection-qe: | ||
|
||
Queryable Encryption | ||
~~~~~~~~~~~~~~~~~~~~ | ||
|
||
Queryable Encryption is the next-generation in-use encryption feature, | ||
first introduced as a preview feature in MongoDB Server version 6.0 and | ||
as a generally available (GA) feature in MongoDB 7.0. Queryable | ||
Encryption supports searching encrypted fields for equality and encrypts | ||
each value uniquely. | ||
|
||
.. important:: Preview Feature Incompatible with MongoDB 7.0 | ||
|
||
The implementation of Queryable Encryption in MongoDB 6.0 is incompatible with the GA version introduced in MongoDB 7.0. The Queryable Encryption preview feature is no longer supported. | ||
|
||
To learn more about Queryable Encryption, see :manual:`Queryable | ||
Encryption </core/queryable-encryption/>` in the Server manual. | ||
|
||
.. _subsection-csfle: | ||
|
||
Client-side Field Level Encryption | ||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
|
||
Client-side Field Level Encryption (CSFLE) was introduced in MongoDB | ||
Server version 4.2 and supports searching encrypted fields for equality. | ||
CSFLE differs from Queryable Encryption in that you can select either a | ||
deterministic or random encryption algorithm to encrypt fields. You can only | ||
query encrypted fields that use a deterministic encryption algorithm when | ||
using CSFLE. When you use a random encryption algorithm to encrypt | ||
fields in CSFLE, they can be decrypted, but you cannot perform equality | ||
queries on those fields. When you use Queryable Encryption, you cannot | ||
specify the encryption algorithm, but you can query all encrypted | ||
fields. | ||
|
||
When you deterministically encrypt a value, the same input value | ||
produces the same output value. While deterministic encryption allows | ||
you to perform queries on those encrypted fields, encrypted data with | ||
low cardinality is susceptible to code breaking by frequency analysis. | ||
|
||
.. tip:: | ||
|
||
To learn more about these concepts, see the following Wikipedia | ||
entries: | ||
|
||
- :wikipedia:`Cardinality <w/index.php?title=Cardinality_(data_modeling)&oldid=1182661589>` | ||
- :wikipedia:`Frequency Analysis <w/index.php?title=Frequency_analysis&oldid=1182536787>` | ||
|
||
To learn more about CSFLE, see :manual:`CSFLE </core/csfle/>` in the | ||
Server manual. |
1 change: 1 addition & 0 deletions
1
source/includes/include-fixes/language-compatibility-table-go.rst
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
The {+driver-long+} requires Go 1.18 or later. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
.. important:: | ||
|
||
MongoDB ensures compatibility between the MongoDB Server and the drivers | ||
for three years after the server version's end of life (EOL) date. To learn | ||
more about the MongoDB release and EOL dates, see | ||
`MongoDB Software Lifecycle Schedules <https://www.mongodb.com/support-policy/lifecycles>`__. |
37 changes: 37 additions & 0 deletions
37
source/includes/include-fixes/mongodb-compatibility-table-go.rst
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,37 @@ | ||
.. list-table:: | ||
:header-rows: 1 | ||
:stub-columns: 1 | ||
:class: compatibility-large | ||
|
||
* - Go Driver Version | ||
- MongoDB 8.0 | ||
- MongoDB 7.0 | ||
- MongoDB 6.1 | ||
- MongoDB 6.0 | ||
- MongoDB 5.0 | ||
- MongoDB 4.4 | ||
- MongoDB 4.2 | ||
- MongoDB 4.0 | ||
- MongoDB 3.6 | ||
|
||
* - 1.12 to 1.17 | ||
- ⊛ [#8.0-support]_ | ||
- ✓ | ||
- ✓ | ||
- ✓ | ||
- ✓ | ||
- ✓ | ||
- ✓ | ||
- ✓ | ||
- ✓ | ||
|
||
* - 1.11 | ||
- ⊛ | ||
- ⊛ | ||
- ✓ | ||
- ✓ | ||
- ✓ | ||
- ✓ | ||
- ✓ | ||
- ✓ | ||
- ✓ |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks like we're missing the footnote for this bullet. Can you add it? You can see it in upcoming here: https://www.mongodb.com/docs/drivers/go/upcoming/compatibility/#ref-8.0-support-id1
Uh oh!
There was an error while loading. Please reload this page.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ah thanks will add! I thought it was commented out in the sharedinclude so I missed it.