Get single SSO connector

client.IAM.SSO.Get(ctx, ssoConnectorID, query) (*SSOGetResponse, error)

GET/accounts/{account_id}/sso_connectors/{sso_connector_id}

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

Accepted Permissions (at least one required)

SSO Connector Read

ParametersExpand Collapse

ssoConnectorID string

SSO Connector identifier tag.

maxLength32

minLength32

query SSOGetParams

AccountID param.Field[string]

Account identifier tag.

maxLength32

minLength32

ReturnsExpand Collapse

type SSOGetResponse struct{…}

ID stringoptional

SSO Connector identifier tag.

maxLength32

minLength32

CreatedOn Timeoptional

Timestamp for the creation of the SSO connector

formatdate-time

EmailDomain stringoptional

Enabled booloptional

UpdatedOn Timeoptional

Timestamp for the last update of the SSO connector

formatdate-time

UseFedrampLanguage booloptional

Controls the display of FedRAMP language to the user during SSO login

Verification SSOGetResponseVerificationoptional

Code stringoptional

DNS verification code. Add this entire string to the DNS TXT record of the email domain to validate ownership.

Status SSOGetResponseVerificationStatusoptional

The status of the verification code from the verification process.

One of the following:

const SSOGetResponseVerificationStatusAwaiting SSOGetResponseVerificationStatus = "awaiting"

const SSOGetResponseVerificationStatusPending SSOGetResponseVerificationStatus = "pending"

const SSOGetResponseVerificationStatusFailed SSOGetResponseVerificationStatus = "failed"

const SSOGetResponseVerificationStatusVerified SSOGetResponseVerificationStatus = "verified"

Get single SSO connector

package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/iam"
  "github.com/cloudflare/cloudflare-go/option"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  sso, err := client.IAM.SSO.Get(
    context.TODO(),
    "023e105f4ecef8ad9ca31a8372d0c353",
    iam.SSOGetParams{
      AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", sso.ID)
}

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "id": "023e105f4ecef8ad9ca31a8372d0c353",
    "created_on": "2025-01-01T12:21:02.0000Z",
    "email_domain": "example.com",
    "enabled": false,
    "updated_on": "2025-01-01T12:21:02.0000Z",
    "use_fedramp_language": false,
    "verification": {
      "code": "cloudflare_dashboard_sso=023e105f4ecef8ad9ca31a8372d0c353",
      "status": "pending"
    }
  }
}

Returns Examples

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "id": "023e105f4ecef8ad9ca31a8372d0c353",
    "created_on": "2025-01-01T12:21:02.0000Z",
    "email_domain": "example.com",
    "enabled": false,
    "updated_on": "2025-01-01T12:21:02.0000Z",
    "use_fedramp_language": false,
    "verification": {
      "code": "cloudflare_dashboard_sso=023e105f4ecef8ad9ca31a8372d0c353",
      "status": "pending"
    }
  }
}