| /* |
| * keyDeriveAes.c |
| * |
| * Copyright(c) 1998 - 2009 Texas Instruments. All rights reserved. |
| * 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 Texas Instruments 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 |
| * OWNER 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. |
| */ |
| |
| /** \file keyDeriveAes.c |
| * \brief AES encryption key derivation implementation. |
| * |
| * \see aesBroadcastKeyDerivation.h |
| */ |
| |
| /**************************************************************************** |
| * * |
| * MODULE: AES broadcast key derivation * |
| * PURPOSE: AES broadcast key derivation * |
| * * |
| ****************************************************************************/ |
| |
| #define __FILE_ID__ FILE_ID_29 |
| #include "osApi.h" |
| #include "report.h" |
| #include "rsnApi.h" |
| |
| #include "keyDerive.h" |
| #include "keyDeriveAes.h" |
| |
| #include "mainKeysSm.h" |
| |
| /** |
| * |
| * keyDeriveAes_config |
| * |
| * \b Description: |
| * |
| * AES broadcast key derivation configuration function: |
| * - Initializes the derive & remove callback functions |
| * \b ARGS: |
| * |
| * None |
| * |
| * \b RETURNS: |
| * |
| * TI_OK on success, TI_NOK otherwise. |
| */ |
| |
| TI_STATUS keyDeriveAes_config(struct _keyDerive_t *pKeyDerive) |
| { |
| pKeyDerive->derive = keyDeriveAes_derive; |
| pKeyDerive->remove = keyDeriveAes_remove; |
| |
| return TI_OK; |
| } |
| |
| |
| /** |
| * |
| * keyDeriveAes_derive |
| * |
| * \b Description: |
| * |
| * AES key derivation function: |
| * - Decodes the key material. |
| * - Distribute the decoded key material to the driver. |
| * |
| * \b ARGS: |
| * |
| * I - p - Pointer to the encoded key material. |
| * |
| * \b RETURNS: |
| * |
| * TI_OK on success, TI_NOK otherwise. |
| */ |
| |
| TI_STATUS keyDeriveAes_derive(struct _keyDerive_t *pKeyDerive, encodedKeyMaterial_t *pEncodedKey) |
| { |
| TI_STATUS status; |
| TSecurityKeys key; |
| keyMaterialAes_t *keyMaterialAes = NULL; |
| |
| /* Small verification */ |
| if ((pEncodedKey==NULL) || (pKeyDerive == NULL)) |
| { |
| return TI_NOK; |
| } |
| |
| /* Note: Reduce 2 bytes from the size of keyMaterialAes_t in the following check, |
| because it is added as padding at the end due to the OS_PACKED removal. */ |
| if ( pEncodedKey->keyLen < (sizeof(keyMaterialAes_t) - 2) ) |
| { |
| TRACE1(pKeyDerive->hReport, REPORT_SEVERITY_ERROR, "KEY_DERIVE_AES: ERROR: wrong key length %d !!!\n", pEncodedKey->keyLen); |
| return TI_NOK; |
| } |
| |
| keyMaterialAes = (keyMaterialAes_t*)pEncodedKey->pData; |
| |
| |
| /* Fill security key structure */ |
| os_memoryZero(pKeyDerive->hOs, &key, sizeof(TSecurityKeys)); |
| |
| key.keyType = KEY_AES; |
| key.keyIndex = (TI_UINT8)pEncodedKey->keyId; |
| key.encLen = DERIVE_AES_KEY_LEN; |
| os_memoryCopy(pKeyDerive->hOs, (void *)key.encKey, pEncodedKey->pData + MAC_ADDR_LEN+KEY_RSC_LEN, |
| DERIVE_AES_KEY_LEN); |
| |
| /* Copy MAC address key */ |
| MAC_COPY (key.macAddress, keyMaterialAes->macAddress); |
| /* Copy RSC */ |
| os_memoryCopy(pKeyDerive->hOs, (void *)key.keyRsc, (void *)keyMaterialAes->keyRSC, KEY_RSC_LEN); |
| |
| status = pKeyDerive->pMainKeys->setKey(pKeyDerive->pMainKeys, &key); |
| if (status == TI_OK) |
| { |
| os_memoryCopy(pKeyDerive->hOs, &pKeyDerive->key, pEncodedKey, sizeof(encodedKeyMaterial_t)); |
| } |
| |
| return status; |
| } |
| |
| /** |
| * |
| * keyDeriveAes_remove |
| * |
| * \b Description: |
| * |
| * AES key remove function: |
| * - Remove the key material from the driver. |
| * |
| * \b ARGS: |
| * |
| * None. |
| * |
| * \b RETURNS: |
| * |
| * TI_OK on success, TI_NOK otherwise. |
| */ |
| |
| TI_STATUS keyDeriveAes_remove(struct _keyDerive_t *pKeyDerive, encodedKeyMaterial_t *pEncodedKey) |
| { |
| TI_STATUS status; |
| TSecurityKeys key; |
| |
| if ((pEncodedKey==NULL) || (pKeyDerive == NULL)) |
| { |
| return TI_NOK; |
| } |
| |
| os_memoryZero(pKeyDerive->hOs, &key, sizeof(TSecurityKeys)); |
| key.keyType = KEY_AES; |
| key.keyIndex = (TI_UINT8)pEncodedKey->keyId; |
| key.encLen = DERIVE_AES_KEY_LEN; |
| MAC_COPY (key.macAddress, pEncodedKey->pData); |
| |
| status = pKeyDerive->pMainKeys->removeKey(pKeyDerive->pMainKeys, &key); |
| if (status == TI_OK) |
| { |
| os_memoryZero(pKeyDerive->hOs, &pKeyDerive->key, sizeof(encodedKeyMaterial_t)); |
| } |
| |
| return status; |
| } |
| |