Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Introduction

2 Working with Sealed Content

• 2.1 Concepts
  • 2.1.1 Sealing
    • 2.1.1.1 Metadata: The Public Header
    • 2.1.1.2 Encrypted Content
  • 2.1.2 Unsealing
  • 2.1.3 Peeking
  • 2.1.4 Resealing
  • 2.1.5 Reclassification
• 2.2 Sealing Server
  • 2.2.1 Sealing Web Service
    • 2.2.1.1 Authentication
    • 2.2.1.2 Authorization
    • 2.2.1.3 MTOM
  • 2.2.2 Desktop Web Service
• 2.3 IRM Java API
  • 2.3.1 Runtime Configuration
    • 2.3.1.1 Storage Folder
    • 2.3.1.2 Device
    • 2.3.1.3 Application
    • 2.3.1.4 Key Store
  • 2.3.2 Enabling the IRM Java API
    • 2.3.2.1 Generating a Key
    • 2.3.2.2 Adding the Key to the Server
    • 2.3.2.3 AES Keys
    • 2.3.2.4 RSA Keys
    • 2.3.2.5 Setting the Password
  • 2.3.3 Authentication
    • 2.3.3.1 Using a java.net.Authenticator
  • 2.3.4 Advanced Topics
    • 2.3.4.1 Supplying Configuration Settings in Code
    • 2.3.4.2 Specifying Key and Key Store Passwords in Code
    • 2.3.4.3 Activating Code Plug-ins

3 Sealed Content Examples

• 3.1 Finding File Extensions
  • 3.1.1 File Extensions
  • 3.1.2 MIME Types
  • 3.1.3 Using the Sealing Server
    • 3.1.3.1 Finding the Corresponding Sealed File Name
    • 3.1.3.2 Obtaining Content Type Information
  • 3.1.4 Using the IRM Java API
    • 3.1.4.1 Finding the Corresponding Sealed File Name
    • 3.1.4.2 Obtaining Content Type Information
• 3.2 Sealing
  • 3.2.1 Sealing Using the Sealing Server
    • 3.2.1.1 Uploading Content
    • 3.2.1.2 Calling seal
    • 3.2.1.3 MIME Type
    • 3.2.1.4 Sealing Options
  • 3.2.2 Sealing Using the IRM Java API
    • 3.2.2.1 Unsealed Content Source
    • 3.2.2.2 Sealing Options
• 3.3 Peeking
  • 3.3.1 Peeking Using the Sealing Server
    • 3.3.1.1 Uploading Sealed Content
    • 3.3.1.2 Calling peek
    • 3.3.1.3 Calling validatedPeek
    • 3.3.1.4 Examining the Classification
    • 3.3.1.5 Reading Labels
    • 3.3.1.6 Accessing the Cookie
    • 3.3.1.7 Large Files
  • 3.3.2 Peeking Using the IRM Java API
    • 3.3.2.1 Calling peek
• 3.4 Resealing
  • 3.4.1 Resealing Using the Sealing Server
    • 3.4.1.1 Uploading Content
    • 3.4.1.2 Calling reseal
    • 3.4.1.3 Extracting the Content
  • 3.4.2 Resealing Using the IRM Java API
• 3.5 Reclassifying
  • 3.5.1 Reclassifying Using the Sealing Server
    • 3.5.1.1 Uploading Content
    • 3.5.1.2 Calling reclassify
    • 3.5.1.3 Extracting the Content
  • 3.5.2 Reclassifying Using the IRM Java API
• 3.6 Unsealing
  • 3.6.1 Unsealing Using the Sealing Sever
    • 3.6.1.1 Uploading Sealed Content
    • 3.6.1.2 Calling unseal
    • 3.6.1.3 Extracting the Content
  • 3.6.2 Unsealing Using the IRM Java API

4 Working with Domains, Contexts, Roles, and Rights

• 4.1 Concepts
  • 4.1.1 Domains
    • 4.1.1.1 DomainRef
    • 4.1.1.2 Domain
  • 4.1.2 Context Templates
    • 4.1.2.1 ContextTemplateRef
    • 4.1.2.2 ContextTemplate
  • 4.1.3 Contexts
    • 4.1.3.1 ContextInstanceRef
    • 4.1.3.2 ContextInstance
  • 4.1.4 Roles (Document Roles)
    • 4.1.4.1 DocumentRoleRef
    • 4.1.4.2 DocumentRole
  • 4.1.5 Rights (Document Rights)
    • 4.1.5.1 DocumentRightRef
    • 4.1.5.2 DocumentRight
• 4.2 Examples
  • 4.2.1 Creating a Context from a Template
    • 4.2.1.1 Calling createContextFromTemplate
  • 4.2.2 Searching for Journal Entries
    • 4.2.2.1 Calling searchJournal
  • 4.2.3 Assigning a Role
  • 4.2.4 Listing the Rights Assigned to a User or Group
  • 4.2.5 Unassigning a Role

5 Working with Users and Groups

• 5.1 The AccountRef Type
  • 5.1.1 About the AccountRef Type
  • 5.1.2 Creating an AccountRef Using a GUID
  • 5.1.3 Creating an AccountRef Using a User Name
  • 5.1.4 Creating an AccountRef Using a Group Name
• 5.2 Obtaining User and Group Names

6 Code Samples for Web Services

• 6.1 Web Services
• 6.2 Using JDeveloper Generated Web Services Proxies
  • 6.2.1 Introduction
  • 6.2.2 Using the Samples
  • 6.2.3 Generating a Web Service Proxy
  • 6.2.4 Creating a Domain
  • 6.2.5 Creating a Role
  • 6.2.6 Creating a Context Template
  • 6.2.7 Creating a Context
  • 6.2.8 Assigning a Role to a User
  • 6.2.9 Listing Rights Assigned to a User or Group
  • 6.2.10 Altering the Role Assigned to a User or Group
  • 6.2.11 Sealing a File
  • 6.2.12 Peeking a Sealed File
  • 6.2.13 Peeking a Sealed File and Checking the Digital Signature
  • 6.2.14 Changing Item Restrictions Associated with a Right
  • 6.2.15 Unassigning Rights Assigned to a User
  • 6.2.16 Reclassifying a File
  • 6.2.17 Resealing a File with Different Custom Data
  • 6.2.18 Unsealing a File
  • 6.2.19 Listing Classifications
  • 6.2.20 Searching the Context Journal Using Web Services
  • 6.2.21 Checking in Licenses
  • 6.2.22 Deleting a Domain
• 6.3 Using the Oracle IRM Web Service Code
  • 6.3.1 Introduction
  • 6.3.2 Class Path
  • 6.3.3 Differences from the JDeveloper Generated Code
  • 6.3.4 Creating a Domain
  • 6.3.5 Creating a Role
  • 6.3.6 Creating a Context Template
  • 6.3.7 Creating a Context
  • 6.3.8 Assigning a Role to a User
  • 6.3.9 Listing Rights Assigned to a User or Group
  • 6.3.10 Altering the Role Assigned to a User or Group
  • 6.3.11 Sealing a File
  • 6.3.12 Peeking a Sealed File
  • 6.3.13 Peeking a Sealed File and Checking the Digital Signature
  • 6.3.14 Changing Item Restrictions Associated with a Right
  • 6.3.15 Unassigning Rights Assigned to a User
  • 6.3.16 Reclassifying a File
  • 6.3.17 Resealing a File with Different Custom Data
  • 6.3.18 Unsealing a File
  • 6.3.19 Listing Classifications
  • 6.3.20 Searching the Context Journal Using Web Services
  • 6.3.21 Checking in Licenses
  • 6.3.22 Deleting a Domain

7 Code Samples for Java Applications

• 7.1 Introduction
• 7.2 Sealing a File
• 7.3 Peeking a Sealed File
• 7.4 Peeking a Sealed File and Checking the Digital Signature
• 7.5 Reclassifying a File
• 7.6 Resealing a File with Different Custom Data
• 7.7 Unsealing a File

8 Status Page Customization

• 8.1 Overview
• 8.2 Customizing Status Pages
  • 8.2.1 Redirection of Status Page Requests Using HTTP GET
  • 8.2.2 Redirection of Status Page Requests Using HTTP POST
• 8.3 Configuring Oracle IRM for Custom Status Pages
• 8.4 Creating Custom Status Pages Using the HTTP GET Method
• 8.5 Creating Custom Status Pages Using the HTTP POST Method
• 8.6 Reference Information and Examples
  • 8.6.1 List of Built-in Parameters
  • 8.6.2 List of Status Page Types
  • 8.6.3 List of URL Elements Available for Use in Custom Status Pages
  • 8.6.4 Example of Oracle IRM Desktop State in XML

9 Reference

• 9.1 Terminology
• 9.2 Feature Codes
• 9.3 Locale Codes

Index