21.5.4 Attaching an Authorization Scheme to an Application, Page, or Components

Attach an authorization scheme to an entire application, page, control, or component.

Tip:

Before you can attach an authorization scheme to an application, page, control, or component, you must first create it. See Creating an Authorization Scheme.

• Attaching an Authorization Scheme to an Application
  Learn how to attach an authorization scheme to an application.
• Attaching an Authorization Scheme to a Page
  Learn how to attach an authorization scheme to a page.
• Attaching an Authorization Scheme to a Control or Component
  Learn how to attach an authorization scheme to a control or component.

21.5.4.1 Attaching an Authorization Scheme to an Application

Learn how to attach an authorization scheme to an application.

To attach an authorization scheme to an application:

1. On the Workspace home page, click the App Builder icon.
2. Select an application.
3. Click the Shared Components icon.

   The Shared Components page appears.

4. Under Security, click Security Attributes.
5. Configure Authorization attributes:
   1. Scroll down to Authorization.
   2. Authorization Scheme - Specify an authorization scheme for your application. Application authorization schemes are defined for an application for the purpose of controlling access. Setting a required authorization scheme here at the application level will require all pages of the application to pass the defined authorization check.
   3. Run on Public Pages - Controls whether the application-level authorization scheme is checked on public pages (that is, pages that do not require authorization). Options include:
      • On - If you select On and the page is public, the application authorization is checked.
      • Off - If you select Off and the page is public, the application authorization is ignored.

      Note:

      This attribute is ignored if you select the Authorization Scheme, Must Not Be Public User.
   4. Run on Background Job - Controls whether the authorization schemes at application, page, region and column level are checked in the background job such as interactive report subscriptions. Options include:
      • On - If you select On, the authorization is checked.
      • Off - If you select Off, the authorization is ignored.

      Note:

      The Run on Background Job authorization check uses cloned session state instead of the current session state. The cloned session state does NOT include collection, report settings nor session state set during the post authentication process. The authorization check may fail if session state in cloned session is not found.
   5. Source for Role or Group Schemes - Define what Oracle APEX should use as the source for authorization schemes of type Is In Role or Group. To learn more, see field-level Help.
6. Click Apply Changes to save your changes..

21.5.4.2 Attaching an Authorization Scheme to a Page

Learn how to attach an authorization scheme to a page.

To attach an authorization scheme to a page:

1. On the Workspace home page, click the App Builder icon.
2. Select an application.
3. Select a page.
   Page Designer appears.
4. In the Rendering tab on the left side, click the page title at the top of the tree.
5. In the Property Editor, locate Security and make a selection from the Authorization Scheme attribute.

   Tip:

   To find a group or attribute:

   • Search for the group or attribute - Enter keywords in the Filter Properties field. The Property Editor displays the group or attributes. To return to the default display, delete the keywords.

   • Use Go to Group - Click Go to Group and select the group. To return the default display, click Go to Group again and select Expand All.

6. Click Save.

21.5.4.3 Attaching an Authorization Scheme to a Control or Component

Learn how to attach an authorization scheme to a control or component.

To attach an authorization scheme to a page component or control:

1. On the Workspace home page, click the App Builder icon.
2. Select an application.
3. Select a page.
   Page Designer appears.
4. Select the component or control to which you want to apply the authorization scheme.
5. In the Property Editor, locate Security and make a selection from the Authorization Scheme attribute.

   Tip:

   To find a group or attribute:

   • Search for the group or attribute - Enter keywords in the Filter Properties field. The Property Editor displays the group or attributes. To return to the default display, delete the keywords.

   • Use Go to Group - Click Go to Group and select the group. To return the default display, click Go to Group again and select Expand All.

6. Click Save.