Skip to content

Commit

Permalink
Add content about tsdbadmin user to both Cloud and MST sections (gith…
Browse files Browse the repository at this point in the history
…ub#1382)

* Add content about tsdbadmin user to TSC and MST

* Fix bad link reference
  • Loading branch information
Loquacity authored Aug 10, 2022
1 parent d0004f6 commit f6c64bc
Show file tree
Hide file tree
Showing 2 changed files with 36 additions and 2 deletions.
17 changes: 17 additions & 0 deletions cloud/service-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,4 +14,21 @@ an overview of the configuration and resource usage for the service.

<img class="main-content__illustration" src="https://s3.amazonaws.com/assets.timescale.com/docs/images/tsc-services-overview.png" alt="Timescale Cloud Services Overview"/>

## Service users
By default, when you create a new service, a new `tsdbadmin` user is created.
This is the user that you use to connect to your new service.

The `tsdbadmin` user is the owner of the database, but is not a superuser. To
access features requiring a superuser, log in as the `postgres` user instead.

On Timescale Cloud services, the `tsdbadmin` user can:

* Create a database
* Create a role

This allows you to use the `tsdbadmin` user to create another user with any
other roles. For a complete list of roles available, see the
[PostgreSQL role attributes documentation][pg-roles-doc].

[cloud-login]: https://console.cloud.timescale.com/
[pg-roles-doc]: https://www.postgresql.org/docs/current/role-attributes.html
21 changes: 19 additions & 2 deletions mst/user-management.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,22 @@ and stop services permission.
</procedure>

## Service users
You can create user accounts for accessing your services.
By default, when you create a new service, a new `tsdbadmin` user is created.
This is the user that you use to connect to your new service.

The `tsdbadmin` user is the owner of the database, but is not a superuser. To
access features requiring a superuser, log in as the `postgres` user instead.

On Managed Service for TimescaleDB services, the `tsdbadmin` user can:

* Create a database
* Create a role
* Perform replication
* Bypass row level security (RLS)

This allows you to use the `tsdbadmin` user to create another user with any
other roles. For a complete list of roles available, see the
[PostgreSQL role attributes documentation][pg-roles-doc].

<highlight type="important">
Your service must be running before you can manage users.
Expand All @@ -63,10 +78,12 @@ Your service must be running before you can manage users.
the user to be replicated, toggle `Allow replication`. Click
`Add service user` to save the user.
1. The new user shows in the `Username` list. You can view the password by
clicking the eye icon. Use the options in the list to change the replication setting and password, or delete the user.
clicking the eye icon. Use the options in the list to change the replication
setting and password, or delete the user.

<img class="main-content__illustration" src="https://s3.amazonaws.com/assets.timescale.com/docs/images/mst-serviceuser.png" alt="Add a new MST service user"/>

</procedure>

[mst-login]: https://portal.managed.timescale.com
[pg-roles-doc]: https://www.postgresql.org/docs/current/role-attributes.html

0 comments on commit f6c64bc

Please sign in to comment.