chef

https://github.com/opscode/chef

Ruby

A systems integration framework, built to bring the benefits of configuration management to your entire infrastructure.

Chef::Mixin::UserContext#with_user_context

valid values for authentication => :remote, :local
When authentication = :local, we use the credentials to create a logon session against the local system, and then try to access the files.
When authentication = :remote, we continue with the current user but pass the provided credentials to the remote system.

Source | Google | Stack overflow

Edit

git clone [email protected]:opscode/chef.git

cd chef

open lib/chef/mixin/user_context.rb

Contribute

# Make a new branch

git checkout -b -your-name--update-docs-Chef--Mixin--UserContext-with_user_context-for-pr

# Commit to git

git add lib/chef/mixin/user_context.rbgit commit -m "better docs for Chef::Mixin::UserContext#with_user_context"

# Open pull request

gem install hub # on a mac you can `brew install hub`

hub fork

git push <your name> -your-name--update-docs-Chef--Mixin--UserContext-with_user_context-for-pr

hub pull-request

# Celebrate!