Uploaded image for project: 'Couchbase Documentation'
  1. Couchbase Documentation
  2. DOC-12173

Couchbase Lite: Start Here! assumes that RBAC user is used to authenticate a replication

    XMLWordPrintable

Details

    • Task
    • Resolution: Unresolved
    • Major
    • None
    • None
    • couchbase-lite
    • 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.

       

      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.

      Attachments

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

        Activity

          People

            elliot.hunter Elliot Hunter
            felix.seanor Felix Seanor
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

            Dates

              Created:
              Updated:

              Gerrit Reviews

                There are no open Gerrit changes

                PagerDuty