1. Registry
  2. Packages
  3. Descope Provider
  4. API Docs
  5. OidcApp
Viewing docs for Descope v1.0.1
published on Sunday, Oct 11, 2026 by Descope
descope logo Descope
Viewing docs for Descope v1.0.1
published on Sunday, Oct 11, 2026 by Descope

    Manages a single OIDC federated application where Descope acts as the identity provider.

    Create OidcApp Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new OidcApp(name: string, args: OidcAppArgs, opts?: CustomResourceOptions);
    @overload
    def OidcApp(resource_name: str,
                args: OidcAppArgs,
                opts: Optional[ResourceOptions] = None)
    
    @overload
    def OidcApp(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                project_id: Optional[str] = None,
                device_code_disabled: Optional[bool] = None,
                default_audience: Optional[str] = None,
                claims: Optional[Sequence[str]] = None,
                client_credentials_disabled: Optional[bool] = None,
                client_id: Optional[str] = None,
                client_secret: Optional[str] = None,
                client_type: Optional[str] = None,
                disabled: Optional[bool] = None,
                approved_redirect_urls: Optional[Sequence[str]] = None,
                deletion_protection: Optional[bool] = None,
                backchannel_logout_url: Optional[str] = None,
                description: Optional[str] = None,
                custom_idp_initiated_login_page_url: Optional[str] = None,
                force_authentication: Optional[bool] = None,
                force_pkce: Optional[bool] = None,
                jwt_bearer_disabled: Optional[bool] = None,
                login_page_url: Optional[str] = None,
                logo: Optional[str] = None,
                name: Optional[str] = None,
                oidc_app_id: Optional[str] = None,
                authorization_code_disabled: Optional[bool] = None,
                refresh_token_disabled: Optional[bool] = None,
                trusted_apps_audience: Optional[str] = None)
    func NewOidcApp(ctx *Context, name string, args OidcAppArgs, opts ...ResourceOption) (*OidcApp, error)
    public OidcApp(string name, OidcAppArgs args, CustomResourceOptions? opts = null)
    public OidcApp(String name, OidcAppArgs args)
    public OidcApp(String name, OidcAppArgs args, CustomResourceOptions options)
    
    type: descope:OidcApp
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "descope_oidc_app" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args OidcAppArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args OidcAppArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args OidcAppArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args OidcAppArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args OidcAppArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var oidcAppResource = new Descope.OidcApp("oidcAppResource", new()
    {
        ProjectId = "string",
        DeviceCodeDisabled = false,
        DefaultAudience = "string",
        Claims = new[]
        {
            "string",
        },
        ClientCredentialsDisabled = false,
        ClientId = "string",
        ClientSecret = "string",
        ClientType = "string",
        Disabled = false,
        ApprovedRedirectUrls = new[]
        {
            "string",
        },
        DeletionProtection = false,
        BackchannelLogoutUrl = "string",
        Description = "string",
        CustomIdpInitiatedLoginPageUrl = "string",
        ForceAuthentication = false,
        ForcePkce = false,
        JwtBearerDisabled = false,
        LoginPageUrl = "string",
        Logo = "string",
        Name = "string",
        OidcAppId = "string",
        AuthorizationCodeDisabled = false,
        RefreshTokenDisabled = false,
        TrustedAppsAudience = "string",
    });
    
    example, err := descope.NewOidcApp(ctx, "oidcAppResource", &descope.OidcAppArgs{
    	ProjectId:          pulumi.String("string"),
    	DeviceCodeDisabled: pulumi.Bool(false),
    	DefaultAudience:    pulumi.String("string"),
    	Claims: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	ClientCredentialsDisabled: pulumi.Bool(false),
    	ClientId:                  pulumi.String("string"),
    	ClientSecret:              pulumi.String("string"),
    	ClientType:                pulumi.String("string"),
    	Disabled:                  pulumi.Bool(false),
    	ApprovedRedirectUrls: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	DeletionProtection:             pulumi.Bool(false),
    	BackchannelLogoutUrl:           pulumi.String("string"),
    	Description:                    pulumi.String("string"),
    	CustomIdpInitiatedLoginPageUrl: pulumi.String("string"),
    	ForceAuthentication:            pulumi.Bool(false),
    	ForcePkce:                      pulumi.Bool(false),
    	JwtBearerDisabled:              pulumi.Bool(false),
    	LoginPageUrl:                   pulumi.String("string"),
    	Logo:                           pulumi.String("string"),
    	Name:                           pulumi.String("string"),
    	OidcAppId:                      pulumi.String("string"),
    	AuthorizationCodeDisabled:      pulumi.Bool(false),
    	RefreshTokenDisabled:           pulumi.Bool(false),
    	TrustedAppsAudience:            pulumi.String("string"),
    })
    
    resource "descope_oidc_app" "oidcAppResource" {
      lifecycle {
        create_before_destroy = true
      }
      project_id                          = "string"
      device_code_disabled                = false
      default_audience                    = "string"
      claims                              = ["string"]
      client_credentials_disabled         = false
      client_id                           = "string"
      client_secret                       = "string"
      client_type                         = "string"
      disabled                            = false
      approved_redirect_urls              = ["string"]
      deletion_protection                 = false
      backchannel_logout_url              = "string"
      description                         = "string"
      custom_idp_initiated_login_page_url = "string"
      force_authentication                = false
      force_pkce                          = false
      jwt_bearer_disabled                 = false
      login_page_url                      = "string"
      logo                                = "string"
      name                                = "string"
      oidc_app_id                         = "string"
      authorization_code_disabled         = false
      refresh_token_disabled              = false
      trusted_apps_audience               = "string"
    }
    
    var oidcAppResource = new OidcApp("oidcAppResource", OidcAppArgs.builder()
        .projectId("string")
        .deviceCodeDisabled(false)
        .defaultAudience("string")
        .claims("string")
        .clientCredentialsDisabled(false)
        .clientId("string")
        .clientSecret("string")
        .clientType("string")
        .disabled(false)
        .approvedRedirectUrls("string")
        .deletionProtection(false)
        .backchannelLogoutUrl("string")
        .description("string")
        .customIdpInitiatedLoginPageUrl("string")
        .forceAuthentication(false)
        .forcePkce(false)
        .jwtBearerDisabled(false)
        .loginPageUrl("string")
        .logo("string")
        .name("string")
        .oidcAppId("string")
        .authorizationCodeDisabled(false)
        .refreshTokenDisabled(false)
        .trustedAppsAudience("string")
        .build());
    
    oidc_app_resource = descope.OidcApp("oidcAppResource",
        project_id="string",
        device_code_disabled=False,
        default_audience="string",
        claims=["string"],
        client_credentials_disabled=False,
        client_id="string",
        client_secret="string",
        client_type="string",
        disabled=False,
        approved_redirect_urls=["string"],
        deletion_protection=False,
        backchannel_logout_url="string",
        description="string",
        custom_idp_initiated_login_page_url="string",
        force_authentication=False,
        force_pkce=False,
        jwt_bearer_disabled=False,
        login_page_url="string",
        logo="string",
        name="string",
        oidc_app_id="string",
        authorization_code_disabled=False,
        refresh_token_disabled=False,
        trusted_apps_audience="string")
    
    const oidcAppResource = new descope.OidcApp("oidcAppResource", {
        projectId: "string",
        deviceCodeDisabled: false,
        defaultAudience: "string",
        claims: ["string"],
        clientCredentialsDisabled: false,
        clientId: "string",
        clientSecret: "string",
        clientType: "string",
        disabled: false,
        approvedRedirectUrls: ["string"],
        deletionProtection: false,
        backchannelLogoutUrl: "string",
        description: "string",
        customIdpInitiatedLoginPageUrl: "string",
        forceAuthentication: false,
        forcePkce: false,
        jwtBearerDisabled: false,
        loginPageUrl: "string",
        logo: "string",
        name: "string",
        oidcAppId: "string",
        authorizationCodeDisabled: false,
        refreshTokenDisabled: false,
        trustedAppsAudience: "string",
    });
    
    type: descope:OidcApp
    properties:
        approvedRedirectUrls:
            - string
        authorizationCodeDisabled: false
        backchannelLogoutUrl: string
        claims:
            - string
        clientCredentialsDisabled: false
        clientId: string
        clientSecret: string
        clientType: string
        customIdpInitiatedLoginPageUrl: string
        defaultAudience: string
        deletionProtection: false
        description: string
        deviceCodeDisabled: false
        disabled: false
        forceAuthentication: false
        forcePkce: false
        jwtBearerDisabled: false
        loginPageUrl: string
        logo: string
        name: string
        oidcAppId: string
        projectId: string
        refreshTokenDisabled: false
        trustedAppsAudience: string
    

    OidcApp Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The OidcApp resource accepts the following input properties:

    ProjectId string
    The ID of the project that this application belongs to. Changing this value will require the resource to be deleted and recreated.
    ApprovedRedirectUrls List<string>
    A list of approved redirect URLs for this application (supports * wildcards). When set, redirect URIs are validated against this per-app list; when empty, validation falls back to the project's approved/trusted domains.
    AuthorizationCodeDisabled bool
    Disables the authorizationCode grant type for this application.
    BackchannelLogoutUrl string
    The URL that Descope notifies with a logout token when the user's session ends, as per the OIDC Back-Channel Logout specification. Leave empty to disable back-channel logout notifications for this application.
    Claims List<string>
    A list of supported claims. e.g. sub, email, exp.
    ClientCredentialsDisabled bool
    Disables the clientCredentials grant type for this application.
    ClientId string
    A dedicated OIDC clientId to import for this application. When omitted, the clientId is generated by the server and is not returned on reads. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    ClientSecret string
    A dedicated OIDC clientSecret to import for this application. When omitted, a secret is generated server-side only for applications with a confidential client type, either on creation or when the application is later switched to confidential, and fetched into the Terraform state. Applications with other client types don't use a client secret and the value stays empty. The value in the state is never overwritten afterwards, so a secret rotated via the API or the Descope console is not reflected until the resource is replaced. Changing this value will require the resource to be deleted and recreated.
    ClientType string
    OAuth client confidentiality. One of "" (default — legacy access-key authentication), "confidential" (a dedicated client secret is generated for the app), or "public" (PKCE only, no client secret). Changing this value on an existing application changes how its clients must authenticate, so coordinate the change with the application's developers.
    CustomIdpInitiatedLoginPageUrl string
    A custom login page URL to redirect users to on IdP-initiated login flows, instead of the default login page.
    DefaultAudience string
    Controls the default aud claim of tokens issued for this application. One of "projectId" (the project ID only), "clientId" (the dedicated client ID only), "appId" (the application ID only), "empty" (no aud claim at all), or "" (default — both the project ID and the client ID). Only applies to modern apps that set a clientType; legacy apps always use the project ID, so the empty default leaves their behavior unchanged.
    DeletionProtection bool
    Protects the application from being accidentally destroyed or replaced. Destroying or replacing a federated application breaks the service provider's configured integration and invalidates its client credentials, so these applications are protected by default. To allow the resource to be destroyed or replaced, for example in ephemeral test environments, set this attribute to false and apply the change first.
    Description string
    A description for the OIDC application.
    DeviceCodeDisabled bool
    Disables the urn:ietf:params:oauth:grant-type:device_code grant type for this application.
    Disabled bool
    Whether the application should be enabled or disabled.
    ForceAuthentication bool
    This configuration overrides the default behavior of the SSO application and forces the user to authenticate via the Descope flow, regardless of the SP's request.
    ForcePkce bool
    When enabled, the authorization code flow requires PKCE in addition to the normal client authentication. A confidential client must then present both its client secret and a valid PKCE codeVerifier. Public clients always use PKCE regardless of this setting.
    JwtBearerDisabled bool
    Disables the urn:ietf:params:oauth:grant-type:jwt-bearer grant type for this application.
    LoginPageUrl string
    The Flow Hosting URL. When left empty the project's default login page URL is used, and the computed value is reflected in this attribute. Read more about using this parameter with custom domain here.
    Logo string
    A logo for the OIDC application. Should be a hosted image URL.
    Name string
    A name for the OIDC application.
    OidcAppId string
    An optional identifier for the application. When omitted, an identifier is generated by the server. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    RefreshTokenDisabled bool
    Disables the refreshToken grant type for this application.
    TrustedAppsAudience string
    Controls the audience values appended to the issued token's aud claim for trusted sibling applications. One of "projectId", "clientId", "appId", "empty" (add none), or "" (default — both the project ID and the client ID). Independent of defaultAudience.
    ProjectId string
    The ID of the project that this application belongs to. Changing this value will require the resource to be deleted and recreated.
    ApprovedRedirectUrls []string
    A list of approved redirect URLs for this application (supports * wildcards). When set, redirect URIs are validated against this per-app list; when empty, validation falls back to the project's approved/trusted domains.
    AuthorizationCodeDisabled bool
    Disables the authorizationCode grant type for this application.
    BackchannelLogoutUrl string
    The URL that Descope notifies with a logout token when the user's session ends, as per the OIDC Back-Channel Logout specification. Leave empty to disable back-channel logout notifications for this application.
    Claims []string
    A list of supported claims. e.g. sub, email, exp.
    ClientCredentialsDisabled bool
    Disables the clientCredentials grant type for this application.
    ClientId string
    A dedicated OIDC clientId to import for this application. When omitted, the clientId is generated by the server and is not returned on reads. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    ClientSecret string
    A dedicated OIDC clientSecret to import for this application. When omitted, a secret is generated server-side only for applications with a confidential client type, either on creation or when the application is later switched to confidential, and fetched into the Terraform state. Applications with other client types don't use a client secret and the value stays empty. The value in the state is never overwritten afterwards, so a secret rotated via the API or the Descope console is not reflected until the resource is replaced. Changing this value will require the resource to be deleted and recreated.
    ClientType string
    OAuth client confidentiality. One of "" (default — legacy access-key authentication), "confidential" (a dedicated client secret is generated for the app), or "public" (PKCE only, no client secret). Changing this value on an existing application changes how its clients must authenticate, so coordinate the change with the application's developers.
    CustomIdpInitiatedLoginPageUrl string
    A custom login page URL to redirect users to on IdP-initiated login flows, instead of the default login page.
    DefaultAudience string
    Controls the default aud claim of tokens issued for this application. One of "projectId" (the project ID only), "clientId" (the dedicated client ID only), "appId" (the application ID only), "empty" (no aud claim at all), or "" (default — both the project ID and the client ID). Only applies to modern apps that set a clientType; legacy apps always use the project ID, so the empty default leaves their behavior unchanged.
    DeletionProtection bool
    Protects the application from being accidentally destroyed or replaced. Destroying or replacing a federated application breaks the service provider's configured integration and invalidates its client credentials, so these applications are protected by default. To allow the resource to be destroyed or replaced, for example in ephemeral test environments, set this attribute to false and apply the change first.
    Description string
    A description for the OIDC application.
    DeviceCodeDisabled bool
    Disables the urn:ietf:params:oauth:grant-type:device_code grant type for this application.
    Disabled bool
    Whether the application should be enabled or disabled.
    ForceAuthentication bool
    This configuration overrides the default behavior of the SSO application and forces the user to authenticate via the Descope flow, regardless of the SP's request.
    ForcePkce bool
    When enabled, the authorization code flow requires PKCE in addition to the normal client authentication. A confidential client must then present both its client secret and a valid PKCE codeVerifier. Public clients always use PKCE regardless of this setting.
    JwtBearerDisabled bool
    Disables the urn:ietf:params:oauth:grant-type:jwt-bearer grant type for this application.
    LoginPageUrl string
    The Flow Hosting URL. When left empty the project's default login page URL is used, and the computed value is reflected in this attribute. Read more about using this parameter with custom domain here.
    Logo string
    A logo for the OIDC application. Should be a hosted image URL.
    Name string
    A name for the OIDC application.
    OidcAppId string
    An optional identifier for the application. When omitted, an identifier is generated by the server. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    RefreshTokenDisabled bool
    Disables the refreshToken grant type for this application.
    TrustedAppsAudience string
    Controls the audience values appended to the issued token's aud claim for trusted sibling applications. One of "projectId", "clientId", "appId", "empty" (add none), or "" (default — both the project ID and the client ID). Independent of defaultAudience.
    project_id string
    The ID of the project that this application belongs to. Changing this value will require the resource to be deleted and recreated.
    approved_redirect_urls list(string)
    A list of approved redirect URLs for this application (supports * wildcards). When set, redirect URIs are validated against this per-app list; when empty, validation falls back to the project's approved/trusted domains.
    authorization_code_disabled bool
    Disables the authorizationCode grant type for this application.
    backchannel_logout_url string
    The URL that Descope notifies with a logout token when the user's session ends, as per the OIDC Back-Channel Logout specification. Leave empty to disable back-channel logout notifications for this application.
    claims list(string)
    A list of supported claims. e.g. sub, email, exp.
    client_credentials_disabled bool
    Disables the clientCredentials grant type for this application.
    client_id string
    A dedicated OIDC clientId to import for this application. When omitted, the clientId is generated by the server and is not returned on reads. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    client_secret string
    A dedicated OIDC clientSecret to import for this application. When omitted, a secret is generated server-side only for applications with a confidential client type, either on creation or when the application is later switched to confidential, and fetched into the Terraform state. Applications with other client types don't use a client secret and the value stays empty. The value in the state is never overwritten afterwards, so a secret rotated via the API or the Descope console is not reflected until the resource is replaced. Changing this value will require the resource to be deleted and recreated.
    client_type string
    OAuth client confidentiality. One of "" (default — legacy access-key authentication), "confidential" (a dedicated client secret is generated for the app), or "public" (PKCE only, no client secret). Changing this value on an existing application changes how its clients must authenticate, so coordinate the change with the application's developers.
    custom_idp_initiated_login_page_url string
    A custom login page URL to redirect users to on IdP-initiated login flows, instead of the default login page.
    default_audience string
    Controls the default aud claim of tokens issued for this application. One of "projectId" (the project ID only), "clientId" (the dedicated client ID only), "appId" (the application ID only), "empty" (no aud claim at all), or "" (default — both the project ID and the client ID). Only applies to modern apps that set a clientType; legacy apps always use the project ID, so the empty default leaves their behavior unchanged.
    deletion_protection bool
    Protects the application from being accidentally destroyed or replaced. Destroying or replacing a federated application breaks the service provider's configured integration and invalidates its client credentials, so these applications are protected by default. To allow the resource to be destroyed or replaced, for example in ephemeral test environments, set this attribute to false and apply the change first.
    description string
    A description for the OIDC application.
    device_code_disabled bool
    Disables the urn:ietf:params:oauth:grant-type:device_code grant type for this application.
    disabled bool
    Whether the application should be enabled or disabled.
    force_authentication bool
    This configuration overrides the default behavior of the SSO application and forces the user to authenticate via the Descope flow, regardless of the SP's request.
    force_pkce bool
    When enabled, the authorization code flow requires PKCE in addition to the normal client authentication. A confidential client must then present both its client secret and a valid PKCE codeVerifier. Public clients always use PKCE regardless of this setting.
    jwt_bearer_disabled bool
    Disables the urn:ietf:params:oauth:grant-type:jwt-bearer grant type for this application.
    login_page_url string
    The Flow Hosting URL. When left empty the project's default login page URL is used, and the computed value is reflected in this attribute. Read more about using this parameter with custom domain here.
    logo string
    A logo for the OIDC application. Should be a hosted image URL.
    name string
    A name for the OIDC application.
    oidc_app_id string
    An optional identifier for the application. When omitted, an identifier is generated by the server. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    refresh_token_disabled bool
    Disables the refreshToken grant type for this application.
    trusted_apps_audience string
    Controls the audience values appended to the issued token's aud claim for trusted sibling applications. One of "projectId", "clientId", "appId", "empty" (add none), or "" (default — both the project ID and the client ID). Independent of defaultAudience.
    projectId String
    The ID of the project that this application belongs to. Changing this value will require the resource to be deleted and recreated.
    approvedRedirectUrls List<String>
    A list of approved redirect URLs for this application (supports * wildcards). When set, redirect URIs are validated against this per-app list; when empty, validation falls back to the project's approved/trusted domains.
    authorizationCodeDisabled Boolean
    Disables the authorizationCode grant type for this application.
    backchannelLogoutUrl String
    The URL that Descope notifies with a logout token when the user's session ends, as per the OIDC Back-Channel Logout specification. Leave empty to disable back-channel logout notifications for this application.
    claims List<String>
    A list of supported claims. e.g. sub, email, exp.
    clientCredentialsDisabled Boolean
    Disables the clientCredentials grant type for this application.
    clientId String
    A dedicated OIDC clientId to import for this application. When omitted, the clientId is generated by the server and is not returned on reads. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    clientSecret String
    A dedicated OIDC clientSecret to import for this application. When omitted, a secret is generated server-side only for applications with a confidential client type, either on creation or when the application is later switched to confidential, and fetched into the Terraform state. Applications with other client types don't use a client secret and the value stays empty. The value in the state is never overwritten afterwards, so a secret rotated via the API or the Descope console is not reflected until the resource is replaced. Changing this value will require the resource to be deleted and recreated.
    clientType String
    OAuth client confidentiality. One of "" (default — legacy access-key authentication), "confidential" (a dedicated client secret is generated for the app), or "public" (PKCE only, no client secret). Changing this value on an existing application changes how its clients must authenticate, so coordinate the change with the application's developers.
    customIdpInitiatedLoginPageUrl String
    A custom login page URL to redirect users to on IdP-initiated login flows, instead of the default login page.
    defaultAudience String
    Controls the default aud claim of tokens issued for this application. One of "projectId" (the project ID only), "clientId" (the dedicated client ID only), "appId" (the application ID only), "empty" (no aud claim at all), or "" (default — both the project ID and the client ID). Only applies to modern apps that set a clientType; legacy apps always use the project ID, so the empty default leaves their behavior unchanged.
    deletionProtection Boolean
    Protects the application from being accidentally destroyed or replaced. Destroying or replacing a federated application breaks the service provider's configured integration and invalidates its client credentials, so these applications are protected by default. To allow the resource to be destroyed or replaced, for example in ephemeral test environments, set this attribute to false and apply the change first.
    description String
    A description for the OIDC application.
    deviceCodeDisabled Boolean
    Disables the urn:ietf:params:oauth:grant-type:device_code grant type for this application.
    disabled Boolean
    Whether the application should be enabled or disabled.
    forceAuthentication Boolean
    This configuration overrides the default behavior of the SSO application and forces the user to authenticate via the Descope flow, regardless of the SP's request.
    forcePkce Boolean
    When enabled, the authorization code flow requires PKCE in addition to the normal client authentication. A confidential client must then present both its client secret and a valid PKCE codeVerifier. Public clients always use PKCE regardless of this setting.
    jwtBearerDisabled Boolean
    Disables the urn:ietf:params:oauth:grant-type:jwt-bearer grant type for this application.
    loginPageUrl String
    The Flow Hosting URL. When left empty the project's default login page URL is used, and the computed value is reflected in this attribute. Read more about using this parameter with custom domain here.
    logo String
    A logo for the OIDC application. Should be a hosted image URL.
    name String
    A name for the OIDC application.
    oidcAppId String
    An optional identifier for the application. When omitted, an identifier is generated by the server. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    refreshTokenDisabled Boolean
    Disables the refreshToken grant type for this application.
    trustedAppsAudience String
    Controls the audience values appended to the issued token's aud claim for trusted sibling applications. One of "projectId", "clientId", "appId", "empty" (add none), or "" (default — both the project ID and the client ID). Independent of defaultAudience.
    projectId string
    The ID of the project that this application belongs to. Changing this value will require the resource to be deleted and recreated.
    approvedRedirectUrls string[]
    A list of approved redirect URLs for this application (supports * wildcards). When set, redirect URIs are validated against this per-app list; when empty, validation falls back to the project's approved/trusted domains.
    authorizationCodeDisabled boolean
    Disables the authorizationCode grant type for this application.
    backchannelLogoutUrl string
    The URL that Descope notifies with a logout token when the user's session ends, as per the OIDC Back-Channel Logout specification. Leave empty to disable back-channel logout notifications for this application.
    claims string[]
    A list of supported claims. e.g. sub, email, exp.
    clientCredentialsDisabled boolean
    Disables the clientCredentials grant type for this application.
    clientId string
    A dedicated OIDC clientId to import for this application. When omitted, the clientId is generated by the server and is not returned on reads. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    clientSecret string
    A dedicated OIDC clientSecret to import for this application. When omitted, a secret is generated server-side only for applications with a confidential client type, either on creation or when the application is later switched to confidential, and fetched into the Terraform state. Applications with other client types don't use a client secret and the value stays empty. The value in the state is never overwritten afterwards, so a secret rotated via the API or the Descope console is not reflected until the resource is replaced. Changing this value will require the resource to be deleted and recreated.
    clientType string
    OAuth client confidentiality. One of "" (default — legacy access-key authentication), "confidential" (a dedicated client secret is generated for the app), or "public" (PKCE only, no client secret). Changing this value on an existing application changes how its clients must authenticate, so coordinate the change with the application's developers.
    customIdpInitiatedLoginPageUrl string
    A custom login page URL to redirect users to on IdP-initiated login flows, instead of the default login page.
    defaultAudience string
    Controls the default aud claim of tokens issued for this application. One of "projectId" (the project ID only), "clientId" (the dedicated client ID only), "appId" (the application ID only), "empty" (no aud claim at all), or "" (default — both the project ID and the client ID). Only applies to modern apps that set a clientType; legacy apps always use the project ID, so the empty default leaves their behavior unchanged.
    deletionProtection boolean
    Protects the application from being accidentally destroyed or replaced. Destroying or replacing a federated application breaks the service provider's configured integration and invalidates its client credentials, so these applications are protected by default. To allow the resource to be destroyed or replaced, for example in ephemeral test environments, set this attribute to false and apply the change first.
    description string
    A description for the OIDC application.
    deviceCodeDisabled boolean
    Disables the urn:ietf:params:oauth:grant-type:device_code grant type for this application.
    disabled boolean
    Whether the application should be enabled or disabled.
    forceAuthentication boolean
    This configuration overrides the default behavior of the SSO application and forces the user to authenticate via the Descope flow, regardless of the SP's request.
    forcePkce boolean
    When enabled, the authorization code flow requires PKCE in addition to the normal client authentication. A confidential client must then present both its client secret and a valid PKCE codeVerifier. Public clients always use PKCE regardless of this setting.
    jwtBearerDisabled boolean
    Disables the urn:ietf:params:oauth:grant-type:jwt-bearer grant type for this application.
    loginPageUrl string
    The Flow Hosting URL. When left empty the project's default login page URL is used, and the computed value is reflected in this attribute. Read more about using this parameter with custom domain here.
    logo string
    A logo for the OIDC application. Should be a hosted image URL.
    name string
    A name for the OIDC application.
    oidcAppId string
    An optional identifier for the application. When omitted, an identifier is generated by the server. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    refreshTokenDisabled boolean
    Disables the refreshToken grant type for this application.
    trustedAppsAudience string
    Controls the audience values appended to the issued token's aud claim for trusted sibling applications. One of "projectId", "clientId", "appId", "empty" (add none), or "" (default — both the project ID and the client ID). Independent of defaultAudience.
    project_id str
    The ID of the project that this application belongs to. Changing this value will require the resource to be deleted and recreated.
    approved_redirect_urls Sequence[str]
    A list of approved redirect URLs for this application (supports * wildcards). When set, redirect URIs are validated against this per-app list; when empty, validation falls back to the project's approved/trusted domains.
    authorization_code_disabled bool
    Disables the authorizationCode grant type for this application.
    backchannel_logout_url str
    The URL that Descope notifies with a logout token when the user's session ends, as per the OIDC Back-Channel Logout specification. Leave empty to disable back-channel logout notifications for this application.
    claims Sequence[str]
    A list of supported claims. e.g. sub, email, exp.
    client_credentials_disabled bool
    Disables the clientCredentials grant type for this application.
    client_id str
    A dedicated OIDC clientId to import for this application. When omitted, the clientId is generated by the server and is not returned on reads. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    client_secret str
    A dedicated OIDC clientSecret to import for this application. When omitted, a secret is generated server-side only for applications with a confidential client type, either on creation or when the application is later switched to confidential, and fetched into the Terraform state. Applications with other client types don't use a client secret and the value stays empty. The value in the state is never overwritten afterwards, so a secret rotated via the API or the Descope console is not reflected until the resource is replaced. Changing this value will require the resource to be deleted and recreated.
    client_type str
    OAuth client confidentiality. One of "" (default — legacy access-key authentication), "confidential" (a dedicated client secret is generated for the app), or "public" (PKCE only, no client secret). Changing this value on an existing application changes how its clients must authenticate, so coordinate the change with the application's developers.
    custom_idp_initiated_login_page_url str
    A custom login page URL to redirect users to on IdP-initiated login flows, instead of the default login page.
    default_audience str
    Controls the default aud claim of tokens issued for this application. One of "projectId" (the project ID only), "clientId" (the dedicated client ID only), "appId" (the application ID only), "empty" (no aud claim at all), or "" (default — both the project ID and the client ID). Only applies to modern apps that set a clientType; legacy apps always use the project ID, so the empty default leaves their behavior unchanged.
    deletion_protection bool
    Protects the application from being accidentally destroyed or replaced. Destroying or replacing a federated application breaks the service provider's configured integration and invalidates its client credentials, so these applications are protected by default. To allow the resource to be destroyed or replaced, for example in ephemeral test environments, set this attribute to false and apply the change first.
    description str
    A description for the OIDC application.
    device_code_disabled bool
    Disables the urn:ietf:params:oauth:grant-type:device_code grant type for this application.
    disabled bool
    Whether the application should be enabled or disabled.
    force_authentication bool
    This configuration overrides the default behavior of the SSO application and forces the user to authenticate via the Descope flow, regardless of the SP's request.
    force_pkce bool
    When enabled, the authorization code flow requires PKCE in addition to the normal client authentication. A confidential client must then present both its client secret and a valid PKCE codeVerifier. Public clients always use PKCE regardless of this setting.
    jwt_bearer_disabled bool
    Disables the urn:ietf:params:oauth:grant-type:jwt-bearer grant type for this application.
    login_page_url str
    The Flow Hosting URL. When left empty the project's default login page URL is used, and the computed value is reflected in this attribute. Read more about using this parameter with custom domain here.
    logo str
    A logo for the OIDC application. Should be a hosted image URL.
    name str
    A name for the OIDC application.
    oidc_app_id str
    An optional identifier for the application. When omitted, an identifier is generated by the server. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    refresh_token_disabled bool
    Disables the refreshToken grant type for this application.
    trusted_apps_audience str
    Controls the audience values appended to the issued token's aud claim for trusted sibling applications. One of "projectId", "clientId", "appId", "empty" (add none), or "" (default — both the project ID and the client ID). Independent of defaultAudience.
    projectId String
    The ID of the project that this application belongs to. Changing this value will require the resource to be deleted and recreated.
    approvedRedirectUrls List<String>
    A list of approved redirect URLs for this application (supports * wildcards). When set, redirect URIs are validated against this per-app list; when empty, validation falls back to the project's approved/trusted domains.
    authorizationCodeDisabled Boolean
    Disables the authorizationCode grant type for this application.
    backchannelLogoutUrl String
    The URL that Descope notifies with a logout token when the user's session ends, as per the OIDC Back-Channel Logout specification. Leave empty to disable back-channel logout notifications for this application.
    claims List<String>
    A list of supported claims. e.g. sub, email, exp.
    clientCredentialsDisabled Boolean
    Disables the clientCredentials grant type for this application.
    clientId String
    A dedicated OIDC clientId to import for this application. When omitted, the clientId is generated by the server and is not returned on reads. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    clientSecret String
    A dedicated OIDC clientSecret to import for this application. When omitted, a secret is generated server-side only for applications with a confidential client type, either on creation or when the application is later switched to confidential, and fetched into the Terraform state. Applications with other client types don't use a client secret and the value stays empty. The value in the state is never overwritten afterwards, so a secret rotated via the API or the Descope console is not reflected until the resource is replaced. Changing this value will require the resource to be deleted and recreated.
    clientType String
    OAuth client confidentiality. One of "" (default — legacy access-key authentication), "confidential" (a dedicated client secret is generated for the app), or "public" (PKCE only, no client secret). Changing this value on an existing application changes how its clients must authenticate, so coordinate the change with the application's developers.
    customIdpInitiatedLoginPageUrl String
    A custom login page URL to redirect users to on IdP-initiated login flows, instead of the default login page.
    defaultAudience String
    Controls the default aud claim of tokens issued for this application. One of "projectId" (the project ID only), "clientId" (the dedicated client ID only), "appId" (the application ID only), "empty" (no aud claim at all), or "" (default — both the project ID and the client ID). Only applies to modern apps that set a clientType; legacy apps always use the project ID, so the empty default leaves their behavior unchanged.
    deletionProtection Boolean
    Protects the application from being accidentally destroyed or replaced. Destroying or replacing a federated application breaks the service provider's configured integration and invalidates its client credentials, so these applications are protected by default. To allow the resource to be destroyed or replaced, for example in ephemeral test environments, set this attribute to false and apply the change first.
    description String
    A description for the OIDC application.
    deviceCodeDisabled Boolean
    Disables the urn:ietf:params:oauth:grant-type:device_code grant type for this application.
    disabled Boolean
    Whether the application should be enabled or disabled.
    forceAuthentication Boolean
    This configuration overrides the default behavior of the SSO application and forces the user to authenticate via the Descope flow, regardless of the SP's request.
    forcePkce Boolean
    When enabled, the authorization code flow requires PKCE in addition to the normal client authentication. A confidential client must then present both its client secret and a valid PKCE codeVerifier. Public clients always use PKCE regardless of this setting.
    jwtBearerDisabled Boolean
    Disables the urn:ietf:params:oauth:grant-type:jwt-bearer grant type for this application.
    loginPageUrl String
    The Flow Hosting URL. When left empty the project's default login page URL is used, and the computed value is reflected in this attribute. Read more about using this parameter with custom domain here.
    logo String
    A logo for the OIDC application. Should be a hosted image URL.
    name String
    A name for the OIDC application.
    oidcAppId String
    An optional identifier for the application. When omitted, an identifier is generated by the server. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    refreshTokenDisabled Boolean
    Disables the refreshToken grant type for this application.
    trustedAppsAudience String
    Controls the audience values appended to the issued token's aud claim for trusted sibling applications. One of "projectId", "clientId", "appId", "empty" (add none), or "" (default — both the project ID and the client ID). Independent of defaultAudience.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the OidcApp resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing OidcApp Resource

    Get an existing OidcApp resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: OidcAppState, opts?: CustomResourceOptions): OidcApp
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            approved_redirect_urls: Optional[Sequence[str]] = None,
            authorization_code_disabled: Optional[bool] = None,
            backchannel_logout_url: Optional[str] = None,
            claims: Optional[Sequence[str]] = None,
            client_credentials_disabled: Optional[bool] = None,
            client_id: Optional[str] = None,
            client_secret: Optional[str] = None,
            client_type: Optional[str] = None,
            custom_idp_initiated_login_page_url: Optional[str] = None,
            default_audience: Optional[str] = None,
            deletion_protection: Optional[bool] = None,
            description: Optional[str] = None,
            device_code_disabled: Optional[bool] = None,
            disabled: Optional[bool] = None,
            force_authentication: Optional[bool] = None,
            force_pkce: Optional[bool] = None,
            jwt_bearer_disabled: Optional[bool] = None,
            login_page_url: Optional[str] = None,
            logo: Optional[str] = None,
            name: Optional[str] = None,
            oidc_app_id: Optional[str] = None,
            project_id: Optional[str] = None,
            refresh_token_disabled: Optional[bool] = None,
            trusted_apps_audience: Optional[str] = None) -> OidcApp
    func GetOidcApp(ctx *Context, name string, id IDInput, state *OidcAppState, opts ...ResourceOption) (*OidcApp, error)
    public static OidcApp Get(string name, Input<string> id, OidcAppState? state, CustomResourceOptions? opts = null)
    public static OidcApp get(String name, Output<String> id, OidcAppState state, CustomResourceOptions options)
    resources:  existingOidcApp:    type: descope:OidcApp    get:      id: ${id}
    import {
      to = descope_oidc_app.example
      id = "${id}"
    }
    
    name string
    The unique name of the resulting resource.
    id Input<ID>
    The unique provider ID of the resource to look up.
    state OidcAppState
    Known property values the provider needs, along with the ID, to find the resource. Usually not required.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resulting resource.
    id str
    The unique provider ID of the resource to look up.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resulting resource.
    id IDInput
    The unique provider ID of the resource to look up.
    state OidcAppState
    Known property values the provider needs, along with the ID, to find the resource. Usually not required.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resulting resource.
    id Input<string>
    The unique provider ID of the resource to look up.
    state OidcAppState
    Known property values the provider needs, along with the ID, to find the resource. Usually not required.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resulting resource.
    id Output<String>
    The unique provider ID of the resource to look up.
    state OidcAppState
    Known property values the provider needs, along with the ID, to find the resource. Usually not required.
    options CustomResourceOptions
    Bag of options to control resource's behavior.
    The following state arguments are supported:
    ApprovedRedirectUrls List<string>
    A list of approved redirect URLs for this application (supports * wildcards). When set, redirect URIs are validated against this per-app list; when empty, validation falls back to the project's approved/trusted domains.
    AuthorizationCodeDisabled bool
    Disables the authorizationCode grant type for this application.
    BackchannelLogoutUrl string
    The URL that Descope notifies with a logout token when the user's session ends, as per the OIDC Back-Channel Logout specification. Leave empty to disable back-channel logout notifications for this application.
    Claims List<string>
    A list of supported claims. e.g. sub, email, exp.
    ClientCredentialsDisabled bool
    Disables the clientCredentials grant type for this application.
    ClientId string
    A dedicated OIDC clientId to import for this application. When omitted, the clientId is generated by the server and is not returned on reads. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    ClientSecret string
    A dedicated OIDC clientSecret to import for this application. When omitted, a secret is generated server-side only for applications with a confidential client type, either on creation or when the application is later switched to confidential, and fetched into the Terraform state. Applications with other client types don't use a client secret and the value stays empty. The value in the state is never overwritten afterwards, so a secret rotated via the API or the Descope console is not reflected until the resource is replaced. Changing this value will require the resource to be deleted and recreated.
    ClientType string
    OAuth client confidentiality. One of "" (default — legacy access-key authentication), "confidential" (a dedicated client secret is generated for the app), or "public" (PKCE only, no client secret). Changing this value on an existing application changes how its clients must authenticate, so coordinate the change with the application's developers.
    CustomIdpInitiatedLoginPageUrl string
    A custom login page URL to redirect users to on IdP-initiated login flows, instead of the default login page.
    DefaultAudience string
    Controls the default aud claim of tokens issued for this application. One of "projectId" (the project ID only), "clientId" (the dedicated client ID only), "appId" (the application ID only), "empty" (no aud claim at all), or "" (default — both the project ID and the client ID). Only applies to modern apps that set a clientType; legacy apps always use the project ID, so the empty default leaves their behavior unchanged.
    DeletionProtection bool
    Protects the application from being accidentally destroyed or replaced. Destroying or replacing a federated application breaks the service provider's configured integration and invalidates its client credentials, so these applications are protected by default. To allow the resource to be destroyed or replaced, for example in ephemeral test environments, set this attribute to false and apply the change first.
    Description string
    A description for the OIDC application.
    DeviceCodeDisabled bool
    Disables the urn:ietf:params:oauth:grant-type:device_code grant type for this application.
    Disabled bool
    Whether the application should be enabled or disabled.
    ForceAuthentication bool
    This configuration overrides the default behavior of the SSO application and forces the user to authenticate via the Descope flow, regardless of the SP's request.
    ForcePkce bool
    When enabled, the authorization code flow requires PKCE in addition to the normal client authentication. A confidential client must then present both its client secret and a valid PKCE codeVerifier. Public clients always use PKCE regardless of this setting.
    JwtBearerDisabled bool
    Disables the urn:ietf:params:oauth:grant-type:jwt-bearer grant type for this application.
    LoginPageUrl string
    The Flow Hosting URL. When left empty the project's default login page URL is used, and the computed value is reflected in this attribute. Read more about using this parameter with custom domain here.
    Logo string
    A logo for the OIDC application. Should be a hosted image URL.
    Name string
    A name for the OIDC application.
    OidcAppId string
    An optional identifier for the application. When omitted, an identifier is generated by the server. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    ProjectId string
    The ID of the project that this application belongs to. Changing this value will require the resource to be deleted and recreated.
    RefreshTokenDisabled bool
    Disables the refreshToken grant type for this application.
    TrustedAppsAudience string
    Controls the audience values appended to the issued token's aud claim for trusted sibling applications. One of "projectId", "clientId", "appId", "empty" (add none), or "" (default — both the project ID and the client ID). Independent of defaultAudience.
    ApprovedRedirectUrls []string
    A list of approved redirect URLs for this application (supports * wildcards). When set, redirect URIs are validated against this per-app list; when empty, validation falls back to the project's approved/trusted domains.
    AuthorizationCodeDisabled bool
    Disables the authorizationCode grant type for this application.
    BackchannelLogoutUrl string
    The URL that Descope notifies with a logout token when the user's session ends, as per the OIDC Back-Channel Logout specification. Leave empty to disable back-channel logout notifications for this application.
    Claims []string
    A list of supported claims. e.g. sub, email, exp.
    ClientCredentialsDisabled bool
    Disables the clientCredentials grant type for this application.
    ClientId string
    A dedicated OIDC clientId to import for this application. When omitted, the clientId is generated by the server and is not returned on reads. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    ClientSecret string
    A dedicated OIDC clientSecret to import for this application. When omitted, a secret is generated server-side only for applications with a confidential client type, either on creation or when the application is later switched to confidential, and fetched into the Terraform state. Applications with other client types don't use a client secret and the value stays empty. The value in the state is never overwritten afterwards, so a secret rotated via the API or the Descope console is not reflected until the resource is replaced. Changing this value will require the resource to be deleted and recreated.
    ClientType string
    OAuth client confidentiality. One of "" (default — legacy access-key authentication), "confidential" (a dedicated client secret is generated for the app), or "public" (PKCE only, no client secret). Changing this value on an existing application changes how its clients must authenticate, so coordinate the change with the application's developers.
    CustomIdpInitiatedLoginPageUrl string
    A custom login page URL to redirect users to on IdP-initiated login flows, instead of the default login page.
    DefaultAudience string
    Controls the default aud claim of tokens issued for this application. One of "projectId" (the project ID only), "clientId" (the dedicated client ID only), "appId" (the application ID only), "empty" (no aud claim at all), or "" (default — both the project ID and the client ID). Only applies to modern apps that set a clientType; legacy apps always use the project ID, so the empty default leaves their behavior unchanged.
    DeletionProtection bool
    Protects the application from being accidentally destroyed or replaced. Destroying or replacing a federated application breaks the service provider's configured integration and invalidates its client credentials, so these applications are protected by default. To allow the resource to be destroyed or replaced, for example in ephemeral test environments, set this attribute to false and apply the change first.
    Description string
    A description for the OIDC application.
    DeviceCodeDisabled bool
    Disables the urn:ietf:params:oauth:grant-type:device_code grant type for this application.
    Disabled bool
    Whether the application should be enabled or disabled.
    ForceAuthentication bool
    This configuration overrides the default behavior of the SSO application and forces the user to authenticate via the Descope flow, regardless of the SP's request.
    ForcePkce bool
    When enabled, the authorization code flow requires PKCE in addition to the normal client authentication. A confidential client must then present both its client secret and a valid PKCE codeVerifier. Public clients always use PKCE regardless of this setting.
    JwtBearerDisabled bool
    Disables the urn:ietf:params:oauth:grant-type:jwt-bearer grant type for this application.
    LoginPageUrl string
    The Flow Hosting URL. When left empty the project's default login page URL is used, and the computed value is reflected in this attribute. Read more about using this parameter with custom domain here.
    Logo string
    A logo for the OIDC application. Should be a hosted image URL.
    Name string
    A name for the OIDC application.
    OidcAppId string
    An optional identifier for the application. When omitted, an identifier is generated by the server. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    ProjectId string
    The ID of the project that this application belongs to. Changing this value will require the resource to be deleted and recreated.
    RefreshTokenDisabled bool
    Disables the refreshToken grant type for this application.
    TrustedAppsAudience string
    Controls the audience values appended to the issued token's aud claim for trusted sibling applications. One of "projectId", "clientId", "appId", "empty" (add none), or "" (default — both the project ID and the client ID). Independent of defaultAudience.
    approved_redirect_urls list(string)
    A list of approved redirect URLs for this application (supports * wildcards). When set, redirect URIs are validated against this per-app list; when empty, validation falls back to the project's approved/trusted domains.
    authorization_code_disabled bool
    Disables the authorizationCode grant type for this application.
    backchannel_logout_url string
    The URL that Descope notifies with a logout token when the user's session ends, as per the OIDC Back-Channel Logout specification. Leave empty to disable back-channel logout notifications for this application.
    claims list(string)
    A list of supported claims. e.g. sub, email, exp.
    client_credentials_disabled bool
    Disables the clientCredentials grant type for this application.
    client_id string
    A dedicated OIDC clientId to import for this application. When omitted, the clientId is generated by the server and is not returned on reads. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    client_secret string
    A dedicated OIDC clientSecret to import for this application. When omitted, a secret is generated server-side only for applications with a confidential client type, either on creation or when the application is later switched to confidential, and fetched into the Terraform state. Applications with other client types don't use a client secret and the value stays empty. The value in the state is never overwritten afterwards, so a secret rotated via the API or the Descope console is not reflected until the resource is replaced. Changing this value will require the resource to be deleted and recreated.
    client_type string
    OAuth client confidentiality. One of "" (default — legacy access-key authentication), "confidential" (a dedicated client secret is generated for the app), or "public" (PKCE only, no client secret). Changing this value on an existing application changes how its clients must authenticate, so coordinate the change with the application's developers.
    custom_idp_initiated_login_page_url string
    A custom login page URL to redirect users to on IdP-initiated login flows, instead of the default login page.
    default_audience string
    Controls the default aud claim of tokens issued for this application. One of "projectId" (the project ID only), "clientId" (the dedicated client ID only), "appId" (the application ID only), "empty" (no aud claim at all), or "" (default — both the project ID and the client ID). Only applies to modern apps that set a clientType; legacy apps always use the project ID, so the empty default leaves their behavior unchanged.
    deletion_protection bool
    Protects the application from being accidentally destroyed or replaced. Destroying or replacing a federated application breaks the service provider's configured integration and invalidates its client credentials, so these applications are protected by default. To allow the resource to be destroyed or replaced, for example in ephemeral test environments, set this attribute to false and apply the change first.
    description string
    A description for the OIDC application.
    device_code_disabled bool
    Disables the urn:ietf:params:oauth:grant-type:device_code grant type for this application.
    disabled bool
    Whether the application should be enabled or disabled.
    force_authentication bool
    This configuration overrides the default behavior of the SSO application and forces the user to authenticate via the Descope flow, regardless of the SP's request.
    force_pkce bool
    When enabled, the authorization code flow requires PKCE in addition to the normal client authentication. A confidential client must then present both its client secret and a valid PKCE codeVerifier. Public clients always use PKCE regardless of this setting.
    jwt_bearer_disabled bool
    Disables the urn:ietf:params:oauth:grant-type:jwt-bearer grant type for this application.
    login_page_url string
    The Flow Hosting URL. When left empty the project's default login page URL is used, and the computed value is reflected in this attribute. Read more about using this parameter with custom domain here.
    logo string
    A logo for the OIDC application. Should be a hosted image URL.
    name string
    A name for the OIDC application.
    oidc_app_id string
    An optional identifier for the application. When omitted, an identifier is generated by the server. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    project_id string
    The ID of the project that this application belongs to. Changing this value will require the resource to be deleted and recreated.
    refresh_token_disabled bool
    Disables the refreshToken grant type for this application.
    trusted_apps_audience string
    Controls the audience values appended to the issued token's aud claim for trusted sibling applications. One of "projectId", "clientId", "appId", "empty" (add none), or "" (default — both the project ID and the client ID). Independent of defaultAudience.
    approvedRedirectUrls List<String>
    A list of approved redirect URLs for this application (supports * wildcards). When set, redirect URIs are validated against this per-app list; when empty, validation falls back to the project's approved/trusted domains.
    authorizationCodeDisabled Boolean
    Disables the authorizationCode grant type for this application.
    backchannelLogoutUrl String
    The URL that Descope notifies with a logout token when the user's session ends, as per the OIDC Back-Channel Logout specification. Leave empty to disable back-channel logout notifications for this application.
    claims List<String>
    A list of supported claims. e.g. sub, email, exp.
    clientCredentialsDisabled Boolean
    Disables the clientCredentials grant type for this application.
    clientId String
    A dedicated OIDC clientId to import for this application. When omitted, the clientId is generated by the server and is not returned on reads. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    clientSecret String
    A dedicated OIDC clientSecret to import for this application. When omitted, a secret is generated server-side only for applications with a confidential client type, either on creation or when the application is later switched to confidential, and fetched into the Terraform state. Applications with other client types don't use a client secret and the value stays empty. The value in the state is never overwritten afterwards, so a secret rotated via the API or the Descope console is not reflected until the resource is replaced. Changing this value will require the resource to be deleted and recreated.
    clientType String
    OAuth client confidentiality. One of "" (default — legacy access-key authentication), "confidential" (a dedicated client secret is generated for the app), or "public" (PKCE only, no client secret). Changing this value on an existing application changes how its clients must authenticate, so coordinate the change with the application's developers.
    customIdpInitiatedLoginPageUrl String
    A custom login page URL to redirect users to on IdP-initiated login flows, instead of the default login page.
    defaultAudience String
    Controls the default aud claim of tokens issued for this application. One of "projectId" (the project ID only), "clientId" (the dedicated client ID only), "appId" (the application ID only), "empty" (no aud claim at all), or "" (default — both the project ID and the client ID). Only applies to modern apps that set a clientType; legacy apps always use the project ID, so the empty default leaves their behavior unchanged.
    deletionProtection Boolean
    Protects the application from being accidentally destroyed or replaced. Destroying or replacing a federated application breaks the service provider's configured integration and invalidates its client credentials, so these applications are protected by default. To allow the resource to be destroyed or replaced, for example in ephemeral test environments, set this attribute to false and apply the change first.
    description String
    A description for the OIDC application.
    deviceCodeDisabled Boolean
    Disables the urn:ietf:params:oauth:grant-type:device_code grant type for this application.
    disabled Boolean
    Whether the application should be enabled or disabled.
    forceAuthentication Boolean
    This configuration overrides the default behavior of the SSO application and forces the user to authenticate via the Descope flow, regardless of the SP's request.
    forcePkce Boolean
    When enabled, the authorization code flow requires PKCE in addition to the normal client authentication. A confidential client must then present both its client secret and a valid PKCE codeVerifier. Public clients always use PKCE regardless of this setting.
    jwtBearerDisabled Boolean
    Disables the urn:ietf:params:oauth:grant-type:jwt-bearer grant type for this application.
    loginPageUrl String
    The Flow Hosting URL. When left empty the project's default login page URL is used, and the computed value is reflected in this attribute. Read more about using this parameter with custom domain here.
    logo String
    A logo for the OIDC application. Should be a hosted image URL.
    name String
    A name for the OIDC application.
    oidcAppId String
    An optional identifier for the application. When omitted, an identifier is generated by the server. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    projectId String
    The ID of the project that this application belongs to. Changing this value will require the resource to be deleted and recreated.
    refreshTokenDisabled Boolean
    Disables the refreshToken grant type for this application.
    trustedAppsAudience String
    Controls the audience values appended to the issued token's aud claim for trusted sibling applications. One of "projectId", "clientId", "appId", "empty" (add none), or "" (default — both the project ID and the client ID). Independent of defaultAudience.
    approvedRedirectUrls string[]
    A list of approved redirect URLs for this application (supports * wildcards). When set, redirect URIs are validated against this per-app list; when empty, validation falls back to the project's approved/trusted domains.
    authorizationCodeDisabled boolean
    Disables the authorizationCode grant type for this application.
    backchannelLogoutUrl string
    The URL that Descope notifies with a logout token when the user's session ends, as per the OIDC Back-Channel Logout specification. Leave empty to disable back-channel logout notifications for this application.
    claims string[]
    A list of supported claims. e.g. sub, email, exp.
    clientCredentialsDisabled boolean
    Disables the clientCredentials grant type for this application.
    clientId string
    A dedicated OIDC clientId to import for this application. When omitted, the clientId is generated by the server and is not returned on reads. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    clientSecret string
    A dedicated OIDC clientSecret to import for this application. When omitted, a secret is generated server-side only for applications with a confidential client type, either on creation or when the application is later switched to confidential, and fetched into the Terraform state. Applications with other client types don't use a client secret and the value stays empty. The value in the state is never overwritten afterwards, so a secret rotated via the API or the Descope console is not reflected until the resource is replaced. Changing this value will require the resource to be deleted and recreated.
    clientType string
    OAuth client confidentiality. One of "" (default — legacy access-key authentication), "confidential" (a dedicated client secret is generated for the app), or "public" (PKCE only, no client secret). Changing this value on an existing application changes how its clients must authenticate, so coordinate the change with the application's developers.
    customIdpInitiatedLoginPageUrl string
    A custom login page URL to redirect users to on IdP-initiated login flows, instead of the default login page.
    defaultAudience string
    Controls the default aud claim of tokens issued for this application. One of "projectId" (the project ID only), "clientId" (the dedicated client ID only), "appId" (the application ID only), "empty" (no aud claim at all), or "" (default — both the project ID and the client ID). Only applies to modern apps that set a clientType; legacy apps always use the project ID, so the empty default leaves their behavior unchanged.
    deletionProtection boolean
    Protects the application from being accidentally destroyed or replaced. Destroying or replacing a federated application breaks the service provider's configured integration and invalidates its client credentials, so these applications are protected by default. To allow the resource to be destroyed or replaced, for example in ephemeral test environments, set this attribute to false and apply the change first.
    description string
    A description for the OIDC application.
    deviceCodeDisabled boolean
    Disables the urn:ietf:params:oauth:grant-type:device_code grant type for this application.
    disabled boolean
    Whether the application should be enabled or disabled.
    forceAuthentication boolean
    This configuration overrides the default behavior of the SSO application and forces the user to authenticate via the Descope flow, regardless of the SP's request.
    forcePkce boolean
    When enabled, the authorization code flow requires PKCE in addition to the normal client authentication. A confidential client must then present both its client secret and a valid PKCE codeVerifier. Public clients always use PKCE regardless of this setting.
    jwtBearerDisabled boolean
    Disables the urn:ietf:params:oauth:grant-type:jwt-bearer grant type for this application.
    loginPageUrl string
    The Flow Hosting URL. When left empty the project's default login page URL is used, and the computed value is reflected in this attribute. Read more about using this parameter with custom domain here.
    logo string
    A logo for the OIDC application. Should be a hosted image URL.
    name string
    A name for the OIDC application.
    oidcAppId string
    An optional identifier for the application. When omitted, an identifier is generated by the server. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    projectId string
    The ID of the project that this application belongs to. Changing this value will require the resource to be deleted and recreated.
    refreshTokenDisabled boolean
    Disables the refreshToken grant type for this application.
    trustedAppsAudience string
    Controls the audience values appended to the issued token's aud claim for trusted sibling applications. One of "projectId", "clientId", "appId", "empty" (add none), or "" (default — both the project ID and the client ID). Independent of defaultAudience.
    approved_redirect_urls Sequence[str]
    A list of approved redirect URLs for this application (supports * wildcards). When set, redirect URIs are validated against this per-app list; when empty, validation falls back to the project's approved/trusted domains.
    authorization_code_disabled bool
    Disables the authorizationCode grant type for this application.
    backchannel_logout_url str
    The URL that Descope notifies with a logout token when the user's session ends, as per the OIDC Back-Channel Logout specification. Leave empty to disable back-channel logout notifications for this application.
    claims Sequence[str]
    A list of supported claims. e.g. sub, email, exp.
    client_credentials_disabled bool
    Disables the clientCredentials grant type for this application.
    client_id str
    A dedicated OIDC clientId to import for this application. When omitted, the clientId is generated by the server and is not returned on reads. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    client_secret str
    A dedicated OIDC clientSecret to import for this application. When omitted, a secret is generated server-side only for applications with a confidential client type, either on creation or when the application is later switched to confidential, and fetched into the Terraform state. Applications with other client types don't use a client secret and the value stays empty. The value in the state is never overwritten afterwards, so a secret rotated via the API or the Descope console is not reflected until the resource is replaced. Changing this value will require the resource to be deleted and recreated.
    client_type str
    OAuth client confidentiality. One of "" (default — legacy access-key authentication), "confidential" (a dedicated client secret is generated for the app), or "public" (PKCE only, no client secret). Changing this value on an existing application changes how its clients must authenticate, so coordinate the change with the application's developers.
    custom_idp_initiated_login_page_url str
    A custom login page URL to redirect users to on IdP-initiated login flows, instead of the default login page.
    default_audience str
    Controls the default aud claim of tokens issued for this application. One of "projectId" (the project ID only), "clientId" (the dedicated client ID only), "appId" (the application ID only), "empty" (no aud claim at all), or "" (default — both the project ID and the client ID). Only applies to modern apps that set a clientType; legacy apps always use the project ID, so the empty default leaves their behavior unchanged.
    deletion_protection bool
    Protects the application from being accidentally destroyed or replaced. Destroying or replacing a federated application breaks the service provider's configured integration and invalidates its client credentials, so these applications are protected by default. To allow the resource to be destroyed or replaced, for example in ephemeral test environments, set this attribute to false and apply the change first.
    description str
    A description for the OIDC application.
    device_code_disabled bool
    Disables the urn:ietf:params:oauth:grant-type:device_code grant type for this application.
    disabled bool
    Whether the application should be enabled or disabled.
    force_authentication bool
    This configuration overrides the default behavior of the SSO application and forces the user to authenticate via the Descope flow, regardless of the SP's request.
    force_pkce bool
    When enabled, the authorization code flow requires PKCE in addition to the normal client authentication. A confidential client must then present both its client secret and a valid PKCE codeVerifier. Public clients always use PKCE regardless of this setting.
    jwt_bearer_disabled bool
    Disables the urn:ietf:params:oauth:grant-type:jwt-bearer grant type for this application.
    login_page_url str
    The Flow Hosting URL. When left empty the project's default login page URL is used, and the computed value is reflected in this attribute. Read more about using this parameter with custom domain here.
    logo str
    A logo for the OIDC application. Should be a hosted image URL.
    name str
    A name for the OIDC application.
    oidc_app_id str
    An optional identifier for the application. When omitted, an identifier is generated by the server. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    project_id str
    The ID of the project that this application belongs to. Changing this value will require the resource to be deleted and recreated.
    refresh_token_disabled bool
    Disables the refreshToken grant type for this application.
    trusted_apps_audience str
    Controls the audience values appended to the issued token's aud claim for trusted sibling applications. One of "projectId", "clientId", "appId", "empty" (add none), or "" (default — both the project ID and the client ID). Independent of defaultAudience.
    approvedRedirectUrls List<String>
    A list of approved redirect URLs for this application (supports * wildcards). When set, redirect URIs are validated against this per-app list; when empty, validation falls back to the project's approved/trusted domains.
    authorizationCodeDisabled Boolean
    Disables the authorizationCode grant type for this application.
    backchannelLogoutUrl String
    The URL that Descope notifies with a logout token when the user's session ends, as per the OIDC Back-Channel Logout specification. Leave empty to disable back-channel logout notifications for this application.
    claims List<String>
    A list of supported claims. e.g. sub, email, exp.
    clientCredentialsDisabled Boolean
    Disables the clientCredentials grant type for this application.
    clientId String
    A dedicated OIDC clientId to import for this application. When omitted, the clientId is generated by the server and is not returned on reads. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    clientSecret String
    A dedicated OIDC clientSecret to import for this application. When omitted, a secret is generated server-side only for applications with a confidential client type, either on creation or when the application is later switched to confidential, and fetched into the Terraform state. Applications with other client types don't use a client secret and the value stays empty. The value in the state is never overwritten afterwards, so a secret rotated via the API or the Descope console is not reflected until the resource is replaced. Changing this value will require the resource to be deleted and recreated.
    clientType String
    OAuth client confidentiality. One of "" (default — legacy access-key authentication), "confidential" (a dedicated client secret is generated for the app), or "public" (PKCE only, no client secret). Changing this value on an existing application changes how its clients must authenticate, so coordinate the change with the application's developers.
    customIdpInitiatedLoginPageUrl String
    A custom login page URL to redirect users to on IdP-initiated login flows, instead of the default login page.
    defaultAudience String
    Controls the default aud claim of tokens issued for this application. One of "projectId" (the project ID only), "clientId" (the dedicated client ID only), "appId" (the application ID only), "empty" (no aud claim at all), or "" (default — both the project ID and the client ID). Only applies to modern apps that set a clientType; legacy apps always use the project ID, so the empty default leaves their behavior unchanged.
    deletionProtection Boolean
    Protects the application from being accidentally destroyed or replaced. Destroying or replacing a federated application breaks the service provider's configured integration and invalidates its client credentials, so these applications are protected by default. To allow the resource to be destroyed or replaced, for example in ephemeral test environments, set this attribute to false and apply the change first.
    description String
    A description for the OIDC application.
    deviceCodeDisabled Boolean
    Disables the urn:ietf:params:oauth:grant-type:device_code grant type for this application.
    disabled Boolean
    Whether the application should be enabled or disabled.
    forceAuthentication Boolean
    This configuration overrides the default behavior of the SSO application and forces the user to authenticate via the Descope flow, regardless of the SP's request.
    forcePkce Boolean
    When enabled, the authorization code flow requires PKCE in addition to the normal client authentication. A confidential client must then present both its client secret and a valid PKCE codeVerifier. Public clients always use PKCE regardless of this setting.
    jwtBearerDisabled Boolean
    Disables the urn:ietf:params:oauth:grant-type:jwt-bearer grant type for this application.
    loginPageUrl String
    The Flow Hosting URL. When left empty the project's default login page URL is used, and the computed value is reflected in this attribute. Read more about using this parameter with custom domain here.
    logo String
    A logo for the OIDC application. Should be a hosted image URL.
    name String
    A name for the OIDC application.
    oidcAppId String
    An optional identifier for the application. When omitted, an identifier is generated by the server. Can only be set when the application is created, and changing it will require the resource to be deleted and recreated.
    projectId String
    The ID of the project that this application belongs to. Changing this value will require the resource to be deleted and recreated.
    refreshTokenDisabled Boolean
    Disables the refreshToken grant type for this application.
    trustedAppsAudience String
    Controls the audience values appended to the issued token's aud claim for trusted sibling applications. One of "projectId", "clientId", "appId", "empty" (add none), or "" (default — both the project ID and the client ID). Independent of defaultAudience.

    Package Details

    Repository
    descope descope/pulumi-descope
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the descope Terraform Provider.
    descope logo Descope
    Viewing docs for Descope v1.0.1
    published on Sunday, Oct 11, 2026 by Descope

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial