Low commit activity in last 3 years
A long-lived project that still receives updates
Ruby WebFinger client library
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 0
>= 1.6.2

Runtime

 Project Readme

WebFinger¶ ↑

An Ruby WebFinger client library.

Following the latest WebFinger spec discussed at IETF WebFinger WG. tools.ietf.org/html/draft-ietf-appsawg-webfinger

If you found something different from the latest spec, open an issue please.

Installation¶ ↑

Add this line to your application’s Gemfile:

gem 'webfinger'

And then execute:

$ bundle

Or install it yourself as:

$ gem install webfinger

Usage¶ ↑

Basic¶ ↑

You can discover resource metadata.

WebFinger.discover! 'acct:nov@connect-op.heroku.com'
WebFinger.discover! 'connect-op.heroku.com'
WebFinger.discover! 'http://connect-op.heroku.com'

You can also specify link relations via “rel” option.

WebFinger.discover! 'acct:nov@connect-op.heroku.com', rel: 'http://openid.net/specs/connect/1.0/issuer'
WebFinger.discover! 'acct:nov@connect-op.heroku.com', rel: ['http://openid.net/specs/connect/1.0/issuer', 'vcard']

Caching¶ ↑

Caching is important in HTTP-based discovery.

If you set your own cache object to WebFinger.cache, this gem caches the discovery result until it expires. (the expiry is calculated based on the “expires” value in JRD response)

# Set Cache
WebFinger.cache = Rails.cache

WebFinger.discover! 'acct:nov@connect-op.heroku.com' # do HTTP request
WebFinger.discover! 'acct:nov@connect-op.heroku.com' # use cache, no HTTP request

Debugging¶ ↑

Once you turn-on debugging, you can see all HTTP request/response in your log.

# Turn on debugging
WebFinger.debug!

# Set logger (OPTIONAL, ::Logger.new(STDOUT) is used as default)
WebFinger.logger = Rails.logger

You can also specify URL builder to force non-HTTPS access. (NOTE: allow non-HTTPS access only for debugging, not on your production.)

WebFinger.url_builder = URI::HTTP # default URI::HTTPS

Contributing¶ ↑

  1. Fork it

  2. Create your feature branch (‘git checkout -b my-new-feature`)

  3. Commit your changes (‘git commit -am ’Add some feature’‘)

  4. Push to the branch (‘git push origin my-new-feature`)

  5. Create new Pull Request

Copyright © 2012 nov matake. See LICENSE for details.