Authentication

2600Hz Authentication

The KAZOO Authentication app enables administrators to configure a secure Multi-Factor Authentication login service and to audit its activity. Currently we support Duo’s 2-factor login service; additional services may be available in future updates. The audit log helps developers monitor both login and API connection activity as a way to troubleshoot unexpected events

Links

> đź’ˇ NOTE: This documentation refers to the Monster UI implementation


Before you Start

  • Set up your Duo account at www.duo.com. It is free!
  • Set up your Duo credentials in the Duo application in KAZOO.
  • Download the Duo Mobile application to any devices you wish to use the option to “enter a code” for security.

Quick Steps

  1. Open the Authentication app in KAZOO. If it isn’t visible, enable it in the App Exchange.
  2. The User Authentication tab should be open; if not click it at the top left of the screen.
  3. Under settings, set Authentication to On.
  4. Turn on any successful / failure log settings you want to track.
  5. Under Multi-Factor Authentication, disable “Inherit Parent Settings” using the toggle.
  6. Pick “Choose Multi-Factor Configuration” and select a Duo Project name as the provider.NOTE: If no configurations are available or the correct Duo configuration is not showing as an option, you will need to check your settings in the Duo app.
  7. Slide the MFA Enabled button to on.
  8. Choose if you want to provide 2-factor for sub-accounts.
  9. Save your Settings.NOTE: Developers may consider additional settings for their custom applications, including setting a shorter expiration window for live API keys and for troubleshooting.

2600Hz Quick Start GUIDE –authentication examples

Authentication Login

This is what the login screen might look like when Authentication is enabled using Duo.

Three methods of Authentication as implemented with DUO

There are three different actions you can request to authenticate your login:

  1. _Respond to a push notification_This is an SMS text message sent directly to your mobile phone number.
  2. _Enter a 6 digit code provided in the Duo Mobile app on your device._If you have Duo Mobile on your device already, the code will be sent to the application.
  3. _Receive a phone call with the 6-digit code_Push Notification 6 digit code

Frequently Asked Questions

What is the Authentication app?

The KAZOO Authentication app provides added security and audit control for administrators. Its settings enable Multi-Factor Authentication services for user logins and activate audit activity for both logins and API key calls within KAZOO. Currently we support Duo’s 2-factor login service; additional services may be available in future updates. The audit log helps developers monitor both login and API connection activity as a way to troubleshoot unexpected events.

What Authentication Services do you support?

In the current release, the Authentication app supports only the Duo Two-Factor Authentication service. We will be adding other services (such as Google) in future releases.

Do I need to install this app before I activate Duo?

This application provides the settings to enable Duo. You will need to install both Authentication and the Duo app to activate the supported 2-Factor Authentication.

Can I have more than one Authentication service loaded under this app?

Yes, you can load more than one service within a single instance of the Authentication app, however only one service can be used at a time for each active sub-account.

Could I use my own OAUTH/SSO server for Kazoo authentication and authorization?

Yes, you can use your own server for the Authentication and Authorization.