|
Oracle Security Developer Tools S/MIME Java API Reference 10g (10.1.4.0.1) B28172-01 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
javax.mail.Multipart
javax.mail.internet.MimeMultipart
oracle.security.crypto.smime.SmimeMultipartSigned
A S/MIME Multipart Signed Message. A multipart signed message is intended for email clients that are not MIME aware.
Please do not create wrapped messages containing a multipart signed message.
Field Summary |
Fields inherited from class javax.mail.internet.MimeMultipart |
ds, parsed |
Fields inherited from class javax.mail.Multipart |
contentType, parent, parts |
Constructor Summary | |
SmimeMultipartSigned(javax.activation.DataSource ds) Create a new SmimeMultipartSigned by reading from a DataSource. |
|
SmimeMultipartSigned(javax.mail.internet.MimeBodyPart bodyPart, oracle.security.crypto.core.AlgorithmIdentifier digestAlgID) Create a new SmimeMultipartSigned with the given body and algorithm identifier. |
Method Summary | |
void |
addCertificate(oracle.security.crypto.cert.X509 cert) Add a Certificate. |
void |
addCRL(oracle.security.crypto.cert.CRL crl) Add a CRL. |
void |
addSignature(oracle.security.crypto.core.PrivateKey signerKey, oracle.security.crypto.cert.X509 signerCert) Add a Signature. |
void |
addSignature(oracle.security.crypto.core.PrivateKey signerKey, oracle.security.crypto.cert.X509 signerCert, oracle.security.crypto.core.AlgorithmIdentifier digestAlgID, oracle.security.crypto.cert.AttributeSet signedAttributes) Add a Signature. |
void |
addSignature(oracle.security.crypto.core.PrivateKey signerKey, oracle.security.crypto.cert.X509 signerCert, java.util.Date timeStamp) Add a Signature. |
void |
addSignature(oracle.security.crypto.core.PrivateKey signerKey, oracle.security.crypto.cert.X509 signerCert, java.util.Date timeStamp, SmimeCapabilities smimeCaps) Add a Signature. |
void |
addSignature(oracle.security.crypto.core.PrivateKey signerKey, oracle.security.crypto.cert.X509 signerCert, SmimeCapabilities smimeCaps) Add a Signature. |
java.lang.String |
generateContentType() Returns the content type. |
java.lang.String |
generateContentType(boolean useStandardContentTypes) Returns the content type. |
java.util.Vector |
getCertificates() Returns the list of X509 certificates included with this signed data object. |
java.lang.String |
getContentType() Returns the content type. |
java.util.Vector |
getCRLs() Returns the list of CRLs included with this signed data object. |
javax.mail.internet.MimeBodyPart |
getEnclosedBodyPart() Returns the message content that was signed. |
EquivalentLabels |
getEquivalentLabels(oracle.security.crypto.cert.X509 signerCert) Returns the EquivalentLabels if present or null . |
ESSSecurityLabel |
getESSSecurityLabel(oracle.security.crypto.cert.X509 signerCert) Returns the ESSSecurityLabel if present or null . |
MLExpansionHistory |
getMLExpansionHistory(oracle.security.crypto.cert.X509 signerCert) Returns the MLExpansionHistory attribute if present or null . |
ReceiptRequest |
getReceiptRequest(oracle.security.crypto.cert.X509 signerCert) Returns the ReceiptRequest attribute if present or null . |
SigningCertificate |
getSigningCertificate(oracle.security.crypto.cert.X509 signerCert) Returns the SigningCertificate Attribute if present or null . |
java.util.Enumeration |
signers() Returns the list of signers. |
protected void |
updateHeaders() |
void |
verify(oracle.security.crypto.cert.CertificateTrustPolicy trustPolicy) Verify the Signature using the specified trust policy. |
void |
verify(oracle.security.crypto.cert.CertificateTrustPolicy trustPolicy, javax.mail.Address[] senderAddresses) Verify the Signature using the specified trust policy and list of email addresses. |
void |
verifySignature(oracle.security.crypto.cert.X509 signerCert) Verify the Signature using the specified certificate. |
void |
verifySignature(oracle.security.crypto.cert.X509 signerCert, javax.mail.Address[] senderAddresses) Verify the Signature using the specified certificate and list of email addresses. |
void |
writeTo(java.io.OutputStream os, java.lang.String contentType) Writes this SmimeMultipartSigned to the given output stream. |
Methods inherited from class javax.mail.internet.MimeMultipart |
createInternetHeaders, createMimeBodyPart, createMimeBodyPart, getBodyPart, getBodyPart, getCount, parse, setSubType, writeTo |
Methods inherited from class javax.mail.Multipart |
addBodyPart, addBodyPart, getParent, removeBodyPart, removeBodyPart, setMultipartDataSource, setParent |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public SmimeMultipartSigned(javax.mail.internet.MimeBodyPart bodyPart, oracle.security.crypto.core.AlgorithmIdentifier digestAlgID) throws javax.mail.MessagingException
SmimeMultipartSigned
with the given body and algorithm identifier. Relevant canonicalizations, such as transforming text line-breaks to CRLF
, are applied to the body.bodyPart
- The message content.digestAlgID
- The digest algorithm.javax.mail.MessagingException
- An error occurred while setting the message content.public SmimeMultipartSigned(javax.activation.DataSource ds) throws javax.mail.MessagingException, java.io.IOException
SmimeMultipartSigned
by reading from a DataSource.ds
- The data source.java.io.IOException
- An I/O error error occurred or the message format is not correct.javax.mail.MessagingException
- An error occurred while initializing the message content.Method Detail |
public void addSignature(oracle.security.crypto.core.PrivateKey signerKey, oracle.security.crypto.cert.X509 signerCert) throws oracle.security.crypto.core.AlgorithmIdentifierException, oracle.security.crypto.core.InvalidKeyException, oracle.security.crypto.core.SignatureException
signerKey
- The private key of the signer.signerCert
- The X509 certificate of the signer.oracle.security.crypto.core.AlgorithmIdentifierException
- Algorithm is not supported.oracle.security.crypto.core.InvalidKeyException
- Private Key format is not valid.oracle.security.crypto.core.SignatureException
- An error occurred while adding the signature.public void addSignature(oracle.security.crypto.core.PrivateKey signerKey, oracle.security.crypto.cert.X509 signerCert, java.util.Date timeStamp) throws oracle.security.crypto.core.AlgorithmIdentifierException, oracle.security.crypto.core.InvalidKeyException, oracle.security.crypto.core.SignatureException
signerKey
- The private key of the signer.signerCert
- The X509 certificate of the signer.timeStamp
- The signingTime attriibute value.oracle.security.crypto.core.AlgorithmIdentifierException
- Algorithm is not supported.oracle.security.crypto.core.InvalidKeyException
- Private Key format is not valid.oracle.security.crypto.core.SignatureException
- An error occurred while adding the signature.public void addSignature(oracle.security.crypto.core.PrivateKey signerKey, oracle.security.crypto.cert.X509 signerCert, SmimeCapabilities smimeCaps) throws oracle.security.crypto.core.AlgorithmIdentifierException, oracle.security.crypto.core.InvalidKeyException, oracle.security.crypto.core.SignatureException
signerKey
- The private key of the signer.signerCert
- The X509 certificate of the signer.smimeCaps
- The SmimeCapabilities attribute value.oracle.security.crypto.core.AlgorithmIdentifierException
- Algorithm is not supported.oracle.security.crypto.core.InvalidKeyException
- Private Key format is not valid.oracle.security.crypto.core.SignatureException
- An error occurred while adding the signature.public void addSignature(oracle.security.crypto.core.PrivateKey signerKey, oracle.security.crypto.cert.X509 signerCert, java.util.Date timeStamp, SmimeCapabilities smimeCaps) throws oracle.security.crypto.core.AlgorithmIdentifierException, oracle.security.crypto.core.InvalidKeyException, oracle.security.crypto.core.SignatureException, javax.mail.MessagingException
signerKey
- The private key of the signer.signerCert
- The X509 certificate of the signer.timeStamp
- The signingTime attriibute value.smimeCaps
- The SmimeCapabilities attribute value.oracle.security.crypto.core.AlgorithmIdentifierException
- Algorithm is not supported.oracle.security.crypto.core.InvalidKeyException
- Private Key format is not valid.oracle.security.crypto.core.SignatureException
- An error occurred while adding the signature.javax.mail.MessagingException
public void addSignature(oracle.security.crypto.core.PrivateKey signerKey, oracle.security.crypto.cert.X509 signerCert, oracle.security.crypto.core.AlgorithmIdentifier digestAlgID, oracle.security.crypto.cert.AttributeSet signedAttributes) throws oracle.security.crypto.core.AlgorithmIdentifierException, oracle.security.crypto.core.InvalidKeyException, oracle.security.crypto.core.SignatureException, javax.mail.MessagingException
The contentType and messageDigest must not be present in the AttributeSet signedAttributes.
signerKey
- The private key of the signer.signerCert
- The X509 certificate of the signer.signedAttributes
- The set of Signed Attributes.oracle.security.crypto.core.AlgorithmIdentifierException
- Algorithm is not supported.oracle.security.crypto.core.InvalidKeyException
- Private Key format is not valid.oracle.security.crypto.core.SignatureException
- An error occurred while adding the signature.javax.mail.MessagingException
public void addCertificate(oracle.security.crypto.cert.X509 cert)
cert
- The X509 certificate.public void addCRL(oracle.security.crypto.cert.CRL crl)
crl
- The CRL.public javax.mail.internet.MimeBodyPart getEnclosedBodyPart() throws oracle.security.crypto.util.InvalidInputException, javax.mail.MessagingException
getEnclosedBodyPart
in interface SmimeSignedObject
MimeBodyPart
.oracle.security.crypto.util.InvalidInputException
- The message content type is not correct.javax.mail.MessagingException
- An error occurred while initializing the content.public java.util.Enumeration signers()
signers
in interface SmimeSignedObject
Vector
containing CMSSignerInfo
objects.public java.util.Vector getCertificates()
getCertificates
in interface SmimeSignedObject
Vector
containing X509
objects or null
if no list of certificates is present.public java.util.Vector getCRLs()
getCRLs
in interface SmimeSignedObject
Vector
containing CRL
objects or null
if no list of CRLs is present.public void verifySignature(oracle.security.crypto.cert.X509 signerCert) throws oracle.security.crypto.core.AuthenticationException, oracle.security.crypto.cms.UnknownSignerException
verifySignature
in interface SmimeSignedObject
signerCert
- The X509 certificate.oracle.security.crypto.core.AuthenticationException
- Signature verification failed.oracle.security.crypto.cms.UnknownSignerException
- The specified certificate does not belong to any of the message signers.public void verifySignature(oracle.security.crypto.cert.X509 signerCert, javax.mail.Address[] senderAddresses) throws oracle.security.crypto.core.AuthenticationException, oracle.security.crypto.cms.UnknownSignerException
verifySignature
in interface SmimeSignedObject
signerCert
- The X509 certificate.oracle.security.crypto.core.AuthenticationException
- Signature verification failed or the email address in the certificate did not match any in the email address list.oracle.security.crypto.cms.UnknownSignerException
- The specified certificate does not belong to any of the message signers.public void verify(oracle.security.crypto.cert.CertificateTrustPolicy trustPolicy) throws oracle.security.crypto.core.AuthenticationException
verify
in interface SmimeSignedObject
trustPolicy
- The certificate trust policy.oracle.security.crypto.core.AuthenticationException
- Signature verification failed.public void verify(oracle.security.crypto.cert.CertificateTrustPolicy trustPolicy, javax.mail.Address[] senderAddresses) throws oracle.security.crypto.core.AuthenticationException
verify
in interface SmimeSignedObject
oracle.security.crypto.core.AuthenticationException
- Signature verification failed or the email address in the certificate did not match any in the email address list.public ESSSecurityLabel getESSSecurityLabel(oracle.security.crypto.cert.X509 signerCert) throws oracle.security.crypto.core.AuthenticationException, oracle.security.crypto.cms.UnknownSignerException
ESSSecurityLabel
if present or null
.
The signature of the SignerInfo that covers the ESSSecurityLabel is first verified. Then, it verifies that all the ESSSecurityLabels in the signed message are identical.
getESSSecurityLabel
in interface SmimeSignedObject
oracle.security.crypto.core.AuthenticationException
- Signature verification did not succeed on any SignerInfo.oracle.security.crypto.cms.UnknownSignerException
- No valid security label could be found.public EquivalentLabels getEquivalentLabels(oracle.security.crypto.cert.X509 signerCert) throws oracle.security.crypto.core.AuthenticationException, oracle.security.crypto.cms.UnknownSignerException
EquivalentLabels
if present or null
.
The signature of the SignerInfo that covers the EquivalentLabels is first verified. Then, it verifies that all the EquivalentLabel's in the signed message are identical.
getEquivalentLabels
in interface SmimeSignedObject
oracle.security.crypto.core.AuthenticationException
- Signature verification did not succeed on any SignerInfo.oracle.security.crypto.cms.UnknownSignerException
- No valid equivalent labels could be found.public SigningCertificate getSigningCertificate(oracle.security.crypto.cert.X509 signerCert) throws oracle.security.crypto.core.AuthenticationException, oracle.security.crypto.cms.UnknownSignerException
SigningCertificate
Attribute if present or null
.
The signature of the SignerInfo that covers the SigningCertificate is verified.
getSigningCertificate
in interface SmimeSignedObject
oracle.security.crypto.core.AuthenticationException
- Signature verification did not succeed on any SignerInfo.oracle.security.crypto.cms.UnknownSignerException
- No valid signing certificate could be found.public MLExpansionHistory getMLExpansionHistory(oracle.security.crypto.cert.X509 signerCert) throws oracle.security.crypto.core.AuthenticationException, oracle.security.crypto.cms.UnknownSignerException
MLExpansionHistory
attribute if present or null
.
The signature of the SignerInfo that covers the MLExpansionHistory is first verified. Then, it verifies that all the MLExpansionHistory's in the signed message are identical.
getMLExpansionHistory
in interface SmimeSignedObject
oracle.security.crypto.core.AuthenticationException
- Signature verification did not succeed on any SignerInfo.oracle.security.crypto.cms.UnknownSignerException
- No valid mailing list expansion history could be found.public ReceiptRequest getReceiptRequest(oracle.security.crypto.cert.X509 signerCert) throws oracle.security.crypto.core.AuthenticationException, oracle.security.crypto.cms.UnknownSignerException
ReceiptRequest
attribute if present or null
.
The signature of the SignerInfo that covers the ReceiptRequest is first verified. Then, it verifies that all the ReceiptRequest's in the signed message are identical.
getReceiptRequest
in interface SmimeSignedObject
oracle.security.crypto.core.AuthenticationException
- Signature verification did not succeed on any SignerInfo.oracle.security.crypto.cms.UnknownSignerException
- No valid receipt request could be found.public java.lang.String generateContentType(boolean useStandardContentTypes)
generateContentType
in interface SmimeObject
useStandardContentTypes
- If true
the standard content type is generated; If false
the experimental content type is generated.public java.lang.String generateContentType()
generateContentType
in interface SmimeObject
public java.lang.String getContentType()
protected void updateHeaders()
public void writeTo(java.io.OutputStream os, java.lang.String contentType) throws java.io.IOException, javax.mail.MessagingException
SmimeMultipartSigned
to the given output stream.writeTo
in interface SmimeObject
os
- The output stream to which this SmimeMultipartSigned
will be written.contentType
- The content type for this SmimeMultipartSigned
.javax.mail.MessagingException
- An error occurred while writing the smime message.java.io.IOException
- An I/O error occurred.
|
Oracle Security Developer Tools S/MIME Java API Reference 10g (10.1.4.0.1) B28172-01 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |