Documentation for login event limitation

gears/carto_gears_api/lib/carto_gears_api/events/user_events.rb

@@ -31,7 +31,13 @@ module CartoGearsApi
       end
     end
 
-    # Event triggered when a user logins
+    # Event triggered when a user performs a login in the box.
+    # This is not triggered if you use an external authentication system
+    # that overrides local authentication.
+    # For example, this won't work in a SaaS with a central authentication system.
+    # Nevertheless, it will always work for organization login.
+    # LDAP, SAML and other authentication systems will work, because they use
+    # local authentication system.
     class UserLoginEvent < BaseEvent
       def initialize(user)
         @user = user