Skip to content

docs: Consolidate pages for access user management #168

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
396 changes: 396 additions & 0 deletions src/docs.json

Large diffs are not rendered by default.

12 changes: 6 additions & 6 deletions src/langsmith/administration-overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ This overview covers topics related to managing users, organizations, and worksp

### Organizations

An organization is a logical grouping of users within LangSmith with its own billing configuration. Typically, there is one organization per company. An organization can have multiple workspaces. For more details, see the [setup guide](/langsmith/set-up-organization).
An organization is a logical grouping of users within LangSmith with its own billing configuration. Typically, there is one organization per company. An organization can have multiple workspaces. For more details, see the [setup guide](/langsmith/set-up-a-workspace#set-up-an-organization).

When you log in for the first time, a personal organization will be created for you automatically. If you'd like to collaborate with others, you can create a separate organization and invite your team members to join. There are a few important differences between your personal organization and shared organizations:

Expand All @@ -25,7 +25,7 @@ When you log in for the first time, a personal organization will be created for
Workspaces were formerly called Tenants. Some code and APIs may still reference the old name for a period of time during the transition.
</Info>

A workspace is a logical grouping of users and resources within an organization. A workspace separates trust boundaries for resources and access control. Users may have permissions in a workspace that grant them access to the resources in that workspace, including tracing projects, datasets, annotation queues, and prompts. For more details, see the [setup guide](/langsmith/set-up-workspace).
A workspace is a logical grouping of users and resources within an organization. A workspace separates trust boundaries for resources and access control. Users may have permissions in a workspace that grant them access to the resources in that workspace, including tracing projects, datasets, annotation queues, and prompts. For more details, see the [setup guide](/langsmith/set-up-a-workspace).

It is recommended to create a separate workspace for each team within your organization. To organize resources even further, you can use [Resource Tags](#resource-tags) to group resources within a workspace.

Expand Down Expand Up @@ -110,7 +110,7 @@ Service keys are prefixed with `lsv2_sk_`

### Organization roles

Organization roles are distinct from the Enterprise feature (RBAC) below and are used in the context of multiple [workspaces](#workspaces). Your organization role determines your workspace membership characteristics and your organization-level permissions. See the [organization setup guide](/langsmith/set-up-organization#organization-roles) for more information.
Organization roles are distinct from the Enterprise feature (RBAC) below and are used in the context of multiple [workspaces](#workspaces). Your organization role determines your workspace membership characteristics and your organization-level permissions. See the [organization setup guide](/langsmith/set-up-a-workspace#organization-roles) for more information.

The organization role selected also impacts workspace membership as described here:

Expand Down Expand Up @@ -158,7 +158,7 @@ Roles can be managed in organization settings under the `Roles` tab:

![Roles](/langsmith/images/roles-tab-rbac.png)

For more details on assigning and creating roles, see the [access control setup guide](/langsmith/set-up-access-control).
For more details on assigning and creating roles, see the [access control setup guide](/langsmith/user-management).

## Best Practices

Expand All @@ -175,7 +175,7 @@ In May 2024, LangSmith introduced a maximum data retention period on traces of 4
#### Why retention matters

* **Privacy**: Many data privacy regulations, such as GDPR in Europe or CCPA in California, require organizations to delete personal data once it's no longer necessary for the purposes for which it was collected. Setting retention periods aids in compliance with such regulations.
* **Cost**: LangSmith charges less for traces that have low data retention. See our tutorial on how to [optimize spend](/langsmith/manage-spend) for details.
* **Cost**: LangSmith charges less for traces that have low data retention. See our tutorial on how to [optimize spend](/langsmith/billing#optimize-your-tracing-spend) for details.

#### How it works

Expand Down Expand Up @@ -358,4 +358,4 @@ Usage limits can be updated from the `Settings` page under `Usage and Billing`.

### Related content

* Tutorial on how to [optimize spend](/langsmith/manage-spend)
* Tutorial on how to [optimize spend](/langsmith/billing#optimize-your-tracing-spend)
2 changes: 1 addition & 1 deletion src/langsmith/authentication-methods.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Users can alternatively use their credentials from GitHub or Google.

### SAML SSO

Enterprise customers can configure [SAML SSO](/langsmith/set-up-saml-sso) and [SCIM](/langsmith/set-up-scim)
Enterprise customers can configure [SAML SSO](/langsmith/user-management) and [SCIM](/langsmith/user-management)

## Self-Hosted

Expand Down
Loading