support

KUDO Help Center

Organizer

  • Getting Started with SSO

    Single Sign-On is an authentication process that allows users to sign into KUDO with their company credentials.

    KUDO SSO is based on SAML 2.0 and works with the following IDP's: Onelogin, Azure, Okta, CAS.

    Notes: 

    • Currently, our EU and COM platforms are not linked. The SSO configuration applied to one of them, would not be applied to the other server. 
    • The user role will be automatically provisioned when a user gets invited to a session. By default, the user role is a participant, unless we receive another parameter from the SAML response. 
    • KUDO acts as the Service Provider (SP) and offers automatic user provisioning. You do not need to register as a user on KUDO. Once KUDO receives a SAML response from the Identity Provider (IdP), KUDO checks if this user exists. If the user does not exist, KUDO creates a user account automatically with the received name ID, using the default role, participant, if we do not receive another role parameter from the SAML response.

    Prerequisites

    1. We will need to know:

    • Your Client Account email;
    • Your Organization name;
    • Identity Provider (IDP);

    Instructions

    2. Once we set up the Organization for you in KUDO, we will be providing you with:

    • ACS URL (Consumer URL);
    • Login URL;
    • Single Logout URL;
    • EntityID/Audience (the name of the SAML 2.0 connector, i.e kudo-sso);

    3. Identity Provider (IDP)

    • Login to your IDP, having Admin rights;
    • Add a SAML connector;
      • Add the info we've provided you at step 2.
    • Create and map the below custom parameters/fields:
      • first_name to First Name;
      • last_name to Last Name;
      • role to Role (user role we currently have 4 roles: participant, interpreter, operator, viewer);
        • by not assigning a role in IDP, KUDO will assign a participant role, by default;
        • once a user gets invited to a session with another role, it will be associated with the user account. Upon login, the user can select what role is he/she planning to use;
      • email to Email;
    • Save the configuration;
    • Download the SAML metadata and sent it to us;

    4. We will get back to you with a confirmation message. Once configured, users can sign in with SSO.

     

     

     

     

     

     

  • Customizing invite sender's email address

    You can customize the email that your attendees get there invite from. By default, the invitation sender email is our support email address. 

     

    If you would like to change that, here is how it can be done:

    1. Sign-in into your KUDO account;
    2. In the top-right drop-down menu, select My Account;
    3. Navigate to the Mailer section, situated on the left side menu;
      1. Enable the Customized Sender Email (toggle the radio button to on);
      2. Add a sender name;
      3. Add a sender email address;
      4. Click on Save;

    Note: If you would like that no emails are sent at all, you can add a dummy email address, or a non-valid one; These settings are applied at the account level, so we will use the chosen email address for all the sessions created under that account.

     

    Screenshot for reference:

    mceclip0.png

  • Streaming through HLS

    In order to find which of the streaming methods you should use (RTMP or HLS), please refer to this article.

    This article will cover:

    Enabling HLS

    Getting the HLS code  

    Starting the broadcast using HLS

    Additional notes

     

    Enabling HLS

    From your Client account, navigate to the Broadcast tab, then click on the ON toggle, next to HLS. Once this has been made, a pop-up notification will appear on the screen, informing you about the change. 

    mceclip0.png

    Getting the HLS code  

    By using HLS, what you need to do is simply paste some generated code on your website. This code can be obtained from the Information tab of your account, then click on the dropdown called 'Copy Widget Code' on the viewer section.

    The correct code for HLS Streaming is called 'Broadcasting'.

    mceclip0.png

     

    Once you have the code, this can be added to a page on your website. We suggest this to be handled by your web developer, to avoid issues with your website. 

    NOTE: Depending on how many viewers you are expecting to have, make sure that your hosting plan supports high traffic. 

    Starting the broadcast

    Once everything has been set up, and your meeting has started in KUDO, you can also start streaming:

    NOTE: If you are having a multilingual session, make sure that all the Interpretation channels are active before starting the broadcast;

    Using the Client account:

    • Navigate to the Broadcast tab;
    • Click on the 'Start Broadcast' link situated on the top right section of the page;
    • mceclip1.png

     

    As an Operator/VIP Participant:

    • Click on the broadcast icon, situated on the bottom icon list;
    • mceclip0.png

     

    Additional notes

    • The number of viewers is unlimited; (It depends on the hosting server located capacity);
    • You can have multiple languages;
    • The viewers can easily switch from one language to another;
    • There will be a delay/latency of about 15-20 seconds, from the time the streamed data reaches the viewer;
    • A broadcast can include up to 9 video streams from the session (and up to 50 audio streams). If the session includes more than 9 video streams concurrently, the extra streams will not be included in the broadcast.
    • The HLS streams stops automatically 60 seconds after the last client disconnects from the session.
    • The maximum HLS stream duration is of 4 hours;

     

     

     

  • Invite method. Configuring access to a session

    Based on your meeting requirements, KUDO allows you to preset how your meeting will be accessed by the participants.

    We currently have two options for configuring access to a session:

    NOTE: On the Event/Breakout sessions users can access the meeting only based on the invitation. The below options do not apply to this type of meeting.

    Add Users/ Invite Links

    Added Users Only

     

    Add Users/ Invite Links

    Enabling this option means that:

    • Anyone having the link to your meeting can access it, even if they have been added  or not to the meeting as a participant;
    • People that were manually added using the 'Add Participant' button, or uploaded through a CSV file will be able to access the meeting;
    • The meeting links will still be available on the information tab (for the Client account);

     

    Added Users Only

    Enabling this option will restrict access to your meeting in the following way:

    • Only people that were added using the 'Add Participant' button, or uploaded through a CSV file will be able to access the meeting;
    • They will receive an email invitation as soon as the above is done, allowing them  to access your meeting;
    • The meeting links will NOT be available on the information tab (for the Client account);

    NOTE: Enabling this way of participation to your session, will disable the possibility to have viewers.

    The above settings can be found by clicking on the 'Advanced Settings', once you have created a meeting, then navigate towards the bottom of the page.

    mceclip0.png

    Once everything has been set, click Save to apply the configuration to the created meeting.

     

  • How to share the viewer link

    Once the meeting has been created, you can go ahead and share the links to your meeting. Depending on the meeting type, on the Information tab you will be presented with the following:

    Small Meeting

    Event Meeting

    Large Meeting

     

    Small Meeting

    We provide a widget code that can be obtained from the Information tab:

    mceclip0.png

    The meeting code looks like this: 

    <div style="position:relative;"><iframe width="100%" height="80%" src="https://live.kudoway.eu/br/110214411756" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen style="min-height:750px"></iframe></div>

    This will need to be pasted on your website, and that's it. Once the meeting starts, your viewers will be able to see the meeting. 

     

    Event Meeting

    To obtain the meeting link you will need to navigate to the event name:

    1. On the Upcoming tab, click the Event that you want to access;
    2. You will be presented with all the sessions that are part of this event, click on the session name 
    3. On the Information tab, you will be able to see the viewer meeting link, which will need to be pasted on your website;mceclip0.png
    <div style="position:relative;"><iframe width="100%" height="80%" src="" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen style="min-height:750px"></iframe></div>

     

     Large Meeting

    For our Large meetings, additionally to our real-time streaming, we have the option to configure a broadcasting channel, more details here.

    Once the meeting has been created on the Information tab, you will see the following:

    mceclip0.png

    Use: 

    • Real-time streaming, if you have not configured any broadcasting channels. The viewers' number can be obtained from our calculator. This link will provide you with an iframe that needs to be pasted on your website:
    • <div style="position:relative;"><iframe width="100%" height="80%" src="https://live.kudoway.eu/k8/770216357578/live" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen style="min-height:750px"></iframe></div>
    •  Broadcasting, if you have already configured a broadcasting channel, then using this link will allow you to broadcast directly using KUDO. Same as with the other one, we will provide you with a link that looks like this 
    • <div id="kudo_wrapper" class="kudo-widget"></div>

      <script src="https://kudo-widget.s3.amazonaws.com/live/main.js"></script>

      <script>window.mid = "770216357578"</script>
    •  Smart viewer link - using this option (if activated when creating the meeting), you can share direct links to a specific language. For example, if you have created your meeting with Afrikaans, English, and Bahasa, for each language KUDO will generate a unique URL that will redirect your viewers directly to that language. For example:
    • https://live.kudoway.eu/k8/770216357578/live?language=afrikaans
      https://live.kudoway.eu/k8/770216357578/live?language=english
      https://live.kudoway.eu/k8/770216357578/live?language=bahasa%20indonesia
    • Note that these links are not for broadcasting, these are for real-time streaming, so they are subject to a limit, as you can see on our System Capacity Calculator

     

  • Live Streaming through RTMP and HLS

    Did you know that not all live video streaming is created equal? And the event that you thought you were watching “live” may actually have happened over a minute ago?

    That’s because the most popular live video streaming protocols such as HLS and RTMP, whilst often described as “real-time”, are subject to encoding, transmission, and then decoding. Each of these processes introduces a delay before the content arrives at you.

    This delay can be anything from 15 seconds up to 90 seconds – a whole minute and a half after the original event. 

     

    This article will cover:

    What are RTMP and HLS?

    RTMP and HLS stream limits and limitations

    How to enable  RTMP or HLS streaming

    When not to use RTPM or HLS 

    Stream live (not RTMP or HLS)

     

    What are RTMP and HLS?

    RTMP and HLS provide high performance of video and audio data. You can broadcast your meeting to platforms that support RTMP, such as Facebook Live, Youtube Live, or IBM Cloud Video (currently supported through KUDO). For platforms that do not support RTMP, you can use HLS (HTTP Live Stream)

     

    RTMP and HLS stream limits and limitations

    RTMP streams are limited by the number of viewers supported by the RTMP provider Facebook Live, Youtube Live, or IBM Cloud Video);

    Limitations:

    • Facebook Live - Facebook supports only one language per stream. You can set up to three streams/session;
    • Youtube Live - Youtube supports only one language per stream. You can set up to three streams/session;  
    • IBM Ustream - IBM supports multiple languages per stream (up to 5);
    • If you stream a foreign language, and the Interpreter stops interpreting, through RTMP we cannot automatically change the stream to the language spoken on Floor, as it happens on KUDO; (This means that if we stream a meeting in a specific language on YouTube using RTMP, when the interpreter stops publishing in that channel, the user watching the stream doesn't get the floor audio);

    NOTE: All the configured language channels should be active/broadcasting before the stream is started;

    HLS streams support an unlimited number of viewers.

     

    How to enable RTMP or HLS streaming

    RTMP streaming is available only for Large meetings. In order to enable it, after creating a large meeting, you should see a Broadcast tab as on the screenshot below:

    mceclip0.png

    Once you have enabled RTMP and set the broadcast duration, you can add the RTMP stream by clicking on the + Add RTMP Stream button.

    The next steps are important, but not difficult:

    1. Select the Casting Medium (Facebook Live, Youtube Live, or IBM Cloud Video;
    2. Select the Server URL and Server Key. Here is how to obtain it on Youtube;
    3. Select the desired channel you want to stream (Floor, or an interpreted language);
    4. Select to code for that language; Find here the supported languages with their codes.
    5. Once done, click on Save and your RTMP stream will be added in KUDO. You can add up to three streams 
    6. Note that you will need to start the broadcast from the same page once you are ready, or directly from the session:mceclip1.png mceclip0.png
    7. Once done, you will be able to see next to the added stream, this messagemceclip2.png

    NOTE:

    • For IBM Cloud Video streaming you can find here a list of language codes for each language';
    • The streaming can be started only by VIP Participants, Operators or Organizer;

     

    When not to use RTMP or HLS 

    • Using RTMP or HLS will allow anyone to access your meeting as a viewer. If you would like your participants to interact in real-time, then you will need to invite them as Participants to your session.
    • RTMP and HLS are available only for Large meetings if you would like to stream to your users not using a Large meeting, then we suggest the other alternative, as detailed below.

     

    Stream live (not RTMP or HLS)

    KUDO offers you the ability to stream on Small and Event type meetings as well. In order to use this feature, after you have created the meeting, you can share the viewer link from the meeting Information tab. Do take into consideration the number of viewers that you can have, using the attached calculator.

    On the Large event mode, we use HLS for broadcasting and Live streaming. Using HLS would enable you to reach a larger audience with a small delay. The number of viewers that you can have for Live Streaming can be calculated using the above calculator link.

    mceclip1.png

     

     

     

     

See all 8 articles