|
| 1 | +--- |
| 2 | +subcategory: "Data Loss Prevention" |
| 3 | +layout: "zscaler" |
| 4 | +page_title: "ZIA: dlp_cloud_to_cloud_ir" |
| 5 | +description: |- |
| 6 | + Official documentation https://help.zscaler.com/zia/dlp-cloud-cloud-incident-forwarding |
| 7 | + API documentation https://help.zscaler.com/zia/data-loss-prevention#/cloudToCloudIR-get |
| 8 | + Retrieves Cloud-to-Cloud Incident Receiver (C2CIR) information configured in the ZIA Admin Portal |
| 9 | +--- |
| 10 | + |
| 11 | +# zia_dlp_cloud_to_cloud_ir (Data Source) |
| 12 | + |
| 13 | +* [Official documentation](https://help.zscaler.com/zia/dlp-cloud-cloud-incident-forwarding) |
| 14 | +* [API documentation](https://help.zscaler.com/zia/data-loss-prevention#/cloudToCloudIR-get) |
| 15 | + |
| 16 | +Use the **zia_dlp_cloud_to_cloud_ir** data source to get information about Cloud-to-Cloud Incident Receiver (C2CIR) tenants configured in the ZIA Admin Portal. This data source retrieves detailed information about C2CIR configurations including tenant authorization, onboardable entities, and validation status. The retrieved information can be used in Web DLP Rules [zia_dlp_web_rules](https://registry.terraform.io/providers/zscaler/zia/latest/docs/resources/zia_dlp_web_rules) or CASB DLP Rules [zia_casb_dlp_rules](https://registry.terraform.io/providers/zscaler/zia/latest/docs/resources/zia_casb_dlp_rules). |
| 17 | + |
| 18 | +## Example Usage |
| 19 | + |
| 20 | +```hcl |
| 21 | +# Retrieve the C2CIR by name |
| 22 | +data "zia_dlp_cloud_to_cloud_ir" "this" { |
| 23 | + name = "AzureTenant01" |
| 24 | +} |
| 25 | +
|
| 26 | +# Output the retrieved information |
| 27 | +output "zia_dlp_cloud_to_cloud_ir" { |
| 28 | + value = data.zia_dlp_cloud_to_cloud_ir.this |
| 29 | +} |
| 30 | +``` |
| 31 | + |
| 32 | +## Argument Reference |
| 33 | + |
| 34 | +The following arguments are supported: |
| 35 | + |
| 36 | +### Required |
| 37 | + |
| 38 | +* `name` - (Required) The name of the Cloud-to-Cloud Incident Receiver tenant to retrieve. |
| 39 | + |
| 40 | +## Attributes Reference |
| 41 | + |
| 42 | +The following attributes are exported: |
| 43 | + |
| 44 | +* `id` - (Number) The unique identifier for the C2CIR tenant. |
| 45 | +* `name` - (String) The name of the C2CIR tenant. |
| 46 | +* `status` - (List of String) The current status of the C2CIR tenant (e.g., `CASB_TENANT_ACTIVE`). |
| 47 | +* `modified_time` - (Number) Timestamp when the C2CIR tenant was last modified. |
| 48 | +* `last_tenant_validation_time` - (Number) Timestamp of the last tenant validation. |
| 49 | +* `last_validation_msg` - (List) Last validation message information. |
| 50 | + * `error_msg` - (String) Error message from validation. |
| 51 | + * `error_code` - (Number) Error code from validation. |
| 52 | +* `last_modified_by` - (List) Information about who last modified the C2CIR tenant. |
| 53 | + * `id` - (Number) Unique identifier for the modifier. |
| 54 | + * `name` - (String) Name of the modifier. |
| 55 | + * `external_id` - (String) External identifier for the modifier. |
| 56 | + * `extensions` - (Map) Additional properties for the modifier. |
| 57 | +* `onboardable_entity` - (List) Information about the onboardable entity. |
| 58 | + * `id` - (Number) Unique identifier for the onboardable entity. |
| 59 | + * `name` - (String) Name of the onboardable entity. |
| 60 | + * `type` - (String) Type of the onboardable entity (e.g., `SAAS_TENANT`). |
| 61 | + * `enterprise_tenant_id` - (String) Enterprise tenant ID. |
| 62 | + * `application` - (String) Application name (e.g., `SLACK`). |
| 63 | + * `last_validation_msg` - (List) Last validation message for the onboardable entity. |
| 64 | + * `error_msg` - (String) Error message from validation. |
| 65 | + * `error_code` - (Number) Error code from validation. |
| 66 | + * `tenant_authorization_info` - (List) Tenant authorization information. |
| 67 | + * `access_token` - (String) Access token for authorization. |
| 68 | + * `bot_token` - (String) Bot token for authorization. |
| 69 | + * `redirect_url` - (String) Redirect URL for authorization. |
| 70 | + * `type` - (String) Authorization type (e.g., `SLACK_BOT`). |
| 71 | + * `env` - (String) Environment (e.g., `SALESFORCE_PRODUCTION`). |
| 72 | + * `temp_auth_code` - (String) Temporary authorization code. |
| 73 | + * `subdomain` - (String) Subdomain for the tenant. |
| 74 | + * `apicp` - (String) API CP configuration. |
| 75 | + * `client_id` - (String) Client ID for authorization. |
| 76 | + * `client_secret` - (String) Client secret for authorization. |
| 77 | + * `secret_token` - (String) Secret token for authorization. |
| 78 | + * `user_name` - (String) Username for authorization. |
| 79 | + * `user_pwd` - (String) User password for authorization. |
| 80 | + * `instance_url` - (String) Instance URL for the tenant. |
| 81 | + * `role_arn` - (String) Role ARN for authorization. |
| 82 | + * `quarantine_bucket_name` - (String) Quarantine bucket name. |
| 83 | + * `cloud_trail_bucket_name` - (String) Cloud trail bucket name. |
| 84 | + * `bot_id` - (String) Bot ID for authorization. |
| 85 | + * `org_api_key` - (String) Organization API key. |
| 86 | + * `external_id` - (String) External identifier. |
| 87 | + * `enterprise_id` - (String) Enterprise identifier. |
| 88 | + * `cred_json` - (String) Credential JSON. |
| 89 | + * `role` - (String) Role for authorization (e.g., `READ`). |
| 90 | + * `organization_id` - (String) Organization identifier. |
| 91 | + * `workspace_name` - (String) Workspace name. |
| 92 | + * `workspace_id` - (String) Workspace identifier. |
| 93 | + * `qtn_channel_url` - (String) Quarantine channel URL. |
| 94 | + * `features_supported` - (List of String) Supported features (e.g., `CASB`). |
| 95 | + * `mal_qtn_lib_name` - (String) Malware quarantine library name. |
| 96 | + * `dlp_qtn_lib_name` - (String) DLP quarantine library name. |
| 97 | + * `credentials` - (String) Credentials for authorization. |
| 98 | + * `token_endpoint` - (String) Token endpoint for authorization. |
| 99 | + * `rest_api_endpoint` - (String) REST API endpoint. |
| 100 | + * `smir_bucket_config` - (List) SMIR bucket configuration. |
| 101 | + * `id` - (Number) Unique identifier for the SMIR bucket. |
| 102 | + * `config_name` - (String) Configuration name for the bucket. |
| 103 | + * `metadata_bucket_name` - (String) Metadata bucket name URL. |
| 104 | + * `data_bucket_name` - (String) Data bucket name URL. |
| 105 | + * `qtn_info` - (List) Quarantine information. |
| 106 | + * `admin_id` - (String) Administrator identifier. |
| 107 | + * `qtn_folder_path` - (String) Quarantine folder path. |
| 108 | + * `mod_time` - (Number) Modification time. |
| 109 | + * `qtn_info_cleared` - (Boolean) Whether quarantine information is cleared. |
| 110 | + * `zscaler_app_tenant_id` - (List) Zscaler app tenant ID information. |
| 111 | + * `id` - (Number) Unique identifier for the Zscaler app tenant. |
| 112 | + * `name` - (String) Name of the Zscaler app tenant. |
| 113 | + * `external_id` - (String) External identifier for the Zscaler app tenant. |
| 114 | + * `extensions` - (Map) Additional properties for the Zscaler app tenant |
0 commit comments