Skip to main content

No project description provided

Project description

Made with pop, a Python implementation of Plugin Oriented Programming Made with Python

The Idem TLS provider


An Idem plugin to work with TLS keys and certificates.

The plugin fetches TLS certificate information for use with other Idem plugins, such as idem-aws, when creating resources that expose TLS services.

What is POP?

This project is built with pop, a Python-based implementation of Plugin Oriented Programming (POP). POP seeks to bring together concepts and wisdom from the history of computing in new ways to solve modern computing problems.

For more information:

Getting Started


  • Python 3.8+

  • git (if installing from source or contributing to the project)

    To contribute to the project and set up your local development environment, see CONTRIBUTING.rst in the source repository for this project.


You can install idem-tls with the Python package installer (PyPI) or from source.

Install from PyPI

pip install idem-tls

Install from Source

# clone repo
git clone git@<your-project-path>/idem-tls.git
cd idem-tls

# Setup venv
python3 -m venv .venv
source .venv/bin/activate
pip install -e .



After installation, idem-tls execution and state modules are accessible to the pop hub.

For more information:

To set the TLS method that idem-tls uses, configure it in your credentials.yaml file.

Credentials for idem-tls are optional. If you don’t configure a TLS method, the plugin uses TLSv1 by default.


    method: TLSv1_2

For more about Idem credentials files, including recommended steps for encryption and environment variables, see Authenticating with Idem

You are now ready to use idem-tls.

Exec Module

An SLS file specifies the desired state of a resource. You can run an exec module within an SLS file using the state, where the exec module returns a new state that can be referenced with argument binding.

The idem-tls plugin exec module supports TLS certificate get and list operations.

  • tls.certificate.get

    Return the root CA certificate for a given URL.

  • tls.certificate.list

    Return the certificate chain for a given URL.


    - path: tls.certificate.get
    - kwargs:
        url: 'string'


    - path: tls.certificate.get
    - kwargs:
        - sample_client
        - ${exec:unmanaged-tls_certificate:sha1_fingerprint}
        - Key: tag-key-1
          Value: tag-value-1
        - Key: tag-key-2
          Value: tag-value-2

Idem command line example:

idem exec exec.tls.certificate.list url=

Current Supported Resource States



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

idem-tls-2.0.0.tar.gz (12.5 kB view hashes)

Uploaded Source

Built Distribution

idem_tls-2.0.0-py3-none-any.whl (11.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page