Skip to main content

Hub Invitation Troubleshooting

Understanding LWS and Hub Invitation Issues in Salesforce

Overview:
This article explains the role of Lightning Web Security (LWS) in resolving hub invitation issues and provides insights into why emails might not be received when inviting users via the hub.

Issue: Hub Invitations Not Working​

Symptoms​

  • Customers report that hub invitations are not being received.
  • Copying the invitation link does not work.

Solution: Enable Lightning Web Security (LWS)​

  • Enabling LWS has resolved similar issues for other customers in the past.
  • LWS specifically impacts the ability to copy the invitation link. Without LWS enabled, this functionality does not work correctly.
  • However, LWS does not directly influence the email invitation being sent.

Issue: Invitation Emails Not Being Received​

Possible Causes​

  1. Email Deliverability Issues (DKIM/SPF)

    • If the customer does not receive any notifications, it is likely due to email authentication issues (DKIM/SPF).

  2. Permission Issues

    • If the customer receives other notifications but not the hub invitation, it may be a permission problem.
    • Hub invitations are sent using the current user's permissions.
    • However, if the "Reset Password" option from the hub is used, it is executed under the integration user context.

Next Steps for Troubleshooting​

  1. Ensure LWS is enabled to allow copying the invitation link.
  2. Verify DKIM/SPF settings to rule out email authentication issues.
  3. Check user permissions if invitations are not being sent but other notifications are received.
  4. Try using "Reset Password" from the hub, which operates under the integration user context and may work if permission issues exist.

For further assistance, reach out to the support team.

Troubleshooting Employee Hub Login Issues​

If employees are unable to log in to the Employee Hub or mobile app, work through the following checklist:

  1. Try using Chrome: Test logging in with the Google Chrome browser to rule out browser-specific issues.
  2. Check browser settings: Ensure cookies and JavaScript are enabled, and try clearing the browser cache.
  3. Verify Integration User permissions: Confirm that the Integration User has the correct permissions and is active.
  4. Enable SSO: If your organization uses Single Sign-On, verify that SSO is properly configured for the employee.
  5. Check email case sensitivity: The email address used to log in must match the email in the employee record exactly, including case.
  6. Resend the invitation link: Try resending the hub invitation from the employee's record in Salesforce.
  7. Check that the Salesforce user is active: Ensure the underlying Salesforce user account has not been deactivated.

If the password reset link is missing from the flair email notification, this typically occurs when SSO is enabled for your organization. When SSO is active, employees authenticate through your identity provider rather than using a flair password.

To resolve this:

  • Ensure SSO is properly enabled and configured for the employee.
  • Direct employees to log in via your organization's SSO portal.
  • If SSO is not intended, check the SSO settings in the flair HR app and disable it for the affected employees.

SSO Not Working​

If SSO suddenly stops working and employees are prompted for a password they don't have, the most common cause is that employees are using the wrong login URL.

Employees must use the company-specific domain URL to log in with SSO:

  • Correct: https://yourcompany.hub.flair.hr/login
  • Incorrect: https://hub.flair.hr/

The generic hub.flair.hr URL does not support SSO authentication. Ensure all employees are using the company-specific URL, which can be found in HR Admin > General > Settings > Domain.