Details
-
Task
-
Resolution: Unresolved
-
Major
-
None
-
None
-
None
Description
Parts of the initial process to set up a Couchbase lite to replicate to a remote database seem out of date, or fails to mention critical information.
- The prerequisites page mentions that you need to create an RBAC user but there is no mention of creating a sync gateway database, or a sync gateway role and a user.
- There is no mention how to use the REST API to create these within Start Here either.
- The page, databases, doesn't mention how to create a sync gateway database on the cluster itself.
- Seemingly the only mention of the REST API exists within remote replication.
To authorize with Sync Gateway, an associated user must first be created. Sync Gateway users can be created through the POST /{tkn-db}/_user endpoint on the Admin REST API.
|
- The admin sync gateway page should be linked here, and in the prerequisites page. The setup for a sync gateway node should be linked in the prerequisites page an optional guide if remote replication is required.
- It should also mention the purposes of the RBAC user and the sync gateway user to provide more context to the end user.
- RBAC users is used for authentications with the admin port
- Sync gateway users is for authentications with the public port
- The Build and Run sample code should be changed to show that its the sgwuser authentication details that are used rather than the rbac user.