Skip to content


Subversion checkout URL

You can clone with
Download ZIP
omniauth gem for authenticating against the MSUnet OAuth service
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib Update gem to version 1.0.0

OmniAuth MSUnet

This is the official OmniAuth strategy gem for authenticating to Michigan State University MSUnet using OAuth2. To use this gem you'll need the following:

  • Contact MSU IT Services at 517-432-6200 to request to register your application.
  • Provide IT Services with a callback URL, which is where to send successful MSUnet authentication requests back to your application. Note: this must be a HTTPS address.
  • Receive a client_id token and client_secret token specific for your application.


To install this gem you need to add it to your Gemfile as follows: gem 'omniauth-msunet', :git => ''

Basic Usage

If this is your applications first OmniAuth strategy then you will need to create the file config/initializers/omniauth.rb, otherwise update your existing one.

Rails.application.config.middleware.use OmniAuth::Builder do
  provider :msunet, "replace_with_client_id", "replace_with_client_secret"

Next you need to setup some routes to handle the callback and if it's a success or failure. You could use something like the following in your config/routes.rb file

match 'auth/:provider/callback', to: 'sessions#create'
match 'auth/failure', to: redirect('/')
match 'signout', to: 'sessions#destroy', as: 'signout'

Finally restart your server for all of the changes to take effect. You can now browse to your apps URL to login.

Once the login is completed you should receive the following hash that you can access:

  "name":"John Sparty",
  "description":"MSUNet OAuth2 Auth-n"


Please see the file.

Something went wrong with that request. Please try again.