# Key Vault

This document explains how to get started using Azure Key Vault Service with Fog to manage Vault. With this gem you can create, list or delete Vault.

## Usage

First of all, you need to require the Fog library by executing:

```ruby
require 'fog/azurerm'
```
## Create Connection

Next, create a connection to the Key Vault Service:

```ruby
fog_key_vault_service = Fog::KeyVault::AzureRM.new(
        tenant_id: '<Tenant Id>',                  # Tenant Id of Azure Active Directory Application
        client_id:    '<Client Id>',               # Client Id of Azure Active Directory Application
        client_secret: '<Client Secret>',          # Client Secret of Azure Active Directory Application
        subscription_id: '<Subscription Id>'       # Subscription Id of an Azure Account
)
```

## Check Vault Existence

```ruby
 fog_key_vault_service.vaults.check_vault_exists('<Resource Group Name>', '<Vault Name>')
```

## Create Vault

Create a new Vault.

```ruby
vault = fog_key_vault_service.vaults.create(
        name: '<Vault Name>',
        location: '<Location>',
        resource_group: '<Resource Group Name>',
        tenant_id: '<Tenant Id>',
        sku_family: '<SKU Family>',
        sku_name: '<SKU Name>',
        access_policies: [
                           {
                             tenant_id: '<Tenant Id>',
                             object_id: '<Tenant Id>',
                             permissions: {
                               keys: ['<Key Permissions>'],
                               secrets: ['<Secret Permissions>']
                             }
                           }
                         ],
        tags: {
                key: 'value'                       # [Optional]
        }

)
```

## List Vaults

List all vaults in a resource group

```ruby
vaults = fog_key_vault_service.vaults(resource_group: '<Resource Group Name>')
vaults.each do |vault|
      puts "#{vault.name}"
end
```

## Retrieve a single Vault

Get a single record of Vault

```ruby
vault = fog_key_vault_service
                       .vaults
                       .get('<Resource Group Name>', '<Vault Name>')
puts "#{vault.name}"
```

## Destroy a single Vault

Get a vault object from the get method and then destroy that vault.

```ruby
vault.destroy
```

## Support and Feedback
Your feedback is highly appreciated! If you have specific issues with the fog ARM, you should file an issue via Github.