Enable username/password authentication for RTMP/RTSP publishing to Wowza Streaming Engine

By default, Wowza Streaming Engine™ media server software authenticates RTMP and RTSP source (encoder) connections to applications. This article describes how to manage username/password authentication when publishing a stream from RTMP/RTSP-based encoders to Wowza Streaming Engine applications.

Contents


Configure authentication for RTMP sources
Configure authentication for RTSP sources
Configure per-application authentication using properties More resources

Configure authentication for RTMP sources


  1. In Wowza Streaming Engine Manager, click the Server menu.
  2. In the Server contents panel, click Source Authentication, and then click Add Source.


     
  3. Add Source User Name and Password information, and then click Add. The sourcename and password values are case-sensitive and can only contain alphanumeric, period (.), underscore (_), and hyphen (-) characters.



    By default, the source credentials are stored in [install-dir]/conf/publish.password.
     
  4. In the live application contents panel, click Source Security, and then click Edit.


     
  5. In the Source Security page, under RTMP Sources, select the Require password authentication option, and then click Save.

     

Configure authentication for RTSP sources


  1. In Wowza Streaming Engine Manager, click the Server menu.
  2. In the Server contents panel, click Source Authentication, and then click Add Source.


 

  1. Add Source User Name and Password information, and then click Add. The source name and password values are case-sensitive and can only contain alphanumeric, period (.), underscore (_), and hyphen (-) characters.



    By default, the source credentials are stored in [install-dir]/conf/publish.password.
     
  2. In the live application contents panel, click Source Security, and then click Edit.


     
  3. In the Source Security page, under RTSP Sources, select the Require password authentication option, and then click Save.

     

Configure per-application authentication using properties


By default, Wowza Streaming Engine uses the [install-dir]/conf/publish.password file for authenticating all source connections to all live applications on the server. This file is written to by Wowza Streaming Engine Manager when you use the Server > Source Authentication page to add or edit source credentials.

To set up per-application source authentication, copy the [install-dir]/conf/publish.password file to a live application configuration folder ([install-dir]/conf/[live-application-name]) and then configure application properties so that source connections to that specific live application use the custom publish.password location. When you do this, the default [install-dir]/conf/publish.password file isn't used and you must manage the password file for the application using a text editor. This section describes the following custom properties that you can configure:

securityPublishPasswordFile property
rtmpEncoderAuthenticateFile property
rtspEncoderAuthenticateFile property

Note: Only administrators with advanced permissions can configure properties in Wowza Streaming Engine Manager. For more information, see Manage credentials.

securityPublishPasswordFile property

  1. In the Wowza Streaming Engine Manager Applications contents panel, click the live application that you want to configure.
     
  2. In the application details page, click the Properties tab.
     
  3. In the Quick Links bar, click Custom.
     
  4. In the Custom properties section, click Edit and then click the Add Custom Property button.
     
  5. In the Add Custom Property dialog box, specify the property settings shown in the following table, and then click Add.
    Path
    Name
    Type
    Value
    Root/Application securityPublishPasswordFile String ${com.wowza.wms.context.VHostConfigHome}/conf/${com.wowza.wms.context.Application}/publish.password
  6. Click Save, and then restart the application.
 
Notes:
  • The securityPublishPasswordFile property isn't supported in Wowza Media Server software. You must use the rtmpEncoderAuthenticateFile and rtspEncoderAuthenticateFile properties to authenticate sources using per-application publish.password files.
     
  • Wowza Streaming Engine 4.1 software first checks to see if the securityPublishPasswordFile property is set. If it's not set, it will then check to see if either (or both) of the rtmpEncoderAuthenticateFile or rtspEncoderAuthenticateFile properties are set.
     
  • If you're running Wowza Streaming Engine 4.0 software, the securityPublishPasswordFile property only supports authentication of RTMP-based sources using per-application publish.password files. To authenticate RTSP-based sources, you must configure the rtspEncoderAuthenticateFile property.

rtmpEncoderAuthenticateFile property

  1. In the Wowza Streaming Engine Manager Applications contents panel, click the live application that you want to configure.
     
  2. In the application details page, click the Properties tab.
     
  3. In the Quick Links bar, click Custom.
     
  4. In the Custom properties section, click Edit and then click the Add Custom Property button.
     
  5. In the Add Custom Property dialog box, specify the property settings shown in the following table, and then click Add.
    Path
    Name
    Type
    Value
    Root/Application rtmpEncoderAuthenticateFile String ${com.wowza.wms.context.VHostConfigHome}/conf/${com.wowza.wms.context.Application}/publish.password
  6. Click Save, and then restart the application.

rtspEncoderAuthenticateFile

  1. In the Wowza Streaming Engine Manager Applications contents panel, click the live application that you want to configure.
     
  2. In the application details page, click the Properties tab.
     
  3. In the Quick Links bar, click Custom.
     
  4. In the Custom properties section, click Edit and then click the Add Custom Property button.
     
  5. In the Add Custom Property dialog box, specify the property settings shown in the following table, and then click Add.
    Path
    Name
    Type
    Value
    Root/Application rtspEncoderAuthenticateFile String ${com.wowza.wms.context.VHostConfigHome}/conf/${com.wowza.wms.context.Application}/publish.password
  6. Click Save, and then restart the application.

More resources