1
0
Fork 0
mirror of https://github.com/omniauth/omniauth.git synced 2022-11-09 12:31:49 -05:00
omniauth--omniauth/index.html
2013-10-04 16:22:31 -04:00

207 lines
No EOL
10 KiB
HTML
Executable file
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html>
<!--[if lt IE 7]> <html class="no-js lt-ie9 lt-ie8 lt-ie7" lang="en"> <![endif]-->
<!--[if IE 7]> <html class="no-js lt-ie9 lt-ie8" lang="en"> <![endif]-->
<!--[if IE 8]> <html class="no-js lt-ie9" lang="en"> <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en"> <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<title>OmniAuth | Multi-provider Authentication for Web Applications</title>
<meta name="description" content="">
<meta name="viewport" content="width=device-width">
<link rel="shortcut icon" href="favicon.ico" type="image/x-icon" />
<link rel="stylesheet" href="css/style.css">
<link rel="stylesheet" href="css/screen.css">
<link rel="stylesheet" href="css/media_queries.css">
<link rel="stylesheet" href="css/code.css">
<link rel="stylesheet" href="http://f.fontdeck.com/s/css/m6Lez9WflF3tDDcWVkR43JhhHws/intridea.github.com/21671.css" type="text/css" />
<script src="js/libs/modernizr-2.5.3.min.js"></script>
</head>
<body>
<div id="container">
<!--[if lt IE 7]><p class=chromeframe>Your browser is <em>ancient!</em> <a href="http://browsehappy.com/">Upgrade to a different browser</a> or <a href="http://www.google.com/chromeframe/?redirect=true">install Google Chrome Frame</a> to experience this site.</p><![endif]-->
<header class="cf">
<section>
<a href="http://www.intridea.com" id="tag"></a>
<div id="title">
<img src="img/logo.png" id="reg_logo">
<h1>Omniauth</h1>
</div>
<div id="quick_links" class="cf">
<span class="button_outer"><a href="https://github.com/intridea/omniauth" class="button">Fork this on Github</a></span>
<span class="button_outer"><a href="https://github.com/intridea/omniauth/wiki" class="button">Full Documentation</a></span>
<span class="button_outer"><a href="https://github.com/intridea/omniauth/issues" class="button">Report a Problem</a></span>
</div>
</section>
</header>
<div id="header_border"></div>
<div id="content_container">
<div role="main" id="content" class="cf">
<div class="col">
<h2>What is Omniauth?</h2>
<p>The web application landscape has changed drastically in the past few years. Most users login in to dozens, sometimes hundreds of services each day; sites are no longer silos unto themselves and cannot reasonably expect users to create a unique login and password for each service. This is where OmniAuth comes in.</p>
<p>OmniAuth is a library that standardizes multi-provider authentication for web applications. It was created to be powerful, secure, and flexible. Any developer can create strategies for OmniAuth that can authenticate users via disparate systems. OmniAuth strategies have been created for everything from Facebook to LDAP.</p>
<h2>Whos Using OmniAuth?</h2>
<p>Hundreds of people are leveraging the advantages of super simple, secure authentication with OmniAuth in their applications. From event registration sites to online wholesale distribution stores, to online trading platforms and beyond, developers are relying on OmniAuth to streamline user authentication in their systems. </p>
<ul class="whouses cf">
<li class="git"><a href="http://www.github.com"><img src="img/github_logo.png" alt="GitHub" class="git" /></a></li>
<li class="hall"><a href="http://www.hall.com"><img src="img/hall_logo.png" alt="Hall" class="hall" /></a></li>
<li><a href="http://www.intridea.com"><img src="img/Intridea_Logo_whois_new.png" alt="Intridea" class="intidea" /></a></a></li>
</ul>
<h2>Getting Started</h2>
<p>To use OmniAuth in a project with a Gemfile, just add each of the strategies
you want to use individually:</p>
<pre><code class="code">gem 'omniauth-github'<br />gem 'omniauth-openid'</code></pre>
<p>Now you can use the <code>OmniAuth::Builder</code> Rack middleware to build
up your list of OmniAuth strategies for use in your application:</p>
<pre><code class="code">use OmniAuth::Builder do<br /> provider:github, ENV['GITHUB_KEY'], ENV['GITHUB_SECRET']<br /> provider:openid, :store =&gt; OpenID::Store::Filesystem.new('/tmp')</br />end</code></pre>
<p>By default, OmniAuth will return auth information to the path
<code>/auth/:provider/callback</code> inside the Rack environment. In Sinatra,
for example, a callback might look something like this:</p>
<pre><code class="code"># Support both GET and POST for callbacks<br />%w(get post).each do |method|<br /> send(method, "/auth/:provider/callback") do<br /> env['omniauth.auth'] # =&gt; OmniAuth::AuthHash<br /> end<br />end</code></pre>
<p>For additional documentation, you should see the <a href="https://github.com/intridea/omniauth/wiki">OmniAuth wiki</a>.</p>
</div>
<div class="col">
<h2>Try OmniAuth!</h2>
<p>Want an idea of the different providers OmniAuth gives you the ability to authenticate through? Try out any of the providers in the list below, each one is a live example of authenticating with OmniAuth!</p>
<article class="provider cf facebook">
<h1>Facebook <small>by <a href="https://github.com/mkdynamic">mkdynamic</a></small></h1>
<nav>
<a href="https://github.com/mkdynamic/omniauth-facebook" class="button">Usage</a>
</nav>
</article>
<article class="provider cf foursquare">
<h1>Foursquare <small>by <a href="https://github.com/arunagw">arunagw</a></small></h1>
<nav>
<a href="https://github.com/arunagw/omniauth-foursquare" class="button">Usage</a>
</nav>
</article>
<article class="provider cf geoloqi">
<h1>Geoloqi <small>by <a href="https://github.com/kyledrake">kyledrake</a></small></h1>
<nav>
<a href="https://github.com/geoloqi/omniauth-geoloqi" class="button">Usage</a>
</nav>
</article>
<article class="provider cf github">
<h1>GitHub <small>by <a href="https://github.com/intridea">intridea</a></small></h1>
<nav>
<a href="https://github.com/intridea/omniauth-github" class="button">Usage</a>
</nav>
</article>
<article class="provider cf identity">
<h1>Identity <small>by <a href="https://github.com/intridea">intridea</a></small></h1>
<nav>
<a href="https://github.com/intridea/omniauth-identity" class="button">Usage</a>
</nav>
</article>
<article class="provider cf linkedin">
<h1>LinkedIn <small>by <a href="https://github.com/skorks">skorks</a></small></h1>
<nav>
<a href="https://github.com/skorks/omniauth-linkedin" class="button">Usage</a>
</nav>
</article>
<article class="provider cf picplz">
<h1>PicPlz <small>by <a href="https://github.com/arunagw">arunagw</a></small></h1>
<nav>
<a href="https://github.com/arunagw/omniauth-picplz" class="button">Usage</a>
</nav>
</article>
<article class="provider cf open_id">
<h1>OpenID <small>by <a href="https://github.com/intridea">intridea</a></small></h1>
<nav>
<a href="https://github.com/intridea/omniauth-openid" class="button">Usage</a>
</nav>
</article>
<article class="provider cf twitter">
<h1>Twitter <small>by <a href="https://github.com/arunagw">arunagw</a></small></h1>
<div>
<nav>
<a href="https://github.com/arunagw/omniauth-twitter" class="button">Usage</a>
</nav>
</div>
</article>
<h2>Resources</h2>
<ul class="rescource">
<li><a href="https://github.com/intridea/omniauth/wiki">Official OmniAuth Wiki</a> - Official OmniAuth Wiki</li>
<li><a href="https://github.com/intridea/omniauth-github">The official Github OmniAuth Strategy </a> - The official Github OmniAuth Strategy</li>
<li><a href="http://rubydoc.info/github/intridea/omniauth/master/frames">README Doc</a> - Blog post announcing OmniAuth 1.0</li>
<li><a href="http://www.intridea.com/blog/2011/11/2/omniauth-1-0">Announcing OmniAuth 1.0</a> - Blog post announcing OmniAuth 1.0</li>
<li><a href="https://github.com/intridea/omniauth/wiki/Sinatra-Example">Sinatra Example</a> - Example of an OmniAuth implementation in Sinatra</li>
<li><a href="https://github.com/intridea/omniauth-identity">OmniAuth Identity</a> - A simple login and password strategy for OmniAuth</li>
</ul>
<h2>Created By:</h2>
<div id="author" class="cf">
<section class="bio">
<h1>Michael Bleigh</h1>
<ul class="author-links">
<li class="icn_twitter"><a href="https://twitter.com/mbleigh">@mbleigh</a></li>
</ul>
<p>Michael has been with Intridea since 2007 and works to build Intridea's portfolio of products. With many years of experience working as both a designer and a developer, Michael specializes in helping to bridge the gap between the back-end development and the front-end design of a project.</p>
<p>Michael is a prolific member of the Ruby on Rails community, having released popular open source libraries such as OmniAuth and spoken at conferences including RailsConf and RubyConf.</p>
</section>
</div>
</div>
</div>
</div>
<footer>
<section>
<a id="hiring" href="http://www.intridea.com/careers">We're Hiring!</a>
<span>Copyright &copy; 2012 <a href="http://www.intridea.com">Intridea</a>. Released under the MIT License on <a href="https://github.com/intridea/omniauth">GitHub</a>.</span>
<a id="footer_logo" href="http://www.intridea.com">Intridea.com</a>
</section>
</footer>
</div>
<script src="//ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script>window.jQuery || document.write('<script src="js/libs/jquery-1.7.1.min.js"><\/script>')</script>
<script src="js/plugins.js"></script>
<script src="js/script.js"></script>
<script src="js/css3-mediaqueries.js"></script>
<script type="text/javascript" src="js/retina.js"></script>
<script src="js/jquery.lettering-0.6.1.min.js"></script>
<script>
var _gaq=[['_setAccount','UA-XXXXX-X'],['_trackPageview']];
(function(d,t){var g=d.createElement(t),s=d.getElementsByTagName(t)[0];
g.src=('https:'==location.protocol?'//ssl':'//www')+'.google-analytics.com/ga.js';
s.parentNode.insertBefore(g,s)}(document,'script'));
</script>
</body>
</html>