# salt.sdb.confidant

An SDB module for getting credentials from confidant.

## Configuring the Confidant module

The module can be configured via sdb in the minion config:

    confidant:
      driver: confidant
      # The URL of the confidant web service
      url: 'https://confidant-production.example.com'
      # The context to use for KMS authentication
      auth_context:
        from: example-production-iad
        to: confidant-production-iad
        user_type: service
      # The KMS master key to use for authentication
      auth_key: "alias/authnz"
      # Cache file for KMS auth token
      token_cache_file: /run/confidant/confidant_token
      # The duration of the validity of a token, in minutes
      token_duration: 60
      # key, keyid and region can be defined in the profile, but it's generally
      # best to use IAM roles or environment variables for AWS auth.
      keyid: 98nh9h9h908h09kjjk
      key: jhf908gyeghehe0he0g8h9u0j0n0n09hj09h0
      region: us-east-1

depends:

  confidant-common, confidant-client

## Module Documentation

salt.sdb.confidant.get(key, profile=None)

  Read pillar data from Confidant via its API.

  CLI Example:

      salt myminion sdb.get 'sdb://confidant/credentials'

  Valid keys are: credentials, credentials_metadata, result. credentials returns a dict of joined credential_pairs, credentials_metadata returns a dict of metadata relevant to the credentials mapped to the confidant service, and result returns a bool that can be used to determine if the sdb call succeeded or failed to fetch credentials from confidant (or from local cache). If result is false, the data in credentials or credentials_metadata can't be trusted.