zydronium/screwturn-4
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Fixed help files.

Browse source
This commit is contained in:
Dario Solera 2009-09-30 13:47:13 +00:00
commit b8f912cc79
1543 changed files with 395123 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

481
Core/AuthReader.cs Normal file
View file

@ -0,0 +1,481 @@

using System;
using System.Collections.Generic;
using System.Text;
using ScrewTurn.Wiki.AclEngine;
using ScrewTurn.Wiki.PluginFramework;
namespace ScrewTurn.Wiki {
/// <summary>
/// Utility class for reading permissions and authorizations.
/// </summary>
public static class AuthReader {
/// <summary>
/// Gets the settings storage provider.
/// </summary>
private static ISettingsStorageProviderV30 SettingsProvider {
get { return Collectors.SettingsProvider; }
}
/// <summary>
/// Gets all the actions for global resources that are granted to a group.
/// </summary>
/// <param name="group">The user group.</param>
/// <returns>The granted actions.</returns>
public static string[] RetrieveGrantsForGlobals(UserGroup group) {
if(group == null) throw new ArgumentNullException("group");
return RetrieveGrantsForGlobals(AuthTools.PrepareGroup(group.Name));
}
/// <summary>
/// Gets all the actions for global resources that are granted to a user.
/// </summary>
/// <param name="user">The user.</param>
/// <returns>The granted actions.</returns>
public static string[] RetrieveGrantsForGlobals(UserInfo user) {
if(user == null) throw new ArgumentNullException("user");
return RetrieveGrantsForGlobals(AuthTools.PrepareUsername(user.Username));
}
/// <summary>
/// Gets all the actions for global resources that are granted to a subject.
/// </summary>
/// <param name="subject">The subject.</param>
/// <returns>The granted actions.</returns>
private static string[] RetrieveGrantsForGlobals(string subject) {
AclEntry[] entries = SettingsProvider.AclManager.RetrieveEntriesForSubject(subject);
List<string> result = new List<string>(entries.Length);
foreach(AclEntry entry in entries) {
if(entry.Value == Value.Grant && entry.Resource == Actions.ForGlobals.ResourceMasterPrefix) {
result.Add(entry.Action);
}
}
return result.ToArray();
}
/// <summary>
/// Gets all the actions for global resources that are denied to a group.
/// </summary>
/// <param name="group">The user group.</param>
/// <returns>The denied actions.</returns>
public static string[] RetrieveDenialsForGlobals(UserGroup group) {
if(group == null) throw new ArgumentNullException("group");
return RetrieveDenialsForGlobals(AuthTools.PrepareGroup(group.Name));
}
/// <summary>
/// Gets all the actions for global resources that are denied to a user.
/// </summary>
/// <param name="user">The user.</param>
/// <returns>The denied actions.</returns>
public static string[] RetrieveDenialsForGlobals(UserInfo user) {
if(user == null) throw new ArgumentNullException("user");
return RetrieveDenialsForGlobals(AuthTools.PrepareUsername(user.Username));
}
/// <summary>
/// Gets all the actions for global resources that are denied to a subject.
/// </summary>
/// <param name="subject">The subject.</param>
/// <returns>The denied actions.</returns>
private static string[] RetrieveDenialsForGlobals(string subject) {
AclEntry[] entries = SettingsProvider.AclManager.RetrieveEntriesForSubject(subject);
List<string> result = new List<string>(entries.Length);
foreach(AclEntry entry in entries) {
if(entry.Value == Value.Deny && entry.Resource == Actions.ForGlobals.ResourceMasterPrefix) {
result.Add(entry.Action);
}
}
return result.ToArray();
}
/// <summary>
/// Retrieves the subjects that have ACL entries set for a namespace.
/// </summary>
/// <param name="nspace">The namespace (<c>null</c> for the root).</param>
/// <returns>The subjects.</returns>
public static SubjectInfo[] RetrieveSubjectsForNamespace(NamespaceInfo nspace) {
string resourceName = Actions.ForNamespaces.ResourceMasterPrefix;
if(nspace != null) resourceName += nspace.Name;
AclEntry[] entries = SettingsProvider.AclManager.RetrieveEntriesForResource(resourceName);
List<SubjectInfo> result = new List<SubjectInfo>(entries.Length);
for(int i = 0; i < entries.Length; i++) {
SubjectType type = AuthTools.IsGroup(entries[i].Subject) ? SubjectType.Group : SubjectType.User;
// Remove the subject qualifier ('U.' or 'G.')
string name = entries[i].Subject.Substring(2);
if(result.Find(delegate(SubjectInfo x) { return x.Name == name && x.Type == type; }) == null) {
result.Add(new SubjectInfo(name, type));
}
}
return result.ToArray();
}
/// <summary>
/// Gets all the actions for a namespace that are granted to a group.
/// </summary>
/// <param name="group">The user group.</param>
/// <param name="nspace">The namespace (<c>null</c> for the root).</param>
/// <returns>The granted actions.</returns>
public static string[] RetrieveGrantsForNamespace(UserGroup group, NamespaceInfo nspace) {
if(group == null) throw new ArgumentNullException("group");
return RetrieveGrantsForNamespace(AuthTools.PrepareGroup(group.Name), nspace);
}
/// <summary>
/// Gets all the actions for a namespace that are granted to a user.
/// </summary>
/// <param name="user">The user.</param>
/// <param name="nspace">The namespace (<c>null</c> for the root).</param>
/// <returns>The granted actions.</returns>
public static string[] RetrieveGrantsForNamespace(UserInfo user, NamespaceInfo nspace) {
if(user == null) throw new ArgumentNullException("user");
return RetrieveGrantsForNamespace(AuthTools.PrepareUsername(user.Username), nspace);
}
/// <summary>
/// Gets all the actions for a namespace that are granted to a subject.
/// </summary>
/// <param name="subject">The subject.</param>
/// <param name="nspace">The namespace (<c>null</c> for the root).</param>
/// <returns>The granted actions.</returns>
private static string[] RetrieveGrantsForNamespace(string subject, NamespaceInfo nspace) {
string resourceName = Actions.ForNamespaces.ResourceMasterPrefix;
if(nspace != null) resourceName += nspace.Name;
AclEntry[] entries = SettingsProvider.AclManager.RetrieveEntriesForSubject(subject);
List<string> result = new List<string>(entries.Length);
foreach(AclEntry entry in entries) {
if(entry.Value == Value.Grant && entry.Resource == resourceName) {
result.Add(entry.Action);
}
}
return result.ToArray();
}
/// <summary>
/// Gets all the actions for a namespace that are denied to a group.
/// </summary>
/// <param name="group">The user group.</param>
/// <param name="nspace">The namespace (<c>null</c> for the root).</param>
/// <returns>The denied actions.</returns>
public static string[] RetrieveDenialsForNamespace(UserGroup group, NamespaceInfo nspace) {
if(group == null) throw new ArgumentNullException("group");
return RetrieveDenialsForNamespace(AuthTools.PrepareGroup(group.Name), nspace);
}
/// <summary>
/// Gets all the actions for a namespace that are denied to a user.
/// </summary>
/// <param name="user">The user.</param>
/// <param name="nspace">The namespace (<c>null</c> for the root).</param>
/// <returns>The denied actions.</returns>
public static string[] RetrieveDenialsForNamespace(UserInfo user, NamespaceInfo nspace) {
if(user == null) throw new ArgumentNullException("user");
return RetrieveDenialsForNamespace(AuthTools.PrepareUsername(user.Username), nspace);
}
/// <summary>
/// Gets all the actions for a namespace that are denied to a subject.
/// </summary>
/// <param name="subject">The subject.</param>
/// <param name="nspace">The namespace (<c>null</c> for the root).</param>
/// <returns>The denied actions.</returns>
private static string[] RetrieveDenialsForNamespace(string subject, NamespaceInfo nspace) {
string resourceName = Actions.ForNamespaces.ResourceMasterPrefix;
if(nspace != null) resourceName += nspace.Name;
AclEntry[] entries = SettingsProvider.AclManager.RetrieveEntriesForSubject(subject);
List<string> result = new List<string>(entries.Length);
foreach(AclEntry entry in entries) {
if(entry.Value == Value.Deny && entry.Resource == resourceName) {
result.Add(entry.Action);
}
}
return result.ToArray();
}
/// <summary>
/// Retrieves the subjects that have ACL entries set for a page.
/// </summary>
/// <param name="page">The page.</param>
/// <returns>The subjects.</returns>
public static SubjectInfo[] RetrieveSubjectsForPage(PageInfo page) {
if(page == null) throw new ArgumentNullException("page");
AclEntry[] entries = SettingsProvider.AclManager.RetrieveEntriesForResource(Actions.ForPages.ResourceMasterPrefix + page.FullName);
List<SubjectInfo> result = new List<SubjectInfo>(entries.Length);
for(int i = 0; i < entries.Length; i++) {
SubjectType type = AuthTools.IsGroup(entries[i].Subject) ? SubjectType.Group : SubjectType.User;
// Remove the subject qualifier ('U.' or 'G.')
string name = entries[i].Subject.Substring(2);
if(result.Find(delegate(SubjectInfo x) { return x.Name == name && x.Type == type; }) == null) {
result.Add(new SubjectInfo(name, type));
}
}
return result.ToArray();
}
/// <summary>
/// Gets all the actions for a page that are granted to a group.
/// </summary>
/// <param name="group">The user group.</param>
/// <param name="page">The page.</param>
/// <returns>The granted actions.</returns>
public static string[] RetrieveGrantsForPage(UserGroup group, PageInfo page) {
if(group == null) throw new ArgumentNullException("group");
return RetrieveGrantsForPage(AuthTools.PrepareGroup(group.Name), page);
}
/// <summary>
/// Gets all the actions for a page that are granted to a user.
/// </summary>
/// <param name="user">The user.</param>
/// <param name="page">The page.</param>
/// <returns>The granted actions.</returns>
public static string[] RetrieveGrantsForPage(UserInfo user, PageInfo page) {
if(user == null) throw new ArgumentNullException("user");
return RetrieveGrantsForPage(AuthTools.PrepareUsername(user.Username), page);
}
/// <summary>
/// Gets all the actions for a page that are granted to a subject.
/// </summary>
/// <param name="subject">The subject.</param>
/// <param name="page">The page.</param>
/// <returns>The granted actions.</returns>
private static string[] RetrieveGrantsForPage(string subject, PageInfo page) {
if(page == null) throw new ArgumentNullException("page");
string resourceName = Actions.ForPages.ResourceMasterPrefix + page.FullName;
AclEntry[] entries = SettingsProvider.AclManager.RetrieveEntriesForSubject(subject);
List<string> result = new List<string>(entries.Length);
foreach(AclEntry entry in entries) {
if(entry.Value == Value.Grant && entry.Resource == resourceName) {
result.Add(entry.Action);
}
}
return result.ToArray();
}
/// <summary>
/// Gets all the actions for a page that are denied to a group.
/// </summary>
/// <param name="group">The user group.</param>
/// <param name="page">The page.</param>
/// <returns>The granted actions.</returns>
public static string[] RetrieveDenialsForPage(UserGroup group, PageInfo page) {
if(group == null) throw new ArgumentNullException("group");
return RetrieveDenialsForPage(AuthTools.PrepareGroup(group.Name), page);
}
/// <summary>
/// Gets all the actions for a page that are denied to a user.
/// </summary>
/// <param name="user">The user.</param>
/// <param name="page">The page.</param>
/// <returns>The granted actions.</returns>
public static string[] RetrieveDenialsForPage(UserInfo user, PageInfo page) {
if(user == null) throw new ArgumentNullException("user");
return RetrieveDenialsForPage(AuthTools.PrepareUsername(user.Username), page);
}
/// <summary>
/// Gets all the actions for a page that are denied to a subject.
/// </summary>
/// <param name="subject">The subject.</param>
/// <param name="page">The page.</param>
/// <returns>The granted actions.</returns>
private static string[] RetrieveDenialsForPage(string subject, PageInfo page) {
if(page == null) throw new ArgumentNullException("page");
string resourceName = Actions.ForPages.ResourceMasterPrefix + page.FullName;
AclEntry[] entries = SettingsProvider.AclManager.RetrieveEntriesForSubject(subject);
List<string> result = new List<string>(entries.Length);
foreach(AclEntry entry in entries) {
if(entry.Value == Value.Deny && entry.Resource == resourceName) {
result.Add(entry.Action);
}
}
return result.ToArray();
}
/// <summary>
/// Retrieves the subjects that have ACL entries set for a directory.
/// </summary>
/// <param name="provider">The provider.</param>
/// <param name="directory">The directory.</param>
/// <returns>The subjects.</returns>
public static SubjectInfo[] RetrieveSubjectsForDirectory(IFilesStorageProviderV30 provider, string directory) {
if(provider == null) throw new ArgumentNullException("provider");
if(directory == null) throw new ArgumentNullException("directory");
if(directory.Length == 0) throw new ArgumentException("Directory cannot be empty", "directory");
AclEntry[] entries = SettingsProvider.AclManager.RetrieveEntriesForResource(Actions.ForDirectories.ResourceMasterPrefix + AuthTools.GetDirectoryName(provider, directory));
List<SubjectInfo> result = new List<SubjectInfo>(entries.Length);
for(int i = 0; i < entries.Length; i++) {
SubjectType type = AuthTools.IsGroup(entries[i].Subject) ? SubjectType.Group : SubjectType.User;
// Remove the subject qualifier ('U.' or 'G.')
string name = entries[i].Subject.Substring(2);
if(result.Find(delegate(SubjectInfo x) { return x.Name == name && x.Type == type; }) == null) {
result.Add(new SubjectInfo(name, type));
}
}
return result.ToArray();
}
/// <summary>
/// Gets all the actions for a directory that are granted to a group.
/// </summary>
/// <param name="group">The user group.</param>
/// <param name="provider">The provider.</param>
/// <param name="directory">The directory.</param>
/// <returns>The granted actions.</returns>
public static string[] RetrieveGrantsForDirectory(UserGroup group, IFilesStorageProviderV30 provider, string directory) {
if(group == null) throw new ArgumentNullException("group");
return RetrieveGrantsForDirectory(AuthTools.PrepareGroup(group.Name), provider, directory);
}
/// <summary>
/// Gets all the actions for a directory that are granted to a user.
/// </summary>
/// <param name="user">The user.</param>
/// <param name="provider">The provider.</param>
/// <param name="directory">The directory.</param>
/// <returns>The granted actions.</returns>
public static string[] RetrieveGrantsForDirectory(UserInfo user, IFilesStorageProviderV30 provider, string directory) {
if(user == null) throw new ArgumentNullException("user");
return RetrieveGrantsForDirectory(AuthTools.PrepareUsername(user.Username), provider, directory);
}
/// <summary>
/// Gets all the actions for a directory that are granted to a subject.
/// </summary>
/// <param name="subject">The subject.</param>
/// <param name="provider">The provider.</param>
/// <param name="directory">The directory.</param>
/// <returns>The granted actions.</returns>
private static string[] RetrieveGrantsForDirectory(string subject, IFilesStorageProviderV30 provider, string directory) {
if(provider == null) throw new ArgumentNullException("provider");
if(directory == null) throw new ArgumentNullException("directory");
if(directory.Length == 0) throw new ArgumentException("Directory cannot be empty", "directory");
string resourceName = Actions.ForDirectories.ResourceMasterPrefix + AuthTools.GetDirectoryName(provider, directory);
AclEntry[] entries = SettingsProvider.AclManager.RetrieveEntriesForSubject(subject);
List<string> result = new List<string>(entries.Length);
foreach(AclEntry entry in entries) {
if(entry.Value == Value.Grant && entry.Resource == resourceName) {
result.Add(entry.Action);
}
}
return result.ToArray();
}
/// <summary>
/// Gets all the actions for a directory that are denied to a group.
/// </summary>
/// <param name="group">The user group.</param>
/// <param name="provider">The provider.</param>
/// <param name="directory">The directory.</param>
/// <returns>The denied actions.</returns>
public static string[] RetrieveDenialsForDirectory(UserGroup group, IFilesStorageProviderV30 provider, string directory) {
if(group == null) throw new ArgumentNullException("group");
return RetrieveDenialsForDirectory(AuthTools.PrepareGroup(group.Name), provider, directory);
}
/// <summary>
/// Gets all the actions for a directory that are denied to a user.
/// </summary>
/// <param name="user">The user.</param>
/// <param name="provider">The provider.</param>
/// <param name="directory">The directory.</param>
/// <returns>The denied actions.</returns>
public static string[] RetrieveDenialsForDirectory(UserInfo user, IFilesStorageProviderV30 provider, string directory) {
if(user == null) throw new ArgumentNullException("user");
return RetrieveDenialsForDirectory(AuthTools.PrepareUsername(user.Username), provider, directory);
}
/// <summary>
/// Gets all the actions for a directory that are denied to a subject.
/// </summary>
/// <param name="subject">The subject.</param>
/// <param name="provider">The provider.</param>
/// <param name="directory">The directory.</param>
/// <returns>The denied actions.</returns>
private static string[] RetrieveDenialsForDirectory(string subject, IFilesStorageProviderV30 provider, string directory) {
if(provider == null) throw new ArgumentNullException("provider");
if(directory == null) throw new ArgumentNullException("directory");
if(directory.Length == 0) throw new ArgumentException("Directory cannot be empty", "directory");
string resourceName = Actions.ForDirectories.ResourceMasterPrefix + AuthTools.GetDirectoryName(provider, directory);
AclEntry[] entries = SettingsProvider.AclManager.RetrieveEntriesForSubject(subject);
List<string> result = new List<string>(entries.Length);
foreach(AclEntry entry in entries) {
if(entry.Value == Value.Deny && entry.Resource == resourceName) {
result.Add(entry.Action);
}
}
return result.ToArray();
}
}
}