auth0 3.2.0 → 3.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c233d8f871a4045c4fcf32245bf4cab7f12ea1ea
-  data.tar.gz: 908f8c84e4ad3170363ec86e508323ebb2924d38
+  metadata.gz: bdf4ecb5c96f5e84e45fc413f782f157ac5ac50d
+  data.tar.gz: c3edbdcee08c40938fc43e97d836a779e3781b4d
 SHA512:
-  metadata.gz: a57726e22e787af7e128c2fb9fe59cb4873d84f9df9f05e1bfa315a3217243c75e743032d738f7a346ebbfe0f8e956f287059d85a57f4a0547979d838ad29f29
-  data.tar.gz: 20ca731787c59444212354b3f284400e9045b35aa64c15c2fb5ee4489c60d12fd48ad7cb41ad276f37bace8d2cf0fd869b248c8ecdfa15e4a1f293dc359111da
+  metadata.gz: f2931b8dfb4223dcb882351f995e51120378234642a59894fc271f441f886e68dfd41aaf4f653dd496b263a29fe6480e73210407f9a56997588776148676be08
+  data.tar.gz: eb8796cfb3d8ceb57da9bae51b9499220dfc3e7f54511b5d4a5c232306c13dffad697577a56683367493305e9986d910887da6d7c37f6c29b3bfe0c0e159d96d

data/.gemrelease

@@ -0,0 +1,2 @@
+bump:
+  tag: true

data/.gitignore

@@ -7,3 +7,4 @@ coverage
 spec/auth0.yml
 .yardoc
 Gemfile.lock
+.env

data/.rspec

@@ -1,3 +1,3 @@
 --color
---format documentation
---fail-fast
+--format Fuubar
+--color

data/.travis.yml

@@ -1,4 +1,10 @@
 language: ruby
+
+sudo: false
+
+cache: bundler
+
 rvm:
-  - 2.1.0
   - 2.2.1
+
+script: MODE=full bundle exec rake all

data/Gemfile

@@ -2,3 +2,8 @@ source "http://rubygems.org"
 
 # Specify your gem's dependencies in auth0.gemspec
 gemspec
+
+group :development do
+  gem 'terminal-notifier-guard', require: false
+  gem 'coveralls', require: false
+end

data/Guardfile

@@ -0,0 +1,34 @@
+scope group: :unit_test
+
+group :unit_test do
+  guard 'rspec', cmd: "bundle exec rspec -P \"spec/lib/auth0/**/*#{ENV['PATTERN']}*_spec.rb\" --drb --format Fuubar --color" do
+    # run every updated spec file
+    watch(%r{^spec/.+_spec\.rb$})
+    # run the lib specs when a file in lib/ changes
+    watch(%r{^lib/(.+)\.rb$}) { "spec" }
+    # run all test for helper changes
+    watch('spec/spec_helper.rb')  { "spec" }
+  end
+end
+
+group :integration do
+  guard 'rspec', cmd: "MODE=full bundle exec rspec -P \"spec/integration/**/*#{ENV['PATTERN']}*_spec.rb\" --drb --format Fuubar --color" do
+    # run every updated spec file
+    watch(%r{^spec/.+_spec\.rb$})
+    # run the lib specs when a file in lib/ changes
+    watch(%r{^lib/(.+)\.rb$}) { "spec" }
+    # run all test for helper changes
+    watch('spec/spec_helper.rb')  { "spec" }
+  end
+end
+
+group :full do
+  guard 'rspec', cmd: "MODE=full bundle exec rspec --drb --format Fuubar --color" do
+    # run every updated spec file
+    watch(%r{^spec/.+_spec\.rb$})
+    # run the lib specs when a file in lib/ changes
+    watch(%r{^lib/(.+)\.rb$}) { "spec" }
+    # run all test for helper changes
+    watch('spec/spec_helper.rb')  { "spec" }
+  end
+end

data/README.md

@@ -1,25 +1,36 @@
-Ruby api client for [Auth0](https://auth0.com)
+Ruby api client for [Auth0](https://auth0.com) platform
 
 [![Build Status](https://travis-ci.org/auth0/ruby-auth0.svg?branch=master)](https://travis-ci.org/auth0/ruby-auth0)
+[![Gem Version](https://badge.fury.io/rb/auth0.svg)](http://badge.fury.io/rb/auth0)
+[![Coverage Status](https://coveralls.io/repos/auth0/ruby-auth0/badge.svg?branch=master)](https://coveralls.io/r/auth0/ruby-auth0?branch=master)
+[![Dependency Status](https://gemnasium.com/auth0/ruby-auth0.svg)](https://gemnasium.com/auth0/ruby-auth0)
 
 ## Installation
 
-```
+``` bash
 $ gem install auth0
 ```
 
+or with [Bundler](http://bundler.io)
+
+```ruby
+gem 'auth0'
+```
+
 ## Basic usage
 
+Using [APIv1](https://auth0.com/docs/api)
+
 ```ruby
 require "auth0"
 
 auth0 = Auth0Client.new(
   :client_id => "YOUR CLIENT ID",
   :client_secret => "YOUR CLIENT SECRET",
-  :namespace => "<YOUR ACCOUNT>.auth0.com"
+  :domain => "<YOUR ACCOUNT>.auth0.com"
 );
 
-puts auth0.get_connections;
+puts auth0.get_users;
 ```
 
 Using [APIv2](https://auth0.com/docs/apiv2)
@@ -30,17 +41,37 @@ require "auth0"
 auth0 = Auth0Client.new(
   :api_version => 2,
   :token => "YOUR JWT HERE",
-  :namespace => "<YOUR ACCOUNT>.auth0.com"
+  :domain => "<YOUR ACCOUNT>.auth0.com"
 );
 
 puts auth0.get_users;
 ```
 
 
+## What is Auth0?
+
+Auth0 helps you to:
+
+* Add authentication with [multiple authentication sources](https://docs.auth0.com/identityproviders), either social like **Google, Facebook, Microsoft Account, LinkedIn, GitHub, Twitter, Box, Salesforce, amont others**, or enterprise identity systems like **Windows Azure AD, Google Apps, Active Directory, ADFS or any SAML Identity Provider**.
+* Add authentication through more traditional **[username/password databases](https://docs.auth0.com/mysql-connection-tutorial)**.
+* Add support for **[linking different user accounts](https://docs.auth0.com/link-accounts)** with the same user.
+* Support for generating signed [Json Web Tokens](https://docs.auth0.com/jwt) to call your APIs and **flow the user identity** securely.
+* Analytics of how, when and where users are logging in.
+* Pull data from other sources and add it to the user profile, through [JavaScript rules](https://docs.auth0.com/rules).
+
+## Create a free Auth0 Account
+
+1. Go to [Auth0](https://auth0.com) and click Sign Up.
+2. Use Google, GitHub or Microsoft Account to login.
+
 ## Issue Reporting
 
 If you have found a bug or if you have a feature request, please report them at this repository issues section. Please do not report security vulnerabilities on the public GitHub issue tracker. The [Responsible Disclosure Program](https://auth0.com/whitehat) details the procedure for disclosing security issues.
 
+## Author
+
+[Auth0](auth0.com)
+
 ## License
 
-MIT 2014 - Auth0 Inc.
+This project is licensed under the MIT license. See the [LICENSE](LICENSE) file for more info.

data/Rakefile

@@ -1,9 +1,24 @@
 #!/usr/bin/env rake
 require "bundler/gem_tasks"
-require 'rspec/core/rake_task'
 
-desc "Run specs"
-RSpec::Core::RakeTask.new
+begin
+	require 'rspec/core/rake_task'
 
-desc 'Run specs'
-task :default => :spec
+	desc "Run Integration Tests"
+	RSpec::Core::RakeTask.new(:integration) do |t|
+		t.pattern = FileList["spec/integration/**/*#{ENV['PATTERN']}*_spec.rb"]
+	end
+
+
+	desc "Run Unit Tests"
+	RSpec::Core::RakeTask.new(:spec) do |t|
+		t.pattern = FileList["spec/lib/auth0/**/*#{ENV['PATTERN']}*_spec.rb"]
+	end
+
+	desc "Run All Suites"
+	RSpec::Core::RakeTask.new(:all)
+
+	task :default => :spec
+rescue LoadError
+	#No RSpec
+end

data/auth0.gemspec

@@ -20,14 +20,17 @@ Gem::Specification.new do |s|
 
   s.add_runtime_dependency 'httparty', '~> 0.13'
 
-  s.add_development_dependency 'rake'
-  s.add_development_dependency 'rspec', '~> 3.1.0', '>= 3.1.0'
-  s.add_development_dependency 'rack-test'
-  s.add_development_dependency 'simplecov'
-  s.add_development_dependency 'webmock'
-  s.add_development_dependency 'byebug'
-  s.add_development_dependency 'faker'
-  s.add_development_dependency 'yard'
-  s.add_development_dependency 'gem-release'
+  s.add_development_dependency 'rake', '~> 10.4'
+  s.add_development_dependency 'fuubar', '~> 2.0'
+  s.add_development_dependency 'guard-rspec', '~> 4.5'
+  s.add_development_dependency 'dotenv-rails', '~> 2.0'
+  s.add_development_dependency 'pry', '~> 0.10'
+  s.add_development_dependency 'pry-nav', '~> 0.2.4'
+  s.add_development_dependency 'rspec', '~> 3.1', '>= 3.1.0'
+  s.add_development_dependency 'rack-test', '~> 0.6'
+  s.add_development_dependency 'simplecov', '~> 0.9'
+  s.add_development_dependency 'faker', '~> 1.4'
+  s.add_development_dependency 'yard', '~> 0.8'
+  s.add_development_dependency 'gem-release', '~> 0.7'
   s.license = 'MIT'
 end

data/lib/auth0/api/authentication_endpoints.rb

@@ -14,7 +14,7 @@ module Auth0
       end
 
       # {https://auth0.com/docs/auth-api#!#post--delegation}
-      def delegation(id_token, target, scope = "openid", api_type = "app")
+      def delegation(id_token, target, scope = "openid", api_type = "app", extra_parameters = {})
         request_params = {
                       client_id:  @client_id,
                       grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer",
@@ -22,7 +22,7 @@ module Auth0
                       target:     target,
                       api_type:   api_type,
                       scope:      scope
-        }
+        }.merge(extra_parameters)
         post("/delegation", request_params)
       end
 

data/lib/auth0/api/v1/clients.rb

@@ -24,7 +24,7 @@ module Auth0
         # @deprecated use {#patch_client}
         # {https://auth0.com/docs/api#!#put--api-clients--client-id-}
         def update_client(name, callbacks="", client_id=@client_id)
-          warn "This endpoint has been deprecated in favor of PUT."
+          warn "This endpoint has been deprecated in favor of PATCH."
           path = "/api/clients/#{client_id}"
           request_params = {
                             name: name,

data/lib/auth0/api/v1/users.rb

@@ -141,7 +141,7 @@ module Auth0
 
         # {https://auth0.com/docs/api#!#delete--api-users--user_id-}
         def delete_user(user_id)
-          raise Auth0::UserIdIsBlank, "if you want to remove all users user delete_users method" if user_id.to_s.empty?
+          raise Auth0::MissingUserId, "if you want to remove all users user delete_users method" if user_id.to_s.empty?
           path = "/api/users/#{user_id}"
           delete(path)
         end

data/lib/auth0/api/v2/clients.rb

@@ -26,13 +26,13 @@ module Auth0
 
         #https://auth0.com/docs/apiv2#!/clients/delete_clients_by_id
         def delete_client(client_id)
-          path = "/api/v2/clients/" + client_id.to_s
+          path = "/api/v2/clients/#{client_id}"
           delete(path)
         end
 
         #https://auth0.com/docs/apiv2#!/clients/patch_clients_by_id
         def patch_client(client_id, options)
-          path = "/api/v2/clients/" + client_id.to_s
+          path = "/api/v2/clients/#{client_id}"
           patch(path, options)
         end
       end

data/lib/auth0/api/v2/users.rb

@@ -44,7 +44,7 @@ module Auth0
 
         #https://auth0.com/docs/apiv2#!/users/delete_users_by_id
         def delete_user(user_id)
-          raise Auth0::UserIdIsBlank, "if you want to remove all users user delete_users method" if user_id.to_s.empty?
+          raise Auth0::MissingUserId, "Must supply a valid user_id" if user_id.nil? or user_id.to_s.empty?
           path = "/api/v2/users/" + user_id.to_s
           delete(path)
         end

data/lib/auth0/exception.rb

@@ -15,8 +15,12 @@ class Auth0::ServerError   < Auth0::Exception; end
 # exception for incorrect request, you've sent wrong params
 class Auth0::BadRequest    < Auth0::Exception; end
 # exception for unset user_id, this might cause removal of all users, or other unexpected bahaviour
-class Auth0::UserIdIsBlank < Auth0::Exception; end
+class Auth0::MissingUserId < Auth0::Exception; end
 # Api v2 access denied
 class Auth0::AccessDenied  < Auth0::Exception; end
 # Invalid parameter passed, e.g. empty where ID is required
 class Auth0::InvalidParameter < Auth0::Exception; end
+# Invalid Auth0 credentials either client_id/secret for API v1 or JWT for API v2/
+class Auth0::InvalidCredentials < Auth0::Exception; end
+# Invalid Auth0 API namespace
+class Auth0::InvalidApiNamespace < Auth0::Exception; end

data/lib/auth0/mixins/initializer.rb

@@ -9,18 +9,15 @@ module Auth0
       # To run using api v2, pass api_version: 2 when creating a client
       def initialize(config)
         options = Hash[config.map{|(k,v)| [k.to_sym,v]}]
-        self.class.base_uri "https://#{options[:namespace]}"
+        domain = api_domain options
+        raise InvalidApiNamespace, "Api namespace must supply an API domain" if domain.nil?
+        self.class.base_uri "https://#{domain}"
         self.class.headers "Content-Type"  => 'application/json'
         self.extend Auth0::Api::AuthenticationEndpoints
         @client_id      = options[:client_id]
-        if options[:protocols].to_s.include?("v2") or options[:api_version] === 2
-          self.extend Auth0::Api::V2
-          @token = (options[:access_token] or options[:token])
-        else
-          self.extend Auth0::Api::V1
-          @client_secret  = options[:client_secret]
-          @token          = obtain_access_token
-        end
+        initialize_v2(options) if api_v2?(options)
+        initialize_v1(options) if api_v1?(options)
+        raise InvalidCredentials, "Must supply a valid API token" if @token.nil?
         self.class.headers "Authorization" => "Bearer #{@token}"
       end
 
@@ -29,6 +26,34 @@ module Auth0
         klass.send :prepend, Initializer
       end
 
+      private
+
+      def api_domain(options)
+        options[:domain] || options[:namespace]
+      end
+
+      def initialize_v2(options)
+        self.extend Auth0::Api::V2
+        @token = options[:access_token] || options[:token]
+      end
+
+      def initialize_v1(options)
+        self.extend Auth0::Api::V1
+        @client_secret  = options[:client_secret]
+        raise InvalidCredentials, "Invalid API v1 client_id and client_secret" if @client_id.nil? or @client_secret.nil?
+        @token = obtain_access_token
+      end
+
+      def api_v2?(options)
+        options[:protocols].to_s.include?("v2") or options[:api_version] === 2
+      end
+
+      def api_v1?(options)
+        version = options[:api_version] || 1
+        protocol = options[:protocols].to_s
+        not protocol.include?("v2") and (protocol.include?("v1") or version === 1)
+      end
+
     end
   end
 end

data/lib/auth0/version.rb

@@ -1,4 +1,4 @@
 module Auth0
   # current version of gem
-  VERSION = "3.2.0"
+  VERSION = "3.3.0"
 end

data/spec/integration/lib/auth0/api/v1/api_clients_spec.rb

@@ -0,0 +1,13 @@
+require "spec_helper"
+describe Auth0::Api::V1::Clients do
+
+  let(:client) { Auth0Client.new(v1_creds) }
+  let(:global_client) { Auth0Client.new(v1_global_creds) }
+  
+  it { expect(client.clients).to_not be_empty }
+
+  it { expect {client.create_client("client")}.to raise_error(Auth0::Unauthorized) }
+
+  it { expect(global_client.create_client("client")).to_not be_nil }
+
+end

data/spec/integration/lib/auth0/api/v1/api_users_spec.rb

@@ -0,0 +1,60 @@
+require "spec_helper"
+describe Auth0::Api::V1::Users do
+
+  let(:client) { Auth0Client.new(v1_creds) }
+  let(:username) { Faker::Internet.user_name }
+  let(:email) { Faker::Internet.safe_email }
+  let(:password) { Faker::Internet.password }
+  let(:connection) { "Username-Password-Authentication" }
+  let!(:user) { client.create_user(email, password, connection, {
+    "username" => username,
+    "email_verified" => false,
+  })}
+
+  describe '.users' do
+
+    let(:users) { client.users() }
+
+    it { expect(users.size).to be > 0 }
+    it { expect(users.find {|user| user["email"] == email}).to_not be_nil }
+
+    context "#filters" do
+      it { expect(client.users("email: #{email}").size).to be 1 }
+    end
+
+  end
+
+  describe '.user' do
+
+    let(:subject) { client.user(user["user_id"]) }
+
+    it { should include("email" => email, "username" => username) }
+
+  end
+
+  describe '.create_user' do
+
+    let(:subject) { user }
+
+    it { should include("user_id", "identities") }
+    it { should include(      
+      "username" => username,
+      "email" => email,
+      "email_verified" => false,
+    )}
+
+  end
+
+  describe '.delete_user' do
+
+    it { expect { client.delete_user user["user_id"] }.to_not raise_error }
+
+    it { expect { client.delete_user "" }.to raise_error(Auth0::MissingUserId) }
+
+  end
+
+  describe '.patch_user_metadata' do
+    it { expect(client.patch_user_metadata(user["user_id"], {"custom_field" => "custom_value"})).to eq "OK" }
+  end
+
+end

data/spec/integration/lib/auth0/api/v2/api_clients_spec.rb

@@ -0,0 +1,17 @@
+require "spec_helper"
+describe Auth0::Api::V2::Clients do
+
+  let(:client) { Auth0Client.new(v2_creds) }
+  let(:existing_client) { client.create_client("existing") }
+  
+  it { expect(client.clients).to_not be_empty }
+
+  it { expect(client.create_client("ClientV2", {custom_login_page_off: true})).to include("name" => "ClientV2", "custom_login_page_off" => true) }
+
+  it { expect(client.patch_client(existing_client["client_id"], {custom_login_page_off: true, sso: true})).to include("custom_login_page_off" => true, "sso" => true) }
+
+  it { expect { client.delete_client(existing_client["client_id"]) }.to_not raise_error }
+
+  it { expect(client.client(existing_client["client_id"])).to include("client_id" => existing_client["client_id"]) }
+
+end

data/spec/integration/lib/auth0/api/v2/api_users_spec.rb

@@ -0,0 +1,71 @@
+require "spec_helper"
+describe Auth0::Api::V2::Users do
+
+  let(:client) { Auth0Client.new(v2_creds) }
+  let(:username) { Faker::Internet.user_name }
+  let(:email) { Faker::Internet.safe_email }
+  let(:password) { Faker::Internet.password }
+  let(:connection) { "Username-Password-Authentication" }
+  let!(:user) { client.create_user(username, {
+    "username" => username,
+    "email" => email,
+    "password" => password,
+    "email_verified" => false,
+    "connection" => connection,
+    "app_metadata" => {}
+  })}
+
+  describe '.users' do
+
+    let(:users) { client.users() }
+
+    it { expect(users.size).to be > 0 }
+    it { expect(users.find {|user| user["email"] == email}).to_not be_nil }
+
+    context "#filters" do
+      it { expect(client.users(per_page: 1).size).to be 1 }
+      it { expect(client.users(per_page: 1, fields: [:picture, :email, :user_id].join(',')).first).to include("email", "user_id", "picture") }
+      it { expect(client.users(per_page: 1, fields: [:picture, :email, :user_id].join(','), exclude_fields: true).first).to_not include("email", "user_id", "picture") }
+    end
+
+  end
+
+  describe '.user' do
+
+    let(:subject) { client.user(user["user_id"]) }
+
+    it { should include("email" => email, "name" => username) }
+
+    context "#filters" do
+      it { expect(client.user(user["user_id"], fields: [:picture, :email, :user_id].join(','))).to include("email", "user_id", "picture") }
+      it { expect(client.user(user["user_id"], fields: [:picture, :email, :user_id].join(','), exclude_fields: true)).to_not include("email", "user_id", "picture") }
+    end
+
+  end
+
+  describe '.create_user' do
+
+    let(:subject) { user }
+
+    it { should include("user_id", "identities") }
+    it { should include(      
+      "username" => username,
+      "email" => email,
+      "email_verified" => false,
+    )}
+
+  end
+
+  describe '.delete_user' do
+
+    it { expect { client.delete_user user["user_id"] }.to_not raise_error }
+
+    it { expect { client.delete_user "" }.to raise_error(Auth0::MissingUserId) }
+
+  end
+
+  describe '.patch_user' do
+    it { expect(client.patch_user(user["user_id"], {"email_verified" => true})).to include("email_verified" => true) }
+  end
+
+end

data/spec/integration/lib/auth0/auth0_client_spec.rb

@@ -0,0 +1,45 @@
+require "spec_helper"
+describe Auth0::Client do
+
+	shared_examples "invalid credentials" do |credentials, error| 
+		it "raise an error with credentials #{credentials}" do
+				if error.nil?
+					expect { Auth0Client.new(credentials) }.to raise_error
+				else
+					expect { Auth0Client.new(credentials) }.to raise_error(error)
+				end
+		end		
+	end
+
+	it_should_behave_like "invalid credentials", {namespace: "samples.auth0.com"}, Auth0::InvalidCredentials
+	it_should_behave_like "invalid credentials", {namespace: "samples.auth0.com", client_id: "client_id"}, Auth0::InvalidCredentials
+	it_should_behave_like "invalid credentials", {namespace: "samples.auth0.com", client_secret: "secret"}, Auth0::InvalidCredentials
+	it_should_behave_like "invalid credentials", {namespace: "samples.auth0.com", api_version: 2}, Auth0::InvalidCredentials
+	it_should_behave_like "invalid credentials", {}
+	it_should_behave_like "invalid credentials", {api_version: 2}
+	it_should_behave_like "invalid credentials", {api_version: 1}
+	it_should_behave_like "invalid credentials", {client_id: "client_id", client_secret: "secret"}, Auth0::InvalidApiNamespace
+	it_should_behave_like "invalid credentials", {api_version: 2, token: "token"}, Auth0::InvalidApiNamespace
+
+	let(:valid_v1_credentials) { {client_id: ENV["CLIENT_ID"], client_secret: ENV["CLIENT_SECRET"], domain: ENV["DOMAIN"]} }
+	let(:token) { ENV["MASTER_JWT"] }
+	let(:v2_credentials) { {domain: ENV["DOMAIN"], api_version: 2} }
+	
+	shared_examples "valid credentials" do
+		it { expect { Auth0Client.new(credentials) }.to_not raise_error }
+	end
+
+	it_should_behave_like "valid credentials" do
+		let(:credentials) { valid_v1_credentials }
+	end
+	it_should_behave_like "valid credentials" do
+		let(:credentials) { valid_v1_credentials.merge({api_version: 1}) }
+	end
+	it_should_behave_like "valid credentials" do
+		let(:credentials) { v2_credentials.merge({token: token})}
+	end
+	it_should_behave_like "valid credentials" do
+		let(:credentials) { v2_credentials.merge({access_token: ENV["MASTER_JWT"]}) }
+	end
+
+end

data/spec/lib/auth0/api/authentication_endpoints_spec.rb

@@ -28,6 +28,12 @@ describe Auth0::Api::AuthenticationEndpoints do
                                                               api_type: "salesforce_api"})
       @instance.delegation("", "", "", "salesforce_api")
     end
+    it "allows to pass extra parameters" do
+      expect(@instance).to receive(:post).with("/delegation",{:client_id=>nil, :grant_type=>"urn:ietf:params:oauth:grant-type:jwt-bearer", 
+                                                              :id_token=>"", :target=>"", :scope=>"", :api_type => "",
+                                                               :community_name => 'test-community', community_url: 'test-url'})
+      @instance.delegation("", "", "", "", community_name: 'test-community', community_url: 'test-url')
+    end
   end
 
   context ".impersonate" do

data/spec/lib/auth0/api/v1/clients_spec.rb

@@ -44,7 +44,7 @@ describe Auth0::Api::V1::Clients do
     end
 
     it "is expected to make warn on deprecated endpoint" do
-      expect(@instance).to receive(:warn).with("This endpoint has been deprecated in favor of PUT.")
+      expect(@instance).to receive(:warn).with("This endpoint has been deprecated in favor of PATCH.")
       @instance.update_client("test")
     end
   end

data/spec/lib/auth0/api/v1/users_spec.rb

@@ -195,7 +195,7 @@ describe Auth0::Api::V1::Users do
 
     it "is expected not to call delete to /api/users if user_id is blank" do
       expect(@instance).not_to receive(:delete)
-      expect{@instance.delete_user("")}.to raise_exception(Auth0::UserIdIsBlank)
+      expect{@instance.delete_user("")}.to raise_exception(Auth0::MissingUserId)
     end
   end
 

data/spec/lib/auth0/api/v2/users_spec.rb

@@ -49,7 +49,7 @@ describe Auth0::Api::V2::Users do
 
     it "is expected not to call delete to /api/v2/users if user_id is blank" do
       expect(@instance).not_to receive(:delete)
-      expect{@instance.delete_user("")}.to raise_exception(Auth0::UserIdIsBlank)
+      expect{@instance.delete_user("")}.to raise_exception(Auth0::MissingUserId)
     end
   end
 

data/spec/lib/auth0/client_spec.rb

@@ -1,47 +1,115 @@
 require "spec_helper"
+
 describe Auth0::Client do
-  context "V1 modules to be included" do
-    let(:subject){Auth0::Client.new({})}
+
+  shared_examples_for "v1 API client" do
+    it { should be_a Auth0::Api::V1 }
+    it { should be_a Auth0::Api::V1::Users }
+    it { should be_a Auth0::Api::V1::Connections }
+    it { should be_a Auth0::Api::V1::Clients }
+    it { should be_a Auth0::Api::V1::Rules }
+    it { should be_a Auth0::Api::V1::Logs }
+    it { should_not be_a Auth0::Api::V2 }
+    it { should_not be_a Auth0::Api::V2::Clients }
+    it { should_not be_a Auth0::Api::V2::Users }
+    it { should_not be_a Auth0::Api::V2::Jobs }
+    it { should_not be_a Auth0::Api::V2::Stats }
+    it { should_not be_a Auth0::Api::V2::Blacklists }
+  end
+
+  shared_examples_for "v2 API client" do
+    it { should be_a Auth0::Api::V2 }
+    it { should be_a Auth0::Api::V2::Clients }
+    it { should be_a Auth0::Api::V2::Users }
+    it { should be_a Auth0::Api::V2::Stats }
+    it { should be_a Auth0::Api::V2::Jobs }
+    it { should be_a Auth0::Api::V2::Blacklists }
+    it { should_not be_a Auth0::Api::V1 }
+    it { should_not be_a Auth0::Api::V1::Users }
+    it { should_not be_a Auth0::Api::V1::Connections }
+    it { should_not be_a Auth0::Api::V1::Clients }
+    it { should_not be_a Auth0::Api::V1::Rules }
+    it { should_not be_a Auth0::Api::V1::Logs }
+  end
+
+  shared_examples_for "authentication API client" do
+    it { should be_a Auth0::Api::AuthenticationEndpoints }
+  end
+
+  let(:domain) { "samples.auth0.com" }
+  let(:client_id) { "client_id" }
+  let(:client_secret) { "client_secret" }
+  let(:jwt) { "Header.Payload.Signature" }
+  let(:access_token) { "token" }
+
+  describe "V1 client" do
+
     before :each do
-      allow_any_instance_of(Auth0::Api::AuthenticationEndpoints).to receive(:obtain_access_token)
-    end
-    it {expect(subject).to be_a HTTParty}
-    it {expect(subject).to be_a Auth0::Mixins}
-    it {expect(subject).to be_a Auth0::Mixins::Initializer}
-    it {expect(subject).to be_a Auth0::Api::V1}
-    it {expect(subject).to be_a Auth0::Api::V1::Users}
-    it {expect(subject).to be_a Auth0::Api::V1::Connections}
-    it {expect(subject).to be_a Auth0::Api::V1::Clients}
-    it {expect(subject).to be_a Auth0::Api::V1::Rules}
-    it {expect(subject).to be_a Auth0::Api::V1::Logs}
-    it {expect(subject).to be_a Auth0::Api::AuthenticationEndpoints}
-    it {expect(subject).not_to be_a Auth0::Api::V2}
-    it {expect(subject).not_to be_a Auth0::Api::V2::Clients}
-    it {expect(subject).not_to be_a Auth0::Api::V2::Users}
-    it {expect(subject).not_to be_a Auth0::Api::V2::Jobs}
-    it {expect(subject).not_to be_a Auth0::Api::V2::Stats}
-    it {expect(subject).not_to be_a Auth0::Api::V2::Blacklists}
+      allow_any_instance_of(Auth0::Api::AuthenticationEndpoints).to receive(:obtain_access_token).and_return "token"
+    end
+    
+    context "with namespace" do
+
+      let(:subject) { Auth0::Client.new(client_id: "client_id", client_secret: "client_secret", namespace: "samples.auth0.com") }
+
+      it_should_behave_like "v1 API client"
+      it_should_behave_like "authentication API client"
+
+    end
+
+    context "with domain" do
+
+      let(:subject) { Auth0::Client.new(client_id: "client_id", client_secret: "client_secret", domain: "samples.auth0.com") }
+
+      it_should_behave_like "v1 API client"
+      it_should_behave_like "authentication API client"
+
+    end
+
+    context "with version" do
+      
+      let(:subject) { Auth0::Client.new(client_id: "client_id", client_secret: "client_secret", domain: "samples.auth0.com", api_version: 1) }
+
+      it_should_behave_like "v1 API client"
+      it_should_behave_like "authentication API client"
+
+    end
+
   end
-  context "V2 modules to be included" do
-    let(:subject){Auth0::Client.new({protocols: "v2"})}
+
+  describe "V2 client" do
+
     before :each do
       expect_any_instance_of(Auth0::Api::AuthenticationEndpoints).not_to receive(:obtain_access_token)
     end
-    it {expect(subject).to be_a HTTParty}
-    it {expect(subject).to be_a Auth0::Mixins}
-    it {expect(subject).to be_a Auth0::Mixins::Initializer}
-    it {expect(subject).to be_a Auth0::Api::V2}
-    it {expect(subject).to be_a Auth0::Api::V2::Clients}
-    it {expect(subject).to be_a Auth0::Api::V2::Users}
-    it {expect(subject).to be_a Auth0::Api::V2::Stats}
-    it {expect(subject).to be_a Auth0::Api::V2::Jobs}
-    it {expect(subject).to be_a Auth0::Api::V2::Blacklists}
-    it {expect(subject).not_to be_a Auth0::Api::V1}
-    it {expect(subject).not_to be_a Auth0::Api::V1::Users}
-    it {expect(subject).not_to be_a Auth0::Api::V1::Connections}
-    it {expect(subject).not_to be_a Auth0::Api::V1::Clients}
-    it {expect(subject).not_to be_a Auth0::Api::V1::Rules}
-    it {expect(subject).not_to be_a Auth0::Api::V1::Logs}
-    it {expect(subject).to be_a Auth0::Api::AuthenticationEndpoints}
+
+    context "with namespace" do
+
+      let(:subject) { Auth0::Client.new(protocols: "v2", access_token: "access_token", namespace: "samples.auth0.com") }
+
+      it_should_behave_like "v2 API client"
+      it_should_behave_like "authentication API client"
+
+    end
+
+    context "with domain" do
+
+      let(:subject) { Auth0::Client.new(protocols: "v2", access_token: "access_token", domain: "samples.auth0.com") }
+
+      it_should_behave_like "v2 API client"
+      it_should_behave_like "authentication API client"
+
+    end
+
+    context "with version" do
+      
+      let(:subject) { Auth0::Client.new(api_version: 2, access_token: "access_token", domain: "samples.auth0.com") }
+
+      it_should_behave_like "v2 API client"
+      it_should_behave_like "authentication API client"
+
+    end
+
   end
+
 end

data/spec/lib/auth0/mixins/initializer_spec.rb

@@ -1,4 +1,5 @@
 require "spec_helper"
+
 class MockClass
   attr_reader :token 
   include Auth0::Mixins::Initializer
@@ -6,7 +7,7 @@ class MockClass
 end
 
 describe Auth0::Mixins::Initializer do
-  let(:params) { {  } }
+  let(:params) { { namespace: 'samples.auth0.com' } }
   let(:instance) { DummyClassForProxy.include(described_class).new(params) }
   context 'api v2' do
     before do

data/spec/spec_helper.rb

@@ -1,18 +1,2 @@
-$:.unshift File.expand_path('..', __FILE__)
-$:.unshift File.expand_path('../../lib', __FILE__)
-require 'simplecov'
-SimpleCov.start do
-  add_filter "/spec/"
-end
-require 'rspec'
-require 'rack/test'
-require 'webmock/rspec'
-require 'byebug'
-require 'auth0'
-Dir[("./lib/**/*.rb")].each { |f| require f }
-Dir[("./spec/support/**/*.rb")].each { |f| require f }
-RSpec.configure do |config|
-  config.include	WebMock::API
-  config.include	Rack::Test::Methods
-#  config.fail_fast = true
-end
+mode = ENV["MODE"] || "unit"
+require_relative "spec_helper_#{mode}"

data/spec/spec_helper_full.rb

@@ -0,0 +1,33 @@
+$:.unshift File.expand_path('..', __FILE__)
+$:.unshift File.expand_path('../../lib', __FILE__)
+
+require 'coveralls'
+Coveralls.wear!
+
+require 'simplecov'
+SimpleCov.start do
+  add_filter "/spec/"
+  add_filter "/spec/integration"
+end
+
+require 'rspec'
+require 'rack/test'
+require 'faker'
+require 'auth0'
+require 'pry'
+
+Dir[("./lib/**/*.rb")].each { |f| require f }
+Dir[("./spec/support/**/*.rb")].each { |f| require f }
+
+RSpec.configure do |config|
+  config.include  Rack::Test::Methods
+  config.include Credentials
+  config.after(:suite) do
+    v2_client = Auth0Client.new({token: ENV["MASTER_JWT"], api_version: 2, domain: ENV["DOMAIN"]})
+    v2_client
+    .clients
+    .select { |client| client["name"] != "DefaultApp" and not client["global"] }
+    .each { |client| v2_client.delete_client(client["client_id"]) }
+    v2_client.delete_users
+  end
+end

data/spec/spec_helper_unit.rb

@@ -0,0 +1,12 @@
+$:.unshift File.expand_path('..', __FILE__)
+$:.unshift File.expand_path('../../lib', __FILE__)
+require 'rspec'
+require 'rack/test'
+require 'faker'
+require 'auth0'
+Dir[("./lib/**/*.rb")].each { |f| require f }
+Dir[("./spec/support/**/*.rb")].each { |f| require f }
+RSpec.configure do |config|
+  config.include  Rack::Test::Methods
+  config.fail_fast = true
+end

data/spec/support/credentials.rb

@@ -0,0 +1,13 @@
+module Credentials
+	def v1_creds
+		{client_id: ENV["CLIENT_ID"], client_secret: ENV["CLIENT_SECRET"], domain: ENV["DOMAIN"]}
+	end
+
+	def v1_global_creds
+		{client_id: ENV["GLOBAL_CLIENT_ID"], client_secret: ENV["GLOBAL_CLIENT_SECRET"], domain: ENV["DOMAIN"]}
+	end
+
+	def v2_creds
+		{token: ENV["MASTER_JWT"], api_version: 2, domain: ENV["DOMAIN"]}
+	end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: auth0
 version: !ruby/object:Gem::Version
-  version: 3.2.0
+  version: 3.3.0
 platform: ruby
 authors:
 - Auth0
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-14 00:00:00.000000000 Z
+date: 2015-04-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -31,134 +31,176 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '10.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '10.4'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: fuubar
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.1.0
-    - - ">="
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.1.0
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.1.0
-    - - ">="
+        version: '4.5'
+- !ruby/object:Gem::Dependency
+  name: dotenv-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.1.0
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: rack-test
+  name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.10'
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: pry-nav
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.2.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.2.4
 - !ruby/object:Gem::Dependency
-  name: webmock
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 3.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 3.1.0
 - !ruby/object:Gem::Dependency
-  name: byebug
+  name: rack-test
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.9'
 - !ruby/object:Gem::Dependency
   name: faker
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.4'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.8'
 - !ruby/object:Gem::Dependency
   name: gem-release
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.7'
 description: Ruby client library for the Auth0 API.
 email:
 - support@auth0.com
@@ -167,10 +209,12 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".bundle/config"
+- ".gemrelease"
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
 - Gemfile
+- Guardfile
 - LICENSE
 - README.md
 - Rakefile
@@ -196,6 +240,11 @@ files:
 - lib/auth0/mixins/initializer.rb
 - lib/auth0/version.rb
 - lib/auth0_client.rb
+- spec/integration/lib/auth0/api/v1/api_clients_spec.rb
+- spec/integration/lib/auth0/api/v1/api_users_spec.rb
+- spec/integration/lib/auth0/api/v2/api_clients_spec.rb
+- spec/integration/lib/auth0/api/v2/api_users_spec.rb
+- spec/integration/lib/auth0/auth0_client_spec.rb
 - spec/lib/auth0/api/authentication_endpoints_spec.rb
 - spec/lib/auth0/api/v1/clients_spec.rb
 - spec/lib/auth0/api/v1/connections_spec.rb
@@ -210,8 +259,10 @@ files:
 - spec/lib/auth0/client_spec.rb
 - spec/lib/auth0/mixins/httparty_proxy_spec.rb
 - spec/lib/auth0/mixins/initializer_spec.rb
-- spec/lib/auth0_client_spec.rb
 - spec/spec_helper.rb
+- spec/spec_helper_full.rb
+- spec/spec_helper_unit.rb
+- spec/support/credentials.rb
 - spec/support/dummy_class.rb
 - spec/support/dummy_class_for_proxy.rb
 - spec/support/stub_response.rb
@@ -240,6 +291,11 @@ signing_key:
 specification_version: 4
 summary: Auth0 API Client
 test_files:
+- spec/integration/lib/auth0/api/v1/api_clients_spec.rb
+- spec/integration/lib/auth0/api/v1/api_users_spec.rb
+- spec/integration/lib/auth0/api/v2/api_clients_spec.rb
+- spec/integration/lib/auth0/api/v2/api_users_spec.rb
+- spec/integration/lib/auth0/auth0_client_spec.rb
 - spec/lib/auth0/api/authentication_endpoints_spec.rb
 - spec/lib/auth0/api/v1/clients_spec.rb
 - spec/lib/auth0/api/v1/connections_spec.rb
@@ -254,8 +310,10 @@ test_files:
 - spec/lib/auth0/client_spec.rb
 - spec/lib/auth0/mixins/httparty_proxy_spec.rb
 - spec/lib/auth0/mixins/initializer_spec.rb
-- spec/lib/auth0_client_spec.rb
 - spec/spec_helper.rb
+- spec/spec_helper_full.rb
+- spec/spec_helper_unit.rb
+- spec/support/credentials.rb
 - spec/support/dummy_class.rb
 - spec/support/dummy_class_for_proxy.rb
 - spec/support/stub_response.rb

data/spec/lib/auth0_client_spec.rb

@@ -1,8 +0,0 @@
-require "spec_helper"
-describe Auth0Client do
-  let(:subject){Auth0Client.new({})}
-  before :each do
-    allow_any_instance_of(Auth0::Api::AuthenticationEndpoints).to receive(:obtain_access_token)
-  end
-  it {expect(subject).to be_a Auth0::Client}
-end