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.

Source Distribution

ibmcloud-iam-0.1.7.tar.gz (8.4 kB view hashes)

Uploaded source

Built Distribution

ibmcloud_iam-0.1.7-py3-none-any.whl (10.3 kB view hashes)

Uploaded py3

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