Metadata-Version: 2.1
Name: akeyless_cloud_id
Version: 0.2.3
Summary: AKEYLESS Cloud ID Retriever
Home-page: https://www.akeyless.io/
Author: Akeyless Security
Author-email: support@akeyless.io
License: Apache 2.0
Keywords: AKEYLESS Cloud ID
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Security
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: urllib3>=1.15
Requires-Dist: requests
Provides-Extra: aws
Requires-Dist: boto3; extra == "aws"
Provides-Extra: gcp
Requires-Dist: google-auth; extra == "gcp"

########################
Akeyless Python Cloud Id
########################

Retrieves cloud identity

Currently, AWS, GCP and Azure clouds are supported.
In order to get cloud identity you should import this package and call the relevant method per your chosen CSP:
- AWS: "generate" (If no aws access id/key and token are provided they will be retrieved automatically from the default session.)
- GCP: "generateGcp"
- Azure: "generateAzure"

Minimum requirements
====================

* Python 3.5+
* urllib3 >= 1.15
* requests

Optional Dependencies
====================

* boto3
* google-auth

Installation
============

.. code::
    pip install akeyless-python-cloud-id

**AWS:**

To install with AWS:

.. code::

    pip install akeyless-python-cloud-id[aws]

The following additional packages will be installed:

* boto3

**GCP:**

To install with GCP:

.. code::

    pip install akeyless-python-cloud-id[gcp]

The following additional packages will be installed:

* google-auth

*****
Usage
*****

Such code can be used, for example, in order to retrieve secrets from Akeyless as part of AWS Code Pipeline:

.. code::
    pip install git+https://github.com/akeylesslabs/akeyless-python-sdk

    import akeyless_api_gateway
    from akeyless_cloud_id import CloudId

    configuration = akeyless_api_gateway.Configuration()
    configuration.host="http://<api-gateway-host>:<port>"

    api_instance = akeyless_api_gateway.DefaultApi(akeyless_api_gateway.ApiClient(configuration))

    cloud_id = CloudId()
    # for AWS use:
    id = cloud_id.generate()
    # For Azure use:
    id = cloud_id.generateAzure()
    # For GCP use:
    id = cloud_id.generateGcp()

    access_id = event['CodePipeline.job']['data']['actionConfiguration']['configuration']['UserParameters']

    auth_response = api_instance.auth(access_id, access_type="aws_iam", cloud_id=id)
    token = auth_response.token

    postgresPassword = api_instance.get_secret_value("PostgresPassword", token)


*******
License
*******
This SDK is distributed under the `Apache License, Version 2.0`_ see LICENSE.txt for more information.


.. _Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0
