Metadata-Version: 2.1
Name: trustyroles
Version: 0.2.3
Summary: AWS roles toolkit
Home-page: https://github.com/hmcguire1/trustyroles
Author: hmcguire1
Author-email: hmcguire.dev@gmail.com
License: UNKNOWN
Description: # Trustyroles
        _An AWS Roles Toolkit_
        
        Trusty Roles is intended to alleviate some of the painpoints I have dealt with in AWS automation leveraging boto3. 
        The first version of this focuses on easily editing the assume role policy document of a role. 
        
        #### Install
        `pip install trustyroles`
        
        ### Assume Role Policy Update Module
        #### Command Line Tool
        #####  arpd_update
        
        -h, --help
        Show this help message and exit
        
        -a, --arn ARN[]
        Add new ARNs to trust policy. Accepts multiple ARNS.
        
        -u, --update_role UPDATE_ROLE
        Role for updating trust policy. Takes an role friendly name as string.
        
        -m,  --method [get, update, remove]
        Takes choice of method to update, get, or remove.
        
        -e, --add_external_id ADD_EXTERNAL_ID
        Takes an external id as a string.
        
        -r, --remove_external_id
        Method for removing externalId condition. Takes no arguments
        
        -j, --json
        Add to print json in get method.
          
        #### Example usage:
        #### Get Policy
        `ardp_update -m get -u 'test-role' --json`
        
        ###### Returns:
        
        {
        
        &nbsp;&nbsp;&nbsp;&nbsp; "Action": "sts:AssumeRole",  
        
        &nbsp;&nbsp;&nbsp;&nbsp; "Condition": {},
        
        &nbsp;&nbsp;&nbsp;&nbsp; "Effect": "Allow",
        
        &nbsp;&nbsp;&nbsp;&nbsp; "Principal": {
        
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; "AWS": ["arn:aws:iam:::user/test-role"]
        
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; }
        
        }
        
        #### Using Python Modules
        #####  arpd_update
        
        #### Get Policy
        ```python
        from trustyroles.arpd_update import arpd_update
        arpd_update.get_arpd('test-role', json_flag=True)
        ```
        ###### Returns:
        {  
        
        &nbsp;&nbsp; "Action": "sts:AssumeRole",  
        
        &nbsp;&nbsp;&nbsp;&nbsp; "Condition": {},
        
        &nbsp;&nbsp;&nbsp;&nbsp; "Effect": "Allow",
        
        &nbsp;&nbsp;&nbsp;&nbsp; "Principal": {
        
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; "AWS": ["arn:aws:iam:::user/test-role"]
        
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; }
        
        }
        
        #### Update Policy ARNS
        The update_arn method takes a list of ARNS(arn_list) and a role_name to add to trust policy of suppplied role.
        
        ```python
        from trustyroles.arpd_update import arpd_update
        arpd_update.update_arn(["arn:aws:iam:::user/test-role2"], role_name='test-role')
        ```
        
        ####  Remove Policy ARNS
        The remove_arn method takes a list of ARNS(arn_list) and a role_name to add to trust policy of suppplied role.
        
        ```python
        from trustyroles.arpd_update import arpd_update
        arpd_update.remove_arn(["arn:aws:iam:::user/test-role2"], role_name='test-role')
        ```
        
        ####  Add ExternalId
        The add_external_id method takes an external_id and role_name as strings to allow the addition of an externalId condition.
        
        ```python
        from trustyroles.arpd_update import arpd_update
        arpd_update.add_external_id('<external_id>', role_name='test-role')
        ```
        
        ####  Remove ExternalId
        The remove_external_id method takes a role_name as a string to allow the removal of an externalId condition.
        
        ```python
        from trustyroles.arpd_update import arpd_update
        arpd_update.remove_external_id(role_name='test-role')
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
