# pyawsopstoolkit_security
The **pyawsopstoolkit_security** package offers a comprehensive array of features designed to identify security risks
and vulnerabilities associated with AWS (Amazon Web Services), such as IAM roles without permissions boundaries.
Meticulously engineered, these features are finely tuned to meet the unique demands of the expansive AWS ecosystem,
encompassing a diverse spectrum of aspects.
## Getting Started
Ready to supercharge your AWS operations? Let's get started with **pyawsopstoolkit_security**!
### Installation
Install **pyawsopstoolkit_security** via pip:
```bash
pip install pyawsopstoolkit_security
```
## Documentation
- [iam](#iam)
### iam
This **pyawsopstoolkit_security.iam** subpackage offers features designed to identify security risks and vulnerabilities
associated with AWS (Amazon Web Services) Identity and Access Management (IAM).
#### Role
A class representing security risks and vulnerabilities related to IAM roles.
##### Constructors
- `Role(session: Session) -> None`: Initializes a new **Role** object.
##### Methods
- `roles_without_permissions_boundary() -> list`: Retrieves a list of IAM roles lacking associated permissions
boundaries, facilitating targeted risk assessment and mitigation.
##### Properties
- `session`: An `pyawsopstoolkit.session.Session` object providing access to AWS services.
##### Usage
```python
from pyawsopstoolkit.session import Session
from pyawsopstoolkit_security.iam import Role
# Create a session using default profile
session = Session(profile_name='default')
# Initialize IAM Role object
role_object = Role(session=session)
# Retrieve IAM roles without permissions boundaries
roles_without_boundaries = role_object.roles_without_permissions_boundary()
# Print the list of roles without permissions boundaries
print(roles_without_boundaries)
```
##### References
- [Permissions boundaries for IAM entities](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html)
- [When and where to use IAM permissions boundaries](https://aws.amazon.com/blogs/security/when-and-where-to-use-iam-permissions-boundaries/)
#### User
A class representing security risks and vulnerabilities related to IAM users.
##### Constructors
- `User(session: Session) -> None`: Initializes a new **User** object.
##### Methods
- `users_without_permissions_boundary() -> list`: Retrieves a list of IAM users lacking associated permissions
boundaries, facilitating targeted risk assessment and mitigation.
##### Properties
- `session`: An `pyawsopstoolkit.session.Session` object providing access to AWS services.
##### Usage
```python
from pyawsopstoolkit.session import Session
from pyawsopstoolkit_security.iam import User
# Create a session using default profile
session = Session(profile_name='default')
# Initialize IAM User object
user_object = User(session=session)
# Retrieve IAM users without permissions boundaries
users_without_boundaries = user_object.users_without_permissions_boundary()
# Print the list of users without permissions boundaries
print(users_without_boundaries)
```
##### References
- [Permissions boundaries for IAM entities](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html)
- [When and where to use IAM permissions boundaries](https://aws.amazon.com/blogs/security/when-and-where-to-use-iam-permissions-boundaries/)
# License
Please refer to the [MIT License](LICENSE) within the project for more information.
# Contributing
We welcome contributions from the community! Whether you have ideas for new features, bug fixes, or enhancements, feel
free to open an issue or submit a pull request on [GitHub](https://github.com/coldsofttech/pyawsopstoolkit-security).
Raw data
{
"_id": null,
"home_page": "https://github.com/coldsofttech/pyawsopstoolkit-models.git",
"name": "pyawsopstoolkit-security",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "aws, toolkit, operations, tools, development, python, utilities, insights, search, advance-search, hygiene, filtering, amazon-web-services",
"author": "coldsofttech",
"author_email": null,
"download_url": null,
"platform": null,
"description": "# pyawsopstoolkit_security\n\nThe **pyawsopstoolkit_security** package offers a comprehensive array of features designed to identify security risks\nand vulnerabilities associated with AWS (Amazon Web Services), such as IAM roles without permissions boundaries.\nMeticulously engineered, these features are finely tuned to meet the unique demands of the expansive AWS ecosystem,\nencompassing a diverse spectrum of aspects.\n\n## Getting Started\n\nReady to supercharge your AWS operations? Let's get started with **pyawsopstoolkit_security**!\n\n### Installation\n\nInstall **pyawsopstoolkit_security** via pip:\n\n```bash\npip install pyawsopstoolkit_security\n```\n\n## Documentation\n\n- [iam](#iam)\n\n### iam\n\nThis **pyawsopstoolkit_security.iam** subpackage offers features designed to identify security risks and vulnerabilities\nassociated with AWS (Amazon Web Services) Identity and Access Management (IAM).\n\n#### Role\n\nA class representing security risks and vulnerabilities related to IAM roles.\n\n##### Constructors\n\n- `Role(session: Session) -> None`: Initializes a new **Role** object.\n\n##### Methods\n\n- `roles_without_permissions_boundary() -> list`: Retrieves a list of IAM roles lacking associated permissions\n boundaries, facilitating targeted risk assessment and mitigation.\n\n##### Properties\n\n- `session`: An `pyawsopstoolkit.session.Session` object providing access to AWS services.\n\n##### Usage\n\n```python\nfrom pyawsopstoolkit.session import Session\nfrom pyawsopstoolkit_security.iam import Role\n\n# Create a session using default profile\nsession = Session(profile_name='default')\n\n# Initialize IAM Role object\nrole_object = Role(session=session)\n\n# Retrieve IAM roles without permissions boundaries\nroles_without_boundaries = role_object.roles_without_permissions_boundary()\n\n# Print the list of roles without permissions boundaries\nprint(roles_without_boundaries)\n```\n\n##### References\n\n- [Permissions boundaries for IAM entities](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html)\n- [When and where to use IAM permissions boundaries](https://aws.amazon.com/blogs/security/when-and-where-to-use-iam-permissions-boundaries/)\n\n#### User\n\nA class representing security risks and vulnerabilities related to IAM users.\n\n##### Constructors\n\n- `User(session: Session) -> None`: Initializes a new **User** object.\n\n##### Methods\n\n- `users_without_permissions_boundary() -> list`: Retrieves a list of IAM users lacking associated permissions\n boundaries, facilitating targeted risk assessment and mitigation.\n\n##### Properties\n\n- `session`: An `pyawsopstoolkit.session.Session` object providing access to AWS services.\n\n##### Usage\n\n```python\nfrom pyawsopstoolkit.session import Session\nfrom pyawsopstoolkit_security.iam import User\n\n# Create a session using default profile\nsession = Session(profile_name='default')\n\n# Initialize IAM User object\nuser_object = User(session=session)\n\n# Retrieve IAM users without permissions boundaries\nusers_without_boundaries = user_object.users_without_permissions_boundary()\n\n# Print the list of users without permissions boundaries\nprint(users_without_boundaries)\n```\n\n##### References\n\n- [Permissions boundaries for IAM entities](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html)\n- [When and where to use IAM permissions boundaries](https://aws.amazon.com/blogs/security/when-and-where-to-use-iam-permissions-boundaries/)\n\n# License\n\nPlease refer to the [MIT License](LICENSE) within the project for more information.\n\n# Contributing\n\nWe welcome contributions from the community! Whether you have ideas for new features, bug fixes, or enhancements, feel\nfree to open an issue or submit a pull request on [GitHub](https://github.com/coldsofttech/pyawsopstoolkit-security).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "This package offers a comprehensive array of features designed to identify security risks and vulnerabilities associated",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/coldsofttech/pyawsopstoolkit-models.git"
},
"split_keywords": [
"aws",
" toolkit",
" operations",
" tools",
" development",
" python",
" utilities",
" insights",
" search",
" advance-search",
" hygiene",
" filtering",
" amazon-web-services"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8454af985173474700b8c3764e2bf337b4b1a801d536b2b8a0878a5638dffc1b",
"md5": "2692318e32929314d500e74c8c028580",
"sha256": "0f136438e21e35b7b6cefab42367f5749fe1cf2a4f1113d742bc86be65f44648"
},
"downloads": -1,
"filename": "pyawsopstoolkit_security-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2692318e32929314d500e74c8c028580",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 5271,
"upload_time": "2024-08-11T14:07:01",
"upload_time_iso_8601": "2024-08-11T14:07:01.050529Z",
"url": "https://files.pythonhosted.org/packages/84/54/af985173474700b8c3764e2bf337b4b1a801d536b2b8a0878a5638dffc1b/pyawsopstoolkit_security-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-11 14:07:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "coldsofttech",
"github_project": "pyawsopstoolkit-models",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "pyawsopstoolkit-security"
}
JSON
