Project

cf-uaa-lib

0.25
Low commit activity in last 3 years
A long-lived project that still receives updates
Client library for interacting with the CloudFoundry User Account and Authorization (UAA) server. The UAA is an OAuth2 Authorization Server so it can be used by webapps and command line apps to obtain access tokens to act on behalf of users. The tokens can then be used to access protected resources in a Resource Server. This library is for use by UAA client applications or resource servers.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Development

~> 2.2
>= 1.9.2, ~> 2.0
>= 1.8.1, ~> 2.5
>= 10.3.2, ~> 13.0
>= 2.14.1, ~> 3.9
~> 0.21.2

Runtime

>= 2.8.0, ~> 2.8
~> 2.8, >= 2.8.2.4
>= 1.12.1, < 1.16
 Project Readme

CloudFoundry UAA Gem

Build Status Gem Version

Client gem for interacting with the CloudFoundry UAA server

For documentation see: https://rubygems.org/gems/cf-uaa-lib

Install from rubygems

$ gem install cf-uaa-lib

Build from source

$ bundle install
$ gem build cf-uaa-lib.gemspec
$ gem install cf-uaa-lib<version>.gem

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 = CF::UAA::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