Skip to Main Content
Return to Navigation

Configuring Content References and Components to Use the Security Authorization Service

This section discusses how to:

Understanding Configuring Content References and Components to Use the Security Authorization Service

When using the authorization service to authorize row-level access to data in a component or content reference, you must configure the content reference or component to use the authorization service.

If you are using the authorization service to provide basic object authorization to a component or content reference you do not need to perform this configuration and you can invoke the authorization service as you would any other service.

Configuring Content References to Use the Security Authorization Service

Use the Authorization Configuration page (PTCAC_AUTH_CONFIG) to map content references to security authorization services.

To access the page, select select PeopleTools, then select Security, then select Authorization Configuration. The following example shows the sections and fields that appear on the Authorization Configuration page when CREF is the content type. It is the default view of the page:

Image: Configuring a content reference to use the authorization service.

This example illustrates the fields and controls that appear on the Authorization Configuration page when CREF is the content type.

sm_auth_config_page_cref_01

Note: Note that the Status field is not currently used.

In the Content Reference Details section of the page select the content reference for which to configure for the service and the provider portal on which the content reference being authorized resides.

The Content Reference Details section features a Click here to select Content Reference link that you use to select the content reference. When you click the link the Select a Content Reference page (PTCAC_CRFURL_SELCT) appears as shown in the following example:

Image: Selecting the content reference for the authorization service

This example illustrates the fields and controls on the Selecting a Content Reference page.

sm_select_a_content_reference

Expand and collapse the folders on the page to select a content reference. The page also features an Include hidden Crefs check box. Select the check box to show and select from hidden content references. When you select a content reference, the system displays the Authorization Configuration page and it populates the component values for the content reference in the Component Details section. The following example shows the Authorization Configuration page after selecting a content reference on the Select a Content Reference page:

Image: Read-only component details of the content reference appear on the Authorization Configuration page.

This example illustrates the fields and controls on the Authorization Configuration page.

sm_auth_config_page_cref_02

The last configuration step is to use the Implementation App Class section of the page to define the details of the application class of the service.

To configure a content reference to use the authorization service:

  1. Access the Authorization Configuration page (select select PeopleTools, then select Security, then select Authorization Configuration).

  2. In the Content Type section, click the CREF radio button.

  3. In the Content Reference Details section:

    1. Click the Click here to Select Content Reference link.

      The Select a Content Reference page appears.

    2. Navigate to and click the content reference to map to the service.

      The Authorization Configuration page appears.

    3. In the Portal Name field, select the provider portal where the authorized content reference resides.

  4. In the Implementation App Class section, define the details of the application class for the service:

    1. In the Package Name field enter the package name.

    2. In the Path field enter the path.

    3. In the Class ID field enter the application class ID.

  5. Click the Save button.

Configuring Components to Use the Security Authorization Service

If you select Component as the content type, the fields that appear on the page are those with which you work to configure a component to use an authorization service.

Image: Authorization Configuration page after selecting a Component to map to an authorization service.

This example shows the Authorization Configuration page when the Content Type is set to Component.

sm_auth_config_page_component_01

Note: Note that the Status field is not currently used.

To configure a component to use the authorization service you must define the information about the component and the application class.

To configure a component to use the authorization service:

  1. Access the Authorization Configuration page (select select PeopleTools, then select Security, then select Authorization Configuration).

  2. In the Content Type section, click the Component radio button.

  3. In the Component Details section:

    1. From the Market drop-down list select a value.

    2. In the Menu Name field enter the name of the menu where the component resides.

    3. In the Component field, enter the name of the component.

  4. In the Implementation App Class section, define the details of the application class for the service:

    1. In the Package Name field enter the package name.

    2. In the Path field enter the path.

    3. In the Class ID field enter the application class ID.

  5. Click the Save button