Setting up SSO as your login method

Setting up SSO as your login method allows users to access multiple applications with one set of login credentials. Here’s how you can set it up.

Understanding SSO with RumbleTalk

SSO integration with RumbleTalk allows users to log in to chat rooms using their existing credentials from your main platform. This enhances the user experience by eliminating the need for multiple logins and simplifies user management.

Before setting up SSO, ensure you have the following:

• An active RumbleTalk account.
• User authentication information from your primary application.

SSO Setup Steps

Single Sign-On (SSO) simplifies user authentication by allowing users to access the chat with a single set of credentials. This guide provides a step-by-step process to configure SSO for RumbleTalk chat rooms, highlighting the importance of enabling “Allow guest logins” to accommodate all users.

Before setting up SSO for RumbleTalk, ensure you have the following:

1. RumbleTalk Account: An active RumbleTalk account with admin privileges.
2. SSO Provider: A configured custom SSO solution (your user base for example).
3. Access to SSO access: make sure you have the ability to get information from your database, cms or users info.

Configuring RumbleTalk SSO

1. Log into the RumbleTalk Admin Panel:
   • Access the Admin Panel by logging into your RumbleTalk account.
2. Navigate to the Settings:
   • Once in the Admin Panel, go to the “Chat Settings” tab.
   • Select “General & Logins” and then choose “Login Options” from the menu.
3. Enable SSO:
   • In “Login Options”, find the “Guests” and “User authentication required” options and enable them by toggling the switch. (yes guest is indeed needed, but it is only the name, no guest will be able to log in)
4. Add User Information for SSO:
   • Add YOUR_CHAT_HASH (8-characters code representing your chat) and USERNAME (username of the user).
   • Optional information:
     • PASSWORD – The predefined password.
     • IMAGE – An image URL to be used as the user avatar
     • FORCE_LOGIN – When set to true, will first log out the currently logged-in user, and then execute the login command. This only affects the user of the browser that executed the command.
     • CALLBACK_FUNCTION – A callback function that will be called (with the result as the first parameter) when the login process is done.
5. Add the following code on your website, along with the regular chat code (as seen in Step 3 here):

// in the header
<script>
(function(g, v, w, d, s, a, b) {
    w['rumbleTalkMessageQueueName'] = g;
    w[g] = w[g] ||
    function() {
    (w[g].q = w[g].q || []).push(arguments)
    };
    a = d.createElement(s);
    b = d.getElementsByTagName(s)[0];
    a.async = 1;
    a.src = 'https://d1pfint8izqszg.cloudfront.net/api/' + v + '/sdk.js';
    b.parentNode.insertBefore(a, b);
})('rtmq', 'v1.1.0', window, document, 'script');
</script>

// populate this with the info you have.
<script>
rtmq(
    'login',
    {
        hash: 'YOUR_CHAT_HASH',
        username: 'USERNAME',
        password: 'PASSWORD', // [optional]
        image: 'IMAGE', // [optional]
        forceLogin: 'FORCE_LOGIN', // [optional]
        callback: 'CALLBACK_FUNCTION' // [optional]
    }
);
</script>

Verification and Troubleshooting

• Test SSO Access: Verify that users can log in through the SSO provider seamlessly.
• Test Guest Access: Confirm that guests can join the chat without needing to authenticate through SSO.
• Monitor User Feedback: Pay attention to any issues reported by users. If problems arise, revisit the SSO configuration and ensure all details are correctly entered.

Common Issues and Solutions

• Incorrect Credentials: Double-check the SSO credentials. Ensure they match the details provided by your SSO provider.
• SSO Login Not Working: Verify that the “Allow guest logins” option is enabled and properly saved.

Conclusion

With SSO as your login method, it enhances user experience by providing a unified login process. By following these steps, you can integrate SSO smoothly, ensuring secure and efficient access to your chat rooms.