Preface

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"Supported Custom 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".

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 OWSM 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 OWSM

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

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Related Documents

For more information, see the following manuals:

• "Web Services" in Release Notes for Oracle Fusion Middleware Infrastructure

• Administering Web Services

• Oracle Fusion Middleware Library

Conventions

The following text conventions are used in this document: