--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/epoc32/include/btsecurity.h Wed Mar 31 12:33:34 2010 +0100
@@ -0,0 +1,120 @@
+// Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "Eclipse Public License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+#ifndef BTSECURITY_H
+#define BTSECURITY_H
+
+/**
+ @file
+ @publishedAll
+ @released
+*/
+
+#include <e32base.h>
+
+/**
+An enumeration to represent the possible levels of Man-in-the-Middle protection
+that a Bluetooth service may specify.
+*/
+enum TBluetoothMitmProtection
+ {
+ EMitmNotRequired = 0x0, /*!< No Man-in-the-Middle protection is required. */
+ EMitmDesired = 0x1, /*!< Man-in-the-Middle protection should be used where possible. */
+ EMitmRequired = 0x2 /*!< Man-in-the-Middle protection is required. */
+ };
+
+NONSHARABLE_CLASS(TBTAccessRequirements)
+/** The access requirements set up by a bluetooth service.
+
+An incoming connection must satisfy these criteria before the connection may proceed.
+Not spectacularly useful for applications; mainly used by other Bluetooth libraries
+@publishedAll
+@released
+*/
+ {
+public:
+ IMPORT_C TBTAccessRequirements();
+ IMPORT_C void SetAuthentication(TBool aPreference);
+ IMPORT_C void SetAuthorisation(TBool aPreference);
+ IMPORT_C void SetEncryption(TBool aPreference);
+ IMPORT_C void SetDenied(TBool aPreference);
+ IMPORT_C void SetAuthentication(TBluetoothMitmProtection aPreference);
+ IMPORT_C TInt SetPasskeyMinLength(TUint aPasskeyMinLength);
+ IMPORT_C TBool AuthenticationRequired() const;
+ IMPORT_C TBool AuthorisationRequired() const;
+ IMPORT_C TBool EncryptionRequired() const;
+ IMPORT_C TBool Denied() const;
+ IMPORT_C TUint PasskeyMinLength() const;
+ IMPORT_C TBool operator==(const TBTAccessRequirements& aRequirements) const;
+ IMPORT_C TBluetoothMitmProtection MitmProtection() const;
+
+private:
+ TUint8 iRequirements;
+ TUint iPasskeyMinLength;
+
+private:
+ enum TBTServiceSecuritySettings
+ {
+ EAuthenticate = 0x01,
+ EAuthorise = 0x02,
+ EEncrypt = 0x04,
+ EDenied = 0x08,
+ EMitm = 0x30, // 2 bit field for MITM
+ };
+
+ enum TBTAccessRequirementsMitmProtection
+ {
+ EAccessRequirementsMitmUndefined = 0x00,
+ EAccessRequirementsMitmNotRequired = 0x10,
+ EAccessRequirementsMitmDesired = 0x20,
+ EAccessRequirementsMitmRequired = 0x30
+ };
+ };
+
+NONSHARABLE_CLASS(TBTServiceSecurity)
+/** The security settings of a bluetooth service.
+
+Contains information regarding the service UID and the access requirements.
+@publishedAll
+@released
+*/
+ {
+public:
+ IMPORT_C TBTServiceSecurity(const TBTServiceSecurity& aService);
+ IMPORT_C TBTServiceSecurity();
+ IMPORT_C void SetUid(TUid aUid);
+ IMPORT_C void SetAuthentication(TBool aPreference);
+ IMPORT_C void SetAuthorisation(TBool aPreference);
+ IMPORT_C void SetEncryption(TBool aPreference);
+ IMPORT_C void SetDenied(TBool aPreference);
+ IMPORT_C void SetAuthentication(TBluetoothMitmProtection aPreference);
+ IMPORT_C TInt SetPasskeyMinLength(TUint aPasskeyMinLength);
+ IMPORT_C TBool AuthorisationRequired() const;
+ IMPORT_C TBool EncryptionRequired() const;
+ IMPORT_C TBool AuthenticationRequired() const;
+ IMPORT_C TBool Denied() const;
+ IMPORT_C TUint PasskeyMinLength() const;
+ IMPORT_C TUid Uid() const;
+ IMPORT_C TBluetoothMitmProtection MitmProtection() const;
+
+private:
+ TUid iUid; //<The UID of the service. Will be used by the UI to work out the name of the service when prompting the user.
+ TBTAccessRequirements iSecurityRequirements; //<Whether the service requires authentication, authorisation, encryption or min passkey len.
+ };
+
+typedef TPckgBuf<TBTServiceSecurity> TBTServiceSecurityPckg; /*!< Package definition for securty settings */
+
+
+#endif // BTSECURITY_H