Contents

Title and Copyright Information

Preface

• Intended Audience
• How to Use This Guide
• Documentation Accessibility
• Related Documents
• Conventions

1 Understanding Policies and Assertions

• 1.1 Predefined Policies and Assertions
• 1.2 Creating Policies
• 1.3 About Custom Assertions
  • 1.3.1 Policies, Assertions, Expressions, and Operators
  • 1.3.2 Understanding Assertion Categories
  • 1.3.3 Rules for Binding of Custom Assertions
  • 1.3.4 Life Cycle of a Custom Assertion
  • 1.3.5 Types of Custom Assertions

2 Creating Custom Assertions

• 2.1 Naming Conventions for Policies and Assertions
• 2.2 Developing Custom Assertions for Web Service
  • 2.2.1 Step 1: Create the Custom Assertion Executor
  • 2.2.2 Step 2: Create the Custom Policy File
  • 2.2.3 Step 3: Specify the Custom Assertion Executor
  • 2.2.4 Step 4: Create the JAR File
  • 2.2.5 Step 5: Add the Custom Policy to the Policy Store
  • 2.2.6 Step 6: Deploy the Custom Assertion
  • 2.2.7 Step 7: Attach the Custom Policy to a Web Service
  • 2.2.8 Step 8: Generate the Client
• 2.3 Testing the Web Service
• 2.4 Creating a Custom Client Policy with Custom Assertions

3 Stepping Through Sample Custom Assertions

• 3.1 Overview
• 3.2 IP Address Validation Custom Assertion Sample
  • 3.2.1 Code Samples
  • 3.2.2 Running This Sample
• 3.3 Encryption and Decryption Custom Assertion Sample
  • 3.3.1 Code Samples
  • 3.3.2 Running the Sample
• 3.4 Authentication Custom Assertion Sample
  • 3.4.1 Code Samples
  • 3.4.2 Running the Sample

4 Implementing Advanced Features in Custom Assertions

• 4.1 Inputting Parameters to Custom Assertions
• 4.2 Accessing Oracle WSM Context Properties
• 4.3 Accessing Request, Response, and Fault Message Objects
• 4.4 Accessing Parts of a Message Using XPath
• 4.5 Accessing Certificates Used by Container for SSL
• 4.6 Accessing Transport Properties
• 4.7 Accessing CSF Keys
• 4.8 Handling Exceptions in Custom Assertions

A Schema Reference for Custom Assertions

• A.1 Graphical Representation
• A.2 Element Descriptions
  • A.2.1 wsp:Policy
  • A.2.2 orasp:Assertion
  • A.2.3 orawsp:bindings
  • A.2.4 orawsp:Implementation
  • A.2.5 orawsp:Config
  • A.2.6 orawsp:PropertySet
  • A.2.7 orawsp:Property
  • A.2.8 orawsp:Description
  • A.2.9 orawsp:Value