Skip to main content

A collection of Python modules used for interacting with IBMCloud IAM API services

Project description


PyPi Downloads License Build Status

This project is a collection of Python modules used for interacting with IBMCloud IAM API services.

Currently it includes support for:

  • Requesting IAM tokens using an intelligent caching mechanism (TokenManager)
  • Parsing IAM tokens and verifying their cryptographic signatures
  • Checking user action authorizations for a service, given a Subject, Action and Resource set (PDPClient)

It is meant to be a lightweight client library that can be used in other projects, such as a service or other client.

Some things that will be added soon in the future:

  • Caching authorization decisions from PDP
  • Support for list a users Roles assigned from IAM policies



pip install ibmcloud_iam

Getting tokens with TokenManager

import os

from ibmcloud_iam.token import TokenManager

tm = TokenManager(api_key=os.environ["IBMCLOUD_API_KEY"])

# whenever you need a token, just use 'tm.get_token()'
# get_token() will return a cached token if the token is not expired,
# or if expired or otherwise invalid, retrieve a new token for you

# gets a new token

# will return the same token as above, because of caching

Parsing and Validating Tokens

import os

import ibmcloud_iam.token
from ibmcloud_iam.token import TokenManager

tm = TokenManager(api_key=os.environ["IBMCLOUD_API_KEY"])

# validate_token will check the signature and parse and return the token claims
claims = ibmcloud_iam.token.validate_token(tm.get_token())


PDP Authorizations

Please see for an example on how to use the PDPClient


Feedback is appreciated in the form of bug reports, enhancement suggestions, testing, or pull requests/patches.

Pull requests and patches will be subject to review and will have to meet the standards of the project to be merged. We are willing to help with fixing issues and polishing if you are willing to be patient and understanding.

For bug reports, feature requests, or other support, please open a Github Issue in this repo.

If you are an IBMer and have access to the IBM Slack group, feel free to direct message me with questions at @mrodden.

Project details

Download files

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

Files for ibmcloud-iam, version 0.1.6
Filename, size File type Python version Upload date Hashes
Filename, size ibmcloud_iam-0.1.6-py3-none-any.whl (10.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size ibmcloud-iam-0.1.6.tar.gz (8.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page