Adding Role-based Security in Oracle Visual Builder Cloud Service

Before You Begin

This 10 minute tutorial is the first in the Creating and Assigning Roles module.

Background

Oracle Visual Builder Cloud Service is a visual development tool for creating web and mobile applications by simply dragging and dropping UI components onto a page. You don't need any programming experience to develop an application.

In this tutorial,  you will enable role based security. Note that changes that you make to authentication and security are only applied after you stage the application. Any versions of your application that are currently staged or published will not be affected.

The images in this tutorial sequence show the standalone version of Oracle Visual Builder Cloud Service. If you are using the Oracle Integration Cloud version, you will see an additional menu at the top of each page that lets you switch between Visual Builder and Integration Cloud.

What Do You Need?

• Access to Oracle Visual Builder Cloud Service
• A supported browser (see Known Issues for Oracle Visual Builder Cloud Service for more information)

Enable Role-based Security

1. In the web browser, log in to Oracle Visual Builder Cloud Service.
2. On the Home page, open Charts Application 1.0.

   

3. Click the Main Menu icon in the top-left corner and open the Security page under Application Settings. Select Require Authentication in the Access pane, and select Allow anonymous access. Anonymous access will allow users who are not logged in to view parts of your application that you grant them access to.

   

4. Click New Role in the Roles pane.

   

5. In the Create Role dialog box, enter or select the following values:
   • Application Role Name: Salesperson
   • Maps to: Identity Domain Administrator
   • Description: Sales associate

   

6. Click Create.
7. Create another role in the same way you did in steps 4-6, and enter or select the following values:
   • Application Role Name: Sales Manager
   • Maps to: HRManager
   • Description: Sales manager

   

Role-based security is disabled by default. To enable role-based security you must configure the specific page, component or business object.

Secure Pages

In this section, you will secure two pages, allowing access only for certain roles, while leaving another page accessible by all roles, including anonymous users.

1. Open the Security page under Application Settings, if it is not already open.
2. In the Pages panel, enable role-based authentication for the Sales Objectives and Sales Regions pages by selecting each page’s Authentication Required checkbox. Ensure that the Summary page's Authentication Required checkbox is not enabled, to allow anyone access to this page.

   

3. The Pages panel lists each page in your application and the roles that can access the page. For each page, click in the Role text area. Select user roles from the dropdown list according to the following table:
   • Sales Objectives: Sales Manager, Salesperson
   • Summary: Anonymous access (Authentication Required checkbox should not be checked)
   • Sales Regions: Authenticated User, Sales Manager, Salesperson

   

Test the Secured Pages

1. Now return to the Page Designer, and click Test Application to preview the application in the Test mode.

   

2. Use the Who am I? role selector to preview your application as an anonymous user. Select only the Anonymous User check box, then click the icon to preview your application.

   

   As the anonymous user, you can see only the Summary page.

   

3. Now use the Who am I? role selector to also select the Authenticated User and preview the application.

   

   In addition to the Summary page, an authenticated user can view the Sales Regions page, but not the Sales Objectives page.
4. Use the Who am I? role selector and add the Sales Manager or Salesperson role, and preview the application.

   

   The Sales Manager and Salesperson roles can view all three pages of the application.