--- title: "Secrets" slug: "secrets-v7-0" description: "Securely store and manage credentials for JavaScript scripts with our secrets store, ensuring safe HTTPS calls without exposing sensitive data." tags: ["Secrets"] updated: 2026-11-02T17:05:30Z published: 2026-11-02T17:05:30Z canonical: "support.appgate.com/secrets-v7-0" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.appgate.com/llms.txt > Use this file to discover all available pages before exploring further. # Secrets The secrets store provides secure storage for credentials used in JavaScript-based scripts. Scripts run throughout AppGate ZTNA and perform complex logic, string manipulation, and calculations. An important part of this capability is support for limited [HTTPS calls](/v1/docs/external-https-calls-v7-0) to external systems. The secrets store ensures that credentials required to authenticate to those external systems are not exposed in scripts or related logs. There are three types of secrets: - ***Generic***. Supports the following script types: User claim scripts, assignment criteria scripts, entitlement scripts, and access criteria scripts. - ***Credentials***. Supports Brokered RDP entitlements. - ***SSH Key***. Supports Brokered SSH entitlements. --- ## Configuring secrets ### Generic To configure a secret: 1. Go to **Secrets** (System > Secrets). 2. Select **+Add** and complete the following fields: - ***Name.*** Enter the name used to reference to the secret in scripts. Use the format `%SECRET:<name>%`. The name must not contain lowercase letters or spaces. Changing the name may break existing scripts. - ***Notes***. Optional. Enter any notes about the secret. - ***Tags***. Select **+Add** to add tags to the secret. - ***Secret.*** Enter the secret value to substitute into the script at run time. You can copy the reference to a secret from the **Secrets** page using the action button (![Three circular shapes stacked vertically on a dark background, selected to access a menu.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/three_dots.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A38Z&se=2026-11-21T22%3A39%3A38Z&sr=b&sp=r&sig=V0K1PFQsHFsljsTNAMn0BBO1Hq9lc6GbcpSGRt90Y5Y%3D)). 3. Save the secret. ### Credentials Brokered RDP sessions use a ***Credentials*** secret. To configure a Credentials secret, complete the following steps: 1. Go to **Secrets** (System > Secrets). 2. Select **Add** > **Credentials**. 3. On the **Edit Secret - Credentials** page, complete the following fields: - ***Name***. Enter the name that scripts use to reference the secret. Use the format `%SECRET:<name>%`. The name cannot contain lowercase letters or spaces. Changing the name can break existing scripts. - ***Notes***. Optional. Enter any notes about the secret. - ***Tags***. Select **+Add** to add tags to the secret. - ***Username***. Enter the username to authenticate with the target resource. - ***Password***. Enter the password for authentication at run time. 4. Select **Save**. ### SSH Key Brokered SSH sessions use an ***SSH Key*** secret. To configure an SSH Key secret, complete the following steps: 1. Go to **Secrets** (System > Secrets). 2. Select **Add** > **SSH Key**. 3. On the **Edit Secret - SSH Key** page, complete the following fields: - ***Name***. Enter the name that scripts use to reference to the secret. Use the format `%SECRET:<name>%`. The name cannot contain lowercase letters or spaces. Changing the name can break existing scripts. - ***Notes***. Optional. Enter any notes about the secret. - ***Tags***. Select **+Add** to add tags to the secret. - ***Username***. Enter the username to authenticate with the target resource. - ***SSH Key***. Enter the private SSH key for authentication at run time. 4. Select **Save**. --- ## Managing secrets Use the action button—the three dots icon (![Three circular shapes stacked vertically on a dark background, selected to access a menu.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/three_dots.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A39%3A38Z&se=2026-11-21T22%3A39%3A38Z&sr=b&sp=r&sig=V0K1PFQsHFsljsTNAMn0BBO1Hq9lc6GbcpSGRt90Y5Y%3D)) to the right of each line item—to access the following option: - ***Copy reference to clipboard***. Copies the secret reference for use in a script.