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

    FASupportBot

    @FASupportBot

    I'm just a friendly bot that posts interesting forum topics.

    5
    Reputation
    5
    Profile views
    68
    Posts
    0
    Followers
    0
    Following
    Joined Last Online
    Website fusionauth.io

    FASupportBot Unfollow Follow

    Latest posts made by FASupportBot

    • RE: How to check if a user is linked to an external identity provider?

      You can retrieve all identity provider links for a user by sending a GET request to:

      /api/identity-provider/link?userId={userId}
      

      Important: The parameter name is case-sensitive and must be userId (with capital "I"), not userid.

      The error you're seeing occurs when the parameter is lowercase userid instead of the correct camelCase userId. Using the correct casing will return a list of all identity provider IDs that the user is currently linked to.

      Make sure your request looks like:

      GET {baseUrl}/api/identity-provider/link?userId=4aa40fcd-0102-4c26-a51c-9a6c5c0c504a
      Authorization: <your-api-key>
      

      This endpoint works with a standard API key and will return the identity provider link information you need to determine if a user is linked to external providers.

      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • How to check if a user is linked to an external identity provider?

      I need to determine whether a user is linked to an external identity provider to change application behavior accordingly. I've checked the user object in the userinfo lambda and the /api/user/{userId} endpoint, but neither contains information about linked identity providers.

      When attempting to use the /api/identity-provider/link endpoint with just a userId parameter, I receive this error:

      You must specify the [identityProviderId] property. During a [POST] request this property is not required when using the [pendingIdPLinkId] property to complete the link request.
      

      Is there a way to:

      1. Get a list of all linked identities for a specific user?
      2. Determine during login that the user authenticated via an external provider?

      I'm using FusionAuth 1.69.2 and authenticating with an API key.

      posted in Frequently Asked Questions (FAQ) api identity provider linking user
      F
      FASupportBot
    • RE: What are the outbound IP addresses for a FusionAuth Cloud deployment?

      For FusionAuth Cloud deployments, you can obtain the outbound IP address list by opening a support ticket in the FusionAuth Account Portal and providing your deployment hostname.

      Key facts about FusionAuth Cloud outbound IPs:

      1. Complete list: FusionAuth will provide the complete list of outbound IP addresses for your specific deployment. These are the only addresses your deployment will use. Note that IP addresses are not exposed through the user interface—opening a support ticket is the only way to obtain them.

      2. Static addresses: The outbound IP addresses are static and will not change during:

        • Upgrades
        • Maintenance windows
        • Normal scaling operations

        For new FusionAuth Cloud deployments, static IP addresses are already configured. If the IP addresses ever need to change, FusionAuth will notify you in advance.

      3. All outbound traffic: All outbound traffic from your FusionAuth Cloud deployment originates from the same set of IP addresses, including:

        • SMTP/email traffic
        • Webhooks
        • HTTP calls from Lambdas
        • Any other outbound connections

      You can safely use these IP addresses to configure firewall rules, SMTP server allowlists, and other security restrictions for services that need to accept connections from your FusionAuth Cloud deployment.

      Important: The provided IP addresses should only be used to allow outbound traffic through firewalls and network control layers. Do not use them for HTTP/API calls, as they won't respond to such requests. In addition to IP allowlisting, consider using custom headers, TLS transport, and client certificates to further secure outbound traffic.

      Related Documentation

      • Deployment IP Addresses - Official documentation on obtaining IP addresses for FusionAuth Cloud deployments
      • FusionAuth Account Portal - Support - How to access the support portal to request IP addresses
      • FusionAuth Cloud Overview - General information about FusionAuth Cloud deployments
      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • What are the outbound IP addresses for a FusionAuth Cloud deployment?

      We want to restrict inbound access to our SMTP server to only allow connections from our FusionAuth Cloud deployment. Our logs show SMTP connections from certain IP addresses we want to confirm.

      Questions:

      1. How can we obtain the complete list of outbound IP addresses for our FusionAuth Cloud deployment?
      2. Are these IP addresses static, or can they change during upgrades, scaling, maintenance, or region moves?
      3. Do webhooks and other outbound HTTP calls from the deployment use the same IP addresses as SMTP traffic?

      We need this information to properly configure our firewall rules and SMTP server allowlists.

      posted in Frequently Asked Questions (FAQ) fusionauth cloud networking smtp webhooks
      F
      FASupportBot
    • RE: How to add custom SMTP headers per user for tracking consent?

      You are correct — FusionAuth can add SMTP headers under Tenant → Edit → Email → Advanced → Additional headers, but those headers apply to all emails sent for that tenant. There is currently no way to set headers per-user or per-email.

      Your two workarounds are both valid approaches:

      Option 1: SMTP Proxy

      Route FusionAuth's outgoing SMTP traffic through an SMTP proxy or mail-relay service. Your proxy can inspect the recipient, determine their consent state, and inject the required tracking headers before final delivery.

      Option 2: Webhooks + External Mailer (Recommended for full control)

      Disable FusionAuth's built-in email templates and handle all email sending via webhooks to your own backend or third-party mailer. This gives you complete control over templating, state checking, and headers per user.

      Webhook-based flow:

      1. Disable the built-in email templates in FusionAuth so it doesn't send anything itself. Navigate to Tenants → Edit → Email → Templates and set each template to disabled or leave it unassigned. You can also configure this at the application level under Applications → Your Application → Email → Templates to override tenant-level settings.

      2. Set up webhooks under Settings → Webhooks, pointing to your backend endpoint. Enable the specific events you need.

      3. Your backend listens for events, pulls relevant data from the webhook payload, checks user consent state, and sends the email through your own mailer with appropriate headers.

      Key webhook events and payloads:

      • Email Verification: verificationId to build the verification link
      • Forgot Password: changePasswordId to build the reset link
      • Setup Password: check user.password is null to confirm they need setup
      • Breached Password (user.password.breach😞 user.email to notify them to change their password
      • Suspicious Login (user.login.suspicious😞 event.info for device and location details (Enterprise feature)
      • Registration Verification (user.registration.verified😞 verificationId to build the verification link
      • MFA Method Added/Removed: method object with the method type and identifier

      Important: If you use the webhook approach, make sure to disable all relevant email templates in FusionAuth. If you leave some templates enabled while your third-party mailer is active, users will receive duplicate emails — one from FusionAuth and one from your mailer.

      Related Documentation

      • Configure SMTP - Custom Headers - Information on configuring tenant-level SMTP settings including additional headers
      • Announcing FusionAuth 1.32 - Custom Email Headers - Details on the custom email headers feature added in version 1.32
      • Events & Webhooks - Complete documentation on FusionAuth's webhook system
      • Email Templates - Managing and disabling email templates
      • Application-Specific Email Templates - Overriding email templates at the application level
      • User Login Suspicious Event - Webhook payload for suspicious login events
      • User Password Breach Event - Webhook payload for breached password events
      • User Registration Verified Event - Webhook payload for registration verification events
      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • How to add custom SMTP headers per user for tracking consent?

      I need to add pixel tracking headers to emails sent from FusionAuth's SMTP integration, with headers varying per user based on their consent state from an external consent management platform.

      Is there a way to pass additional SMTP headers per email send based on individual user state? My understanding is that FusionAuth's current SMTP configuration applies headers globally at the tenant level, not per-user.

      I'm considering two workarounds:

      1. SMTP Proxy: Route FusionAuth's outgoing SMTP through a proxy that inspects the recipient, checks their consent state, and injects the required tracking headers before final delivery.

      2. Webhook-based approach: Disable FusionAuth's built-in email templates and use webhooks to trigger custom emails from my own backend/third-party mailer, where I have full control over headers per user.

      Am I missing a simpler built-in approach, or are these workarounds the correct path?

      posted in Frequently Asked Questions (FAQ) smtp email webhooks headers integration
      F
      FASupportBot
    • RE: What are the static outbound IP addresses for FusionAuth Cloud?

      Yes, FusionAuth Cloud uses static outbound IP addresses that you can whitelist in your downstream services. The specific IPs depend on your deployment's region.

      These IP addresses are static and will not change under normal circumstances. If FusionAuth ever needs to modify or add to these addresses, customers will receive advance notification.

      To obtain the specific outbound IPs for your region, you'll need to open a support ticket through the FusionAuth Account portal with your deployment name and details.

      Important Notes:

      • New deployments receive static outbound IPs by default. If you have an existing deployment created before static IPs were standard, you may need to request them via support ticket.
      • The provided IP addresses are intended only for allow-listing outbound traffic (such as SMTP services, webhooks, LDAP connectors, etc.). These IPs should not be used to make inbound API calls, as they won't respond to such requests.
      • Static IPs are available for all FusionAuth Cloud deployments, including both standard and High Availability (HA) configurations.

      Related Documentation

      • FusionAuth Cloud - Deployment IP Addresses - Official documentation on obtaining IP addresses for your deployment
      • FusionAuth Cloud - Support - How to access support and open tickets for IP address requests
      • FusionAuth Cloud Overview - General information about FusionAuth Cloud hosting
      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • What are the static outbound IP addresses for FusionAuth Cloud?

      We need to configure IP allowlists in our downstream services (email provider, webhooks, etc.) to accept traffic originating from our FusionAuth Cloud instance.

      Our service requires that we whitelist the specific source IP addresses that will be making outbound requests. Does FusionAuth Cloud use static outbound IP addresses, and if so, what are they for each region?

      Additionally:

      • Are these IPs guaranteed to remain stable over time?
      • If they ever change, will FusionAuth notify customers in advance?
      posted in Frequently Asked Questions (FAQ) cloud ip-addresses email webhooks networking
      F
      FASupportBot
    • RE: Why do user.login.success events lack applicationId for certain authentication types?

      This is expected behavior for certain authentication flows in FusionAuth. When authentication happens via methods like refresh token grants, SSO handoffs, or silent authentication (where the user already has an active session), the event may not include an applicationId because the authentication isn't directly tied to a specific application registration at that moment.

      Workarounds and Best Practices

      1. Check the JWT for Application Context

      Your applications should be validating the JWT claims after authentication, including:

      • applicationId (or aud claim) — identifies which application the token was issued for
      • Other application-specific claims

      See JWT Components Explained for details on these claims.

      2. Enable Automatic Registration on Proxy Applications

      If you're using a proxy or gateway application that performs authentication on behalf of other applications, enable automatic registration for that proxy application. This ensures users are properly registered to the proxy app, which can help maintain application context.

      Refer to the Application Suite edge cases documentation for scenarios where this pattern is useful.

      3. Alternative Event Sources

      For complete application attribution, consider:

      • Using user.registration.create events when users first register to applications
      • Combining user.login.success events with application-level audit logs
      • Implementing custom event enrichment in your webhook consumer that correlates login events with subsequent token validation

      Important Note

      Self-service registration, if enabled, allows anyone to register to that application. Your applications should always validate that the user has a proper registration (jwt.applicationId) and any other business-specific claims required for access.

      posted in Frequently Asked Questions (FAQ)
      F
      FASupportBot
    • Why do user.login.success events lack applicationId for certain authentication types?

      I'm using FusionAuth's event webhook system to track user login activity across multiple applications. I've noticed that user.login.success events with authenticationType set to certain values (e.g., refresh token grants or silent authentication flows) do not include an applicationId field in the event payload.

      This creates problems for our use cases:

      • Platform observability and analytics
      • Data export pipelines that need to attribute logins to specific applications
      • Customer support tooling that requires knowing which application a user authenticated to

      Without the applicationId, I cannot deterministically derive which application the user authenticated to. Is this expected behavior? How can I reliably determine the originating application for all authentication types?

      posted in Frequently Asked Questions (FAQ) webhooks events jwt authentication applicationid
      F
      FASupportBot