/usr/include/xmltooling/security/Credential.h is in libxmltooling-dev 1.4.2-5+deb7u1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 | /**
* Licensed to the University Corporation for Advanced Internet
* Development, Inc. (UCAID) under one or more contributor license
* agreements. See the NOTICE file distributed with this work for
* additional information regarding copyright ownership.
*
* UCAID licenses this file to you under the Apache License,
* Version 2.0 (the "License"); you may not use this file except
* in compliance with the License. You may obtain a copy of the
* License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
* either express or implied. See the License for the specific
* language governing permissions and limitations under the License.
*/
/**
* @file xmltooling/security/Credential.h
*
* Wraps keys and related functionality.
*/
#if !defined(__xmltooling_cred_h__) && !defined(XMLTOOLING_NO_XMLSEC)
#define __xmltooling_cred_h__
#include <xmltooling/base.h>
#include <set>
#include <string>
class XSECCryptoKey;
namespace xmlsignature {
class XMLTOOL_API KeyInfo;
};
namespace xmltooling {
class XMLTOOL_API CredentialCriteria;
class XMLTOOL_API CredentialContext;
/**
* Wraps keys and related functionality.
*
* <p>Shared credential implementations should implement reference counting
* and honor any locking parameters to ensure appropriate synchronization.
*/
class XMLTOOL_API Credential
{
MAKE_NONCOPYABLE(Credential);
protected:
Credential();
public:
virtual ~Credential();
/**
* Bitmask constants for limiting resolution process inside a CredentialResolver.
*/
enum ResolveTypes {
RESOLVE_KEYS = 1,
RESOLVE_NAMES = 2
};
/**
* Bitmask of use cases for credentials.
*/
enum UsageTypes {
UNSPECIFIED_CREDENTIAL = 0,
SIGNING_CREDENTIAL = 1,
TLS_CREDENTIAL = 2,
ENCRYPTION_CREDENTIAL = 4
};
/**
* Bitmask of supported KeyInfo content to generate.
*/
enum KeyInfoTypes {
KEYINFO_KEY_VALUE = 1,
KEYINFO_KEY_NAME = 2
};
/**
* Get credential usage types.
*
* @return the usage bitmask
*/
virtual unsigned int getUsage() const=0;
/**
* Returns an algorithm identifier for the Credential.
*
* @return the Credential algorithm, or nullptr if indeterminate
*/
virtual const char* getAlgorithm() const=0;
/**
* Returns the size of the key in bits.
*
* @return the key size, or 0 if indeterminate
*/
virtual unsigned int getKeySize() const=0;
/**
* Returns a secret or private key to use for signing or decryption operations.
*
* @return a secret or private key
*/
virtual XSECCryptoKey* getPrivateKey() const=0;
/**
* Returns a secret or public key to use for verification or encryption operations.
*
* @return a secret or public key
*/
virtual XSECCryptoKey* getPublicKey() const=0;
/**
* Returns names representing the Credential.
*
* <p>Names should be unique in the context of the comparisons against CredentialCriteria
* that deployments expect to see.
*
* @return a sorted set of names
*/
virtual const std::set<std::string>& getKeyNames() const=0;
/**
* Returns a ds:KeyInfo object representing the Credential for use in
* communicating with other entities.
*
* @param compact true iff the communication medium is such that only compact forms should be included
* @return a KeyInfo object, which must be freed by the caller
*/
virtual xmlsignature::KeyInfo* getKeyInfo(bool compact=false) const=0;
/**
* Get the credential context information, which provides additional information
* specific to the context in which the credential was resolved.
*
* @return resolution context of the credential
*/
virtual const CredentialContext* getCredentalContext() const;
};
};
#endif /* __xmltooling_cred_h__ */
|