Preface

This preface describes the document accessibility features and conventions used in this guide—Extensibility Guide for Oracle Web Services Manager.

Intended Audience

This manual is intended for software developers who are interested in creating custom assertions for Web services.

How to Use This Guide

This document describes the following:

About Policies and Assertions

• Learn about predefined policies and assertions

  For more information, see "Predefined Policies and Assertions" and "About Custom Assertions".

• Learn about parts and types of custom assertions

  For more information, see "Policies, Assertions, Expressions, and Operators" and "Types of Custom Assertions".

• Review the rules and restrictions about categories and bindings

  For more information, see"Understanding Assertion Categories" and "Rules for Binding of Custom Assertions".

• Review the lifecycle of a custom assertion

  For more information, see"Life Cycle of a Custom Assertion".

• Understand the types of custom assertions

  For more information, see"Types of Custom Assertions".

Creation of Custom Assertions

• Review the naming conventions for policies and assertions

  For more information, see "Naming Conventions for Policies and Assertions".

• Create the custom assertions

  For more information, see "Developing Custom Assertions for Web Service".

• Test the custom assertion

  For more information, see "Testing the Web Service".

• Generate a client policy from a Web service policy created using custom assertions

  For more information, see "Creating a Custom Client Policy with Custom Assertions".

Code Examples

• "IP Address Validation Custom Assertion Sample"

• "Encryption and Decryption Custom Assertion Sample"

• "Authentication Custom Assertion Sample"

Advanced Topics

• Implement advanced features:

  • input parameters to the assertion

  • access Oracle WSM context properties

  • access request, response, and fault message objects

  • access specific parts of a message based on XPath

  • access certificate used by container for SSL

  • access transport properties such as HTTP requests and responses

  • access CSF keys

  For more information, see "Implementing Advanced Features in Custom Assertions".

• Handling exceptions

  For more information, see "Handling Exceptions in Custom Assertions".

References

• XML schema for creating custom assertions

  For more information, see "Schema Reference for Custom Assertions".

• Java API reference for Oracle WSM

  For more information, see Java API Reference for Oracle Web Services Manager.

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/.

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/support/contact.html or visit http://www.oracle.com/accessibility/support.html if you are hearing impaired.

Related Documents

For more information, see the following manuals:

• Oracle Fusion Middleware Release Notes for Linux x86

• Oracle Fusion Middleware Release Notes for Microsoft Windows

• Oracle Fusion Middleware Security and Administrator's Guide

• Oracle Fusion Middleware Library on OTN

Conventions

The following text conventions are used in this document: