livebook-dev/livebook
1
1
Fork 0
mirror of https://github.com/livebook-dev/livebook.git synced 2025-10-25 04:46:04 +08:00
Code Issues Projects Releases Packages Wiki Activity

Remove slug prefix access type from docs (#3060)

Browse source
This commit is contained in:
Hugo Baraúna 2025-09-12 08:27:28 -03:00 • committed by GitHub
parent 28caea2b26
commit 2c27299eb4
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 2 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

BIN
docs/images/oidc_groups_auth.png
View file

Binary file not shown.
Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 92 KiB

After

Width:  |  Height:  |  Size: 204 KiB

16
docs/teams/oidc_groups.md
View file

@ -12,7 +12,6 @@ Livebook Teams allows you to control access to your app servers and Livebook app
OIDC groups authorization enables you to:
- Restrict access to your Livebook apps and app servers based on group membership
- Control which users can access specific apps using slug prefix filtering
- Integrate seamlessly with your existing OIDC SSO provider (Okta, Microsoft Entra, etc.)
## Prerequisites
@ -33,7 +32,7 @@ To enable authorization via OIDC SSO groups for a deployment group:
1. Log in to Livebook Teams
2. Navigate to the **Deployments** panel
3. Click **Edit** on the deployment group where you want to enable authorization
4. Go to the **IAM** section (requires "admin" role in the organization)
4. Go to the **App server access** section (requires "admin" role in the organization)
5. Ensure that **Authenticate via Livebook Teams** is enabled
6. Enable **Authorize via OIDC SSO groups**
@ -44,10 +43,7 @@ Once authorization is enabled, you can add group access rules:
1. Click the **Add group** button
2. Select one of your configured OIDC identity providers
3. Enter the name of a group from your identity provider
4. Choose the **Access type**:
- Full access
- Slug prefix access
5. Click the **Add group** button to save the rule
4. Click the **Add group** button to save the rule
You can add multiple groups with different access types to configure your authorization strategy.
@ -61,14 +57,6 @@ Users who belong to groups with full access can access:
**Notice that [Admin authentication](authentication.md#admin-authentication) configs will also apply if configured.*
### Slug prefix access
Users who belong to groups with slug prefix access can only access Livebook apps whose URL slugs start with the specified prefix.
For example, with the slug prefix "**finance-**", users can access an app whose slug is "**finance-**budget", but not one with the slug "**hr-**budget".
This allows you to create role-based access control based on your organization's existing group structure.
## Testing the Configuration
To verify the configuration is working: