# System Administrator’s Guide

# Managing the Policy Service

The following section describes how to manage the Policy Service in Oracle Communications Services Gatekeeper:

- Introduction
- Configuration workflow
- Reference: Attributes and Operations for PolicyService

## Introduction

The Policy Service is responsible for the provisioning of rules into the rules engine. The rules engine can perform some of the policy evaluation of requests flowing through Oracle Communications Services Gatekeeper. The Policy Service uses rules written in the policy evaluation language IRL, the Ilog Rules Language. The rules operate on data originating in the requests.

Management of the Policy Service mainly involves loading and deleting rules.

A rule file has an ID, that is given when it is loaded into persistent storage. Rule evaluation is performed if this ID corresponds to the plug-in type associated with the request. If there is no match the rule file with the ID DEFAULT is used. Rules exists on two levels, service provider- and application level.

The rules are enforced by a service interceptor, EvaluateILOGPolicy.

## Configuration workflow

No configuration is necessary.

## Reference: Attributes and Operations for PolicyService

Managed object: Container ServicesPolicyService

MBean: com.bea.wlcp.wlng.policy.PolicyServiceMBean

Below is a list of attributes and operations for configuration and maintenance.

- Operation: deleteApplicationRuleFile
- Operation: deleteServiceProviderRuleFile
- Operation: listApplicationRuleFiles
- Operation: listServiceProviderRuleFiles
- Operation: loadApplicationRules
- Operation: loadServiceProviderRules
- Operation: viewApplicationRuleFile
- Operation: viewServiceProviderRuleFile

### Operation: deleteApplicationRuleFile

Deletes a rule file on the application group level.

Signature:

    deleteApplicationRuleFile(serviceName: String)

Table 15-1 deleteApplicationRuleFile
deleteApplicationRuleFile
Parameter | Description
--- | ---
serviceName | ID of the rule file, same as the plug-in type.

### Operation: deleteServiceProviderRuleFile

Deletes a rule file on the service provider group level.

Signature:

    deleteServiceProviderRuleFile(serviceName: String)

Table 15-2 deleteServiceProviderRuleFile
deleteServiceProviderRuleFile
Parameter | Description
--- | ---
serviceName | ID of the rule file, same as the plug-in type.

### Operation: listApplicationRuleFiles

Displays the IDs of all application group rule files.

Signature:

    listApplicationRuleFiles()

Table 15-3 listApplicationRuleFiles
listApplicationRuleFiles
Parameter | Description
--- | ---
- | -

### Operation: listServiceProviderRuleFiles

Displays the IDs of all service provider group rule files.

Signature:

    listServiceProviderRuleFiles()

Table 15-4 listServiceProviderRuleFiles
listServiceProviderRuleFiles
Parameter | Description
--- | ---
- | -

### Operation: loadApplicationRules

Loads a rule file on the application group level.

Signature:

    loadApplicationRules(serviceName: String)

Table 15-5 loadApplicationRules
loadApplicationRules
Parameter | Description
--- | ---
irlUrl | URL to the rule file.
serviceName | ID of the rule file, same as the plug-in type.

### Operation: loadServiceProviderRules

Loads a rule file on the service provider group level.

Signature:

    loadServiceProviderRules(serviceName: String)

Table 15-6 loadServiceProviderRules
loadServiceProviderRules
Parameter | Description
--- | ---
irlUrl: | URL to the rule file.
serviceName | ID of the rule file, same as the plug-in type.

### Operation: viewApplicationRuleFile

Displays the contents of a rule file on the application group level.

Signature:

    viewApplicationRuleFile(serviceName: String)

Table 15-7 viewApplicationRuleFile
viewApplicationRuleFile
Parameter | Description
--- | ---
serviceName | Name of the service for which the rule file is applied.

### Operation: viewServiceProviderRuleFile

Displays the contents of a rule file on the service provider group level.

Signature:

    viewServiceProviderRuleFile(serviceName: String)

Table 15-8 viewServiceProviderRuleFile
viewServiceProviderRuleFile
Parameter | Description
--- | ---
serviceName | Name of the service for which the rule file is applied.