Skip to content

Commit 0c39d91

Browse files
authored
DOCSP-32282 API Security (#149) (#290)
* DOCSP-32282 Security notice for API calls * Text adjustment * Text adjustment * Adds security notice to other endpoints * Fixes build issue * Fixes build issue * Fixes text * Fixes per Sarah
1 parent 8078e0e commit 0c39d91

File tree

7 files changed

+54
-2
lines changed

7 files changed

+54
-2
lines changed

source/includes/fact-api-endpoint.rst

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
2+
3+
``mongosync`` does not protect the |endpoint| endpoint. However, by default
4+
the API binds to localhost only and does not accept calls from other sources.
5+
Additionally, the |endpoint| call does not expose connection credentials
6+
or user data.
7+
8+

source/reference/api/commit.txt

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -150,7 +150,6 @@ State
150150
~~~~~
151151

152152
If the ``commit`` request is successful, ``mongosync`` enters the
153-
``COMMITTING`` state, then automatically transitions to the
154153
``COMMITTED`` state. Once ``mongosync`` enters the ``COMMITTED`` state,
155154
continuous sync between the clusters stops.
156155

@@ -159,4 +158,11 @@ Data Verification
159158

160159
.. include:: /includes/fact-verification
161160

161+
Endpoint Protection
162+
~~~~~~~~~~~~~~~~~~~
163+
164+
.. |endpoint| replace:: ``commit``
165+
.. include:: /includes/fact-api-endpoint
166+
167+
162168

source/reference/api/pause.txt

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,3 +77,12 @@ Behavior
7777
increase the size of the replica set :term:`oplog` in the source
7878
cluster. To learn more, see :ref:`Frequently Asked Questions
7979
<c2c-faq-increase-oplog>`.
80+
81+
Endpoint Protection
82+
~~~~~~~~~~~~~~~~~~~
83+
84+
.. |endpoint| replace:: ``pause``
85+
.. include:: /includes/fact-api-endpoint
86+
87+
88+

source/reference/api/progress.txt

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,13 @@ Behavior
5959
- The endpoint does not auto-refresh. To get updated status, call the
6060
``progress`` endpoint again.
6161

62+
Endpoint Protection
63+
~~~~~~~~~~~~~~~~~~~
64+
65+
.. |endpoint| replace:: ``progress``
66+
.. include:: /includes/fact-api-endpoint
67+
68+
6269
Example
6370
-------
6471

source/reference/api/resume.txt

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -73,3 +73,11 @@ Behavior
7373

7474
If the ``resume`` request is successful, ``mongosync`` enters the
7575
``RUNNING`` state.
76+
77+
Endpoint Protection
78+
~~~~~~~~~~~~~~~~~~~
79+
80+
.. |endpoint| replace:: ``resume``
81+
.. include:: /includes/fact-api-endpoint
82+
83+

source/reference/api/reverse.txt

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -141,3 +141,10 @@ To view the mapping direction for the synchronization of the source and
141141
destination clusters, use the :ref:`progress <c2c-api-progress>`
142142
endpoint and check the ``directionMapping`` object.
143143

144+
Endpoint Protection
145+
~~~~~~~~~~~~~~~~~~~
146+
147+
.. |endpoint| replace:: ``reverse``
148+
.. include:: /includes/fact-api-endpoint
149+
150+

source/reference/api/start.txt

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -468,4 +468,11 @@ Indexes that are always built include:
468468
sharded collection, which are removed after commit. When ``buildIndexes`` is
469469
set to ``never``, ``mongosync`` retains this index after commit.
470470

471-
471+
472+
Endpoint Protection
473+
~~~~~~~~~~~~~~~~~~~
474+
475+
.. |endpoint| replace:: ``start``
476+
.. include:: /includes/fact-api-endpoint
477+
478+

0 commit comments

Comments
 (0)