Concepts

Resources & Access

A resource is a connection the organization owns: an SSH host, a SQL or NoSQL database, a REST collection, or a storage connection for Explorer. An administrator creates it once in the Organization Console and attaches it to groups. Members of those groups get the connection in the desktop app with its credentials already in place.

Use resources when a team should share a connection without anyone passing a password around.

Kinds

Kind Opens in
SSH SSH
SQL SQL
NoSQL NoSQL
REST REST
Explorer Explorer

How access works

  1. An administrator creates the connection under Manage → Resources.
  2. The administrator attaches it to one or more groups.
  3. Members of those groups receive the connection on their next desktop sync.
  4. When the connection is detached from a group, members of that group lose it on their next sync.

A connection that is not attached to any group reaches nobody. The Resources page counts these under Unattached.

Inside a group, Who can use can narrow a connection from everyone in the group to chosen job roles, chosen people, or the group's leads.

A resource attached to a group in the Organization Console.

Create a connection

  1. Open Manage → Resources in the Organization Console.
  2. Select New connection.
  3. Choose the Kind.
  4. Enter a Name and fill in the connection fields for that kind. For REST, export the collection from the Clauge desktop app and upload the file.
  5. Under Attach to groups, select the groups that need it.
  6. Select Create connection.

A SQL connection can go through an SSH resource: choose it under Connect via SSH tunnel.

Manage a connection

Each row on the Resources page has these actions:

Action Effect
Open Shows the configuration, the attached groups, who can reach it, and recent access.
Edit connection Changes the name or the connection fields.
Attach to group Adds the connection to more groups.
Rotate secret Replaces the stored secret. Not offered for REST collections.
Delete Removes the connection. Its groups lose it immediately. Access history is kept.

To remove a connection from one group only, open the connection and select Detach next to that group.

Secrets

  • Secrets are stored encrypted. Nobody can read a secret back, including administrators.
  • After a secret is rotated, desktop apps pick up the new secret on their next sync. Sessions that are already open keep working until they reconnect.
  • The Resources page flags secrets older than 90 days under Secrets due for rotation.

In the desktop app

Organization resources appear in the matching mode, inside the group they are attached to. They carry an Org badge and are read-only: you connect and work, but you cannot edit or delete the connection.

Access to organization resources is recorded. The record shows who reached what and when. Administrators read it under Governance → Access log.

Your own connections

You can still add your own connections from each mode's sidebar when your organization's policy allows it. A connection you add is yours to edit and delete. It is separate from the organization's resources.

If a connection is missing

Check these in order:

  1. You belong to a group the connection is attached to. See Groups.
  2. The desktop app has synced since you were added.
  3. Your organization's policy allows the mode. A mode that is turned off shows Turned off by your organization.

If all three are fine, ask an administrator to check Who can use for that connection in the group.

What’s next