Copyright (c) Rally Software Development Corp. 2014 Distributed under the MIT License.

The Rally User Management toolkit is available on an as-is basis.

Rally Software does not actively maintain or support this toolkit. If you have a problem or question, we recommend filing a Github Issue or posting a question to Stack Overflow: http:https://stackoverflow.com/questions/ask?tags=rally

• grant_everyone_editor_access.rb: script to grant Editor-level to a project of interest, to all enabled Rally users that don't already have it.
• grant_everyone_viewer_access.rb: script to grant Viewer-level to a project of interest, to all enabled Rally users that don't already have it.
• summarize_project_permissions.rb: script to summarize Permissions for all Users within a Project of interest. Includes Admins - this is an audit-quality script, whereas user_permissions_summary.rb summarizes permissions only for Users that have access.
• update_project_permissions.rb: script to update Permissions for all non-Admin users already existing in a Project, to an updated value of interest.
• user_permissions_summary_selected.rb: script to summarize permissions only for a select list of users specified in an input CSV file.

The Rally-User-Management kit is an enhanced toolset for Rally subscription administrators who want to bulk create/update users in their Rally subscription, enable/disable users, and assign permissions.

Rally-User-Management provides the following updates and enhancements from the original user_mgmt toolkit:

• Updated to use rally_api gem instead of rally_rest_api
• rally_api greatly improves speed and reliability.
• Provides bulk permission management granular to Projects (original provisioned at Workspace level only)
• Provides capability to bulk assign or update team membership

Rally-User-Management requires:

• Ruby 1.9.3
• rally_api 1.0.1 or higher
• You can install rally_api and dependent gems by using:
• gem install rally_api

The Rally user management toolkit takes a set of users formatted in a Tab-Delimited text file and performs the following functions:

• Creates the users in your Rally subscription if they do not exist, and
• Assigns and/or updates permissions to users across workspaces and projects.
• Assigns and/or updates team memberships for users across projects
• Enables or disables user in your Rally subscription

The contents of this Github repository include:

• change_usernames_template.csv - Template file showing format for username/email bulk update mapping
• change_usernames.rb - Script to bulk update usernames and email addresses
• enable_or_disable_users.rb - Script to bulk enable or disable users
• enable_or_disable_users_template.txt - Template file contain list of users to enable/disable
• grant_everyone_editor_access.rb - Script to grant Editor-level to a project of interest, to all enabled Rally users that don't already have it.
• grant_everyone_viewer_access.rb - Script to grant Viewer-level to a project of interest, to all enabled Rally users that don't already have it.
• ldap_username_load.rb - Script to update Onprem Ldap Username field when enabling LDAP for Rally On-Premise
• ldap_username_load_template.csv - Template file contain list of Username and OnpremLdapUsername values.
• my_vars.rb - User configurable variables
• new_user_list_template.txt - Template list of users/attributes you want to create
• simple_user_loader.rb - A simplified user loader that creates users directly.
• simple_user_loader_template.txt - START HERE! Template file for users, permissions, and attributes used as input to the simple_user_loader.rb script.
• update_user_attributes.rb - A script to bulk update standard and extended User Attributes such as Department, CostCenter, Default Workspace/Project, TimeZone.
• update_user_attributes_template.txt - Template file for user attribute updates, used as input to the update_user_attributes.rb script
• user_loader_from_export.rb - Script to create users from a CSV input file generated by an export from Rally UI.
• user_loader_from_export_template.txt - Template file for user attribute updates, used as input to the user_loader_from_export.rb script
• user_permissions_loader.rb - Script to upload users and permissions
• user_permissions_loader_template.txt - Template file showing what an upload file should look like
• user_permissions_summary.rb - Script to output summary of user permissions AND Team Membership for all users
• user_permissions_syncer.rb - Script to synchronize permissions and team memberships from a list of existing users in Rally to a list of target users needing updated permissions.
• user_permissions_template_generator.rb - Script to generate template of WorkspacePermissions and ProjectPermissions for all users in the new_user_list file
• user_sync_template.txt - Template/example file for input to user_permissions_syncer.rb
• user_team_membership_summary.rb - Script that summarizes just team membership(s) for all users
• README.docx - User guide Word document
• README.md - This README
• README.pdf - User guide PDF

Please clone the repo and save to a folder on your local drive.

To run the tests for the permissions utility, you will need to make a copy of the example_test_configuration_helper.rb file and update it with your own credentials to use for testing.