summaryrefslogtreecommitdiff
path: root/usr/src/lib/libkmsagent/common/KMSAgentChallenge.h
diff options
context:
space:
mode:
authorJohn Sonnenschein <johns@joyent.com>2012-05-17 18:26:57 +0000
committerJohn Sonnenschein <johns@joyent.com>2012-05-17 18:26:57 +0000
commit04b244dd661c24b510ac22936decfc0972d202d3 (patch)
tree3ebfef98afc303fddf3415d6fba64e8682f495e8 /usr/src/lib/libkmsagent/common/KMSAgentChallenge.h
parenteac250589e41f1b705e1b7427b02b3379aac9f9e (diff)
parenta69187741b83640a90dd8586195456dd50c016a8 (diff)
downloadillumos-joyent-20120517.tar.gz
Merge git.joyent.com:illumos-joyent20120517
Diffstat (limited to 'usr/src/lib/libkmsagent/common/KMSAgentChallenge.h')
-rw-r--r--usr/src/lib/libkmsagent/common/KMSAgentChallenge.h111
1 files changed, 0 insertions, 111 deletions
diff --git a/usr/src/lib/libkmsagent/common/KMSAgentChallenge.h b/usr/src/lib/libkmsagent/common/KMSAgentChallenge.h
deleted file mode 100644
index b259f13e69..0000000000
--- a/usr/src/lib/libkmsagent/common/KMSAgentChallenge.h
+++ /dev/null
@@ -1,111 +0,0 @@
-/*
- * CDDL HEADER START
- *
- * The contents of this file are subject to the terms of the
- * Common Development and Distribution License (the "License").
- * You may not use this file except in compliance with the License.
- *
- * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
- * or http://www.opensolaris.org/os/licensing.
- * See the License for the specific language governing permissions
- * and limitations under the License.
- *
- * When distributing Covered Code, include this CDDL HEADER in each
- * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
- * If applicable, add the following below this CDDL HEADER, with the
- * fields enclosed by brackets "[]" replaced with your own identifying
- * information: Portions Copyright [yyyy] [name of copyright owner]
- *
- * CDDL HEADER END
- */
-
-/*
- * Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
- */
-
-/**
- * \file KMSAgentChallenge.h
- */
-
-#ifndef KMSAagentChallenge_H
-#define KMSAagentChallenge_H
-
-/**
- * computes the response to the KMA's challenge using
- * HMAC-SHA1( RootCACertificate || AuthenticationChallenge,
- * AuthenticationSecret ). The AuthenticationSecret is
- * used as the key in the HMAC-SHA1 computation.
- *
- * @param i_pAuthenticationSecret
- * @param i_iAuthenticationSecretLength
- * @param i_pRootCACertificate
- * @param i_iRootCACertificateLength
- * @param i_pAuthenticationChallenge
- * @param i_iAuthenticationChallengeLength
- * @param o_pAuthenticationChallengeResponse
- * @param i_iAuthenticationChallengeResponseLength
- *
- * @return boolean success indicator
- */
-bool ComputeChallengeResponse(
- const unsigned char* i_pAuthenticationSecret,
- int i_iAuthenticationSecretLength,
- const unsigned char* i_pRootCACertificate,
- int i_iRootCACertificateLength,
- const unsigned char* i_pAuthenticationChallenge,
- int i_iAuthenticationChallengeLength,
- unsigned char* o_pAuthenticationChallengeResponse,
- int i_iAuthenticationChallengeResponseLength );
-
-/**
- * computes the SHA1 hash of the specified passphrase.
- * The number of SHA1 iterations
- * is recorded in <code>o_iAuthenticationHashIterationCount</code> and the result
- * stored in o_sHexAuthenticationSecret as a UTF8 hex string.
- * HexAuthenticationSecret is SHA1( SHA1( ... ( SHA1( HashedPassphrase ) ) )
- * The number of iterations is time bounded at 1/10 of a second, and also
- * bounded by fixed minimum and maximum values (to prevent too weak of a
- * computation and to prevent a DoS, respectively).
- * This value is used as the shared secret in challenge-response
- * authentication exchanges.
-
- * @param i_sPassphrase the passphrase to be hashed
- * @param o_sHexHashedPassphrase the hashed passphrase
- * returned in UTF8 hexadecimal, this
- * buffer should be at least
- * 2*HASH_LENGTH+1 bytes
- * @param o_iAuthenticationHashIterationCount
- * @param o_sHexAuthenticationSecret
- *
- * @return boolean success indicator
- */
-bool ComputeEntityHashedPassphraseAndAuthenticationSecret(
- const char* const i_sPassphrase,
- char* const o_sHexHashedPassphrase,
- int* const o_piAuthenticationHashIterationCount,
- char* const o_sHexAuthenticationSecret );
-
-/**
- * computes the SHA1 hash of the specified passphrase. The SHA1 is
- * performed a "fixed" number of times as specified by
- * <code>i_iAuthenticationHashIterationCount</code>.
- *
- * @param i_sPassphrase the passprhase to be SHA1 hashed
- * @param o_sHexHashedPassphrase the SHA1 hash
- * of i_sPassphrase stored as a UTF8 hex string
- * @param i_iAuthenticationHashIterationCount the number
- * of times to SHA1 hash the passphrase
- * @param o_sHexAuthenticationSecret the passphrase hashed
- * the fixed number of times and stored as a UTF8
- * hex string
- *
- * @return boolean success indicator
- */
-bool ComputeFixedEntityHashedPassphraseAndAuthenticationSecret(
- const char* i_sPassphrase,
- char* const o_sHexHashedPassphrase,
- int i_iAuthenticationHashIterationCount,
- char* const o_sHexAuthenticationSecret );
-
-#endif /* KMSAagentChallenge_H */
-