mittwald/vault-php

A PHP client library for 'Vault by HashiCorp'

2.1.0 2024-08-26 11:39 UTC

This package is auto-updated.

Last update: 2024-10-26 11:58:17 UTC


README

Tests

PHP Client Library for the Hashicorp Vault Service. This Client follows the Request and Response Data equal to the Hashicorp Vault Client Documentation.

Feel free to open Pull Requests to add improvements or missing functionality.

Installation

Composer

composer require mittwald/vault-php

Implemented Functionality:

  • Auth
    • User/Password
    • Token
    • Kubernetes
    • AppRole
  • Secret Engines
    • Transit Engine
      • Encrypt/Decrypt
      • Update Key Config
      • Create Key
      • Delete Key
      • List Keys
      • Sign Data

Basic Usage

// setting up independent http client 
$httpClient = new Client();

// setting up vault auth provider
$auth = new Token('foo');

// creating the vault request client
$client = new VaultClient(
    $httpClient,
    $auth,
    'http://127.0.0.1:8200'
);

// selecting the desired secret engine
// e.g. Transit Secret Engine
$api = new Transit($client);

// calling specific endpoint
$response = $api->listKeys();

//reading results
var_dump($response->getKeys());
//...
//...
//Profit...

VaultClient

public function __construct(
    HttpClient $httpClient,
    AuthenticationProviderInterface $authProvider,
    string $apiHost
)

HttpClient takes every PSR-18 compliant HTTP Client Adapter like "php-http/curl-client": "^1.7"

AuthenticationProviderInterface Authentication Provider from /authentication/provider/*

$apiHost Hashicorp Vault REST Endpoint URL

Bulk Requests

Using Bulk Requests also requires to iterate through the Response and calling hasErrors within the MetaData of each Bulk Item to ensure it was processed successfully.

Exceptions

Calling library methods will throw exceptions, indicating where ever invalid data was provided or HTTP errors occurred or Vault Generic Endpoint Errors are encountered.

VaultException

Generic Root Exception where every exception in this library extends from.

VaultHttpException

Exception will thrown when something inside the HTTP handling will cause an error.

VaultAuthenticationException

Will be thrown when API Endpoint Authentication fails.

VaultResponseException

Will be thrown on 5xx status code errors.

InvalidRouteException

Calling an Invalid/Non Existing/Disabled Vault API Endpoint will throw this Exception.

InvalidDataException

Exception indicates a failed server payload validation.

KeyNameNotFoundException

Will be thrown when trying to request an API Endpoint where the Key Name - that is indicated within the url - will not exist.