FusionAuth
    • Home
    • Categories
    • Recent
    • Popular
    • Pricing
    • Contact us
    • Docs
    • Login
    1. Home
    2. FASupportBot
    3. Posts
    F
    • Profile
    • Following 0
    • Followers 0
    • Topics 54
    • Posts 108
    • Best 0
    • Controversial 0
    • Groups 0

    Posts made by FASupportBot

    • RE: Is there a Helm chart release for FusionAuth 1.53.4?

      The Helm chart for FusionAuth 1.53.4 has been released and should now be available in the FusionAuth charts repository.

      In the meantime, if you need to deploy a specific FusionAuth version before the corresponding Helm chart is released, you can override the image tag in your Helm values file:

      image:
        tag: "1.53.4"
      

      This allows you to use the latest Helm chart while specifying the exact FusionAuth Docker image version you need.

      Related Documentation

      • Deploy with Kubernetes - Helm Chart Configuration - Complete guide on configuring and deploying FusionAuth using Helm charts
      • Deploy FusionAuth to the Cluster - Instructions for installing and verifying your Helm deployment
      • Kubernetes Overview - Overview of FusionAuth on Kubernetes with architecture diagrams
      • Upgrade FusionAuth - General guidance on upgrading FusionAuth installations

      When you override the image tag in your values.yaml file, you can verify the correct version is deployed by checking the IMAGES column in your Kubernetes deployment:

      kubectl get deployments -o wide
      
      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • Is there a Helm chart release for FusionAuth 1.53.4?

      I'm looking to upgrade to FusionAuth 1.53.4 using Helm, but I don't see a corresponding chart version in the FusionAuth charts repository.

      Is a Helm chart release for version 1.53.4 expected soon? I'd like to deploy this version today.

      I understand I can specify the Docker image version directly in the Helm values, but I typically track helm chart version == image version for FusionAuth deployments.

      posted in Frequently Asked Questions (FAQ) helm kubernetes deployment upgrade docker
      F
      FASupportBot
    • RE: Getting HTTP 429 rate limit errors during performance testing in FusionAuth Cloud

      The rate limiting you're encountering is applied at the WAF (Web Application Firewall) level on FusionAuth Cloud, not from the FusionAuth application itself. These rate limits protect customers and are standard across all FusionAuth Cloud deployments.

      Rate Limit Configuration

      FusionAuth does not publish rate limits publicly and they are subject to change.

      Please open a support ticket to obtain more guidance.

      Whitelisting for Performance Testing

      Since these are network-level rate limits, they cannot be configured within your deployment. However, IP allow listing is available to bypass rate limiting for performance testing if your IP address meets these requirements:

      1. It is static
      2. It is owned by your company (not shared infrastructure like a CDN)
      3. It is associated with a production server (not a developer's laptop)

      If you can provide a static IP address that meets these criteria, you can open a support ticket to get it allow listed. Note that allow list changes typically take two to three business days to implement.

      Best Practices for Performance Testing

      When planning load or performance tests against FusionAuth Cloud:

      • Open a support ticket before testing to notify the FusionAuth team of your planned stress test window
      • Don't use Basic cloud deployments for performance testing, as they run on limited infrastructure and results won't be representative. Use a Business or High-Availability plan instead, which you can spin up, test, and tear down as needed
      • Implement exponential backoff when you receive a 429 response - this is the recommended approach for handling rate limits gracefully
      • Distribute requests over time rather than sending bursts of traffic

      Alternative Testing Approaches

      If you cannot obtain an allow-listable static IP address (such as for developer machines or CI/CD pipelines), consider:

      • Running a self-hosted FusionAuth instance for automated testing, which gives you full control over rate limiting configuration
      • Using smaller-scale testing that stays under the rate limits

      Related Documentation

      • FusionAuth Cloud - CAPTCHA and Rate Limits
      • FusionAuth Cloud - Load Testing
      • Troubleshooting FusionAuth Cloud API Calls
      • User Search API Documentation
      • Advanced Threat Detection - Customizable Rate Limiting (for application-level rate limits within FusionAuth)
      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • Getting HTTP 429 rate limit errors during performance testing in FusionAuth Cloud

      We are encountering a large number of HTTP 429 (Too Many Requests) errors during performance testing against our FusionAuth Cloud environment.

      Error Message:

      [FusionAuthCloudRateLimitedException]: Your request has been rate limited. Please reduce the number of requests or wait a period of time before making the next HTTP request.
      

      We have run similar performance tests in the past without encountering this issue. We need to understand:

      1. What are the current rate limits configured for FusionAuth Cloud environments?
      2. Are these limits applied per API endpoint, tenant, application, IP address, or across the entire environment?
      3. Can these rate limits be increased to support our performance testing and expected production traffic volumes?
      4. What are the recommended best practices for handling higher request volumes without triggering HTTP 429 errors?
      posted in Frequently Asked Questions (FAQ) fusionauth cloud rate-limiting 429-error performance
      F
      FASupportBot
    • RE: FreeMarker error: postMethod variable null in registration verify template

      The postMethod variable can be null or missing in certain scenarios (such as when a verification link is clicked multiple times), causing the FreeMarker template to fail.

      To fix this, you need to provide a safe fallback for the postMethod variable. Update line 16 in your registration/verify.ftl template from:

      [#if verificationId?? && postMethod]
      

      To:

      [#if verificationId?? && (postMethod!false)]
      

      The !false syntax provides a default value of false when postMethod is null or missing, preventing the FreeMarker exception.

      Steps to apply the fix:

      1. Navigate to Customizations → Themes in the FusionAuth admin UI
      2. Edit your theme
      3. Locate the registration/verify.ftl template
      4. Update the conditional check as shown above
      5. Save the theme

      This pattern can be applied to other templates where variables might be null or missing in certain execution paths.

      Why this happens:

      According to the FusionAuth documentation, the postMethod variable is not a standard template-specific variable for the /registration/verify template. It is typically available on other verification templates like /email/verify (where it defaults to true). The registration verify template is rendered when a user clicks the URL from the verification email and the verificationId has expired or is invalid. In these scenarios, postMethod may not be set in the template context, which causes the FreeMarker error when attempting to evaluate it as a boolean.

      Related Documentation

      • Theme Template Variables - Verify Registration - Documents the variables available in the registration verify template
      • Theme Template Variables - Email Verification - Shows that postMethod is documented for email verification but not registration verification
      • Theme Template Variables - Complete reference for all template variables across different templates
      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • FreeMarker error: postMethod variable null in registration verify template

      I'm encountering a FreeMarker template error when users click a verification link, specifically on the registration verify page. The error indicates that the postMethod variable is evaluating to null:

      FreeMarker template error:
      The following has evaluated to null or missing:
      ==> postMethod  [in template "registration/verify.ftl" at line 16, column 30]
      

      The problematic line in my registration/verify.ftl template is:

      [#if verificationId?? && postMethod]
      

      This error seems to occur when the verification link is clicked a second time. The stack trace shows:

      freemarker.core.InvalidReferenceException
        at freemarker.core.NonBooleanException.<init>
        at freemarker.core.Expression.modelToBoolean
        at freemarker.core.AndExpression.evalToBoolean
        at freemarker.core.IfBlock.accept
      

      Is there a recommended way to handle this variable safely in the template to prevent this error?

      posted in Frequently Asked Questions (FAQ) freemarker templates themes registration verification
      F
      FASupportBot
    • RE: LDAP connector not functioning after upgrade — no logs, users can't authenticate

      This issue was caused by a bug that existed prior to version 1.68.0. In earlier versions, there was a problem where LDAP connectors scoped to specific domains could incorrectly be called (or not called) for users outside those domains. This could result in the connector appearing to stop functioning entirely after an upgrade.

      Solution:

      Recreate the LDAP connector configuration. When doing so, verify the Domains field:

      • If you need the connector to apply to all users, use a wildcard (*) for the domains.
      • If you need domain-specific scoping, explicitly configure the same domains you had previously.

      This bug was fixed in FusionAuth 1.68.0. See the release notes for details:

      Fixed an issue where Connectors configured for a specific domain in a Tenant could be called for users outside of that domain.

      If you encounter this issue after upgrading to 1.68.0 or later and recreating the connector does not resolve it, verify:

      1. Debug mode is enabled for both the connector and the reconcile lambda.
      2. The LDAP server is reachable from the FusionAuth instance.
      3. Event log and system log (fusionauth-app.log) for any connection or authentication errors.
      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • LDAP connector not functioning after upgrade — no logs, users can't authenticate

      After upgrading FusionAuth to 1.69.2, the LDAP connector and reconcile lambda stopped working entirely. Users cannot authenticate unless they have a local FusionAuth account, and no LDAP-related activity appears in the event log — no reconcile attempts, no communication with the LDAP server.

      Debug mode is enabled for both the connector and the lambda, but still no log entries are generated when users attempt to log in. It appears FusionAuth is not honoring or applying the connector configuration at all.

      The issue was temporarily resolved by deleting and recreating the LDAP connector, but the root cause was unclear at the time.

      posted in Frequently Asked Questions (FAQ) ldap connector upgrade lambda authentication
      F
      FASupportBot
    • RE: Why aren't user.login.suspicious webhook events firing despite emails being sent?

      The user.login.suspicious webhook event requires the Client Risk Configuration to be enabled at the tenant level. Even though Risk Signals are evaluated by default, the webhook event itself won't fire unless this configuration is explicitly turned on.

      To enable it:

      1. Navigate to Tenants → Select your tenant → Edit → Security tab
      2. Find the Client Risk Configuration section
      3. Ensure it's enabled for your tenant

      Additionally, verify that the user.login.suspicious event is enabled in the tenant's webhook settings:

      1. Go to Tenants → Select your tenant → Edit → Webhooks tab
      2. Confirm user.login.suspicious is checked/enabled

      Once both are configured, your webhook should start receiving user.login.suspicious events along with details about which Risk Signals triggered the suspicious login determination.

      About Risk Signals and Email Volume

      If you're seeing a significant increase in suspicious login emails after upgrading to 1.68.0 or later, this is because FusionAuth introduced comprehensive Risk Signals in version 1.68.0. Previously, only Impossible Travel was tracked. Now additional signals are evaluated including:

      • Untrusted Device
      • Unrecognized Device
      • Recent Password Change
      • Recent Identity Change
      • Dormant Password
      • Suspicious Agent

      All Risk Signals are enabled by default without any configuration changes.

      Managing Email Volume

      You can tune which Risk Signals trigger suspicious login alerts:

      1. Go to Tenants → Select tenant → Edit → Security tab → Client Risk Configuration
      2. Disable specific Risk Signals that are generating too many false positives for your use case

      Monitoring Without Sending Emails

      You can monitor webhook events while tuning your Risk Signals without sending emails to users:

      1. Go to your tenant/application settings → Identities tab
      2. Change the Suspicious Login template to "No Template Selected"
      3. Monitor your webhook endpoint to see which Risk Signals are triggering
      4. Fine-tune your Risk Signal configuration
      5. Re-enable the email template once you're satisfied with the detection accuracy

      The webhook fires whenever a Risk Signal threshold is met, independent of whether an email template is configured. This allows you to observe and tune the system before alerting end users.

      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • Why aren't user.login.suspicious webhook events firing despite emails being sent?

      After upgrading FusionAuth, we're seeing suspicious login emails being sent to end users, but we're not receiving user.login.suspicious webhook events in our webhook logs. We've confirmed:

      • The webhook has user.login.suspicious set to true in eventsEnabled
      • The webhook is scoped to the specific tenant where logins are occurring
      • Other webhook events (like user.action, user.password.reset.success, etc.) are working correctly
      • Reactor license is activated
      • Users are definitely receiving suspicious login emails, confirming the events are being triggered

      Our webhook configuration shows:

      {
        "eventsEnabled": {
          "user.login.suspicious": true,
          // ... other events
        },
        "tenantIds": ["<your-tenant-id>"],
        "global": false
      }
      

      What configuration might we be missing to receive these webhook events?

      posted in Frequently Asked Questions (FAQ) webhook risk-signals suspicious login reactor
      F
      FASupportBot
    • RE: How to share SSO session between two applications in the same tenant?

      Yes, you need to create two separate applications within the same tenant in FusionAuth. Here's how to configure this:

      Configuration Steps

      1. Create both applications in the same tenant - Users are scoped at the tenant level, so applications in the same tenant can share authentication state through FusionAuth's SSO session.

      2. Enable self-service registration on the second application - This ensures a seamless login experience. When a user navigates to the second application while already authenticated to the first, they will be automatically registered and logged in.

      How It Works

      • User logs into the first application at your registration URL to create their account. Make sure the rememberDevice parameter is true or checked. You can modify your theme to hardcode that value.
      • While that session is valid, they navigate to the second application's login URL
      • They are automatically registered and authenticated to the second application without manual intervention

      The key to this working is that FusionAuth creates an SSO session at the tenant level when a user logs in and rememberDevice is checked. When the authenticated user tries to access the second application, FusionAuth recognizes the existing SSO session and automatically creates a registration for that user in the second application (when self-service registration is enabled).

      Password Reset Behavior

      Because users are scoped at the tenant level, a password reset applies to all applications under that tenant. Users can utilize the password reset page for the first application and will be able to log in at the second application with the new password.

      Sharing Templates

      Both applications can share the same theme and templates. Themes are assigned at the tenant level (though you can also assign application-specific themes if needed starting with FusionAuth 1.27+). This means you can configure one set of templates - including password reset, login, and user management pages - that will be used by both applications.

      Pre-creating User Accounts

      If you create user accounts ahead of time, you can automatically include the registration for the second application when creating the users. This would mean adding that application to their registrations when you create the account initially using the Create a User and Registration API.

      Related Documentation

      • Implementing Single Sign-On - Complete guide to configuring SSO between applications
      • Self-Service Registration - How automatic registration works when SSO is enabled
      • Create a User Registration API - Programmatically register existing users to additional applications
      • Application Themes - Configure application-specific themes if needed
      • Themes Documentation - Customize and share login pages and templates across applications
      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • How to share SSO session between two applications in the same tenant?

      I have an application using FusionAuth for SSO and want to set up a second application to share authentication state. Once a user is logged into the first application, they should be automatically authenticated into the second application without needing to log in again.

      I'd like the first application to handle password reset and user management, while sharing templates between both applications.

      How should I configure FusionAuth to enable this SSO session sharing between two applications? Do I need to set up two separate applications in the same tenant?

      posted in Frequently Asked Questions (FAQ) sso multi application tenant self
      F
      FASupportBot
    • RE: Will bulk user imports into one tenant affect performance in other tenants?

      FusionAuth tenants provide logical isolation, not physical isolation. While users, applications, groups, and configuration are logically separated per tenant, all tenants in an instance share the same FusionAuth nodes, database, and search index.

      This means that while importing data into one tenant will not impact the data integrity in another tenant, it does draw on the same compute and database capacity that other tenants' logins and profile updates use. Large imports can potentially affect performance across all tenants.

      Recommendations to minimize impact:

      1. Serialize imports: Do not run multiple imports simultaneously. Even when migrating multiple clients, avoid having two clients in the initial import phase at the same time.

      2. Pre-hash passwords: Since you're already sending passwords with hash, salt, factor, and encryption scheme, this will significantly reduce load during imports. If passwords were sent as plaintext, FusionAuth would need to hash each one on import (which can take several hundred milliseconds per user).

      3. Start with smaller batches: Rather than immediately using 100k user batches, start smaller to monitor system performance during imports. If performance is acceptable, gradually increase the batch size until you find the right balance between performance and import speed.

      4. Avoid transactional webhooks: You mentioned using Kafka integration instead of custom webhooks, which is good. Ensure you are only using the Kafka integration for events and not using any transactional webhooks, as these can add additional load during imports. Transactional webhooks block the operation until the webhook completes, which can significantly slow down bulk imports. Non-transactional events (like those sent to Kafka) are fire-and-forget and don't block the import process.

      5. Limit concurrent operations: You mentioned planning to run only one import call at a time from one worker, which is the right approach. Updates using the PATCH endpoint can occur in parallel as they should be infrequent.

      6. Monitor database performance: Keep an eye on your database connection pool and query performance during imports. The shared database is typically the bottleneck in multi-tenant scenarios under heavy load.

      By following these practices, you can minimize the impact of bulk imports on other tenants in your multi-tenant FusionAuth deployment.

      Related Documentation

      • Multi-tenancy Guide - Overview of FusionAuth's multi-tenant architecture and concepts
      • Levels of Isolation - Explanation of logical vs. physical isolation in FusionAuth
      • Import Users API - API documentation for bulk user imports
      • Password Hashes - Details on importing pre-hashed passwords to improve performance
      • Transactional vs. Non-Transactional Events - Understanding event types and their performance impact
      • Kafka Integration - Using Kafka for non-blocking event processing
      • Scaling Your Auth - Best Practices - Performance and scaling considerations for authentication systems
      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • Will bulk user imports into one tenant affect performance in other tenants?

      We are building a migration application that imports users from a legacy database into FusionAuth. Some clients have millions of users that need to be migrated.

      Our migration process:

      • Users are imported in batches (up to 100,000 per batch following the Import API recommendations)
      • Passwords are sent pre-hashed with salt, factor, and encryption scheme
      • Initial import phase may take up to 2 days to complete
      • After initial import, ongoing sync uses the /api/user/{userId} PATCH endpoint for updates
      • Duplicates are unlikely as data goes through cleanup before import
      • We have Kafka integration enabled for events (all event toggles enabled per tenant)
      • No transactional webhooks are configured

      Our FusionAuth deployment is multi-tenant, and migrations need to run without interrupting day-to-day operations for other clients on the platform.

      Question: If we initiate a bulk user import into one tenant, how will this affect activity on other tenants? Will users logging in or managing their data in other tenants experience performance issues?

      posted in Frequently Asked Questions (FAQ) multi-tenant bulk-import user-import performance migration
      F
      FASupportBot
    • RE: Can I customize HTTP security headers (HSTS, CSP, etc.) on FusionAuth Cloud?

      At this time, FusionAuth Cloud does not support customizing HTTP security headers on individual tenant deployments. There is an existing GitHub feature request tracking this capability, but it is not currently on the roadmap and no ETA is available for when this might be added.

      If you are running a self-hosted FusionAuth instance, you can configure these headers using a reverse proxy (nginx, Apache, etc.) in front of FusionAuth. For FusionAuth Cloud customers, this configuration is managed at the infrastructure level and cannot be modified per-tenant.

      You may want to subscribe to or comment on the relevant GitHub issue to track progress on this feature request.

      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • Can I customize HTTP security headers (HSTS, CSP, etc.) on FusionAuth Cloud?

      I'm running a security scan against our FusionAuth Cloud tenant and found several HTTP security header issues:

      • Strict-Transport-Security is present but has max-age=300 (5 minutes), which is far below the 1-year minimum (31536000 seconds) required for HSTS preload to take effect
      • Content-Security-Policy header is not being sent
      • X-Content-Type-Options header is not being sent
      • Referrer-Policy header is not being sent

      Is there a way to configure or customize these security headers for a FusionAuth Cloud tenant? Ideally I'd like to set Strict-Transport-Security: max-age=31536000; includeSubDomains; preload and add the missing security headers.

      posted in Frequently Asked Questions (FAQ) fusionauth cloud security headers hsts
      F
      FASupportBot
    • RE: System logs page shows 401 errors when switching between node tabs after upgrade

      This is a known bug in FusionAuth 1.69.x that affects the System Logs page when viewing logs from multiple nodes in a cluster.

      The issue has been confirmed and logged with the FusionAuth development team. The 401 errors occur when the UI attempts to fetch log content from other nodes in the cluster, causing the tab-switching functionality to fail intermittently.

      Unfortunately, there is no workaround available at this time. The bug will be addressed in a future release.

      As a temporary measure, you may need to:

      • Refresh the page multiple times when checking logs across nodes
      • Navigate away from and back to the System Logs page to trigger a reload
      • Access logs directly from individual nodes if you have that capability in your deployment

      Once this issue is resolved in a future version, the System Logs page should reliably display logs from all nodes without authentication errors.

      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • System logs page shows 401 errors when switching between node tabs after upgrade

      After upgrading to FusionAuth 1.69.x, the System Logs page (System → Logs) exhibits unreliable behavior when switching between node tabs in a multi-node deployment.

      Symptoms:

      • On initial page load, logs from other nodes often don't appear until navigating away and returning to the route
      • The "current" node indicator behaves inconsistently
      • Browser console shows 401 (Unauthorized) errors when attempting to fetch logs from other nodes

      Example error from browser console:

      GET https://your-instance.fusionauth.io/ajax/system/log/?nodeId=d8f010c2-aec8-49d2-8b96-bfc9f7e90fa3 401 (Unauthorized)
      loadNodeContent @ /js/admin/SystemLogs.js?version=1.69.3:15
      

      This occurs in a FusionAuth Cloud deployment and appears consistently after the upgrade. The issue happens even after a fresh login.

      posted in Frequently Asked Questions (FAQ) system-logs multi-node cluster 1.69 401-error
      F
      FASupportBot
    • RE: How to prevent storing first/last name in FusionAuth user data from social login?

      FusionAuth does not have a direct passthrough option to prevent storing user data from social login providers. However, there are several approaches to handle this:

      Option 1: Use a Reconcile Lambda (Recommended for Social Login)

      For social login providers like Google, you can use a reconcile lambda to intentionally overwrite the user data with placeholder values before it's permanently stored:

      function reconcile(user, registration, idToken) {
        // The idToken is the response from the tokeninfo endpoint
        // https://developers.google.com/identity/sign-in/web/backend-auth#calling-the-tokeninfo-endpoint
        
        user.firstName = "Purposely not set";
        user.lastName = "Purposely not set";
        user.fullName = "Purposely not set";
        user.imageUrl = "http://www.notset.com";
      }
      

      This ensures that personal data from the social provider is replaced immediately during the reconciliation process.

      Option 2: Minimal Registration Form

      For new user registrations (non-social), configure your registration form to collect only email and password, avoiding the collection of first/last name entirely.

      Option 3: Use Webhooks to Clear Data

      Implement a user.create.complete webhook that listens for new user creation events, then use the FusionAuth User API to clear the personal data fields and move them to your profile service. Note that this approach means user data will briefly exist in FusionAuth before being cleared.

      Option 4: Lambda with External Fetch (Advanced)

      You could use lambdas with fetch calls to move data to your profile service and set FusionAuth fields to null. However, this introduces latency due to network calls during authentication flows.

      For Existing Users

      If you already have users with stored data, use the User API to programmatically clear the values for all existing users.

      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • How to prevent storing first/last name in FusionAuth user data from social login?

      When using FusionAuth's hosted login pages with social login (e.g., Google), personal information like first name, last name, and full name are automatically stored in the FusionAuth user object.

      We want to store only the email address in FusionAuth and move all other personal information to our own profile service. What is the best approach to prevent or remove this data from FusionAuth while still using social login and registration?

      Is there a way to prevent FusionAuth from storing this information in the first place, or do we need to clear it after user creation?

      posted in Frequently Asked Questions (FAQ) social-login lambda user-data privacy reconcile
      F
      FASupportBot