SHOW Signed SHOW CryptoExtensionAPI
 

net.rim.device.api.crypto.certificate.status
Interface ProviderResponseData


public interface ProviderResponseData

Encapsulates information to be received on the device from the proxy during a certificate status response. Provider plugins on the device can access information sent from the corresponding plugin on the proxy from this interface.

Category:
CryptoExtensionAPI: This element is part of the Crypto Extension API. These APIs are intended for parties interested in extending the security provider frameworks, such as integrating a new security medium.
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:
JDE 3.6.0
See Also:
ProviderRequestData

Method Summary
 Category: CryptoExtensionAPI Category: Signed  byte[] getCertField(Certificate cert, int tag)
          Returns the field identified by the given tag, associated with the specified certificate.
 Category: CryptoExtensionAPI Category: Signed  Enumeration getCertificates()
          Returns an enumeration containing all the certificates for which data exists in this response.
 Category: CryptoExtensionAPI Category: Signed  Object getContextObject()
          Returns the context object set during the request encoding process.
 Category: CryptoExtensionAPI Category: Signed  byte[] getGlobalField(int tag)
          Returns the value of the global field (for this response) associated with the given tag.
 Category: CryptoExtensionAPI Category: Signed  void setCertificateStatus(Certificate cert, CertificateStatus status)
          Sets the status of the given certificate (to be sent later to the certificate status listener, and potentially used to update the Key Store).
 

Method Detail

getCertField

public byte[] getCertField(Certificate cert,
                           int tag)
Returns the field identified by the given tag, associated with the specified certificate.

Parameters:
cert - The certificate associated with the field in question.
tag - An integer value (in the range 0 to 255) associated with the data field in question.
Returns:
A byte array containing the data field.
Since:
JDE 3.6.0
Category:
CryptoExtensionAPI: This element is part of the Crypto Extension API. These APIs are intended for parties interested in extending the security provider frameworks, such as integrating a new security medium.
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getCertificates

public Enumeration getCertificates()
Returns an enumeration containing all the certificates for which data exists in this response. This should, but may not, be identical to the list of certificates sent to the proxy. It should not include any additional certificates.

Returns:
An enumeration of Certificates.
Since:
JDE 3.6.0
Category:
CryptoExtensionAPI: This element is part of the Crypto Extension API. These APIs are intended for parties interested in extending the security provider frameworks, such as integrating a new security medium.
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getContextObject

public Object getContextObject()
Returns the context object set during the request encoding process.

Returns:
The context object.
Since:
JDE 3.6.0
Category:
CryptoExtensionAPI: This element is part of the Crypto Extension API. These APIs are intended for parties interested in extending the security provider frameworks, such as integrating a new security medium.
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getGlobalField

public byte[] getGlobalField(int tag)
Returns the value of the global field (for this response) associated with the given tag.

Parameters:
tag - An integer value (in the range 0 to 255) associated with the data field in question.
Returns:
A byte array containing the data field.
Since:
JDE 3.6.0
Category:
CryptoExtensionAPI: This element is part of the Crypto Extension API. These APIs are intended for parties interested in extending the security provider frameworks, such as integrating a new security medium.
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

setCertificateStatus

public void setCertificateStatus(Certificate cert,
                                 CertificateStatus status)
Sets the status of the given certificate (to be sent later to the certificate status listener, and potentially used to update the Key Store). This method MUST be called in order for the status of a given certificate to be set.

Parameters:
cert - The certificate of interest.
status - The status to assign to the certificate of interest.
Since:
JDE 3.6.0
Category:
CryptoExtensionAPI: This element is part of the Crypto Extension API. These APIs are intended for parties interested in extending the security provider frameworks, such as integrating a new security medium.
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.



Copyright 1999-2009 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.