Read 1Password Environments using 1Password SDKs

Beta You can use 1Password SDKs to programmatically read environment variables stored in 1Password Environments (beta) and use them in your applications.

Requirements

To use this feature, you’ll need to install the beta version of the Go, JS, or Python SDK:

go get github.com/1password/onepassword-sdk-go@v0.4.1-beta.1

Read environment variables

Go
JavaScript
Python

To read environment variables stored in an Environment, use the GetVariables() method. Replace <your-environment-id> with the Environment’s ID.

res, err := client.Environments().GetVariables(context.Background(), "<your-environment-id>")
if err != nil {
	panic(err)
}
for _, env := range res.Variables {
	fmt.Printf("Variable %s: %s (hidden: %t)\n", env.Name, env.Value, env.Masked)
}

The method returns a GetVariablesResponse struct that contains a list of the environment variables stored in the Environment.

// Response containing the full set of environment variables from an Environment.
type GetVariablesResponse struct {
	// List of environment variables.
	Variables []EnvironmentVariable `json:"variables"`
}

Each EnvironmentVariable struct in the response contains the following:

Name: The environment variable’s name (for example, DB_HOST).
Value: The environment variable’s value.
Masked: A boolean that indicates whether the value is hidden by default in the 1Password app.

// Represents an environment variable (name:value pair) and its masked state
type EnvironmentVariable struct {
	// An environment variable's name
	Name string `json:"name"`
	// An environment variable's value
	Value string `json:"value"`
	// An environment variable's masked state
	Masked bool `json:"masked"`
}

To read environment variables stored in an Environment, use the getVariables() method. Replace <your-environment-id> with the Environment’s ID.

const res = await client.environments.getVariables("<your-environment-id>");
for (const env of res.variables) {
  console.log(`Variable ${env.name}: ${env.value} (hidden: ${env.masked})`);
}

The method returns a GetVariablesResponse object that contains a list of the environment variables stored in the Environment.

/** Response containing the full set of environment variables from an Environment. */
interface GetVariablesResponse {
  /** List of environment variables. */
  variables: EnvironmentVariable[];
}

Each EnvironmentVariable object in the response contains the following:

Name: The environment variable’s name (for example, DB_HOST).
Value: The environment variable’s value.
Masked: A boolean that indicates whether the value is hidden by default in the 1Password app.

/** Represents an environment variable (name:value pair) and its masked state */
export interface EnvironmentVariable {
  /** An environment variable's name */
  name: string;
  /** An environment variable's value */
  value: string;
  /** An environment variable's masked state */
  masked: boolean;
}

To read environment variables stored in an Environment, use the get_variables() method. Replace <your-environment-id> with the Environment’s ID.

res = await client.environments.get_variables("<your-environment-id>")
for env in res.variables:
    print(f"Environment {env.name}: {env.value} (hidden: {env.masked})")

The method returns a GetVariablesResponse object that contains a list of the environment variables stored in the Environment.

class GetVariablesResponse(BaseModel):
    """
    Response containing the full set of environment variables from an Environment.
    """

    variables: List[EnvironmentVariable]
    """
    List of environment variables.
    """

Each EnvironmentVariable object in the response contains the following:

Name: The environment variable’s name (for example, DB_HOST).
Value: The environment variable’s value.
Masked: A boolean that indicates whether the value is hidden by default in the 1Password app.

class EnvironmentVariable(BaseModel):
    """
    Represents an environment variable (name:value pair) and its masked state
    """

    name: str
    """
    An environment variable's name
    """
    value: str
    """
    An environment variable's value
    """
    masked: bool
    """
    An environment variable's masked state
    """

1Password Environment variables are masked by default. To change this:

Open and unlock the 1Password desktop app.
Select Developer > View Environments.
Choose the Environment, select Edit, then select the vertical ellipsis next to the variable and select Show value by default.

Appendix: Get an Environment’s ID

To read environment variables from a 1Password Environment, you’ll need its unique identifier (ID). You can find this ID in the 1Password desktop app:

Open and unlock the 1Password desktop app.
Navigate to Developer > View Environments.
Select View environment next to the Environment you want to fetch.
Select Manage environment > Copy environment ID.

SDKs

​Requirements

​Read environment variables

​Appendix: Get an Environment’s ID

Requirements

Read environment variables

Appendix: Get an Environment’s ID