|
Oracle® Information Rights Management Server Java API Reference 11g Release 1 (11.1.1) E12907-03 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface SealingServices
Sealing, unsealing, resealing and peeking services for content. Sealing is the process of taking unprotected content, encrypting it and adding in meta data called a classification. Unsealing is the term used when sealed content is decrypted. Resealing is the term used when altering the sealed content meta data or classification. Peeking is the term given to the process of extracting meta data from sealed content without decrypting the content.
The methods on the sealing services are designed to used remotely, where the content is sent to a server, processes and the results returned to the client.
The sealing services support the MTOM (Message Transmission Optimization Mechanism) feature. This allows the services to transfer the binary sealed and unsealed content in the most optimal form available. When sending content to using the sealing services it is recommended to enable MTOM in the client web service stack.
The methods on SealingServices can be invoked using SealingServicesInstance
.
Method Summary | |
---|---|
ContentDescription |
peek(InputStream input) Peek sealed content. |
InputStream |
reclassify(InputStream input, Classification classification) Re-classify sealed content. |
InputStream |
reseal(InputStream input, Collection<CustomData> customData) Reseal content with new custom data. |
InputStream |
seal(InputStream stream, String mimeType, SealingOptions options) Seal content. |
InputStream |
unseal(InputStream input) Unseal a stream into an output stream. |
ContentDescription |
validatedPeek(InputStream input) Peek sealed content (with validation of the signature). |
Method Detail |
---|
InputStream seal(InputStream stream, String mimeType, SealingOptions options) throws UnsupportedContentTypeException, IllegalEncryptedContentBlockSizeException, PublicHeaderLengthException, IOException, AuthorizationDeniedException
Classification
.ItemCode
if one is not specified in the classification details.Feature
for the Classification
specified in the sealing options.stream
- the data stream.mimeType
- the unsealed or sealed MIME type of the data provided in the stream. The stream is assumed to contain unsealed data. It is advisable to use the sealed MIME type; this ensures the sealed content content type is unambiguous. e.g. the {text/plain} content type can be sealed as sealed text or sealed email. If the {text/plain} MIME type is specified the content will be sealed as sealed text.options
- the sealing options.UnsupportedContentTypeException
- unsupported MIME type. The MIME type is not a supported sealable content type.IllegalEncryptedContentBlockSizeException
- illegal encrypted content block size specified in the sealing options.PublicHeaderLengthException
- the classification and custom data exceeds the maximum permitted size.IOException
- an input/output/sealing error occurred sealing the content.AuthorizationDeniedException
- thrown if sealing content using the provided classification is not allowed.InputStream unseal(InputStream input) throws ContentParseException, IOException, AuthorizationDeniedException
Feature
for the content's Classification
.input
- sealed data.ContentParseException
- indicates that there was an issue parsing the sealed content. The exception will contains a reason that identifies which section of the sealed content which caused the parsing to fail.IOException
- an input/output/sealing error occurred unsealing the content.AuthorizationDeniedException
- thrown if unsealing for the classification is not allowed.InputStream reseal(InputStream input, Collection<CustomData> customData) throws ContentParseException, IOException, AuthorizationDeniedException
Feature
for the content's Classification
.input
- sealed data.customData
- the new custom data. This parameter is optional, it is valid to pass null or an empty collection.ContentParseException
- indicates that there was an issue parsing the sealed content. The exception will contains a reason that identifies which section of the sealed content which caused the parsing to fail.IOException
- an input/output/sealing error occurred resealing the content.AuthorizationDeniedException
- thrown if resealing for the classification is not allowed.InputStream reclassify(InputStream input, Classification classification) throws ContentParseException, IOException, AuthorizationDeniedException
Classification
of the sealed content without having to perform a two step unseal and seal. During re-classification the content is re-encrypted and re-signed.Id
matches the classification returned by the server. If no key set is provided then the key set is filled in from the license used to perform the sealing operation. If the license specifies multiple key sets then the first key set in the license is used.Feature
. The target classification license must allow the oracle.irm.generic.Seal feature. If the source license has a copy to feature the transformation is only permitted if target classification is allowed by the trusted Destinations
of the source classification license. If the source license has a save unsealed feature then there are no restrictions on the target classification.input
- sealed data.classification
- new classification.ContentParseException
- indicates that there was an issue parsing the sealed content. The exception will contains a reason that identifies which section of the sealed content which caused the parsing to fail.IOException
- an input/output/sealing error occurred reclassifying the content.AuthorizationDeniedException
- thrown if reclassification from the source to target classification is not allowed.ContentDescription peek(InputStream input) throws ContentParseException, IOException
Classification
as well as information such as the CreationTime
.input
- sealed data.ContentParseException
- indicates that there was an issue parsing the sealed content. The exception will contains a reason that identifies which section of the sealed content which caused the parsing to fail.IOException
- an input/output/sealing error occurred peeking the content.ContentDescription validatedPeek(InputStream input) throws ContentParseException, IOException, AuthorizationDeniedException
Feature
for the content's Classification
.input
- sealed data.ContentParseException
- indicates that there was an issue parsing the sealed content. The exception will contains a reason that identifies which section of the sealed content which caused the parsing to fail.IOException
- an input/output/sealing error occurred peeking the content.AuthorizationDeniedException
- thrown if peeking the classification is not allowed.
|
Oracle® Information Rights Management Server Java API Reference 11g Release 1 (11.1.1) E12907-03 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |