| Index: libsrtp/crypto/include/crypto_types.h
|
| ===================================================================
|
| --- libsrtp/crypto/include/crypto_types.h (revision 0)
|
| +++ libsrtp/crypto/include/crypto_types.h (revision 0)
|
| @@ -0,0 +1,220 @@
|
| +/*
|
| + * crypto_types.h
|
| + *
|
| + * constants for cipher types and auth func types
|
| + *
|
| + * David A. McGrew
|
| + * Cisco Systems, Inc.
|
| + */
|
| +/*
|
| + *
|
| + * Copyright(c) 2001-2006 Cisco Systems, Inc.
|
| + * All rights reserved.
|
| + *
|
| + * Redistribution and use in source and binary forms, with or without
|
| + * modification, are permitted provided that the following conditions
|
| + * are met:
|
| + *
|
| + * Redistributions of source code must retain the above copyright
|
| + * notice, this list of conditions and the following disclaimer.
|
| + *
|
| + * Redistributions in binary form must reproduce the above
|
| + * copyright notice, this list of conditions and the following
|
| + * disclaimer in the documentation and/or other materials provided
|
| + * with the distribution.
|
| + *
|
| + * Neither the name of the Cisco Systems, Inc. nor the names of its
|
| + * contributors may be used to endorse or promote products derived
|
| + * from this software without specific prior written permission.
|
| + *
|
| + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
| + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
| + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
| + * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
| + * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
|
| + * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
| + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
| + * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
| + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
| + * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
| + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
|
| + * OF THE POSSIBILITY OF SUCH DAMAGE.
|
| + *
|
| + */
|
| +
|
| +#ifndef CRYPTO_TYPES_H
|
| +#define CRYPTO_TYPES_H
|
| +
|
| +/**
|
| + * @defgroup Algos Cryptographic Algorithms
|
| + *
|
| + *
|
| + * This library provides several different cryptographic algorithms,
|
| + * each of which can be selected by using the cipher_type_id_t and
|
| + * auth_type_id_t. These algorithms are documented below.
|
| + *
|
| + * Authentication functions that use the Universal Security Transform
|
| + * (UST) must be used in conjunction with a cipher other than the null
|
| + * cipher. These functions require a per-message pseudorandom input
|
| + * that is generated by the cipher.
|
| + *
|
| + * The identifiers STRONGHOLD_AUTH and STRONGHOLD_CIPHER identify the
|
| + * strongest available authentication function and cipher,
|
| + * respectively. They are resolved at compile time to the strongest
|
| + * available algorithm. The stronghold algorithms can serve as did
|
| + * the keep of a medieval fortification; they provide the strongest
|
| + * defense (or the last refuge).
|
| + *
|
| + * @{
|
| + */
|
| +
|
| +/**
|
| + * @defgroup Ciphers Cipher Types
|
| + *
|
| + * @brief Each cipher type is identified by an unsigned integer. The
|
| + * cipher types available in this edition of libSRTP are given
|
| + * by the #defines below.
|
| + *
|
| + * A cipher_type_id_t is an identifier for a cipher_type; only values
|
| + * given by the #defines above (or those present in the file
|
| + * crypto_types.h) should be used.
|
| + *
|
| + * The identifier STRONGHOLD_CIPHER indicates the strongest available
|
| + * cipher, allowing an application to choose the strongest available
|
| + * algorithm without any advance knowledge about the avaliable
|
| + * algorithms.
|
| + *
|
| + * @{
|
| + */
|
| +
|
| +/**
|
| + * @brief The null cipher performs no encryption.
|
| + *
|
| + * The NULL_CIPHER leaves its inputs unaltered, during both the
|
| + * encryption and decryption operations. This cipher can be chosen
|
| + * to indicate that no encryption is to be performed.
|
| + */
|
| +#define NULL_CIPHER 0
|
| +
|
| +/**
|
| + * @brief AES Integer Counter Mode (AES ICM)
|
| + *
|
| + * AES ICM is the variant of counter mode that is used by Secure RTP.
|
| + * This cipher uses a 16-, 24-, or 32-octet key concatenated with a
|
| + * 14-octet offset (or salt) value.
|
| + */
|
| +#define AES_ICM 1
|
| +
|
| +/**
|
| + * @brief AES-128 Integer Counter Mode (AES ICM)
|
| + * AES-128 ICM is a deprecated alternate name for AES ICM.
|
| + */
|
| +#define AES_128_ICM AES_ICM
|
| +
|
| +/**
|
| + * @brief SEAL 3.0
|
| + *
|
| + * SEAL is the Software-Optimized Encryption Algorithm of Coppersmith
|
| + * and Rogaway. Nota bene: this cipher is IBM proprietary.
|
| + */
|
| +#define SEAL 2
|
| +
|
| +/**
|
| + * @brief AES Cipher Block Chaining mode (AES CBC)
|
| + *
|
| + * AES CBC is the AES Cipher Block Chaining mode.
|
| + * This cipher uses a 16-, 24-, or 32-octet key.
|
| + */
|
| +#define AES_CBC 3
|
| +
|
| +/**
|
| + * @brief AES-128 Cipher Block Chaining mode (AES CBC)
|
| + *
|
| + * AES-128 CBC is a deprecated alternate name for AES CBC.
|
| + */
|
| +#define AES_128_CBC AES_CBC
|
| +
|
| +/**
|
| + * @brief Strongest available cipher.
|
| + *
|
| + * This identifier resolves to the strongest cipher type available.
|
| + */
|
| +#define STRONGHOLD_CIPHER AES_ICM
|
| +
|
| +/**
|
| + * @}
|
| + */
|
| +
|
| +
|
| +
|
| +/**
|
| + * @defgroup Authentication Authentication Function Types
|
| + *
|
| + * @brief Each authentication function type is identified by an
|
| + * unsigned integer. The authentication function types available in
|
| + * this edition of libSRTP are given by the #defines below.
|
| + *
|
| + * An auth_type_id_t is an identifier for an authentication function type;
|
| + * only values given by the #defines above (or those present in the
|
| + * file crypto_types.h) should be used.
|
| + *
|
| + * The identifier STRONGHOLD_AUTH indicates the strongest available
|
| + * authentication function, allowing an application to choose the
|
| + * strongest available algorithm without any advance knowledge about
|
| + * the avaliable algorithms. The stronghold algorithms can serve as
|
| + * did the keep of a medieval fortification; they provide the
|
| + * strongest defense (or the last refuge).
|
| + *
|
| + * @{
|
| + */
|
| +
|
| +/**
|
| + * @brief The null authentication function performs no authentication.
|
| + *
|
| + * The NULL_AUTH function does nothing, and can be selected to indicate
|
| + * that authentication should not be performed.
|
| + */
|
| +#define NULL_AUTH 0
|
| +
|
| +/**
|
| + * @brief UST with TMMH Version 2
|
| + *
|
| + * UST_TMMHv2 implements the Truncated Multi-Modular Hash using
|
| + * UST. This function must be used in conjunction with a cipher other
|
| + * than the null cipher.
|
| + * with a cipher.
|
| + */
|
| +#define UST_TMMHv2 1
|
| +
|
| +/**
|
| + * @brief (UST) AES-128 XORMAC
|
| + *
|
| + * UST_AES_128_XMAC implements AES-128 XORMAC, using UST. Nota bene:
|
| + * the XORMAC algorithm is IBM proprietary.
|
| + */
|
| +#define UST_AES_128_XMAC 2
|
| +
|
| +/**
|
| + * @brief HMAC-SHA1
|
| + *
|
| + * HMAC_SHA1 implements the Hash-based MAC using the NIST Secure
|
| + * Hash Algorithm version 1 (SHA1).
|
| + */
|
| +#define HMAC_SHA1 3
|
| +
|
| +/**
|
| + * @brief Strongest available authentication function.
|
| + *
|
| + * This identifier resolves to the strongest available authentication
|
| + * function.
|
| + */
|
| +#define STRONGHOLD_AUTH HMAC_SHA1
|
| +
|
| +/**
|
| + * @}
|
| + */
|
| +/**
|
| + * @}
|
| + */
|
| +
|
| +#endif /* CRYPTO_TYPES_H */
|
|
|
| Property changes on: libsrtp/crypto/include/crypto_types.h
|
| ___________________________________________________________________
|
| Added: svn:eol-style
|
| + LF
|
|
|
|
|