DDILConfig

D D I L Config resource for Zscaler Private Access.

Resource operations

This resource supports the following standard methods: create(), load(), update(), delete(). They operate on the instance state — set properties with dot notation, then call the method with no arguments. Any other action listed below is a custom action that takes explicit keyword arguments and returns a value.

Quick Start

import zssdk
import logging

# Enable debug logging for DDILConfig
logging.getLogger('zssdk.zpa').setLevel(logging.DEBUG)
logging.basicConfig(level=logging.DEBUG)

session = zssdk.Session(
    vanity_domain="your-vanity-domain",
    client_id="your-client-id",
    client_secret="your-client-secret",
)

# Get a specific DDILConfig
resource = session.zpa.DDILConfig(id="your-resource-id")
resource.load()
print(resource)

# Debug output shows HTTP request/response details

Identifiers

Name	Type	Description
`id`	string	Unique identifier

Actions

create()

Creates a new DDILConfig. Set properties on the resource instance, then call create() — this method takes no arguments.

Properties for creation:

Name	Type	Required	Description
`customer_id`	long	Yes	-
`offline_domain`	string	No	-
`meta_data`	ServiceProvider	No	-
`new_user_support`	boolean	No	-
`sitec_preferred`	boolean	No	-
`max_allowed_down_time`	long	No	-
`max_allowed_down_time_unit`	string	No	-
`max_allowed_switch_time`	long	No	-
`max_allowed_switch_time_unit`	string	No	-
`idp_login_url`	string	No	-
`idp_cert`	string	No	-
`idp_entity_id`	string	No	-
`switch_time_enabled`	boolean	No	-
`use_existing_idp`	boolean	No	-
`restriction_type`	string	No	-
`backup_enabled`	boolean	No	-
`backup_basedir`	string	No	-
`backup_schedule_type`	string	No	-
`backup_schedule_value`	string	No	-
`backup_max_allowed_num`	integer	No	-
`site_SP_cert_id`	string	No	-
`ba_auth_domain_cert_id`	string	No	-
`encrypt_saml_response`	boolean	No	-
`read_only`	boolean	No	-
`zscaler_managed`	boolean	No	-

Returns: DDILConfig

Example:

resource = session.zpa.DDILConfig()
resource.customer_id = "resource-id"
resource.create()
print(f"Created with ID: {resource.id}")

delete()

Deletes a DDILConfig by id. Only the id identifier is required; delete() takes no other arguments.

Example:

resource = session.zpa.DDILConfig(id="your-resource-id")
resource.delete()

download_meta_data()

Parameters:

Name	Type	Required	Description
`customer_id`	long	Yes	-

Example:

resource = session.zpa.DDILConfig()
result = resource.download_meta_data(customer_id=3600)
print(result)

download_SP_certificate()

Parameters:

Name	Type	Required	Description
`customer_id`	long	Yes	-

Example:

resource = session.zpa.DDILConfig()
result = resource.download_SP_certificate(customer_id=3600)
print(result)

get_all_ddil_config()

Parameters:

Name	Type	Required	Description
`customer_id`	long	Yes	-

Returns: DDILConfig

Example:

resource = session.zpa.DDILConfig()
result = resource.get_all_ddil_config(customer_id=3600)
print(result)

load()

Fetches an existing DDILConfig by id. Only the id identifier is required; load() takes no other arguments.

Returns: DDILConfig

Example:

resource = session.zpa.DDILConfig(id="your-resource-id")
resource.load()
print(resource.modified_by)

update()

Updates an existing DDILConfig. Call load() first, modify properties, then call update() — this method takes no arguments.

Properties for update:

Name	Type	Required	Description
`customer_id`	long	Yes	-
`offline_domain`	string	No	-
`meta_data`	ServiceProvider	No	-
`new_user_support`	boolean	No	-
`sitec_preferred`	boolean	No	-
`max_allowed_down_time`	long	No	-
`max_allowed_down_time_unit`	string	No	-
`max_allowed_switch_time`	long	No	-
`max_allowed_switch_time_unit`	string	No	-
`idp_login_url`	string	No	-
`idp_cert`	string	No	-
`idp_entity_id`	string	No	-
`switch_time_enabled`	boolean	No	-
`use_existing_idp`	boolean	No	-
`restriction_type`	string	No	-
`backup_enabled`	boolean	No	-
`backup_basedir`	string	No	-
`backup_schedule_type`	string	No	-
`backup_schedule_value`	string	No	-
`backup_max_allowed_num`	integer	No	-
`site_SP_cert_id`	string	No	-
`ba_auth_domain_cert_id`	string	No	-
`encrypt_saml_response`	boolean	No	-
`read_only`	boolean	No	-
`zscaler_managed`	boolean	No	-

Returns: DDILConfig

Example:

resource = session.zpa.DDILConfig(id="your-resource-id")
resource.load()
resource.modified_by = "Updated value"
resource.update()

Attributes

Name	Type	Required	Description
`modified_time`	integer	No	-
`creation_time`	integer	No	-
`modified_by`	string	No	-
`id`	string	No	-
`offline_domain`	string	No	-
`sitesp_signing_certificate`	string	No	-
`sitesp_signing_private_key`	string	No	-
`sitesp_certificate`	string	No	-
`sitesp_private_key`	string	No	-
`sitesp_CA_certificate`	string	No	-
`sitesp_CA_private_key`	string	No	-
`meta_data`	ServiceProvider	No	-
`user_idps_meta_data`	ServiceProviderWrapperCollection	No	-
`new_user_support`	boolean	No	-
`sitec_preferred`	boolean	No	-
`max_allowed_down_time`	long	No	-
`max_allowed_down_time_unit`	string	No	-
`max_allowed_switch_time`	long	No	-
`max_allowed_switch_time_unit`	string	No	-
`idp_login_url`	string	No	-
`idp_cert`	string	No	-
`idp_entity_id`	string	No	-
`switch_time_enabled`	boolean	No	-
`use_existing_idp`	boolean	No	-
`restriction_type`	string	No	-
`backup_enabled`	boolean	No	-
`backup_basedir`	string	No	-
`backup_schedule_type`	string	No	-
`backup_schedule_value`	string	No	-
`backup_max_allowed_num`	integer	No	-
`site_SP_cert_id`	string	No	-
`site_SP_cert_name`	string	No	-
`ba_auth_domain_cert_id`	string	No	-
`ba_auth_domain_cert_name`	string	No	-
`encrypt_saml_response`	boolean	No	-
`sitesp_encryption_certificate`	string	No	-
`read_only`	boolean	No	-
`zscaler_managed`	boolean	No	-

DDILConfig - Data structure definition
Logging guide - enable verbose logs while debugging this resource

Quick Start​

Identifiers​

Actions​

create()​

delete()​

download_meta_data()​

download_SP_certificate()​

get_all_ddil_config()​

load()​

update()​

Attributes​

Related​

Quick Start

Identifiers

Actions

create()

delete()

download_meta_data()

download_SP_certificate()

get_all_ddil_config()

load()

update()

Attributes

Related