21.5.5 Editing an Authorization Scheme

Learn how to edit an authorization scheme.

• Editing Attributes of an Existing Authorization Scheme
  Edit attributes of an existing authorization scheme.
• Changing the Evaluation Point Attribute
  Control when an authorization scheme is validated using the Evaluation Point, Validate authorization scheme attribute.
• Subscribing to an Authorization Scheme
  Subscribe to an authorization scheme on the Authorization Schemes, Edit page.
• About Resetting Authorization Scheme State
  Call an API to reset a session's authorization scheme state.

21.5.5.1 Editing Attributes of an Existing Authorization Scheme

Edit attributes of an existing authorization scheme.

To edit attributes of an existing authorization scheme:

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

   The Shared Components page appears.

4. Under Security, select Authorization Schemes.

   The Authorization Schemes page appears. By default, each scheme displays as an icon. You can customize the appearance the page using the Search bar at the top of the page.

5. Select an authorization scheme.
6. Edit the appropriate attributes.

   To learn more, see field-level Help.

7. To save your changes, click Apply Changes.

21.5.5.2 Changing the Evaluation Point Attribute

Control when an authorization scheme is validated using the Evaluation Point, Validate authorization scheme attribute.

Authorization schemes are evaluated on first use in a session. The Validate authorization scheme attribute controls if future uses cause re-evaluations and when a memorized result can be taken instead.

To change the authorization scheme evaluation point:

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

   The Shared Components page appears.

4. Under Security, select Authorization Schemes.

   The Authorization Schemes page appears.

   By default, each scheme displays as an icon. You can customize the appearance the page using the Search bar at the top of the page.

5. Select an authorization scheme.
6. Scroll down to Evaluation Point and edit the Validate authorization scheme attribute. Options include:

   • Once per session - Evaluate only once and always use the memorized result afterwards.

   • Once per page view - Evaluate once for each request that is processed. Use the memorized result if the authorization scheme is referenced in more than one component on the page.

   • Once per component - Evaluate once for each component that references the authorization scheme, but save the result in the session. Further requests to render or process the scheme use the result that was memorized for the component.

   • Always (No Caching) - The authorization scheme will always be evaluated.

   To learn more, see field-level Help.

7. To save your changes, click Apply Changes.

Tip:

The default value Once per session is the most efficient. You should choose another value if the authorization check depends on changing session state or other factors that are not consistent over an entire session.

21.5.5.3 Subscribing to an Authorization Scheme

Subscribe to an authorization scheme on the Authorization Schemes, Edit page.

Subscriptions enable developers to reuse shared components across several applications in a workspace. To learn more about shared component subscriptions, see Using Shared Component Subscriptions.

Tip:

You can also subscribe to an authorization schemes by copying it and then subscribing. See Copying or Subscribing to an Authorization Scheme.

To subscribe to an authorization scheme

1. Navigate to the Authorization Schemes page:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. On the Application home page, click Shared Components.

      The Shared Components page appears.

   4. Under Security, click Authorization Schemes.

   The Authorization Schemes page appears. Note that the report includes the following columns: Subscribed From, Subscription Status, and Subscribers.

2. Select an authorization scheme.

   The Edit page appears.

3. To subscribe to an authorization scheme:
   1. Find the Subscription region.
   2. Subscription, Subscribe From - Select an application whose authorization scheme you want this scheme to subscribe to and click Apply Changes.

      When you select a master authorization scheme and click Apply Changes, the subscribed shared component are be automatically refreshed from the selected master

   Tip:

   You can also subscribe to a shared component during the copy process.
4. To refresh an authorization scheme:
   1. Find the Subscription region.
   2. Subscription, Refresh Scheme - If the authentication scheme is already subscribed, click Refresh Scheme.
   3. Click Apply Changes.
5. To unsubscribe an authorization scheme:
   1. Find the Subscription region.
   2. Subscription, Unsubscribe - Click Unsubscribe.

21.5.5.4 About Resetting Authorization Scheme State

Call an API to reset a session's authorization scheme state.

If an authorization scheme is validated once for each session, Oracle APEX caches the validation results in each user's session cache. You can reset a session's authorization scheme state by calling the APEX_AUTHORIZATION.RESET_CACHE API.

See Also:

APEX_AUTHORIZATION.RESET_CACHE Procedure in Oracle APEX API Reference