Skip to main content

RentalEngine integration

If your community also uses RentalEngine, you can let members sign in there with their Somiti account. You connect the two once. After that, members click Login with Somiti on RentalEngine and don’t need a separate RentalEngine password.

Admins and managers can connect it. Admins find it under Settings, Integrations tab, then Partner SSO. The Integrations tab only shows for admins, so a manager opens it by adding /sso/rental-engine to the end of your community’s Somiti address.

Connect to RentalEngine

You need to be an admin or manager in Somiti and in your RentalEngine community, and you need to know your RentalEngine address (for example myclub.rentalengine.net).

The Connect to RentalEngine form: a field for the RentalEngine subdomain ending in .rentalengine.net, a blue box explaining you'll be sent to RentalEngine to confirm, and a Connect to RentalEngine button.
  1. The first part of your RentalEngine address, before .rentalengine.net.
  2. Takes you to RentalEngine to confirm.
  1. Go to Settings, click the Integrations tab, then Partner SSO.
  2. Type your RentalEngine subdomain: the part before .rentalengine.net. For myclub.rentalengine.net, type myclub. Use lowercase letters, numbers and dashes only.
  3. Click Connect to RentalEngine →.
  4. Somiti sends you to your RentalEngine community. Sign in there if you need to, and confirm the connection.
  5. RentalEngine sends you back to Somiti.

You’ll see “Successfully connected to RentalEngine!” and the page changes to show the connection.

You have 10 minutes between clicking Connect to RentalEngine → and confirming on RentalEngine. If you take longer, you’ll come back to Somiti with “Connection failed:” at the top; start again from step 1.

Check the connection

Once you’re connected, Partner SSO shows the connection’s details:

The RentalEngine connection card with a green check and Connected, the linked RentalEngine address, when it was connected and by whom, how many times members have signed in through it, when it was last used, and a Disconnect button.
  1. The RentalEngine community you're connected to.
  2. How many times members have signed in to RentalEngine with Somiti.
  3. Stops Login with Somiti working.

Your community can only be connected to one RentalEngine community at a time.

How members sign in

When a member clicks Login with Somiti on RentalEngine:

  1. RentalEngine sends them to your community’s Somiti sign-in page. If they’re already signed in to Somiti, they skip it.
  2. Somiti shows a Sign in to RentalEngine screen with their name, email and picture, and says RentalEngine will receive their name and email address.
  3. They click Continue to RentalEngine, and they’re back on RentalEngine, signed in.

If they click Cancel, nothing is shared with RentalEngine.

Anyone who can sign in to your community in Somiti can use Login with Somiti, whatever their role and whether or not their membership is current. RentalEngine matches them to its own accounts by email address. Each sign-in adds one to Logins via SSO.

Disconnect from RentalEngine

  1. Go to Partner SSO.
  2. Click Disconnect.
  3. Click OK when asked to confirm.

You’ll see “Disconnected from RentalEngine.” From then on, Login with Somiti on RentalEngine shows members an error. To connect again, or to connect a different RentalEngine community, go through Connect to RentalEngine again.

Troubleshooting

“Already connected to RentalEngine.”
You can only have one connection. Click Disconnect first, then connect to the new community.

“Connection failed: community mismatch.”
RentalEngine sent you back to a different Somiti community from the one you started in. Start again from the community you want to connect, and make sure you’re signed in to the right one.

“Connection failed:” with something about the token.
The 10 minutes ran out, or the link was changed on the way. Start again.

A member sees “Unable to Complete Sign-in”.

  • “This login link has expired” means they took more than a few minutes. Ask them to go back to RentalEngine and click Login with Somiti again.
  • “This community is not connected to the requesting RentalEngine community” means the connection was removed or points to a different RentalEngine community. Check Partner SSO.

A member can’t sign in to Somiti at all.
They need an account in your community first. See Members to add them, or Profile if they’ve forgotten their password.

  • Integrations for Slack and Mailchimp
  • Members for adding people to your community
  • Settings for the rest of your community’s settings