User guide

104 Chapter 11
External authorization module
Version 3.1
Overview
The Authorization module allows you to develop your own access control
for the movies stored on the server.
By adding specific information into the URL, you will be able to apply
your own dedicated authorization mechanism.
4Sight calls a function in the Authorization module for every incoming
RTSP request:
bool ESSRequestAuthorization(char* inURL, char* inIPAddress, char*
inQueryString);
where:
• inURL is the path to the movie – for example, if the request is
rtsp://192.178.155.10/tutorial1/file.mp4, the URL is "tutorial1/file.mp4".
• inIPAddress is the IP address of the player requesting the movie,
• inQueryString is extra information from the player that is included in
the URL after '?'. This information can include a user name and any
specific information that you need. The field is NULL if nothing has
been specified in the URL.
• The return value is true if you want to accept the RTSP request or
false to refuse the RTSP request.
URL example:
rtsp://192.178.155.10/tutorial1/file.mp4?user=julien&auth=123
See “Basic example of external authorization module” on page 106.