Skip to main content

Load secrets into scripts

You can use 1Password CLI to load secrets into your scripts, so that the credentials in your scripts are always in sync with the information in your 1Password account and your secrets are never exposed in plaintext.

tip

We recommend using 1Password Service Accounts to follow the principle of least privilege. Service accounts support restricting 1Password CLI to specific vaults, so that processes in your authorized terminal session can only access items required for a given purpose.

Service accounts are also useful if your personal account has SSO or MFA requirements.

You can use the following methods to load secrets into scripts, separately or in combination:

  1. Use op run to pass environment variables from a 1Password Environment
  2. Use op run to load secrets into the environment.
  3. Use op read to read secrets.
  4. Use op inject to load secrets into a config file.
  5. Use op plugin run to load secrets using a shell plugin.

Requirements​

Before you can use 1Password CLI to load secrets into your scripts, you'll need to:

  1. Sign up for 1Password.
  2. Install 1Password CLI.
  3. Store the secrets you need for your script in your 1Password account.

Use op run to pass environment variables from a 1Password Environment Beta​

Beta feature

To use op run with 1Password Environments, you'll need to install the latest beta build of 1Password CLI, version 2.33.0-beta.02 or later.

You can use op run to pass environment variables stored in a 1Password Environment to an application or script at runtime.

1Password CLI runs the application or script in a subprocess with the environment variables stored in your 1Password Environment provisioned for the duration of the process.

Use op run to pass secrets using secret references​

You can replace the plaintext secrets in your environemnt files with secret reference URIs that reference where your project secrets are stored in your 1Password account, then use op run to load the corresponding secrets from 1Password and pass them to your script as environment variables at runtime.

Learn more about loading secrets into the environment.

Use op read to read secrets​

You can use op read with secret references directly in your script or with environment variables.

Directly in your script​

With this method, secrets are only passed to the single command that includes the secret reference.

For example, to replace your Docker username and password with secret references in a command to log in to Docker:

yourscript.sh

With environment variables​

You can also include a command to set environment variables to op read and secret references in your script.

For example, if you supply an AWS command in your script with secrets using the AWS_SECRET_ACCESS_KEY and AWS_ACCESS_KEY_ID environment variables, your script might look like this:

yourscript.sh

Use op inject to load secrets into a config file​

If your script uses a configuration file, you can template the config file with secret references, then use op inject to pass the config file with the resolved secrets to your script at runtime.

This allows you to check config files into source control and keep them in sync throughout developer workstations, CI, and production servers. And you can include template variables within the secret references to load different sets of secrets for different environments.

Learn how to load secrets into config files.

Use op plugin run to load secrets using a shell plugin​

If your script runs interactively and each person using the script authenticates with their own personal token, you can minimize the configuration required in advance of using the script with a 1Password Shell Plugin. Shell plugins prompt each user to select their credentials when the script is executed.

Each person using the script will be prompted to configure when their credentials should be used to authenticate. To make sure the credentials they selected will also be used for future invocations of the script, they can configure their credentials as a global or directory default.

To use a shell plugin to authenticate an individual command, wrap the command in op plugin run. For example, to use the AWS shell plugin to provide an AWS Access Key and Secret Key ID to the sts get-caller-identity command:

yourscript.sh

To use a shell plugin throughout a script, you can include an alias for the tool's executable command at the beginning of the script. For example, in this script, the AWS shell plugin would be used to supply secrets for every aws command in the script.

yourscript.sh

If a shell plugin doesn't exist for the tool you're using, you can build a new plugin.

Learn more​

Was this page helpful?