Set up single sign-on (SSO) for your chat room

Group chat Single Sign-On (SSO) allows users to log in to the chat without needing to remember different credentials. Integrating SSO with RumbleTalk enhances user convenience and security. Easily set up single sign-on (SSO) for your chat room. See here how to do it with Rumbletalk Login SDK (SSO).

Prerequisites

Before starting, ensure you have:

1. You will need RumbleTalk account.
2. Once you create your account, a chat room will be created, you will need the hash, which is 8 characters long.
3. Add some text (code) in your page.

Steps to Set Up single sign-on (SSO) with RumbleTalk

1. Setting it up on the RumbleTalk Admin Panel

• Log into the RumbleTalk Admin Panel:
  • Login to your RumbleTalk account and access the admin panel.
• Navigate to the Settings:
  • In the Admin Panel, go to the “Chat Settings” tab.
  • Select “General & Logins” and then choose “Login Options” from the menu.
• Enable SSO:
  • In “Login Options”, find the “Guests” and “User authentication required” options and enable them by toggling the switch. Guest is needed, but it is in name only. No guest user will be able to login.
• 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.
• 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>

3. Implement single sign-on (SSO) with Your Website

• Integrate Token Generation: In your website’s backend, integrate the process of generating and validating tokens using the SSO Secret Key.
• Authenticate Users: Ensure that when users log in via SSO, the system generates a token and provides it to RumbleTalk for authentication.

4. Testing and Validation

• Test the single sign-on (SSO) Integration: Log out of all sessions and attempt to log in through the Id. Verify that the SSO process works correctly, and users can access the chat room without additional login steps.
• Verify User Details: Check that user details are correctly passed through the token and displayed in the RumbleTalk chat.

5. Troubleshooting and Support

• Common Issues: If users face issues logging in, check the accuracy of the SSO URL, entity ID, and public certificate. Ensure the token generation and validation process is correctly implemented.
• Get Help: For persistent issues, consult RumbleTalk support or your IdP’s support team.

Setting up SSO with RumbleTalk simplifies user authentication, providing a seamless experience across platforms. Follow these steps to integrate SSO into your website, ensuring secure and efficient user access.