Pull request Compare This branch is 226 commits ahead of cfid:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
..
Failed to load latest commit information.
bin
lib
spec
.gitignore
Gemfile
README.md
Rakefile
cf-uaa-client.gemspec

README.md

CloudFoundry UAA Gem

NOTE: This gem is deprecated. Please use cf-uaa-lib and cf-uaac gems instead. They are available from rubygems.org or https://github.com/cloudfoundry/cf-uaa-lib and https://github.com/cloudfoundry/cf-uaac

Client gem for interacting with the CloudFoundry UAA server.

Set up a local ruby environment (so sudo not required):

$ rvm use 1.9.2

or

$ rbenv global 1.9.2-p180

see: https://rvm.io/ or http://rbenv.org/

Build the gem

$ bundle install
$ gem build cf-uaa-client.gemspec

Install it

$ gem install cf-uaa-client*.gem

Run it

$ uaac help
$ uaac target uaa.cloudfoundry.com
$ uaac token get <your-cf-username>
$ uaac token decode

Use the gem:

#!/usr/bin/env ruby
require 'uaa'
token_issuer = CF::UAA::TokenIssuer.new("https://uaa.cloudfoundry.com", "vmc")
puts token_issuer.prompts.inspect
token = token_issuer.implicit_grant_with_creds(username: "<your_username>", password: "<your_password>")
token_info = TokenCoder.decode(token.info[:access_token], nil, nil, false) #token signature not verified
puts token_info[:user_name]

Tests

Run the tests with rake:

$ bundle exec rake test

Run the tests and see a fancy coverage report:

$ bundle exec rake cov

Run integration tests (on a server running on localhost:8080/uaa):

$ export UAA_CLIENT_ID="admin"
$ export UAA_CLIENT_SECRET="adminsecret"
$ export UAA_CLIENT_TARGET="http://localhost:8080/uaa"
$ bundle exec rspec spec/integration_spec.rb