chore(backend): Introduce SAML connections per org (#4792)

Co-authored-by: Izaak Lauer <[email protected]>

.changeset/kind-crews-hear.md

@@ -0,0 +1,7 @@
+---
+'@clerk/backend': patch
+---
+
+Allow to create and update SAML connections with organization IDs.
+
+When users sign in or up using an organization's SAML connection, they're automatically added as members of that organization. For more information, refer to our docs: https://clerk.com/docs/organizations/manage-sso

packages/backend/src/api/endpoints/SamlConnectionApi.ts

@@ -14,6 +14,7 @@ type CreateSamlConnectionParams = {
   name: string;
   provider: SamlIdpSlug;
   domain: string;
+  organizationId?: string;
   idpEntityId?: string;
   idpSsoUrl?: string;
   idpCertificate?: string;
@@ -31,6 +32,7 @@ type UpdateSamlConnectionParams = {
   name?: string;
   provider?: SamlIdpSlug;
   domain?: string;
+  organizationId?: string;
   idpEntityId?: string;
   idpSsoUrl?: string;
   idpCertificate?: string;

packages/backend/src/api/resources/JSON.ts

@@ -360,6 +360,7 @@ export interface PaginatedResponseJSON {
 export interface SamlConnectionJSON extends ClerkResourceJSON {
   name: string;
   domain: string;
+  organization_id: string | null;
   idp_entity_id: string;
   idp_sso_url: string;
   idp_certificate: string;

packages/backend/src/api/resources/SamlConnection.ts

@@ -5,6 +5,7 @@ export class SamlConnection {
     readonly id: string,
     readonly name: string,
     readonly domain: string,
+    readonly organizationId: string | null,
     readonly idpEntityId: string | null,
     readonly idpSsoUrl: string | null,
     readonly idpCertificate: string | null,
@@ -28,6 +29,7 @@ export class SamlConnection {
       data.id,
       data.name,
       data.domain,
+      data.organization_id,
       data.idp_entity_id,
       data.idp_sso_url,
       data.idp_certificate,