(Last Updated 04 October 2013)
|
Contents [hide]
|
One of the key aspects of the v2 SHOUTcast Directory infrastructure (as used by the v2 DNAS server) is an authhash which is used to validate your DNAS server when it tries to connect to the SHOUTcast Directory for any of the station(s) you run.
Once an authhash has been obtained, it will be valid for all DNAS servers of the station being broadcast which make use of it though it will be tied to the original host used to generate it if subsequent editing is required.
Important: An authhash is not something you are charged for and are free to create.
You can obtain multiple authhash or re-use an existing authhash depending on your needs and the type and format of the stream. So the same authhash can be used for all instances of a station if each stream is using a different bitrate or type as the SHOUTcast Directory will automatically list those streams separately for you.
The DNAS server can be run in two modes:
If you want the station to be publically listed then you will need an authhash, otherwise it is not needed for private stations.
If you want to run the DNAS privately then you can change the appropriate setting in the stream source being used. Otherwise you can change publicserver or streampublicserver (if using stream specific control) to be 'never' in the DNAS's configuration file e.g. publicserver=never.
The main purpose of an authhash is to primarily help to ensure your listing in the SHOUTcast Directory will use the same stationid irrespective of server address changes and other changes which could not be guaranteed when using a v1 based DNAS server. This is achieved the authhash acting as a fixed piece of information the SHOUTcast Directory knows about and from the DNAS server being able to provide it so there is no doubt when we find your listing details (which was not possible with the previous v1 based methods).
Additionally, it makes it simple to ensure that multiple servers for a stream are correctly grouped together and that they all provide the same stream title and associated metadata. This is because the authhash can be re-used on other streams so by copy + pasting it into another stream configuration, it is simple to add other servers to a listing. With a v1 DNAS server, you would have to ensure that all sources connected were setup the same otherwise it is possible for them not to be grouped correctly or in some cases be grouped with the servers of an unrelated stream.
Finally, it makes it possible to control and also change details of the stream without having to rely upon access to all sources used to feed the stream (which can be useful if you have multiple DJs providing the stream and they are not as careful about their settings for the stream title as they should be).
Overall, the authhash helps ensure a better stability in your listing as well as resolving some issues with the v1 SHOUTcast system. It may seem like an unnecessary step but is the equivalent of signing up and filling in details for your stream(s) as other stream directories require.
To obtain a authhash, you first need to have setup the v2 DNAS server and have a source (such as the Source DSP or Transcoder) connected so the stream is recognised by the DNAS.
Then you need to login to the 'Server Summary' page which is accessed from the 'Server Login' link in the top right on publically accessible pages of the DNAS server.
To login, the username is 'admin' and the password is the
configured adminpassword (see DNAS server - section 4.8)
You can also access it directly by opening http://127.0.0.1:8000/admin.cgi if doing this on the same machine as the DNAS server is being run on. If you have changed 'portbase' then you will need to change 8000 to the value specified for 'portbase'. If you are accessing this remotely then you will need to change 127.0.0.1 to the appropriate IP address / DNS name of the machine you are trying to access.
On the 'Server Summary' page you will see listed any streams which have sources connected or have been configured. For streams which have sources connected, 'Create Authhash', 'Update Authhash' and 'Remove Authhash' options will be shown as appropriately beneath the stream number. Additionally there will be a 'Manually Edit Authhash' option.
Depending on the version and configuration of your DNAS server it may automatically do this step for you the first time the stream is started. If it does then see 'Update Authhash' for making edits.
To create an authhash for a stream, click the 'Create Authhash' link. This will take you to where you need to fill in the missing fields as applicable for your stream as the DNAS server will attempt to fill in fields with the information obtained from the source. Once all of the required information has been entered then click the 'Create Authhash' button.
If there is a missing field or something is determined to not be correct, you will see a message showing what needs to be entered or changed or what to do to get additional help. This will generally happen if you enter a value for the station name which is not allowed (as per here).
On successful creation, the new authhash will be saved into the configuration file either in the root configuration file or one where there's an empty streamauthhash entry which matches the stream identifier. When you go back to the 'Server Summary' page the 'Create Authhash' link will have changed to 'Update Authhash' and 'Remove Authhash' links.
It can take up to 10 minutes for the new authhash to be fully recognised so if you have made a mistake or are trying to get listed then you will need to wait a bit before trying again / allowing the listing details to refresh fully.
Updating an authhash is the same as with creating an authhash with the existing details of the authhash shown in the fields instead of being taken from the connected source. If there are no issues and the authhash can be updated from the machine used (with it having the same external IP as was used when creating the authhash) then any changes made should be updated.
If there is a missing field or something is determined to not be correct, you will see a message showing what needs to be entered or changed or what to do to get additional help. This will generally happen if you enter a value for the station name which is not allowed (as per here).
It can take up to 10 minutes for changed details to be fully recognised so if you have made a mistake or are trying to get listed then you will need to wait.
The DNAS server will attempt to apply any updated authhash changes automatically (even if made from the main DNAS server used to edit the details and other streams are using the same authhash) though if the DNAS server cannot complete this then it may automatically drop the current source for the stream(s) to allow it to then re-connect so it can then update the stream to sue the new details.
Removing an authhash is a simple action of clicking the 'Remove Authhash' link. If there are no issues and the authhash can be removed from the machine used (with it having the same external IP as used to create the authhash) it will be removed from the SHOUTcast Directory systems and will also be removed from your configuration file.
If there is an issue with the removal of the authhash, you will see a message showing what the error is to guide what to do or what to do to get additional help. Additionally you can use the 'Manually Edit Authhash' option to remove it as long as the issue is not related to saving changes to the configuration file.
If you want to use the same authhash on another stream (e.g. if only the stream format is different or you want to group the same stream content) then you can use the 'Manually Edit Authhash' option or to manually edit the configuration file by setting the relevant 'streamauthhash' entry for the required stream configuration group followed by using the 'Reload All Stream Configuration(s)' option on the 'Server Summary' page.
This is provided to make it easier to duplicate existing authhashes between streams on the same DNAS server or to copy them onto a different DNAS server instance. It provides the means to see the authhash for the selected stream or to choose an existing authhash from another stream on the DNAS server, allowing it to be choosen or cleared or replaced.
Updating or removing an authhash requires the same external IP address of the machine to be detected by the YP compared to what was used when the authhash was created. If this external IP has changed then you can contact support here and ensuring all required information is provided as is requested for the issue being experienced. Alternatively if you are not concerned about the stationid of the Directory listing changing then you can use the 'Manually Edit Authhash' option to remove it which allows for creation of a new authhash.
If you experience other issues with managing your authhashes via the options provided, make sure you follow any information provided to attempt to resolve the issue. If that still does not work then you will need to contact support here ensuring all required information is provided as is requested for the issue being experienced.
The following are browsers which have been tested and are known to have issues causing reduced functionality (not related to security options which can be changed):
The DNAS will show the following message when using this browser:
Unable to download the details for the dropdown options. You need to use a browser with 'Cross Origin Resource Sharing' (CORS) support.
There should be no issues with using other modern browsers with the following showing from which older versions are known to work with the authhash management pages and so newer versions of them should also work as well: