From 36988b3950cd3c9b8dd6a2d794023951839096c7 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 3 Sep 2026 08:25:59 +0000
Subject: [PATCH 1/5] feat: add SSO, SCIM and Magic Link documentation
Add documentation for setting up SSO, setting up SCIM and using Magic
Link
---
administration/authentication/magic_link.md | 31 +++++
.../authentication/single_sign_on.md | 47 ++++++++
.../automated_user_provisioning.md | 110 ++++++++++++++++++
.../managing_users/roles_in_kosli.md | 4 +
config/navigation.json | 7 +-
getting_started/authenticating_to_kosli.md | 4 +
images/administration/add-sso.png | Bin 0 -> 158281 bytes
.../administration/magic-link-check-email.png | Bin 0 -> 69077 bytes
images/administration/magic-link-email.png | Bin 0 -> 66586 bytes
.../administration/magic-link-enter-email.png | Bin 0 -> 109847 bytes
.../scim-group-role-mapping.png | Bin 0 -> 268570 bytes
images/administration/scim-setup-wizard.png | Bin 0 -> 82940 bytes
images/administration/select-idp.png | Bin 0 -> 345182 bytes
images/administration/sso-setup-suite.png | Bin 0 -> 481062 bytes
14 files changed, 201 insertions(+), 2 deletions(-)
create mode 100644 administration/authentication/magic_link.md
create mode 100644 administration/authentication/single_sign_on.md
create mode 100644 administration/managing_users/automated_user_provisioning.md
create mode 100644 images/administration/add-sso.png
create mode 100644 images/administration/magic-link-check-email.png
create mode 100644 images/administration/magic-link-email.png
create mode 100644 images/administration/magic-link-enter-email.png
create mode 100644 images/administration/scim-group-role-mapping.png
create mode 100644 images/administration/scim-setup-wizard.png
create mode 100644 images/administration/select-idp.png
create mode 100644 images/administration/sso-setup-suite.png
diff --git a/administration/authentication/magic_link.md b/administration/authentication/magic_link.md
new file mode 100644
index 00000000..f6351a3d
--- /dev/null
+++ b/administration/authentication/magic_link.md
@@ -0,0 +1,31 @@
+---
+title: Magic Link
+description: "Learn about signing in to Kosli with Magic Link."
+icon: "wand-magic-sparkles"
+---
+
+Magic Link is a way of signing into Kosli without needing to set up [single sign-on](/administration/authentication/single_sign_on). When you want to sign in, Kosli emails you a link, and clicking that link signs you in.
+
+## Enabling Magic Link
+
+To use Magic Link with your company email, email [support@kosli.com](mailto:support@kosli.com) and we'll enable it for your email domain.
+
+## Using Magic Link
+
+
+
+ Once Magic Link is enabled for your domain, enter your email address on the Kosli sign-in page and select **Continue with SSO** — the same button is used for Magic Link sign-in.
+
+ 
+
+
+ Kosli then sends you an email containing the link and asks you to check your inbox.
+
+ 
+
+
+ The email contains a button to click; clicking this will sign you in to your Kosli account.
+
+ 
+
+
diff --git a/administration/authentication/single_sign_on.md b/administration/authentication/single_sign_on.md
new file mode 100644
index 00000000..e58992b6
--- /dev/null
+++ b/administration/authentication/single_sign_on.md
@@ -0,0 +1,47 @@
+---
+title: Single sign-on
+description: "Learn about configuring single sign-on with Kosli"
+icon: "key"
+---
+
+Kosli supports signing in using your identity provider, via single sign-on (SSO). If you don't use an identity provider, [Magic Link](/administration/authentication/magic_link) is an alternative way to sign in.
+
+## Enabling single sign-on
+
+When you are ready for your organization to access Kosli using single sign-on, your IT team will need to configure a new SSO connection. It's done through a self-service setup wizard to make this as straightforward as possible.
+
+Your Kosli Customer Success representative will provide you with a custom direct link to your personalized SSO setup wizard.
+
+## Step by step
+
+Before you begin, you will need access to your Identity Provider (IdP) — such as Azure Entra ID, Okta, or Google Workspace — with permissions to create or modify application registrations and SSO configurations.
+
+
+
+ Open the link provided by Kosli. The wizard will display the current state of your SSO connection. If no connection exists yet, you'll see an option to add one.
+
+
+ 
+
+
+
+ Click **+ Add**, then select your IdP from the list (for example, Okta, Azure Entra ID, Keycloak, or Auth0). Select **OIDC** if there is a choice. The exception is Okta: its SCIM integration only works with a SAML connection, so select **SAML** if you use Okta and expect to add [SCIM provisioning](/administration/managing_users/automated_user_provisioning) — choosing OIDC now means recreating the connection later.
+
+
+ 
+
+
+
+ The wizard will guide you through the setup process with screenshots specific to your IdP. You'll be asked to copy and paste values between your IdP and the wizard, including:
+
+ - **Client ID** from your IdP's application registration
+ - **Client Secret** from your IdP's application registration
+
+
+ 
+
+
+
+ Once you have completed the SSO configuration in the wizard, please let your Kosli Customer Success representative know. We will then switch your email domain to use SSO and confirm when the migration is complete.
+
+
diff --git a/administration/managing_users/automated_user_provisioning.md b/administration/managing_users/automated_user_provisioning.md
new file mode 100644
index 00000000..c42cc2f0
--- /dev/null
+++ b/administration/managing_users/automated_user_provisioning.md
@@ -0,0 +1,110 @@
+---
+title: Automated user provisioning
+description: "Learn about configuring automated user provisioning (SCIM) with Kosli."
+---
+
+Kosli supports SCIM provisioning and deprovisioning of users. This feature allows users to be added to Kosli by assigning them to the Kosli application within your Identity Provider (IdP). This page explains how to get started.
+
+## Benefits
+
+User provisioning within your IdP simplifies the process of granting access to Kosli; you no longer need to explicitly invite people one-by-one. Your existing processes and procedures for onboarding team members can now be leveraged to give access to the Kosli platform.
+
+User deprovisioning within your IdP means that when your people no longer need access to Kosli, for example because they have changed roles or left your organization, their access to Kosli is revoked automatically.
+
+## Prerequisites
+
+Before configuring SCIM, make sure that:
+
+- **[Single sign-on](/administration/authentication/single_sign_on) is already configured.** SCIM builds on your
+ existing SSO connection, and IdP groups are mapped to Kosli roles in the SSO part of the same wizard.
+- **SCIM is enabled for your Kosli organizations.** Tell your Kosli Customer Success representative which
+ organizations you want SCIM for, so that the matching roles can be created — see
+ [Roles for new and existing users](#roles-for-new-and-existing-users) below.
+- **You have a link to the setup wizard.** Your Customer Success representative provides one with instructions
+ for your IdP, which you can pass on to the team that will do the work.
+- **That team can administer your IdP.** They need permissions to create or modify application registrations,
+ and to manage the groups you map to Kosli roles.
+
+## Setup
+
+The team that manages your IdP configures the connection between your IdP and Kosli's auth provider. Because
+different IdPs need different configuration, the wizard gives step-by-step instructions specific to yours.
+
+
+Adding SCIM does not normally require any change to your existing SSO connection. The exception is Okta over
+OIDC: Okta's SCIM integration only works with a SAML connection, so an Okta OIDC connection has to be recreated
+using SAML before SCIM can be enabled. If you are not sure which your IdP uses, ask your Kosli Customer Success
+representative.
+
+
+
+
+ Open the link from your Customer Success representative and select the **SCIM Configuration** box on the
+ first screen.
+
+
+ 
+
+
+
+ The wizard then guides you through setting up and configuring the application, with screenshots at each
+ stage.
+
+
+ Create a group in your IdP for each Kosli organization and role you need, then add your users to them. See
+ [Roles for new and existing users](#roles-for-new-and-existing-users) for the group naming scheme, and for
+ how to map those groups to Kosli roles.
+
+
+ Once your users are in the right groups and you have triggered a provisioning cycle, changes to your users
+ within the IdP are reflected in Kosli.
+
+
+
+## Timeliness
+
+Once changes within your IdP have been synced, they are typically reflected in Kosli within five minutes.
+
+## Existing Kosli users
+
+People who already have access to Kosli via SSO keep that access. Enabling SCIM does not, by itself, change
+anyone's roles or organization memberships — nothing in Kosli moves until your IdP sends a change.
+
+From then on, your IdP drives membership. Once a user has been provisioned through SCIM, the groups they belong
+to in your IdP determine their organizations and roles in Kosli, replacing whatever they had before.
+
+That makes the first sync worth planning. A full or forced sync in your IdP — however it is labeled there —
+provisions every assigned user at once, not only the ones you have just changed, so make sure your groups and
+[role mappings](#map-your-idp-groups-to-kosli-roles) are correct before you trigger one.
+
+## Roles for new and existing users
+
+Kosli supports role assignment through your IdP, so that users' [roles within Kosli](/administration/managing_users/roles_in_kosli) can be managed by your onboarding and IT teams, without requiring admin access to Kosli.
+
+You will need to tell us which of your Kosli organizations you wish to have SCIM enabled for; we will then create the necessary roles within our auth provider. Each organization will have four roles, with the names `kosli--`, to correspond to the available roles in Kosli (admin, member, snapshotter, reader).
+
+Within your IdP you will need to create a group for each of these roles. You will then add your users to the groups corresponding to the organizations/roles you wish them to have in Kosli. If a member receives two different roles for the same organization, the highest-privilege role will be assigned.
+
+### Map your IdP groups to Kosli roles
+
+
+
+ Group mapping is done in **SSO Configuration**, not in the SCIM configuration you used to set up
+ provisioning. Open **SSO Configuration** and go to the **Group Attribute Mapping** tab.
+
+
+ Follow the instructions on the tab, mapping each of your IdP groups to the corresponding role.
+
+
+ 
+
+
+
+ Click through to the **Testing** page and save the configuration.
+
+
+
+
+Once a user has been provisioned through SCIM, your IdP is authoritative for that user: their roles can no
+longer be changed in Kosli, so every later role change has to be made through their IdP group membership.
+
diff --git a/administration/managing_users/roles_in_kosli.md b/administration/managing_users/roles_in_kosli.md
index cda1d222..f25230b0 100644
--- a/administration/managing_users/roles_in_kosli.md
+++ b/administration/managing_users/roles_in_kosli.md
@@ -188,6 +188,10 @@ The following sections provide more details about each Kosli user role, includin
## Assigning roles
+
+This procedure does not apply to users provisioned through [automated user provisioning](/administration/managing_users/automated_user_provisioning) — their roles cannot be changed in Kosli. Manage those roles through your identity provider groups instead.
+
+
To assign or change a user's role:
1. Log in to Kosli as an Admin
diff --git a/config/navigation.json b/config/navigation.json
index e680d778..b2e7574d 100644
--- a/config/navigation.json
+++ b/config/navigation.json
@@ -47,14 +47,17 @@
"pages": [
"administration/authentication/api_authentication_methods",
"administration/authentication/service_accounts",
- "administration/authentication/api_key_rotation"
+ "administration/authentication/api_key_rotation",
+ "administration/authentication/single_sign_on",
+ "administration/authentication/magic_link"
]
},
{
"group": "Users & roles",
"pages": [
"administration/managing_users/roles_in_kosli",
- "administration/managing_users/mapping_users_to_roles"
+ "administration/managing_users/mapping_users_to_roles",
+ "administration/managing_users/automated_user_provisioning"
]
},
{
diff --git a/getting_started/authenticating_to_kosli.md b/getting_started/authenticating_to_kosli.md
index 417e022e..1bb1fc6e 100644
--- a/getting_started/authenticating_to_kosli.md
+++ b/getting_started/authenticating_to_kosli.md
@@ -25,6 +25,8 @@ For anything automated, use a service account. Personal API keys inherit your us
- EU: [app.kosli.com](https://app.kosli.com)
- US: [app.us.kosli.com](https://app.us.kosli.com)
+
+ Depending on how your organization is set up, you'll sign in with [single sign-on](/administration/authentication/single_sign_on) or [Magic Link](/administration/authentication/magic_link).
- **For CI/CD**, follow [Service accounts](/administration/authentication/service_accounts) to create a service account and generate its first API key.
@@ -48,6 +50,8 @@ For CLI usage, basic auth, and full examples, see [API authentication methods](/
## See also
+- [Single sign-on](/administration/authentication/single_sign_on) — configure sign-in through your identity provider.
+- [Magic Link](/administration/authentication/magic_link) — sign in with an emailed link, without an identity provider.
- [Service accounts](/administration/authentication/service_accounts) — admin lifecycle for machine credentials.
- [API key rotation](/administration/authentication/api_key_rotation) — how rotation works, with a [step-by-step tutorial](/tutorials/rotating_api_keys).
- [Roles in Kosli](/administration/managing_users/roles_in_kosli) — what users and service accounts can do at each role.
diff --git a/images/administration/add-sso.png b/images/administration/add-sso.png
new file mode 100644
index 0000000000000000000000000000000000000000..264b85e28c0dfbee17572cb73c3b962994a5f4d9
GIT binary patch
literal 158281
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