Skip to main content

​
Introduction

Laravel Cloud supports single sign-on (SSO) through Security Assertion Markup Language (SAML) 2.0 and OpenID Connect (OIDC). With SSO, members of your organization can authenticate through an identity provider such as Okta, Auth0, Microsoft Entra ID, or Google Workspace instead of managing separate Cloud credentials. You configure SSO at the organization level. Once enabled, members of your organization can sign in to Cloud through your identity provider. Cloud continues to manage organization membership and roles.

​
Configuring SSO

Setting up SSO begins by enabling it for your organization and verifying that you own the domain your members sign in with.
1

Enable single sign-on

Navigate to your organization’s Settings > General page and toggle Enable single sign-on. This opens the single sign-on configuration modal, where you first verify your domain and then configure your identity provider. Only Admins can configure SSO.
2

Verify your domain

Under Domain verification, enter your organization’s domain and click Add domain. You can add multiple domains if members use email addresses from multiple domains.
3

Add DNS records

Add the DNS records Cloud provides to your domain. Cloud automatically verifies your domain after the records propagate, which may take a few hours. You may close the modal and return later without losing progress.
4

Configure your identity provider

Once Cloud has verified your domain, complete the Identity provider configuration step to connect your identity provider. Each identity provider is different, so follow the steps presented in the SSO flow for your provider.

​
Signing in with SSO

Once SSO is enabled, members of your organization can authenticate in two ways:
  • From your identity provider: Members can launch Cloud directly from their identity provider’s application dashboard.
  • From Cloud: Members can choose the SSO option on the Cloud login page and enter their work email address. Cloud will redirect them to your identity provider to authenticate.
After authenticating, members land in your organization’s dashboard with the role assigned to them in Cloud. SSO handles authentication only. Roles and permissions still control what each member can do.

​
Member provisioning

When someone signs in through your identity provider for the first time and does not yet have a Cloud account, Cloud automatically creates an account for them and adds them to your organization. This allows you to provision new members without sending individual invitations. Cloud assigns newly provisioned members the Developer role. You cannot change this default, but you can adjust an individual member’s role from the Settings > Members page after their first sign-in. Removing a member from your identity provider’s SSO application prevents them from signing in through SSO; however, you should also remove them from your organization in Cloud to revoke their access entirely.

​
Disabling SSO

To disable SSO, navigate to your organization’s Settings > General page and remove the connection. Members will no longer be able to authenticate through your identity provider and will need to sign in using their email address and password or another supported login method.
Before disabling SSO, ensure that members of your organization have another way to sign in. Members whose accounts Cloud provisioned through SSO may need to reset their password before they can sign in directly.