intercom-rails 0.3.4 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ae61e5efdf193cc74b1176e5689e18ec2ceca704
-  data.tar.gz: e5dfb686a1b287f254d6f4fa16f6a6c794f885d4
+SHA256:
+  metadata.gz: 02ee9e097fd0d56647c686ee99951ffab111c4dbb557945724b2a0bc3fe4e5db
+  data.tar.gz: d07d7828811fc2efa8e9de4396d6209de92b6b094e70ea29d999a3c717620abf
 SHA512:
-  metadata.gz: d8296981fcc1ce3cbbc916f8ba0d99ccf2689c19bc92e9d3b2496908f79de5202aceb8a3c14bf7e79bd367864295cb7a7737f853b70ea226c0c5094cd18b9e95
-  data.tar.gz: 1b0b1c01a2de42adf788f684616d33ef7de2e147a8f3fe1392105f2619051c067fa337dcfe7cfc2f20fd5a7bb694810961d151405470c2f0de7f33942acd70fc
+  metadata.gz: e4549531a669d19d6d2dae37bbb46ed70771a7bc5b3c4541ee5b194679d335346278a5bb65e2256ae402e72eff417f17bee27b6ecb0e7039225a608240b27c56
+  data.tar.gz: 811c41ee91378ed52c256aa360d3f5c0bb01f44cdb18b617c3d8610f6b9ca1afcd54e6958525cbcbd4748c6116a3e90e61e2097de45363d00efde32f78033783

data/{README.mdown → README.md}

@@ -4,6 +4,8 @@ The easiest way to install Intercom in a rails app.
 
 For interacting with the Intercom REST API, use the `intercom` gem (https://github.com/intercom/intercom-ruby)
 
+Requires Ruby 2.0 or higher.
+
 ## Installation
 Add this to your Gemfile:
 
@@ -17,7 +19,7 @@ Then run:
 bundle install
 ```
 
-Take note of your `app_id` from [here](https://app.intercom.io/a/apps/_/settings/api-keys) and generate a config file:
+Take note of your `app_id` from [here](https://app.intercom.com/a/apps/_/settings/web) and generate a config file:
 
 ```
 rails generate intercom:config YOUR-APP-ID
@@ -26,9 +28,8 @@ rails generate intercom:config YOUR-APP-ID
 To make installing Intercom easy, where possible a `<script>` tag **will be automatically inserted before the closing `</body>` tag**. For most Rails apps, **you won't need to do any extra config**. Having trouble? Check out troubleshooting below.
 
 
-### Live Chat / Acquire
-With our [Acquire package](https://www.intercom.io/live-chat), Intercom Messenger now works with logged out users and visitors to your web site. Include the Intercom snippet on every page by setting:
-
+### Live Chat
+With the Intercom Messenger you can [chat](https://www.intercom.com/live-chat) with users and visitors to your web site. Include the Intercom Messenger on every page by setting:
 ```ruby
   config.include_for_logged_out_users = true
 ```
@@ -42,7 +43,7 @@ To disable automatic insertion for a particular controller or action you can:
 ```
 
 ### Troubleshooting
-If it's not working make sure:
+If things are not working make sure that:
 
 * You've generated a config file with your `app_id` as detailed above.
 * Your user object responds to an `id` or `email` method.
@@ -50,37 +51,36 @@ If it's not working make sure:
 ```ruby
   config.user.current = Proc.new { current_user_object }
 ```
-If your users can be defined in different ways in your app you can also pass an array as follows :
+If your users can be defined in different ways in your app you can also pass an array as follows:
 ```ruby
   config.user.current = [Proc.new { current_user_object }, Proc.new { @user_object }]
 ```
-* If you want the Intercom Messenger to be available when there is no current user,  set `config.include_for_logged_out_users = true` in your config and sign up for the [Acquire](https://www.intercom.io/live-chat) package.
+* If you want the Intercom Messenger to be available when there is no current user,  set `config.include_for_logged_out_users = true` in your config.
 
-Feel free to mail us: team@intercom.io, if you're still having trouble.
+Feel free to mail us: team@intercom.io, if you're still having trouble and we'll work with you to get you sorted.
 
 ## Configuration
 
 ### API Secret
-If you want to use secure mode, ensure you set your API secret in `config/initializers/intercom.rb`:
+It is possible to enable Identity Verification for the Intercom Messenger and you can find the documentation in how to do it [here](https://developers.intercom.com/docs/enable-secure-mode-on-your-web-product). We strongly encourage doing this as it makes your installation more secure! If you want to use this feature, ensure you set your Identity Verification Secret as the API secret in `config/initializers/intercom.rb`:
 
 ```ruby
   config.api_secret = '123456'
 ```
-**Note: This example is just for the sake of simplicity, you should never include your api secret in source control. Instead, you should use the Rails [secret config](http://guides.rubyonrails.org/4_1_release_notes.html#config-secrets-yml) feature.**
-### Shutdown
+**Note: This example is just for the sake of simplicity, you should never include this secret in source control. Instead, you should use the Rails [secret config](http://guides.rubyonrails.org/4_1_release_notes.html#config-secrets-yml) feature.**
 
-If you use Intercom Acquire combined with another product like Support, Learn or Engage, any user that uses a shared computer and browser with someone else will be able to see the most recently logged in user’s conversation history until the cookie expires.
-Because of this, it’s very important to properly shutdown Intercom when a user’s session on your app ends (via manually or automatically logging out).
+### Shutdown
+We make use of first-party cookies so that we can identify your users the next time they open your messenger. When people share devices with someone else, they might be able to see the most recently logged in user’s conversation history until the cookie expires. Because of this, it’s very important to properly shutdown Intercom when a user’s session on your app ends (either manually or due to an automated logout).
 
 #### Using Devise
 
-If you use devise, you can override (if not already done) the session_controller by replacing in your `config/routes.rb` file :
+If you use devise, you can override (if not already done) the session_controller by replacing in your `config/routes.rb` file:
 ```ruby
 devise_for :users
 ```
-by
+with
 ```ruby
-devise_for :users, controllers: {sessions: "sessions"}
+devise_for :users, controllers: { sessions: "sessions" }
 ```
 
 Then you can use the following code to prepare Intercom Shutdown on log out in your `app/session_controller.rb`
@@ -114,7 +114,7 @@ class VisitorsController < ApplicationController
 
   protected
   def intercom_shutdown
-    IntercomRails::ShutdownHelper.intercom_shutdown(session, cookies)
+    IntercomRails::ShutdownHelper.intercom_shutdown(session, cookies, request.domain)
   end
 end
 ```
@@ -124,7 +124,7 @@ end
 If you use another service than Devise or if you implemented your own authentication service, you can call the following method in a controller to shutdown Intercom on logout.
 
 ```ruby
-IntercomRails::ShutdownHelper::intercom_shutdown_helper(cookies)
+IntercomRails::ShutdownHelper::intercom_shutdown_helper(cookies, domain)
 ```
 
 **Be aware that if you call this method before a 'redirect_to' (quite common on logout) it will have no impact** as it is impossible to update cookies when you use a redirection.
@@ -379,13 +379,14 @@ You can do this using the [intercom-ruby](https://github.com/intercom/intercom-r
 
 ```
 class User
-  after_destroy { DeleteFromIntercom.perform_later(self)
+  after_destroy { DeleteFromIntercomJob.perform_later(self) }
 end
 
-class DeleteFromIntercom < ApplicationJob
+class DeleteFromIntercomJob < ApplicationJob
   def perform(user)
     intercom = Intercom::Client.new
-    intercom.users.find(email: user.email).delete
+    user = intercom.users.find(id: user.id)
+    deleted_user = intercom.users.delete(user)
   end
 end
 ```
@@ -417,7 +418,7 @@ bundle exec rspec spec/
 - **Send coherent history**. Make sure each individual commit in your pull
   request is meaningful. If you had to make multiple intermediate commits while
   developing, please squash them before sending them to us.
-  
+
 
 ## Contributors
 
@@ -430,4 +431,4 @@ intercom-rails is released under the [MIT License](http://www.opensource.org/lic
 
 ## Copyright
 
-Copyright (c) 2011-2012 Intercom, Inc.  All rights reserved.
+Copyright (c) 2011-2020 Intercom, Inc.  All rights reserved.

data/lib/intercom-rails.rb

@@ -3,6 +3,7 @@ require 'intercom-rails/date_helper'
 require 'intercom-rails/proxy'
 require 'intercom-rails/proxy/user'
 require 'intercom-rails/proxy/company'
+require 'intercom-rails/encrypted_mode'
 require 'intercom-rails/script_tag'
 require 'intercom-rails/script_tag_helper'
 require 'intercom-rails/custom_data_helper'

data/lib/intercom-rails/auto_include_filter.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module IntercomRails
 
   module AutoInclude
@@ -8,9 +10,8 @@ module IntercomRails
     end
 
     class Filter
-
-      CLOSING_BODY_TAG = %r{</body>}
-      BLACKLISTED_CONTROLLER_NAMES = ["Devise::PasswordsController"]
+      CLOSING_BODY_TAG = "</body>"
+      BLACKLISTED_CONTROLLER_NAMES = %w{ Devise::PasswordsController }
 
       def self.filter(controller)
         return if BLACKLISTED_CONTROLLER_NAMES.include?(controller.class.name)
@@ -32,9 +33,7 @@ module IntercomRails
       end
 
       def include_javascript!
-        split = response.body.split("</body>")
-        response.body = split.first + intercom_script_tag.to_s + "</body>"
-        response.body = response.body + split.last if split.size > 1
+        response.body = response.body.insert(response.body.rindex(CLOSING_BODY_TAG), intercom_script_tag.to_s)
       end
 
       def include_javascript?
@@ -55,11 +54,15 @@ module IntercomRails
       end
 
       def html_content_type?
-        response.content_type == 'text/html'
+        if response.respond_to?(:media_type)
+          response.media_type == 'text/html'
+        else
+          response.content_type == 'text/html'
+        end
       end
 
       def response_has_closing_body_tag?
-        !!(response.body[CLOSING_BODY_TAG])
+        response.body.include? CLOSING_BODY_TAG
       end
 
       def intercom_script_tag_called_manually?
@@ -79,7 +82,7 @@ module IntercomRails
           nonce = CoreExtensions::IntercomRails::AutoInclude.csp_nonce_hook(controller)
           options.merge!(:nonce => nonce)
         end
-        @script_tag = ScriptTag.new(options)
+        @script_tag ||= ScriptTag.new(options)
       end
 
       def show_everywhere?

data/lib/intercom-rails/config.rb

@@ -108,6 +108,8 @@ module IntercomRails
     config_accessor :enabled_environments, &ARRAY_VALIDATOR
     config_accessor :include_for_logged_out_users
     config_accessor :hide_default_launcher
+    config_accessor :api_base
+    config_accessor :encrypted_mode
 
     def self.api_key=(*)
       warn "Setting an Intercom API key is no longer supported; remove the `config.api_key = ...` line from config/initializers/intercom.rb"

data/lib/intercom-rails/custom_data_helper.rb

@@ -1,6 +1,7 @@
 module IntercomRails
 
   module CustomDataHelper
+    STORE = Struct.new(:user, :company)
 
     # This helper allows custom data attributes to be added to a user
     # for the current request from within the controller. e.g.
@@ -10,12 +11,7 @@ module IntercomRails
     #   ...
     # end
     def intercom_custom_data
-      @_request_specific_intercom_custom_data ||= begin
-        s = Struct.new(:user, :company).new
-        s.user = {}
-        s.company = {}
-        s
-      end
+      @_request_specific_intercom_custom_data ||= STORE.new({}, {})
     end
 
   end

data/lib/intercom-rails/encrypted_mode.rb

@@ -0,0 +1,34 @@
+module IntercomRails
+  class EncryptedMode
+    attr_reader :secret, :initialization_vector, :enabled
+
+    ENCRYPTED_MODE_SETTINGS_WHITELIST = [:app_id, :session_duration, :widget, :custom_launcher_selector, :hide_default_launcher, :api_base, :alignment, :horizontal_padding, :vertical_padding]
+
+    def initialize(secret, initialization_vector, options)
+      @secret = secret
+      @initialization_vector = initialization_vector || SecureRandom.random_bytes(12)
+      @enabled = options.fetch(:enabled, false)
+    end
+
+    def plaintext_part(settings)
+      enabled ? settings.slice(*ENCRYPTED_MODE_SETTINGS_WHITELIST) : settings
+    end
+
+    def encrypted_javascript(payload)
+      enabled ? "window.intercomEncryptedPayload = \"#{encrypt(payload)}\";" : ""
+    end
+
+    def encrypt(payload)
+      return nil unless enabled
+      payload = payload.except(*ENCRYPTED_MODE_SETTINGS_WHITELIST)
+      key = Digest::SHA256.digest(secret)
+      cipher = OpenSSL::Cipher.new('aes-256-gcm')
+      cipher.encrypt
+      cipher.key = key
+      cipher.iv = initialization_vector
+      json = ActiveSupport::JSON.encode(payload).gsub('<', '\u003C')
+      encrypted = initialization_vector + cipher.update(json) + cipher.final + cipher.auth_tag
+      Base64.encode64(encrypted).gsub("\n", "\\n")
+    end
+  end
+end

data/lib/intercom-rails/exceptions.rb

@@ -2,6 +2,7 @@ module IntercomRails
 
   class Error < StandardError; end
   class NoUserFoundError < Error; end
+  class ExcludedUserFoundError < Error; end
   class NoCompanyFoundError < Error; end
 
 end

data/lib/intercom-rails/proxy/user.rb

@@ -31,11 +31,11 @@ module IntercomRails
           begin
             user_proxy = new(search_object.instance_eval(&potential_object), search_object)
             return user_proxy if user_proxy.valid?
+            raise ExcludedUserFoundError if user_proxy.excluded?
           rescue NameError
             next
           end
         end
-
         raise NoUserFoundError
       end
 
@@ -47,10 +47,14 @@ module IntercomRails
 
       def valid?
         return false if user.blank? || user.respond_to?(:new_record?) && user.new_record?
-        return false if config.user.exclude_if.present? && config.user.exclude_if.call(user)
+        return false if excluded?
         identity_present?
       end
 
+      def excluded?
+        config.user.exclude_if.present? && config.user.exclude_if.call(user)
+      end
+
     end
 
   end

data/lib/intercom-rails/script_tag.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'active_support/json'
 require 'active_support/core_ext/hash/indifferent_access'
 require 'active_support/core_ext/string/output_safety'
@@ -6,11 +8,18 @@ require 'action_view'
 module IntercomRails
 
   class ScriptTag
+    # Base64 regexp:
+    # - blocks of 4 [A-Za-z0-9+/]
+    # followed either by:
+    # - blocks of 2 [A-Za-z0-9+/] + '=='
+    # - blocks of 3 [A-Za-z0-9+/] + '='
+    NONCE_RE = %r{^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$}
 
     include ::ActionView::Helpers::JavaScriptHelper
+    include ::ActionView::Helpers::TagHelper
 
     attr_reader :user_details, :company_details, :show_everywhere, :session_duration
-    attr_accessor :secret, :widget_options, :controller, :nonce
+    attr_accessor :secret, :widget_options, :controller, :nonce, :encrypted_mode_enabled, :encrypted_mode
 
     def initialize(options = {})
       self.secret = options[:secret] || Config.api_secret
@@ -20,18 +29,22 @@ module IntercomRails
       @session_duration = session_duration_from_config
       self.user_details = options[:find_current_user_details] ? find_current_user_details : options[:user_details]
 
+      self.encrypted_mode_enabled = options[:encrypted_mode] || Config.encrypted_mode
+      self.encrypted_mode = IntercomRails::EncryptedMode.new(secret, options[:initialization_vector], {:enabled => encrypted_mode_enabled})
+
       # Request specific custom data for non-signed up users base on lead_attributes
       self.user_details = self.user_details.merge(find_lead_attributes)
 
       self.company_details = if options[:find_current_company_details]
         find_current_company_details
       elsif options[:user_details]
-        options[:user_details].delete(:company) if options[:user_details]
+        options[:user_details].delete(:company)
       end
       self.nonce = options[:nonce]
     end
 
     def valid?
+      return false if user_details[:excluded_user] == true
       valid = user_details[:app_id].present?
       unless @show_everywhere
         valid = valid && (user_details[:user_id] || user_details[:email]).present?
@@ -42,21 +55,14 @@ module IntercomRails
       valid
     end
 
-    def valid_nonce?
-      valid = false
-      if nonce
-        # Base64 regexp:
-        # - blocks of 4 [A-Za-z0-9+/]
-        # followed either by:
-        # - blocks of 2 [A-Za-z0-9+/] + '=='
-        # - blocks of 3 [A-Za-z0-9+/] + '='
-        base64_regexp = Regexp.new('^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$')
-        m = base64_regexp.match(nonce)
-        if nonce == m.to_s
-          valid = true
-        end
+    if //.respond_to?(:match?)
+      def valid_nonce?
+        nonce && NONCE_RE.match?(nonce)
+      end
+    else
+      def valid_nonce?
+        nonce && !!NONCE_RE.match(nonce)
       end
-      valid
     end
 
     def intercom_settings
@@ -65,16 +71,14 @@ module IntercomRails
       hsh[:widget] = widget_options if widget_options.present?
       hsh[:company] = company_details if company_details.present?
       hsh[:hide_default_launcher] = Config.hide_default_launcher if Config.hide_default_launcher
+      hsh[:api_base] = Config.api_base if Config.api_base
       hsh
     end
 
     def to_s
-      js_options = 'id="IntercomSettingsScriptTag"'
-      if nonce && valid_nonce?
-        js_options = js_options + " nonce=\"#{nonce}\""
-      end
-      str = "<script #{js_options}>#{intercom_javascript}</script>\n"
-      str.respond_to?(:html_safe) ? str.html_safe : str
+      html_options = { id: 'IntercomSettingsScriptTag' }
+      html_options['nonce'] = nonce if valid_nonce?
+      javascript_tag(intercom_javascript, html_options) + "\n"
     end
 
     def csp_sha256
@@ -93,13 +97,21 @@ module IntercomRails
       custom_data.select {|k, v| lead_attributes.map(&:to_s).include?(k)}
     end
 
+    def plaintext_settings
+      encrypted_mode.plaintext_part(intercom_settings)
+    end
+
+    def encrypted_settings
+      encrypted_mode.encrypt(intercom_settings)
+    end
+
     private
-    def intercom_javascript
-      intercom_settings_json = ActiveSupport::JSON.encode(intercom_settings).gsub('<', '\u003C')
 
-      str = "window.intercomSettings = #{intercom_settings_json};(function(){var w=window;var ic=w.Intercom;if(typeof ic===\"function\"){ic('reattach_activator');ic('update',intercomSettings);}else{var d=document;var i=function(){i.c(arguments)};i.q=[];i.c=function(args){i.q.push(args)};w.Intercom=i;function l(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='#{Config.library_url || "https://widget.intercom.io/widget/#{j app_id}"}';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);}if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}};})()"
+    def intercom_javascript
+      plaintext_javascript = ActiveSupport::JSON.encode(plaintext_settings).gsub('<', '\u003C')
+      intercom_encrypted_payload_javascript = encrypted_mode.encrypted_javascript(intercom_settings)
 
-      str
+      "window.intercomSettings = #{plaintext_javascript};#{intercom_encrypted_payload_javascript}(function(){var w=window;var ic=w.Intercom;if(typeof ic===\"function\"){ic('reattach_activator');ic('update',intercomSettings);}else{var d=document;var i=function(){i.c(arguments)};i.q=[];i.c=function(args){i.q.push(args)};w.Intercom=i;function l(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='#{Config.library_url || "https://widget.intercom.io/widget/#{j app_id}"}';var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);}if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}};})()"
     end
 
     def user_details=(user_details)
@@ -117,6 +129,10 @@ module IntercomRails
       Proxy::User.current_in_context(controller).to_hash
     rescue NoUserFoundError
       {}
+    rescue ExcludedUserFoundError
+      {
+        excluded_user: true
+      }
     end
 
     def company_details=(company_details)

data/lib/intercom-rails/script_tag_helper.rb

@@ -5,14 +5,14 @@ module IntercomRails
     # Generate an intercom script tag.
     #
     # @param user_details [Hash] a customizable hash of user details
-    # @param options [Hash] an optional hash for secure mode and widget customisation
+    # @param options [Hash] an optional hash for Identity Verification and widget customization
     # @option user_details [String] :app_id Your application id
     # @option user_details [String] :user_id unique id of this user within your application
     # @option user_details [String] :email email address for this user
     # @option user_details [String] :name the users name, _optional_ but useful for identify people in the Intercom App.
     # @option user_details [Hash] :custom_data custom attributes you'd like saved for this user on Intercom.
     # @option options [String] :widget a hash containing a css selector for an element which when clicked should show the Intercom widget
-    # @option options [String] :secret Your app secret for secure mode
+    # @option options [String] :secret Your app secret for Identity Verification
     # @option options [String] :nonce a nonce generated by your CSP framework to be included inside the javascript tag
     # @return [String] Intercom script tag
     # @example basic example

data/lib/intercom-rails/shutdown_helper.rb

@@ -2,15 +2,17 @@ module IntercomRails
   module ShutdownHelper
     # This helper allows to erase cookies when a user log out of an application
     # It is recommanded to call this function every time a user log out of your application
-    # specifically if you use both "Acquire" and another Intercom product
     # Do not use before a redirect_to because it will not clear the cookies on a redirection
-    def self.intercom_shutdown_helper(cookies)
+    def self.intercom_shutdown_helper(cookies, domain = nil)
+      nil_session = { value: nil, expires: 1.day.ago }
+      nil_session = nil_session.merge(domain: domain) unless domain.nil? || domain == 'localhost'
+
       if (cookies.is_a?(ActionDispatch::Cookies::CookieJar))
-        cookies["intercom-session-#{IntercomRails.config.app_id}"] = { value: nil, expires: 1.day.ago}
+        cookies["intercom-session-#{IntercomRails.config.app_id}"] = nil_session
       else
         controller = cookies
         Rails.logger.info("Warning: IntercomRails::ShutdownHelper.intercom_shutdown_helper takes an instance of ActionDispatch::Cookies::CookieJar as an argument since v0.2.34. Passing a controller is depreciated. See https://github.com/intercom/intercom-rails#shutdown for more details.")
-        controller.response.delete_cookie("intercom-session-#{IntercomRails.config.app_id}", { value: nil, expires: 1.day.ago})
+        controller.response.delete_cookie("intercom-session-#{IntercomRails.config.app_id}", nil_session)
       end
     rescue
     end
@@ -19,10 +21,10 @@ module IntercomRails
       session[:perform_intercom_shutdown] = true
     end
 
-    def self.intercom_shutdown(session, cookies)
+    def self.intercom_shutdown(session, cookies, domain = nil)
       if session[:perform_intercom_shutdown]
         session.delete(:perform_intercom_shutdown)
-        intercom_shutdown_helper(cookies)
+        intercom_shutdown_helper(cookies, domain)
       end
     end
 

data/lib/intercom-rails/version.rb

@@ -1,3 +1,3 @@
 module IntercomRails
-  VERSION = "0.3.4"
+  VERSION = "0.4.2"
 end

data/lib/rails/generators/intercom/config/config_generator.rb

@@ -7,7 +7,7 @@ module Intercom
       end
 
       argument :app_id, :desc => "Your Intercom app-id, which can be found here: https://app.intercom.io/apps/api_keys"
-      argument :api_secret, :desc => "Your Intercom api-secret, used for secure mode", :optional => true
+      argument :api_secret, :desc => "Your Intercom api-secret, used for Identity Verification", :optional => true
       argument :session_duration, :desc => "user session duration, this should match your app", :optional => true
 
       FALSEY_RESPONSES = ['n', 'no']

data/lib/rails/generators/intercom/config/intercom.rb.erb

@@ -11,8 +11,8 @@ IntercomRails.config do |config|
   # config.session_duration = 300000
   <%- end -%>
   # == Intercom secret key
-  # This is required to enable secure mode, you can find it on your Setup
-  # guide in the "Secure Mode" step.
+  # This is required to enable Identity Verification, you can find it on your Setup
+  # guide in the "Identity Verification" step.
   #
   <%- if @api_secret -%>
   config.api_secret = "<%= @api_secret %>"
@@ -38,7 +38,7 @@ IntercomRails.config do |config|
 
   # == Include for logged out Users
   # If set to true, include the Intercom messenger on all pages, regardless of whether
-  # The user model class (set below) is present. Only available for Apps on the Acquire plan.
+  # The user model class (set below) is present.
   <%- if @include_for_logged_out_users -%>
   config.include_for_logged_out_users = true
   <%- else -%>
@@ -127,4 +127,8 @@ IntercomRails.config do |config|
   #
   # If you'd like to hide default launcher button uncomment this line
   # config.hide_default_launcher = true
+  #
+  # If you need to route your Messenger requests through a different endpoint than the default, uncomment the below line. Generally speaking, this is not needed.
+  # config.api_base = "https://#{config.app_id}.intercom-messenger.com"
+  #
 end

metadata

@@ -1,16 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: intercom-rails
 version: !ruby/object:Gem::Version
-  version: 0.3.4
+  version: 0.4.2
 platform: ruby
 authors:
 - Ben McRedmond
 - Ciaran Lee
 - Darragh Curran
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2016-10-24 00:00:00.000000000 Z
+date: 2020-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -163,7 +163,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- README.mdown
+- README.md
 - Rakefile
 - lib/data/cacert.pem
 - lib/intercom-rails.rb
@@ -171,6 +171,7 @@ files:
 - lib/intercom-rails/config.rb
 - lib/intercom-rails/custom_data_helper.rb
 - lib/intercom-rails/date_helper.rb
+- lib/intercom-rails/encrypted_mode.rb
 - lib/intercom-rails/exceptions.rb
 - lib/intercom-rails/proxy.rb
 - lib/intercom-rails/proxy/company.rb
@@ -186,7 +187,7 @@ homepage: http://www.intercom.io
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -201,10 +202,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: intercom-rails
-rubygems_version: 2.4.8
-signing_key: 
+rubygems_version: 3.0.4
+signing_key:
 specification_version: 4
 summary: Rails helper for emitting javascript script tags for Intercom
 test_files: []
-has_rdoc: