How to: Enable Roles in Open Ria Services
[ This document was written for WCF Services Version 1 Service Pack 2 and might not be up to date
Please see Release Notes or Changelog for a list of changes since WCF RIA Services ]
This topic demonstrates how to enable roles in your Open Ria Services solution if you have previously enabled authentication. You can retrieve a user’s roles only after the user has been authenticated. To configure your solution for authentication, see How to: Enable Authentication in Open Ria Services. You restrict access to a domain operation to members of a role by applying the RequiresRoleAttribute attribute to the method for the domain operation.
Roles are used to specify which group of authenticated users can access certain resources. Roles in Open Ria Services build upon roles in ASP.NET. For more information about roles, see Understanding Role Management.
- 1.In the server project, open the Web.config file.
- 2.In the \ section, enable the manager role by adding the \ element.The following example shows how to enable the manager role.<system.web><authentication mode="Forms"></authentication><roleManager enabled="true"></roleManager></system.web>
- 3.In the membership database, create the required roles and assign users to the roles as needed.For more information, see Understanding Role Management. For an example of creating roles, see Walkthrough: Using Authentication Service with Silverlight Business Application or Walkthrough: Using Authentication Service with Silverlight Navigation Application.
- 4.To restrict access to a domain operation to only members of a specified role, apply the RequiresRoleAttribute attribute to the domain operation.The following example specifies that only members of the Managers role can access the domain operation.<RequiresRole("Managers")> _Public Function GetCustomers() As IQueryable(Of Customer)Return Me.ObjectContext.CustomersEnd Function[RequiresRole("Managers")]public IQueryable<Customer> GetCustomers(){return this.ObjectContext.Customers;}
- 1.To check whether the user belongs to the required role, access the Roles property or call the IsInRole method on the WebContext.Current.User object.The following example checks whether the user belongs to a role named Managers before calling the domain operation.Private Sub LoadRestrictedReports()Dim loadSales = context.Load(context.GetSalesOrderHeadersQuery().Take(numberOfRows))SalesOrdersGrid.ItemsSource = loadSales.EntitiesSalesOrdersGrid.Visibility = System.Windows.Visibility.VisibleIf (WebContext.Current.User.IsInRole("Managers")) ThenDim loadCustomers = context.Load(context.GetCustomersQuery().Take(numberOfRows))CustomersGrid.ItemsSource = loadCustomers.EntitiesCustomersGrid.Visibility = System.Windows.Visibility.VisibleElseCustomersGrid.Visibility = System.Windows.Visibility.CollapsedEnd IfEnd Subprivate void LoadRestrictedReports(){LoadOperation<SalesOrderHeader> loadSales = context.Load(context.GetSalesOrderHeadersQuery().Take(numberOfRows));SalesOrdersGrid.ItemsSource = loadSales.Entities;SalesOrdersGrid.Visibility = System.Windows.Visibility.Visible;if (WebContext.Current.User.IsInRole("Managers")){LoadOperation<Customer> loadCustomers = context.Load(context.GetCustomersQuery().Take(numberOfRows));CustomersGrid.ItemsSource = loadCustomers.Entities;CustomersGrid.Visibility = System.Windows.Visibility.Visible;}else{CustomersGrid.Visibility = System.Windows.Visibility.Collapsed;}}
- 2.If you want to make the WebContext object available in XAML, add the current WebContext instance to the application resources in the Application.Startup event before creating the root visual.The following example shows how to add the WebContext instance as an application resource.Private Sub Application_Startup(ByVal o As Object, ByVal e As StartupEventArgs) Handles Me.StartupMe.Resources.Add("WebContext", WebContext.Current)Me.RootVisual = New MainPage()End Subprivate void Application_Startup(object sender, StartupEventArgs e){this.Resources.Add("WebContext", WebContext.Current);this.RootVisual = new MainPage();}