Wejn s.r.o.

Solving complicated IT problems is our hobby.

Wowza Streaming Engine Missing conf/Authentication.xml

It’s been a while that I noticed an issue with missing conf/Authentication.xml file in Wowza Streaming Engine (Wowza 4.X).

First I tried to talk to Wowza on the forum, then I redirected the conversation, as instructed, to support email (ticket #89955).

The outcome (official response from Wowza) is still in the making.

And in the meantime I was contacted by couple of people having problems installing my custom Wowza HTTPProviders.

Well, if you’re running Wowza Streaming Engine and need to modify conf/Authentication.xml file, the fix is actually straightforward.

At first I was copying over the file from Wowza Media Server 3.X, but then I actually took a short look at WSE 4.0.3 installation and I found out that they bundle the file in wms-server.jar:

1
2
3
4
5
6
$ pwd
/usr/local/WowzaStreamingEngine-4.0.3/lib
$ grep Authentication.xml *
Binary file wms-server.jar matches
$ jar tvf wms-server.jar | grep Auth.*xml
  2553 Thu Mar 27 01:35:36 CET 2014 com/wowza/wms/conf/Authentication.xml

Which brings me to an quick and easy fix how to source the conf/Authentication.xml file when you need to add custom Authentication methods:

1
2
$ cd ../conf
$ unzip -j ../lib/wms-server.jar com/wowza/wms/conf/Authentication.xml

In other words (or if you’re not on Linux): just extract the file from wms-server.jar, stick it in your conf and modify at will.

If the conf/Authentication.xml is present, Wowza Streaming Engine (at least the 4.0.3 version I happen to have installed at this time) will happily prefer the actual filesystem file (including your modifications).

We’ll see how long it will take to Wowza Media Systems to issue an official guidance on this. But after more than one month of waiting… I’m not exactly holding my breath.

Oh, and btw, this same extraction should also work for any of the following files:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
$ pwd
/usr/local/WowzaStreamingEngine-4.0.3/lib
$ jar tvf wms-server.jar | awk '/wms.conf/ { print substr($8, 15) }'
conf/Application.xml
conf/Authentication.xml
conf/CEACaptionConversion.xml
conf/DVR.xml
conf/HTTPStreamers.xml
conf/HostPortTemplates.xml
conf/LiveStreamPacketizers.xml
conf/LiveStreamTranscoders.xml
conf/MP3Tags.xml
conf/MediaCache.xml
conf/MediaCacheSourceTemplates.xml
conf/MediaCasters.xml
conf/MediaReaders.xml
conf/MediaWriters.xml
conf/PushPublishProfiles.xml
conf/RTP.xml
conf/Server.xml
conf/StartupStreams.xml
conf/Streams.xml
conf/TimedTextProviders.xml
conf/Tune.xml
conf/VHost.xml
conf/VHosts.xml
conf/clientaccesspolicy.xml
conf/crossdomain.xml
conf/live/Application.xml
conf/vod/Application.xml