d5be4fbd6a
* Adds a summary to the top of each plugin's page showing the capabilities that the plugin has. * Fixed sidebar sorting (they weren't quite alpabetical) * Improved instructions for using the Oracle plugin * Added note about using the pluggable database rather than the container database * Replaced admin/root usernames with super-user ones to encourage users to not use the root user in Vault * Included suggestions to rotate the root user's password when the plugin is capable * Improve documentation around rotating the root user's password * Fixed various typos
87 lines
2.8 KiB
Plaintext
87 lines
2.8 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: InfluxDB - Database - Secrets Engines
|
|
sidebar_title: InfluxDB
|
|
description: |-
|
|
InfluxDB is one of the supported plugins for the database secrets engine.
|
|
This plugin generates database credentials dynamically based on configured
|
|
roles for the InfluxDB database.
|
|
---
|
|
|
|
# InfluxDB Database Secrets Engine
|
|
|
|
InfluxDB is one of the supported plugins for the database secrets engine. This
|
|
plugin generates database credentials dynamically based on configured roles for
|
|
the InfluxDB database.
|
|
|
|
See the [database secrets engine](/docs/secrets/databases) docs for
|
|
more information about setting up the database secrets engine.
|
|
|
|
## Capabilities
|
|
| Plugin Name | Root Credential Rotation | Dynamic Roles | Static Roles |
|
|
| --- | --- | --- | --- |
|
|
| `influxdb-database-plugin` | Yes | Yes | No |
|
|
|
|
## Setup
|
|
|
|
1. Enable the database secrets engine if it is not already enabled:
|
|
|
|
```text
|
|
$ vault secrets enable database
|
|
Success! Enabled the database secrets engine at: database/
|
|
```
|
|
|
|
By default, the secrets engine will enable at the name of the engine. To
|
|
enable the secrets engine at a different path, use the `-path` argument.
|
|
|
|
1. Configure Vault with the proper plugin and connection information:
|
|
|
|
```text
|
|
$ vault write database/config/my-influxdb-database \
|
|
plugin_name="influxdb-database-plugin" \
|
|
host=127.0.0.1 \
|
|
username=vaultuser \
|
|
password=vaultpass \
|
|
allowed_roles=my-role
|
|
```
|
|
|
|
1. Configure a role that maps a name in Vault to an SQL statement to execute to
|
|
create the database credential:
|
|
|
|
```text
|
|
$ vault write database/roles/my-role \
|
|
db_name=my-influxdb-database \
|
|
creation_statements="CREATE USER \"{{username}}\" WITH PASSWORD '{{password}}'; \
|
|
GRANT ALL ON \"vault\" TO \"{{username}}\";" \
|
|
default_ttl="1h" \
|
|
max_ttl="24h"
|
|
Success! Data written to: database/roles/my-role
|
|
```
|
|
|
|
## Usage
|
|
|
|
After the secrets engine is configured and a user/machine has a Vault token with
|
|
the proper permission, it can generate credentials.
|
|
|
|
1. Generate a new credential by reading from the `/creds` endpoint with the name
|
|
of the role:
|
|
|
|
```text
|
|
$ vault read database/creds/my-role
|
|
Key Value
|
|
--- -----
|
|
lease_id database/creds/my-role/2f6a614c-4aa2-7b19-24b9-ad944a8d4de6
|
|
lease_duration 1h
|
|
lease_renewable true
|
|
password 8cab931c-d62e-a73d-60d3-5ee85139cd66
|
|
username v-vaultuser-e2978cd0-
|
|
```
|
|
|
|
## API
|
|
|
|
The full list of configurable options can be seen in the [InfluxDB database
|
|
plugin API](/api/secret/databases/influxdb) page.
|
|
|
|
For more information on the database secrets engine's HTTP API please see the [Database secret
|
|
secrets engine API](/api/secret/databases) page.
|