IAM Policy Troubleshooter makes it easier to understand why a user has
access to a resource or doesn’t have permission to call an API. Given an email,
resource, and permission, Policy Troubleshooter examines all Identity and
Access Management (IAM) policies that apply to the resource. It then reveals
whether the member’s roles include the permission on that resource and, if so,
which policies bind the member to those roles.
Install this library in a virtualenv using pip. virtualenv is a tool to
create isolated Python environments. The basic problem it addresses is one of
dependencies and versions, and indirectly permissions.
With virtualenv, it’s possible to install this library without needing system
install permissions, and without clashing with the installed system
dependencies.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["Version latestkeyboard_arrow_down\n\n- [1.13.3 (latest)](/python/docs/reference/policytroubleshooter/latest)\n- [1.13.1](/python/docs/reference/policytroubleshooter/1.13.1)\n- [1.12.1](/python/docs/reference/policytroubleshooter/1.12.1)\n- [1.11.5](/python/docs/reference/policytroubleshooter/1.11.5)\n- [1.10.0](/python/docs/reference/policytroubleshooter/1.10.0)\n- [1.9.0](/python/docs/reference/policytroubleshooter/1.9.0)\n- [1.8.2](/python/docs/reference/policytroubleshooter/1.8.2)\n- [1.7.1](/python/docs/reference/policytroubleshooter/1.7.1)\n- [1.6.0](/python/docs/reference/policytroubleshooter/1.6.0)\n- [1.5.4](/python/docs/reference/policytroubleshooter/1.5.4)\n- [1.4.2](/python/docs/reference/policytroubleshooter/1.4.2)\n- [1.3.1](/python/docs/reference/policytroubleshooter/1.3.1)\n- [1.2.0](/python/docs/reference/policytroubleshooter/1.2.0)\n- [1.1.3](/python/docs/reference/policytroubleshooter/1.1.3)\n- [1.0.0](/python/docs/reference/policytroubleshooter/1.0.0)\n- [0.2.0](/python/docs/reference/policytroubleshooter/0.2.0)\n- [0.1.0](/python/docs/reference/policytroubleshooter/0.1.0) \n\nPython Client for IAM Policy Troubleshooter\n===========================================\n\n[](https://github.com/googleapis/google-cloud-python/blob/master/README.rst#beta-support) [](https://pypi.org/project/google-cloud-policy-troubleshooter/) [](https://pypi.org/project/google-cloud-policy-troubleshooter/)\n\n[IAM Policy Troubleshooter](https://cloud.google.com/iam/docs/troubleshooting-access#rest-api/) makes it easier to understand why a user has\naccess to a resource or doesn't have permission to call an API. Given an email,\nresource, and permission, Policy Troubleshooter examines all Identity and\nAccess Management (IAM) policies that apply to the resource. It then reveals\nwhether the member's roles include the permission on that resource and, if so,\nwhich policies bind the member to those roles.\n\n- [Client Library Documentation](https://googleapis.dev/python/policytroubleshooter/latest)\n\n- [Product Documentation](https://cloud.google.com/iam/docs/troubleshooting-access#rest-api/)\n\nQuick Start\n-----------\n\nIn order to use this library, you first need to go through the following steps:\n\n1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)\n\n2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)\n\n3. [Enable the Resource Manager API Service.](https://cloud.google.com/iam/docs/quickstart-client-libraries)\n\n4. [Setup Authentication.](https://googleapis.dev/python/google-api-core/latest/auth.html)\n\n### Installation\n\nInstall this library in a [virtualenv](https://virtualenv.pypa.io/en/latest/) using pip. [virtualenv](https://virtualenv.pypa.io/en/latest/) is a tool to\ncreate isolated Python environments. The basic problem it addresses is one of\ndependencies and versions, and indirectly permissions.\n\nWith [virtualenv](https://virtualenv.pypa.io/en/latest/), it's possible to install this library without needing system\ninstall permissions, and without clashing with the installed system\ndependencies.\n\n#### Mac/Linux\n\n pip install virtualenv\n virtualenv \u003cyour-env\u003e\n source \u003cyour-env\u003e/bin/activate\n \u003cyour-env\u003e/bin/pip install google-cloud-policy-troubleshooter\n\n#### Windows\n\n pip install virtualenv\n virtualenv \u003cyour-env\u003e\n \u003cyour-env\u003e\\Scripts\\activate\n \u003cyour-env\u003e\\Scripts\\pip.exe install google-cloud-policy-troubleshooter\n\n### Next Steps\n\n- Read the [Client Library Documentation](https://googleapis.dev/python/policytroubleshooter/latest) for IAM Policy Troubleshooter\n to see other available methods on the client.\n\n- Read the [IAM Policy Troubleshooter Product documentation](https://cloud.google.com/iam/docs/quickstart-client-libraries) to learn\n more about the product and see How-to Guides.\n\n- View this [README](https://github.com/googleapis/google-cloud-python/blob/master/README.rst) to see the full list of Cloud\n APIs that we cover."]]