//
-// Open Service Platform
// Copyright (c) 2013 Samsung Electronics Co., Ltd.
//
// Licensed under the Apache License, Version 2.0 (the License);
/**
* @class Pkcs05PbKdf2Parameters
- * @brief This class implements the functionalities specified by the Pkcs05 KDF2 scheme. PBKDF2 applies a pseudo random function to derive
- * keys. The length of the derived key is essentially unbounded. However, the maximum effective search space for the derived key may
- * be limited by the structure of the underlying pseudorandom function.
+ * @brief This class provides methods for the functionalities specified by the PKCS05 KDF2 scheme.
*
- * It is defined in ASN.1 as:
+ * @since 2.1
+ *
+ * The %Pkcs05PbKdf2Parameters class provides methods for the functionalities specified by the PKCS05 KDF2 scheme. PBKDF2 applies a pseudo
+ * random function to derive keys. The length of the derived key is essentially unbounded. However, the maximum effective search
+ * space for the derived key can be limited by the structure of the underlying pseudo random function.
*
+ * This is defined in ASN.1 as demonstrated in the following code:
+ * @code
* PBKDF2-params ::= SEQUENCE {
* salt CHOICE {
* specified OCTET STRING,
* keyLength INTEGER (1..MAX) OPTIONAL,
* prf AlgorithmIdentifier {{PBKDF2-PRFs}} DEFAULT
* algid-hmacWithSHA1 }
- * @since 2.1
+ * @endcode
*
*/
virtual ~Pkcs05PbKdf2Parameters(void);
/**
- * Initializes this instance of %Pkcs05PbKdf2Parameters with the encoded Bytebuffer which contain password based @n
- * key derivation function parameters structure(PBKDF2) in ASN.1 DER format.
- *
+ * Initializes this instance of %Pkcs05PbKdf2Parameters with the encoded Tizen::Base::ByteBuffer that contains Password
+ * Based Key Derivation Function parameters structure(PBKDF2) in ASN.1 DER format.
+ *
* @since 2.1
*
* @return An error code
- * @param[in] encodedData DER encoded ByteBuffer of Pkcs05PbKdf2Parameters.
- * @exception E_SUCCESS The method is successful.
+ * @param[in] encodedData The DER encoded Tizen::Base::ByteBuffer of %Pkcs05PbKdf2Parameters
+ * @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& encodedData);
/**
- * Initializes the %Pkcs05PbKdf2Parameters with supplied input parameters values.
+ * Initializes the %Pkcs05PbKdf2Parameters with the specified input parameters values.
*
* @since 2.1
*
* @return An error code
- * @param[in] saltBuffer An instance of ByteBuffer, holding salt value.
- * @param[in] iterationCount Integer value holding the positive integer specifying iteration count
- * for generation of password based key.
- * @param[in] derivedKeyLength Positive integer specifying length of password based key to be generated.
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
- * @remark In this case when pseudo random function algorithm is not passed then default HMAC-SHA1 will be used.
+ * @param[in] saltBuffer An instance of Tizen::Base::ByteBuffer holding salt value
+ * @param[in] iterationCount The positive integer specifying iteration count for generation of password based key
+ * @param[in] derivedKeyLength The positive integer specifying the length of the password based key
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @remarks In this case, when pseudo random function algorithm is not passed, then default HMAC-SHA1 will be used.
*/
result Construct(const Tizen::Base::ByteBuffer& saltBuffer, int iterationCount, int derivedKeyLength = 0);
/**
- * Initializes the %Pkcs05PbKdf2Parameters with supplied input parameters values.
+ * Initializes this %Pkcs05PbKdf2Parameters instance with the specified input parameters values.
*
* @since 2.1
*
* @return An error code
- * @param[in] saltBuffer An instance of ByteBuffer, holding salt value.
- * @param[in] iterationCount Integer value holding the positive integer specifying iteration count
- * for generation of password based key.
- * @param[in] prf An instance of AlgorithIdentifier, holding the underlying pseudo-random function to use for
- * generation of password based key.
- * @param[in] derivedKeyLength Positive integer specifying length of password based key to be generated.
- * @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @param[in] saltBuffer An instance of Tizen::Base::ByteBuffer holding salt value
+ * @param[in] iterationCount The positive integer specifying iteration count for generation of password based key
+ * @param[in] prf The AlgorithIdentifier instance holding the underlying pseudo random function to use
+ * to generate a password based key
+ * @param[in] derivedKeyLength The positive integer specifying the length of the password based key
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& saltBuffer, int iterationCount, const AlgorithmIdentifier& prf, int derivedKeyLength = 0);
/**
- * Gets the encoded form of the Pkcs05PbKdf2Parameters.
- * It is assumed that each Pkcs05PbKdf2Parameters will have only a single form of encoding example ASN.1 DER.
+ * Gets the encoded form of the %Pkcs05PbKdf2Parameters instance. @n
+ * It is assumed that each %Pkcs05PbKdf2Parameters will have only a single form of encoding, for example: ASN.1 DER.
*
* @since 2.1
*
- * @return A pointer to the ByteBuffer class that contains the output, @n
- * else @c null if an error occurs.
+ * @return A pointer to the Tizen::Base::ByteBuffer instance that contains the output, @n
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
Tizen::Base::ByteBuffer* GetEncodedDataN(void) const;
/**
- * Get the salt byte buffer.
+ * Gets the salt byte buffer.
*
* @since 2.1
*
- * @return A reference to Salt ByteBuffer Containing the specified salt value.
+ * @return A reference to the Tizen::Base::ByteBuffer instance containing the specified salt value
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
const Tizen::Base::ByteBuffer& GetSaltValue(void) const;
/**
- * Get the iteration count.
- * The purpose of this count is to increase the cost of producing keys from a password, thereby also increasing the difficulty of attack.
+ * Gets the iteration count. @n
+ * The purpose of this count is to increase the cost of producing keys from a password, thereby, also increasing the difficulty of attack.
*
* @since 2.1
*
- * @return An integer value containing the iteration count for PBKDF2.
+ * @return An integer value containing the iteration count for PBKDF2
*
*/
int GetIterationCount(void) const;
/**
- * Get the derived key length.
- * This API will return the length of the derived key that will be used for generating the password based key.
+ * Gets the derived key length. @n
+ * The %GetDerivedKeyLength() method returns the length of the derived key that is used to generate the password based key.
*
* @since 2.1
*
- * @return An integer value containing the length of the derived key.
+ * @return An integer value containing the length of the derived key
*
*/
int GetDerivedKeyLength(void) const;
/**
- * Get the reference to the Algorithm Identifier which identifies the underlying pseudo random function.
+ * Gets a reference to AlgorithmIdentifier that identifies the underlying pseudo random function.
*
* @since 2.1
*
- * @return A reference to AlgorithmIdentifier Containing the algorithm identifier of underlying pseudo random function.
+ * @return A reference to AlgorithmIdentifier containing the algorithm identifier of underlying pseudo random function
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
const AlgorithmIdentifier& GetPrf(void) const;
/**
*
- * Get the pointer to the AlgorithmParameters which identifies the underlying Parameters like PbKdf2,PbEs2,PbMac1.
- * For this class AlgorithmParameters will be of PbKdf2 type.
+ * Gets a pointer to AlgorithmParameters that identifies the underlying parameters such as PbKdf2,PbEs2,PbMac1. @n
+ * For this class, %AlgorithmParameters will be of PbKdf2 type.
*
* @since 2.1
*
- * @return Pointer to IAlgorithmParameters Containing the algorithm identifier of underlying pseudo random function, @n
- * else @c null if an error occurs.
+ * @return A pointer to IAlgorithmParameters containing the algorithm identifier of underlying pseudo random function, @n
+ * else @c null if an error occurs
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual IAlgorithmParameters* CloneN(void) const;
/**
- * Get the PkcsAlgorithmParameterType value.
+ * Gets the PkcsAlgorithmParameterType value.
*
* @since 2.1
*
- * @return PkcsAlgorithmParameterType holding enum value PKCS_ALGO_PARAM_TYPE_PKCS05_KDF02 for KDF2 Parameters.
+ * @return The PkcsAlgorithmParameterType instance holding the enum value @c PKCS_ALGO_PARAM_TYPE_PKCS05_KDF02 for KDF2 Parameters
*/
virtual PkcsAlgorithmParameterType GetType(void) const;
*
* @return @c true if the specified instance equals the current instance, @n
* else @c false
- * @param[in] rhs An instance of %Pkcs05PbKdf2Parameters
+ * @param[in] rhs An instance of %Pkcs05PbKdf2Parameters
* @exception E_SUCCESS The method is successful.
- * @exception E_INVALID_ARG The specified input parameter is invalid.
+ * @exception E_INVALID_ARG The specified input parameter is invalid.
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual bool Equals(const Tizen::Base::Object& rhs) const;