Users: Difference between revisions

From wiki.jriver.com
Jump to navigation Jump to search
(Created page with "== Overview == MC19 adds user accounts to the library. User accounts allow you to control which users see what content in your library. User accounts can optionally be passwor…")
 
No edit summary
Line 78: Line 78:


'''DO NOT MODIFY THIS FILE (doing so will damage the Library).'''
'''DO NOT MODIFY THIS FILE (doing so will damage the Library).'''

So, to switch to my Everyday user from the example above, using MC19, I'd use:

<code>MC19.exe /MCC 22028,1003</code>

== Restrict Files or Users ==

The special Administrator account (which cannot be removed) will always see ''all files''. For regular users, by default, all files will also be visible (so part of the "common shared library"). You have two ways to "restrict" access to files:

# the [User] Field for each file
# the Files to Show field available when you create a new user, or

=== User Field Restrictions ===

To restrict a file or files by the [User] field, add the username of the user that should see the files to the special [User] field. You can do this from the Tag Action Window (choose <span style="color:#8B4513">Also Show > User<span> on if needed). Then, only that user (and the Administrator) will see those files. In effect, you are "assigning" those files to that particular user.

So, for any files you want to be seen only by your wife, you'd pick her account in the [User] drop-down list. And, for yours, pick your account. If you messed them up, use the Administrator account to find them and fix them. All other files where this [User] field is blank (so, every file before you start this mission) will be shown to all users and part of the common library.

More than one user can own a particular file. If you assign two users to the same file (or files) then they will be able to see the files, but other users won't.

[[File:MC19-User Field-Multiple Values.png|frame|none]]

=== Files to Show User Restrictions ===

If instead of assigning files to a particular user, you want to restrict what that user can see in the library, you can add a Search Expression to the Files to Show box in the Edit User dialog (shown above). This will be applied in addition to whatever restrictions are applied by tagging individual files with a [User] tag. This method is probably best reserved for intermediately experienced users, but it can be handy when you want to restrict a particular user from certain categories of content.

As an example, if I added the following search to my "Snuggle Bunny" user above:

<code>[Media Sub Type]=Adult</code>

It would change the whole meaning of the pet name, and that user would see only things marked as adult (everywhere else in my Library would be blank). To do the reverse, for a child's account, for example, you use this instead:

<code>-[Media Sub Type]=Adult</code>

[[File:MC19-Simple User Restriction.png|frame|none]]

Revision as of 16:28, 23 March 2014

Overview

MC19 adds user accounts to the library. User accounts allow you to control which users see what content in your library. User accounts can optionally be password protected. The User system replaces Access Control from earlier versions.

The accounts are part of the library. The user accounts are included as part of a library backup, and any connected clients will have access to the same accounts as the server.

Security and Scope

User accounts change what files are shown in the library. However, they have no impact on a file's actual availability at the operating system level.

None of this restricts access to the filesystem in any way. So, users can still all of the source media files via Windows Explorer. MC will refuse to play a file if opened (even from Windows Explorer) by a user without permissions for the file. But no other application will respect this restriction. Also, if you've created a user restriction via the Files to Show field in the Add User dialog, there is nothing to stop this user from simply re-opening the dialog and removing the filter.

Passwords for the users are stored encrypted, but a clever person with a hex editor could remove the user accounts completely from the library.

The purpose of the feature is not about security. It is about hiding "noise" from users who don't need to see it (or shouldn't have it shoved in their faces). It is, as Matt put it originally, that:

The possibilities here are pretty endless, but our goals for MC19 are modest. I want a simple way to not see Curious George when I sit down at the couch. We're not trying to make everything in MC fully multi-user.

Adding Users

1. Add a new user via View > User > Add User

2. Give the user a name, and a password if you want.

MC19-Add User.png

Repeat the above to create additional users. You can add any number of users. For each user, you can optionally specify search criteria in order to hide items from that user (detailed below).

Choosing the Active User

Switch users in Standard View using the View > User menu item.

MC19-Switch Users-StandardView.png

In Theater View, the User name will be shown in the Top Roller of your Views, and you can navigate to it and then choose the user you want to use.

MC19-Switch Users-TheaterView.png

If the user has a password, you will be prompted for it:

Media Network Users

If you are using Media Network features, any connected clients (whether connected copies of MC, JRemote, Gizmo, or whatever) will "open as" whichever User is currently active on the server when first launched. In other words, whichever User happened to have been "last used", on the server, becomes is the "network client user setting". So, if you want to keep a default of a particular one of your users (the Everyday one, for example) then you'll want to make sure to leave the server set on the Everyday user when you're done using it.

In connected copies of Media Center, however (the HTPC in the Living Room, for example) you are able to switch the active user to any of the other options (using the above explained methods). But when you close and re-open the client copy, it will revert back to whatever is currently active on the server. On JRemote I don't believe there is (currently) a mechanism to switch users, so you're stuck with the default. I'm not sure about Gizmo.

So what will often work best is if you have exactly this: An Everyday user (with no password) that you use regularly, and leave the Server set on (if using those features). And then you add a password to the Administrator account, and any other users you want restricted for some reason.

Automation

MC includes a MCC_SET_USER Core Command (22028) that can be used from the command line and from within scripts to switch select a specified user automatically.

To use this command, you can use the MC launcher from the command line with something like:

MC<version>.exe /MCC 22028,<nUserId>

To locate the nUserId for each user you've added to your system, open the user.jmd file in your Library in a text editor, and locate the UD for the user you'd like to use:

<tt>
<XMLPH version="1.0">
<Item Name="WriteAccess">1</Item>
<Item Name="ID">0</Item>
<Item Name="VisibleFilesSearch"/>
<Item Name="Password"></Item>
<Item Name="DisplayName">Administrator</Item>
</XMLPH><XMLPH version="1.0">
<Item Name="WriteAccess">1</Item>
<Item Name="ID">1003</Item>
<Item Name="VisibleFilesSearch">-[Media Sub Type]=[Adult]</Item>
<Item Name="Password"></Item>
<Item Name="DisplayName">Everyday</Item>
</tt>

DO NOT MODIFY THIS FILE (doing so will damage the Library).

So, to switch to my Everyday user from the example above, using MC19, I'd use:

MC19.exe /MCC 22028,1003

Restrict Files or Users

The special Administrator account (which cannot be removed) will always see all files. For regular users, by default, all files will also be visible (so part of the "common shared library"). You have two ways to "restrict" access to files:

  1. the [User] Field for each file
  2. the Files to Show field available when you create a new user, or

User Field Restrictions

To restrict a file or files by the [User] field, add the username of the user that should see the files to the special [User] field. You can do this from the Tag Action Window (choose Also Show > User on if needed). Then, only that user (and the Administrator) will see those files. In effect, you are "assigning" those files to that particular user.

So, for any files you want to be seen only by your wife, you'd pick her account in the [User] drop-down list. And, for yours, pick your account. If you messed them up, use the Administrator account to find them and fix them. All other files where this [User] field is blank (so, every file before you start this mission) will be shown to all users and part of the common library.

More than one user can own a particular file. If you assign two users to the same file (or files) then they will be able to see the files, but other users won't.

MC19-User Field-Multiple Values.png

Files to Show User Restrictions

If instead of assigning files to a particular user, you want to restrict what that user can see in the library, you can add a Search Expression to the Files to Show box in the Edit User dialog (shown above). This will be applied in addition to whatever restrictions are applied by tagging individual files with a [User] tag. This method is probably best reserved for intermediately experienced users, but it can be handy when you want to restrict a particular user from certain categories of content.

As an example, if I added the following search to my "Snuggle Bunny" user above:

[Media Sub Type]=Adult

It would change the whole meaning of the pet name, and that user would see only things marked as adult (everywhere else in my Library would be blank). To do the reverse, for a child's account, for example, you use this instead:

-[Media Sub Type]=Adult

MC19-Simple User Restriction.png