An open API service indexing awesome lists of open source software.

https://github.com/ankitsaini2609/pviewer

This Tool will be used to find the conflicting policies for a user.
https://github.com/ankitsaini2609/pviewer

aws boto3 iam iam-policy python3

Last synced: about 1 year ago
JSON representation

This Tool will be used to find the conflicting policies for a user.

Awesome Lists containing this project

README

          

# PViewer
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Twitter](https://img.shields.io/twitter/follow/d3afh3av3n?style=social)](https://twitter.com/d3afh3av3n)

## Table of Contents

* [About the Project](#about-the-project)
* [Built With](#built-with)
* [Getting Started](#getting-started)
* [Installation via pip](#Installation-via-pip)
* [How to run](#How-to-run)
* [Project Setup](#project-setup)
* [Usage](#usage)
* [License](#license)
* [Contact](#contact)
* [Acknowledgements](#acknowledgements)

## About The Project

PViewer is a tool which will be used to find the conflicting policies for a AWS IAM user.

### Built With
* [python3](https://docs.python.org/3/)

## Getting Started

This is an example of how you may give instructions on setting up your project locally.
To get a local copy up and running follow these simple example steps.

### Installation via pip

1. Install using pip:
```sh
pip3 install pviewer
```

### How to run
1. Set the AWS_PROFILE as environment variable
```sh
export AWS_PROFILE=default
```
2. Run
```sh
python3 -m pviewer -u username
Where username is IAM username in AWS for which you have to find the overlapping policies
```

### Project Setup

1. Clone this repo
* With HTTPS
```sh
git clone https://github.com/ankitsaini2609/PViewer.git
```
* With SSH (just use HTTPS if you aren't sure what SSH is)
```sh
git clone git@github.com:ankitsaini2609/PViewer.git
```
2. Hop into the project directory
```sh
cd PViewer/pviewer
```
3. Install python3 packages
```sh
sudo pip3 install -r requirements.txt
```
4. Set the AWS_PROFILE as environment variable
```sh
export AWS_PROFILE=default
```
5. Run it :rocket:
```sh
python3 __main__.py -u username
Where username is IAM username in AWS for which you have to find the overlapping policies.
```
6. Output
![OUTPUT](https://github.com/ankitsaini2609/PViewer/blob/master/pviewer/output.png "output")

## Usage
Two policies allowing you to write objects in the same S3 bucket. It will plot a graph and connecting overlapping policies as edges.

![DEMO](https://github.com/ankitsaini2609/PViewer/blob/master/pviewer/demo.gif "demo")

## License

Distributed under the MIT License. See [LICENSE](https://github.com/ankitsaini2609/PViewer/blob/master/LICENSE.txt) for more information.

## Contact

Ankit Saini
* Twitter - [@d3afh3av3n](https://twitter.com/d3afh3av3n)
* Github - [ankitsaini2609](https://github.com/ankitsaini2609)
* Medium - [ankitsaini2609](https://medium.com/@ankitsaini2609)
* LinkedIn - [ankitsaini2609](https://linkedin.com/in/ankitsaini2609)

## Acknowledgements
* [GitHub Emoji Cheat Sheet](https://www.webpagefx.com/tools/emoji-cheat-sheet)
* [Choose an Open Source License](https://choosealicense.com)