SSO connections

Use the connection client to configure enterprise SSO (SAML/OIDC) for an organization.

Enable SSO after the organization exists: create a connection, complete IdP setup, and test sign-in for that org.

CreateConnection

clientConnectionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/connection.go

#asyncCreateConnection

Runs CreateConnection and returns the result.

paramctxcontext.Context

Request context

paramorganizationIdstring

Organization ID.

paramconnectionconnectionsv1.CreateConnection

Connection.

returnsCreateConnectionResponse

The created resource.

import (
  connectionsv1 "github.com/scalekit-inc/scalekit-sdk-go/v2/pkg/grpc/scalekit/v1/connections"
)

created, err := scalekitClient.Connection().CreateConnection(ctx, "org_123", &connectionsv1.CreateConnection{
  Provider:    connectionsv1.ConnectionProvider_OKTA,
  Type:        connectionsv1.ConnectionType_SAML,
  ProviderKey: "my-okta-connection",
})
if err != nil {
  // handle
}
_ = created.Connection

DeleteConnection

clientConnectionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/connection.go

#asyncDeleteConnection

Runs DeleteConnection and returns the result.

paramctxcontext.Context

Request context

paramorganizationIdstring

Organization ID.

paramidstring

Resource ID.

returnserror

error

if err := scalekitClient.Connection().DeleteConnection(ctx, "org_123", "conn_456"); err != nil {
  // handle
}

GetConnection

clientConnectionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/connection.go

#asyncGetConnection

Runs GetConnection and returns the result.

paramctxcontext.Context

Request context

paramorganizationIdstring

Organization ID.

paramidstring

Resource ID.

returnsGetConnectionResponse

The response payload for this operation.

conn, err := scalekitClient.Connection().GetConnection(ctx, "org_123", "conn_123")
if err != nil {
  // handle
}
_ = conn.Connection

ListConnectionsByDomain

clientConnectionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/connection.go

#asyncListConnectionsByDomain

Runs ListConnectionsByDomain and returns the result.

paramctxcontext.Context

Request context

paramdomainstring

Domain name.

returnsListConnectionsResponse

Paginated connections.

conns, err := scalekitClient.Connection().ListConnectionsByDomain(ctx, "acme.com")
if err != nil {
  // handle
}
_ = conns.Connections

ListConnections

clientConnectionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/connection.go

#asyncListConnections

Runs ListConnections and returns the result.

paramctxcontext.Context

Request context

paramorganizationIdstring

Organization ID.

returnsListConnectionsResponse

Paginated connections.

conns, err := scalekitClient.Connection().ListConnections(ctx, "org_123")
if err != nil {
  // handle
}
_ = conns.Connections

EnableConnection

clientConnectionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/connection.go

#asyncEnableConnection

Runs EnableConnection and returns the result.

paramctxcontext.Context

Request context

paramorganizationIdstring

Organization ID.

paramidstring

Resource ID.

returnsToggleConnectionResponse

The updated resource.

resp, err := scalekitClient.Connection().EnableConnection(ctx, "org_123", "conn_123")
if err != nil {
  // handle
}
_ = resp.Enabled

DisableConnection

clientConnectionshttps://github.com/scalekit-inc/scalekit-sdk-go/blob/main/connection.go

#asyncDisableConnection

Runs DisableConnection and returns the result.

paramctxcontext.Context

Request context

paramorganizationIdstring

Organization ID.

paramidstring

Resource ID.

returnsToggleConnectionResponse

The updated resource.

resp, err := scalekitClient.Connection().DisableConnection(ctx, "org_123", "conn_123")
if err != nil {
  // handle
}
_ = resp.Enabled