docs-v2/content/influxdb/v2/admin/secrets/add.md

1.8 KiB

title description influxdb/v2/tags menu weight aliases
Add secrets Add secrets using the `influx` CLI or the InfluxDB API.
secrets
security
influxdb_v2
parent
Manage secrets
301
/influxdb/v2/security/secrets/manage-secrets/add/
/influxdb/v2/security/secrets/add/

Add secrets using the influx command line interface (CLI) or the InfluxDB API.

Add a secret using the influx CLI

Use the influx secret update command to add a new secret to your organization. Provide the secret key with the -k or --key flag. You may also provide the secret value with the -v or --value flag. If you do not provide the secret value with the -v or --value flag, enter the value when prompted.

{{% warn %}} Providing a secret value with the -v or --value flag may expose the secret in your command history. {{% /warn %}}

# Syntax
influx secret update -k <secret-key>

# Example
influx secret update -k foo

Add a secret using the InfluxDB API

Use the PATCH request method and the /orgs/{orgID}/secrets API endpoint to add a new secret to your organization.

Include the following:

  • Your organization ID in the request URL
  • Your API token in the Authorization header
  • The secret key-value pair in the request body
curl --request PATCH http://localhost:8086/api/v2/orgs/<org-id>/secrets \
  --header 'Authorization: Token YOURAUTHTOKEN' \
  --header 'Content-type: application/json' \
  --data '{
	"<secret-key>": "<secret-value>"
}'