[xiph-cvs] r6617 - in icecast/trunk/icecast: conf doc
oddsock at xiph.org
oddsock at xiph.org
Tue May 4 21:31:00 PDT 2004
Author: oddsock
Date: 2004-05-03 11:00:18 -0400 (Mon, 03 May 2004)
New Revision: 6617
Added:
icecast/trunk/icecast/doc/icecast2_listenerauth.html
icecast/trunk/icecast/doc/listener_auth1.jpg
icecast/trunk/icecast/doc/listener_auth2.jpg
icecast/trunk/icecast/doc/listener_auth3.jpg
Modified:
icecast/trunk/icecast/conf/icecast.xml.in
icecast/trunk/icecast/doc/icecast2.hhc
icecast/trunk/icecast/doc/index.html
Log:
much better documentation of listener authentication
<p>Modified: icecast/trunk/icecast/conf/icecast.xml.in
===================================================================
--- icecast/trunk/icecast/conf/icecast.xml.in 2004-05-03 14:59:40 UTC (rev 6616)
+++ icecast/trunk/icecast/conf/icecast.xml.in 2004-05-03 15:00:18 UTC (rev 6617)
@@ -110,6 +110,11 @@
<!--
<alias source="/foo" dest="/bar"/>
-->
+ <!-- Aliases: can also be used for simple redirections as well,
+ this example will redirect all requests for http://server:port/ to
+ the status page
+ -->
+ <alias source="/" dest="/status.xsl"/>
</paths>
<logging>
Modified: icecast/trunk/icecast/doc/icecast2.hhc
===================================================================
--- icecast/trunk/icecast/doc/icecast2.hhc 2004-05-03 14:59:40 UTC (rev 6616)
+++ icecast/trunk/icecast/doc/icecast2.hhc 2004-05-03 15:00:18 UTC (rev 6617)
@@ -42,6 +42,10 @@
<param name="Local" value="icecast2_yp.html">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
+ <param name="Name" value="Listener Authentication">
+ <param name="Local" value="icecast2_listenerauth.html">
+ </OBJECT>
+ <LI> <OBJECT type="text/sitemap">
<param name="Name" value="Win32 specific documentation">
<param name="Local" value="icecast2_win32.html">
</OBJECT>
Added: icecast/trunk/icecast/doc/icecast2_listenerauth.html
===================================================================
--- icecast/trunk/icecast/doc/icecast2_listenerauth.html 2004-05-03 14:59:40 UTC (rev 6616)
+++ icecast/trunk/icecast/doc/icecast2_listenerauth.html 2004-05-03 15:00:18 UTC (rev 6617)
@@ -0,0 +1,53 @@
+<LINK REL=STYLESHEET TYPE= "text/css" HREF= "style.css">
+<div class=boxtest>
+<body bgcolor="#efefef" text="#323232" link="#0000ff" vlink="#800080" alink="#ff0000">
+<h1>Icecast 2 Listener Authentication</h1>
+<table width=100%><tr><td bgcolor="#007B79" height="10" align="center"></td></tr></table>
+<br>
+<br>
+<br>
+<h2>Listener Authentication</h2>
+<p>Listener authentication is a feature of icecast which allows you to secure certain mountpoint so that in order to listen, a listener must provide a username and password. With this feature a simple pay-for-play operation can be setup. This section will show you the basics of setting up and maintaining this component.</p>
+
+<br>
+<br>
+<br>
+<h2>HTPASSWD Listener Authentication</h2>
+<h3>Config File Entries</h3>
+<p>In order to use listener authentication, you MUST configure a mount specific option. This means that you have to provide a <mount> section in the main icecast config file. The following is an example :</p>
+<pre>
+ <mount>
+ <mount-name>/example-complex.ogg</mount-name>
+ <authentication type="htpasswd">
+ <option name="filename" value="myauth"/>
+ </authentication>
+ </mount>
+</pre>
+<p>To support listener authentication you MUST provide at a minimum <mount-name> and <authentication>. The mount-name is the name of the mountpoint that you will use to connect your source client with and authentication configures what type of icecast2 authenticator to use. Currently, only a single type "htpasswd" is implemented. New authenticators will be added later. Each authenticator has a variable number of options that are required and these are specified as shown in the example. The htpasswd authenticator requires only a single parameter, filename, which specifies the name of the file to use to store users and passwords. Note that this file need not exist (and probably will not exist when you first set it up). Icecast has built-in support for managing users and passwords via the web admin interface. More on this later in this section.</p>
+
+<p>Icecast supports a mixture of streams that require listener authentication and those that do not. Only mounts that are named in the config file can be configured for listener authentication.</p>
+<br>
+<br>
+<br>
+<h3>Configuring Users and Passwords</h3>
+<p>Once the appropriate entries are made to the config file, connect your source client (using the mountpoint you named in the config file). To configure users and passwords for this stream you must use the web-based admin interface. Navigate to http://server:ip/admin/stats.xsl to begin. If you have configured everything properly, you should see a screen like the following :</p>
+<img border=1 src="listener_auth1.jpg">
+<p>You will see a red key in front of all mountpoint configured for listener authentication. Also note that this page will only show CONNECTED mountpoints.</p>
+<p>To manage users and passwords for this mountpoint, click on the red key or follow the "Manage Authentication" link. The following screen will be shown :</p>
+<img border=1 src="listener_auth2.jpg">
+<p>This screen will show all the users configured for this mountpoint. Adding users is as simple as entering a username and password in the fields and clicking "Add New User". Note that usernames MUST be unique and there are NO restrictions on passwords. You can delete users by clicking the appropriate delete link next to each user.</p>
+<br>
+<br>
+<br>
+<h3>Finishing it all off</h3>
+<p>Ok, so you've created your users, and you have everything setup properly, how do your users login ? Well, we've provided a simple login form that you can use for this purpose. This page (http://server:port/auth.xsl) will bring up a form that users can use to enter their username and password.</p>
+<img border=1 src="listener_auth3.jpg">
+<p>This page will serve a m3u with the username and password and in most cases should open the correct media player and begin playing your stream</p>
+<br>
+<br>
+<br>
+<h2>A note about players and authentication</h2>
+<p>We do not have an exaustive list of players that support listener authentication. We use standard HTTP basic authentication, and in general, many media players support this if they support anything at all. Winamp and Foobar2000 support HTTP basic authentication on windows, and XMMS supports it on unix platforms.</p>
+</div>
+</body>
+</html>
<p>Property changes on: icecast/trunk/icecast/doc/icecast2_listenerauth.html
___________________________________________________________________
Name: svn:executable
+ *
Modified: icecast/trunk/icecast/doc/index.html
===================================================================
--- icecast/trunk/icecast/doc/index.html 2004-05-03 14:59:40 UTC (rev 6616)
+++ icecast/trunk/icecast/doc/index.html 2004-05-03 15:00:18 UTC (rev 6617)
@@ -11,6 +11,7 @@
<li>Server Statistics
<li>Relaying
<li>Listing in a YP directory
+<li>Listener Authentication
<li>Win32 specific documentation
<li>Glossary
<li>FAQ
Added: icecast/trunk/icecast/doc/listener_auth1.jpg
===================================================================
(Binary files differ)
<p>Property changes on: icecast/trunk/icecast/doc/listener_auth1.jpg
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: icecast/trunk/icecast/doc/listener_auth2.jpg
===================================================================
(Binary files differ)
<p>Property changes on: icecast/trunk/icecast/doc/listener_auth2.jpg
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: icecast/trunk/icecast/doc/listener_auth3.jpg
===================================================================
(Binary files differ)
<p>Property changes on: icecast/trunk/icecast/doc/listener_auth3.jpg
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
--- >8 ----
List archives: http://www.xiph.org/archives/
Ogg project homepage: http://www.xiph.org/ogg/
To unsubscribe from this list, send a message to 'cvs-request at xiph.org'
containing only the word 'unsubscribe' in the body. No subject is needed.
Unsubscribe messages sent to the list will be ignored/filtered.
More information about the commits
mailing list