On Journey by Forj, single sign-on (SSO) can be configured with re:Members, an association management system (AMS) platform. re:Members provides authentication for end users, allowing members to sign into Journey by Forj using their re:Members credentials. Once SSO is configured appropriately in a Journey by Forj Community, users are able to link from the Community sign-in page to the re:Members login page to authenticate access to the Community. After successful authentication in re:Members, the session is redirected back to the Community and the user is logged in automatically without re-entering any credentials in the Community.

Journey by Forj integrates with re:Members to provide seamless authentication with additional field mapping capabilities to synchronize user profile information and membership tiers from re:Members into Journey by Forj.

Table of Contents

Obtain re:Members App Credentials

Setup re:Members Authentication in Journey by Forj

Map Profile Fields

Map Membership Tiers

Committee Sync

OBTAIN RE:MEMBERS APP CREDENTIALS

Before the re:Members SSO can be configured in Journey by Forj, you must obtain the necessary credentials from re:Members. Contact your re:Members administrator or re:Members support to request the following information:

• Forj Community App ID - The application identifier for the Journey by Forj integration
• Forj Community App Password - The application password/secret for authentication
• Forj Community App User Email - The service account email used for API access
• Forj Community App User Password - The service account password for API access

SETUP RE:MEMBERS AUTHENTICATION IN FORJ

SSO connections are configured on the Authentication page available from the Community Settings accessible by the designated Account Owner. 

Follow the steps below to setup re:Members authentication. 

• Click the Community menu.
• Select Community settings.

• Select Authentication.
• Enable Single Sign-on Toggle to the right.

• Select and Expand the re:Members Configuration.
• From the dropdown under re:Members Configuration, select the Group that users should be automatically added to when connecting for the first time via SSO.
• In the Button Label Text field, enter the desired text for the Login Button that will appear on the Community Sign in page (e.g., "remembers").
• Enter the credentials obtained from re:Members:

1. Forj Community App ID
2. Forj Community App Password
3. Forj Community App User Email
4. Forj Community App User Password

MAP PROFILE FIELDS

On top of authenticating users into Journey by Forj, SSO can pre-fill desired Profile information based on information associated with the User in re:Members. The Fields Mapping section allows you to map user attributes from re:Members to Journey by Forj user profile fields.

1. Click the Add Mapping button under Fields Mapping.
2. Select the Journey by Forj profile field you want to populate from the dropdown.
3. Enter the exact name of the corresponding field in re:Members that contains the data.
4. Repeat steps 1-3 for each field you want to map.

Note: If there are defined Registration fields that aren't mapped through SSO, users will be presented with the Registration form after SSO on first access to Journey by Forj.

Note: If unsure of the available fields for mapping from re:Members, reach out to Forj Support for assistance. The available fields are logged in the background.

MAP MEMBERSHIP TIERS

Journey by Forj can automatically assign users to membership tiers based on membership information from re:Members. The Membership Tier Mapping section allows you to define rules that place users into the appropriate tier based on fields from re:Members.

1. Select the default membership tier from the dropdown. This tier will be assigned to users if no specific tier mapping matches.
2. Click the Add Mapping button under Membership Tier Mapping.
3. Configure the mapping rule by specifying which re:Members field values should map to which Journey by Forj membership tier.
4. Repeat steps 2-3 for each tier mapping you need to configure.

Note: Save changes to commit all configuration updates and enable SSO into the Community through re:Members.

Note: After saving, users will see a button with your specified label text on the Journey by Forj sign-in page that redirects them to re:Members for authentication.

COMMITTEE SYNC

Journey by Forj supports automatic synchronization of Committee memberships from re:Members at member sign-on. When enabled, this feature allows you to automatically add users to specific Journey by Forj Groups based on their Committee assignments in re:Members. This ensures that group membership in Journey by Forj stay in sync with Committee participation tracked in your AMS.

For detailed information about configuring Committee to Group Sync with re:Members, please see the support article: New ReMembers SSO Committee Sync