Additional configuration for cartridges

This page explains the additional configuration needed from the ReachFive side that you need to complete for the SalesForce ReachFive cartridge.

Activate the SSO feature

You need to activate the SSO feature on your ReachFive Console to ensure ReachFive properly manages the end user cookie session.

This is not applicable if you are only using the Social Login cartridge mode.

  1. In the ReachFive Console, go to Security  SSO.

  2. Set the Session lifetime in days (default is 3 days).

  3. Set the Require log in after in days (maximum value is 365 days in compliance with the GDPR).

  4. If desired, specify the Allowed logout callback URLs.

    This is optional. If URLs are specified here, the user will only be redirected to these whitelisted URLs. See the logout page for more details.

  5. Don’t forget to Save your input.

The setting is active immediately to all clients within the ReachFive account.

Session duration is renewed with the next /oauth/authorize operation or the equivalent SDK method, for instance checkSession or loginFromSession. If the cookie session lifetime expands beyond the Require login after parameter period, then the user will be forced to re-authenticate.

Configure webhook

With user-event webhooks, you can register specific URLs to be called on specific user actions or events. For cartridge setup and integration, we recommend post-event webhooks.

Post-event webhooks trigger after the event has been processed. Post-event webhooks are asynchronous: the API returns a response and the user can continue browsing your application without waiting for an answer from the URL.

  1. Go to your ReachFive Console.

  2. Go to Settings  Webhooks  Post-event webhooks.

  3. Click New post-event webhook.

  4. Follow the instructions to create or edit a webhook on the User-event webhooks page and ensure the following values are added where noted and Don’t forget to Save your input..

    Field Value

    Enabled

    Yes

    Key

    webhook_name

    Where webhook_name is your desired webhook name.

    Event types

    user_update

    Filter

    optional

    URL

    https://<your-sandboxId>.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site/en_US/ReachFiveController-UserUpdate

    Fields

    • user.phoneNumberVerified

    • user.name

    • user.phoneNumber

    • user.emailVerified

    • user.email

    • user.username

    • user.familyName

    • user.age

    • user.birthdate

    • user.id

    • user.emails

    • user.givenName

    • user.gender

    • user.customIdentifier

    • user.nickname

    Timeout

    5

    HTTP Authorization value

    optional

The cartridge requires one standalone consent with the key of newsletter.

To do this, follow the instructions at Consents.