• HashiCorp Developer

  • HashiCorp Cloud Platform
  • Terraform
  • Packer
  • Consul
  • Vault
  • Boundary
  • Nomad
  • Waypoint
  • Vagrant
Vault
  • Install
  • Tutorials
  • Documentation
  • API
  • Integrations
  • Try Cloud(opens in new tab)
  • Sign up
Vault Home

Documentation

Skip to main content
  • Documentation
  • What is Vault?
  • Use Cases

  • Browser Support
  • Installing Vault
    • Overview
    • replication
    • sentinel
      • Overview
      • Aerospike
      • Alicloud OSS
      • Azure
      • Cassandra
      • CockroachDB
      • Consul
      • CouchDB
      • DynamoDB
      • Etcd
      • Filesystem
      • FoundationDB
      • Google Cloud Spanner
      • Google Cloud Storage
      • In-Memory
      • Manta
      • MSSQL
      • MySQL
      • OCI Object Storage
      • PostgreSQL
      • Integrated Storage (Raft)
      • S3
      • Swift
      • Zookeeper
    • telemetry
    • ui
    • Log Completed Requests
    • Entropy Augmentation
      ENTENT
    • kms_library
      ENTENT

  • Vault Integration Program
  • Vault Interoperability Matrix
  • Troubleshoot






  • Glossary


  • Resources

  • Tutorial Library
  • Certifications
  • Community Forum
    (opens in new tab)
  • Support
    (opens in new tab)
  • GitHub
    (opens in new tab)
  1. Developer
  2. Vault
  3. Documentation
  4. Configuration
  5. storage
  6. Swift
  • Vault
  • v1.11.x
  • v1.10.x
  • v1.9.x
  • v1.8.x
  • v1.7.x
  • v1.6.x
  • v1.5.x
  • v1.4.x

»Swift Storage Backend

The Swift storage backend is used to persist Vault's data in an OpenStack Swift Container.

  • No High Availability – the Swift storage backend does not support high availability.

  • Community Supported – the Swift storage backend is supported by the community. While it has undergone review by HashiCorp employees, they may not be as knowledgeable about the technology. If you encounter problems with them, you may be referred to the original author.

storage "swift" {
  auth_url  = "https://..."
  username  = "admin"
  password  = "secret123!"
  container = "my-storage-container"
}

swift Parameters

  • auth_url (string: <required>) – Specifies the OpenStack authentication endpoint. This can also be provided via the environment variable OS_AUTH_URL.

  • container (string: <required>) – Specifies the name of the Swift container. This can also be provided via the environment variable OS_CONTAINER.

  • max_parallel (string: "128") – The maximum number of concurrent requests.

  • password (string: <required>) – Specifies the OpenStack password. This can also be provided via the environment variable OS_PASSWORD.

  • tenant (string: "") – Specifies the name of the tenant. If left blank, this will default to the default tenant of the username. This can also be provided via the environment variable OS_TENANT_NAME.

  • username (string: <required>) – Specifies the OpenStack account/username. This can also be provided via the environment variable OS_USERNAME.

  • region (string: "") – Specifies the name of the region. This can also be provided via the environment variable OS_REGION_NAME.

  • tenant_id (string: "") - Specifies the id of the tenant. This can also be provided via the environment variable OS_TENANT_ID.

  • domain (string: "") - Specifies the name of the user domain. This can also be provided via the environment variable OS_USER_DOMAIN_NAME.

  • project-domain (string: "") - Specifies the name of the project's domain. This can also be provided via the environment variable OS_PROJECT_DOMAIN_NAME.

  • trust_id (string: "") - Specifies the id of the trust. This can also be provided via the environment variable OS_TRUST_ID.

  • storage_url (string: "") - Specifies storage URL from alternate authentication. This can also be provided via the environment variable OS_STORAGE_URL.

  • auth_token (string: "") - Specifies auth token from alternate authentication. This can also be provided via the environment variable OS_AUTH_TOKEN.

swift Examples

Default Example

This example shows a default configuration for Swift.

storage "swift" {
  auth_url  = "https://os.internal/v1/auth"
  container = "container-239"

  username  = "user1234"
  password  = "pass5678"
}
Edit this page on GitHub

On this page

  1. Swift Storage Backend
  2. swift Parameters
  3. swift Examples
Give Feedback(opens in new tab)
  • Certifications
  • System Status
  • Terms of Use
  • Security
  • Privacy
  • Trademark Policy
  • Trade Controls
  • Give Feedback(opens in new tab)