/

Managing Secrets

Cloud management

The ByteHide Cloud Panel provides a centralized interface for managing all your secrets across different environments.

Accessing the Secrets Dashboard

  1. Log in to ByteHide Cloud
  2. Select your project
  3. Click on the Keys tab to view your secrets dashboard

Secrets Dashboard

Creating Secrets

To add a new secret:

  1. Click the Create secret button
  2. Enter a key name (e.g., "database-connection")
  3. Enter values for each environment
  4. Click Save

Create Secret

Secret Keys

Key Naming Restrictions

Secret key names must match this regex pattern: /^[0-9A-Za-z]([0-9A-Za-z-]{0,125}[0-9A-Za-z])?$/

This means:

  • Start and end with alphanumeric characters
  • Can contain hyphens in the middle
  • Maximum length of 127 characters

When naming your secrets, follow these best practices:

  • Use descriptive names (e.g., stripe-api-key instead of key1)
  • Use lowercase letters, numbers, and hyphens
  • Group related secrets with prefixes (e.g., database-host, database-password)

Managing Environment Values

Each secret can have different values for each environment:

  1. Click on a secret to expand it
  2. View all environment values
  3. Edit or add values for specific environments

Environment Values

Environment-Specific Editing

For easier management of all secrets in a specific environment:

  1. In the top navigation area of the secrets page, click the View button next to an environment name Environment Values
  2. This displays all secrets for only that environment Environment Values
  3. Edit multiple values at once
  4. Click Save to store all changes

This view makes it much easier to update all values for a specific environment during deployment or configuration changes.

Environment Indicators

The Cloud Panel uses indicators to show which environments have values for each secret:

  • Green check: Environment has a value for this secret
  • Red circle: Environment is missing a value for this secret

Viewing and Editing Secrets

To view or edit a secret:

  1. Click on a secret to expand it
  2. View the values for each environment
  3. Click the "eye" icon to reveal hidden values
  4. Click the "edit" icon to modify a value
  5. Click Save to store your changes

Copying Secret Values

To copy a secret value to your clipboard:

  1. Expand the secret
  2. Click the "copy" button next to the value you want to copy

This is useful when you need to use a secret value outside of your application.

Deleting Secrets

To delete a secret:

  1. Expand the secret
  2. Click the "delete" icon for the entire secret or for a specific environment value
  3. Confirm the deletion

Deletion is permanent

Deleting a secret is permanent and cannot be undone. Make sure you no longer need the secret before deleting it.

Secret History

ByteHide maintains a history of changes to your secrets:

  1. Expand a secret
  2. Click the "history" tab
  3. View who made changes and when

This audit trail helps you track changes to your secrets over time.

Bulk Operations

Importing Secrets

To import secrets in bulk:

  1. Prepare a .env style file with your secrets
  2. Click Import in the secrets dashboard
  3. Upload your env file
  4. Map the environments
  5. Click Import

Exporting Secrets

To export your secrets:

  1. Click Export in the secrets dashboard
  2. Choose which environments to include
  3. Click Export
  4. Download the JSON file

This is useful for backup purposes or for transferring secrets between projects.

Security Features

For detailed information on securing your secrets, including:

  • Access control
  • IP restrictions
  • Custom headers
  • Two-factor authentication

See Security Settings.

Next Steps

Previous
Multi-Environment Setup