Using QTSSAccessModule

    To use QTSSAccessModule you must:
    create an access file
    create a user file
    add users to the file

    You can also create a group file, but it's optional.

Creating an access file

    An access file is a text file that contains information about users and groups who are authorized to view media in the directory in which the access file is stored. The directory you use to store streamed media can contain other directories. Each directory can have its own access file. When a user tries to view a media file, Darwin Streaming Server checks for an access file to see whether the user is authorized to view the media. The server first looks for an access file in the directory where the media file is located. If an access file is not found, it looks up the directory hierarchy. The first access file that's found is used to determine whether a user is authorized to view the media file.

    Note: The access file for Darwin Streaming Server works similarly to the Apache Web server access file.

    You create an access file with any text editor. The filename must be qtaccess and the file must follow this format:

    AuthName <message>
    AuthUserFile <user filename>
    AuthGroupFile <group filename>
    require user <username1> <username2>
    require group <groupname1> <groupname2>

    Anything not in angled brackets is a keyword. Anything in angled brackets is information you supply.
    "Message" is text your users see when the login window appears. It's optional.
    If your message contains any white space (such as a space character between terms), make sure you enclose the entire message string in quotation marks.
    "User filename" is the path and filename of the user file. The default is /etc/qtusers.
    "Group filename" is the path and filename of the user file. The default is /etc/qtgroups. A group file is optional. If you have a lot of users you may find it easier to set up one or more groups, then enter the group names, rather than list each user.
    "Username" is a user who is authorized to log in and view the media file. The user's name must be in the user file you specified. You can also specify valid_user, which designates any valid user.
    "Groupname" is a group whose members are authorized to log in and view the media file. The group and its members must be listed in the group file you specified.

Creating a user file

    To let users access your media files, you must add them to a user file.

    To create a user file, open a terminal window and type the following:

    qtpasswd -c <user filename> <user-name>

    You'll be asked to enter a password for the user.

    A file is created with the user you specified.

    Note: The -c option means create a file. You use this option only once; otherwise you will overwrite a previously created user file.

Adding users to the user file

    To add a user to the user file, open a terminal shell and type:

    qtpasswd <user filename> <user-name>

    You'll be asked to enter a password for the user. Then re-enter the same password a second time when prompted.

    You can allow access to any user by typing:

    qtpasswd <user filename> valid_user

Adding or deleting groups

    You can create a group file with any text editor as long as it follows this format:

    <groupname>: <user-name1> <user-name2> <user-name3>

    To add or delete a group, edit the text file you set up.

Deleting users

    To delete a user from a user or group file:

    Use a text editor to open the user or group file. Delete the user name and encrypted password from the user file; delete the user name from the group file.

Changing a password

    To change a user password, open a terminal shell and type the following:

    qtsspasswd <user filename> <user-name>

    You'll be asked to enter a password for the user. The password you enter replaces the password that's in the file.

Related topic

 


Table of contents