Skip to main content

IBM Cloud Secrets Manager Python SDK

Project description

IBM Cloud Secrets Manager Python SDK

A Python client library to interact with the IBM Cloud® Secrets Manager APIs.

Table of Contents

Overview

The IBM Cloud Secrets Manager Python SDK allows developers to programmatically interact with the following IBM Cloud services:

Service name Imported class name
Secrets Manager SecretsManagerV1

Prerequisites

Installation

To install, use pip or easy_install:

pip install --upgrade "ibm-secrets-manager-sdk"

or

easy_install --upgrade "ibm-secrets-manager-sdk"

Authentication

Secrets Manager uses token-based Identity and Access Management (IAM) authentication.

With IAM authentication, you supply an API key that is used to generate an access token. Then, the access token is included in each API request to Secrets Manager. Access tokens are valid for a limited amount of time and must be regenerated.

Authentication for this SDK is accomplished by using IAM authenticators. Import authenticators from ibm_cloud_sdk_core.authenticators.

Examples

Programmatic credentials

from ibm_cloud_sdk_core.authenticators.iam_authenticator import IAMAuthenticator

secretsManager = SecretsManagerV1(
    authenticator=IAMAuthenticator(apikey='<IBM_CLOUD_API_KEY>')
)

To learn more about IAM authenticators and how to use them in your Python application, see the IBM Python SDK Core documentation.

Using the SDK

Basic usage

  • Use the set_service_url method to set the endpoint URL that is specific to your Secrets Manager service instance. To find your endpoint URL, you can copy it from the Endpoints page in the Secrets Manager UI.

Examples

Construct a service client and use it to create and retrieve a secret from your Secrets Manager instance.

Here's an example secrets_manager.py file:

from ibm_cloud_sdk_core.authenticators.iam_authenticator import IAMAuthenticator
from ibm_secrets_manager_sdk.secrets_manager_v1 import *

secretsManager = SecretsManagerV1(
    authenticator=IAMAuthenticator(apikey='<IBM_CLOUD_API_KEY>')
)

secretsManager.set_service_url('<SERVICE_URL>')

# create arbitrary secret
response = secretsManager.create_secret(
    'arbitrary',
    {'collection_type': 'application/vnd.ibm.secrets-manager.secret+json', 'collection_total': 1},
    [{'name': 'example-arbitrary-secret', 'description': 'Extended description for this secret.',
      'payload': 'secret-data'}]
)

secretId = response.result['resources'][0]['id']

# get arbitrary secret
response = secretsManager.get_secret(
    'arbitrary',
    secretId
)

secretPayload = response.result['resources'][0]['secret_data']['payload']
print('The arbitrary secret payload is: ' + secretPayload)

Replace the apikey and set_service_url() values. Then use the python secrets_manager.py command to run your application. You should see the payload of the arbitrary secret that was created.

For more information and IBM Cloud SDK usage examples for Python, see the IBM Cloud SDK Common documentation.

Questions

If you're having difficulties using this SDK, you can ask questions about this project by using Stack Overflow. Be sure to include the ibm-cloud and ibm-secrets-manager tags.

You can also check out the Secrets Manager documentation and API reference for more information about the service.

Issues

If you encounter an issue with the project, you're welcome to submit a bug report to help us improve.

Contributing

For general contribution guidelines, see CONTRIBUTING.

License

This SDK project is released under the Apache 2.0 license. The license's full text can be found in LICENSE.

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

ibm-secrets-manager-sdk-1.0.22.tar.gz (81.1 kB view details)

Uploaded Source

Built Distribution

ibm_secrets_manager_sdk-1.0.22-py3-none-any.whl (81.7 kB view details)

Uploaded Python 3

File details

Details for the file ibm-secrets-manager-sdk-1.0.22.tar.gz.

File metadata

File hashes

Hashes for ibm-secrets-manager-sdk-1.0.22.tar.gz
Algorithm Hash digest
SHA256 c6238ea0d26bbda73896a58db2041592426910282bdc81fc1f04367a2706a571
MD5 a4d170161fc083b782f53a68b889ca18
BLAKE2b-256 a03830ac01d1d49be428d9259fb0e20ece16a40eeb6ee5fe2b49bf17ee9481c8

See more details on using hashes here.

File details

Details for the file ibm_secrets_manager_sdk-1.0.22-py3-none-any.whl.

File metadata

File hashes

Hashes for ibm_secrets_manager_sdk-1.0.22-py3-none-any.whl
Algorithm Hash digest
SHA256 eb2bec793d9985ef6ef7a7362c89722b1cd135ea927592abb2da651cbee0cfb5
MD5 229cecb92c1c24117b5c2d057365e70b
BLAKE2b-256 e3e2acef83737f50455fe81625fba286e2d0bd39f10ea1ddcac296943cb02195

See more details on using hashes here.

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