/// <summary>
/// Checks whether slot information matches PKCS#11 URI
/// </summary>
/// <param name="pkcs11Uri">PKCS#11 URI</param>
/// <param name="slotInfo">Slot information</param>
/// <returns>True if slot information matches PKCS#11 URI</returns>
public static bool Matches(Pkcs11Uri pkcs11Uri, SlotInfo slotInfo)
{
if (pkcs11Uri == null)
{
throw new ArgumentNullException("pkcs11Uri");
}
if (slotInfo == null)
{
throw new ArgumentNullException("slotInfo");
}
return(Pkcs11UriSharedUtils.Matches(pkcs11Uri, slotInfo.ManufacturerId, slotInfo.SlotDescription, slotInfo.SlotId));
}
/// <summary>
/// Checks whether PKCS#11 library information matches PKCS#11 URI
/// </summary>
/// <param name="pkcs11Uri">PKCS#11 URI</param>
/// <param name="libraryInfo">PKCS#11 library information</param>
/// <returns>True if PKCS#11 library information matches PKCS#11 URI</returns>
public static bool Matches(Pkcs11Uri pkcs11Uri, LibraryInfo libraryInfo)
{
if (pkcs11Uri == null)
{
throw new ArgumentNullException("pkcs11Uri");
}
if (libraryInfo == null)
{
throw new ArgumentNullException("libraryInfo");
}
return(Pkcs11UriSharedUtils.Matches(pkcs11Uri, libraryInfo.ManufacturerId, libraryInfo.LibraryDescription, libraryInfo.LibraryVersion));
}
/// <summary>
/// Checks whether token information matches PKCS#11 URI
/// </summary>
/// <param name="pkcs11Uri">PKCS#11 URI</param>
/// <param name="tokenInfo">Token information</param>
/// <returns>True if token information matches PKCS#11 URI</returns>
public static bool Matches(Pkcs11Uri pkcs11Uri, TokenInfo tokenInfo)
{
if (pkcs11Uri == null)
{
throw new ArgumentNullException("pkcs11Uri");
}
if (tokenInfo == null)
{
throw new ArgumentNullException("tokenInfo");
}
return(Pkcs11UriSharedUtils.Matches(pkcs11Uri, tokenInfo.Label, tokenInfo.ManufacturerId, tokenInfo.SerialNumber, tokenInfo.Model));
}
/// <summary>
/// Checks whether token information matches PKCS#11 URI
/// </summary>
/// <param name="pkcs11Uri">PKCS#11 URI</param>
/// <param name="tokenInfo">Token information</param>
/// <returns>True if token information matches PKCS#11 URI</returns>
public static bool Matches(Pkcs11Uri pkcs11Uri, CK_TOKEN_INFO tokenInfo)
{
if (pkcs11Uri == null)
{
throw new ArgumentNullException("pkcs11Uri");
}
string token = ConvertUtils.BytesToUtf8String(tokenInfo.Label, true);
string manufacturer = ConvertUtils.BytesToUtf8String(tokenInfo.ManufacturerId, true);
string serial = ConvertUtils.BytesToUtf8String(tokenInfo.SerialNumber, true);
string model = ConvertUtils.BytesToUtf8String(tokenInfo.Model, true);
return(Pkcs11UriSharedUtils.Matches(pkcs11Uri, token, manufacturer, serial, model));
}
/// <summary>
/// Obtains a list of all PKCS#11 URI matching slots
/// </summary>
/// <param name="pkcs11Uri">PKCS#11 URI</param>
/// <param name="pkcs11Library">High level PKCS#11 wrapper</param>
/// <param name="slotsType">Type of slots to be obtained</param>
/// <returns>List of slots matching PKCS#11 URI</returns>
public static List<ISlot> GetMatchingSlotList(Pkcs11Uri pkcs11Uri, IPkcs11Library pkcs11Library, SlotsType slotsType)
{
if (pkcs11Uri == null)
throw new ArgumentNullException("pkcs11Uri");
if (pkcs11Library == null)
throw new ArgumentNullException("pkcs11Library");
List<ISlot> matchingSlots = new List<ISlot>();
ILibraryInfo libraryInfo = pkcs11Library.GetInfo();
if (!Matches(pkcs11Uri, libraryInfo))
return matchingSlots;
List<ISlot> slots = pkcs11Library.GetSlotList(SlotsType.WithOrWithoutTokenPresent);
if ((slots == null) || (slots.Count == 0))
return matchingSlots;
foreach (ISlot slot in slots)
{
ISlotInfo slotInfo = slot.GetSlotInfo();
if (Matches(pkcs11Uri, slotInfo))
{
if (slotInfo.SlotFlags.TokenPresent)
{
ITokenInfo tokenInfo = slot.GetTokenInfo();
if (Matches(pkcs11Uri, tokenInfo))
matchingSlots.Add(slot);
}
else
{
if (slotsType == SlotsType.WithOrWithoutTokenPresent && Pkcs11UriSharedUtils.Matches(pkcs11Uri, null, null, null, null))
matchingSlots.Add(slot);
}
}
}
return matchingSlots;
}
/// <summary>
/// Obtains a list of all slots where token that matches PKCS#11 URI is present
/// </summary>
/// <param name="pkcs11Uri">PKCS#11 URI</param>
/// <param name="pkcs11">Low level PKCS#11 wrapper</param>
/// <param name="tokenPresent">Flag indicating whether the list obtained includes only those slots with a token present (true), or all slots (false)</param>
/// <param name="slotList">List of slots matching PKCS#11 URI</param>
/// <returns>CKR_OK if successful; any other value otherwise</returns>
public static CKR GetMatchingSlotList(Pkcs11Uri pkcs11Uri, Pkcs11 pkcs11, bool tokenPresent, out NativeULong[] slotList)
{
if (pkcs11Uri == null)
{
throw new ArgumentNullException("pkcs11Uri");
}
if (pkcs11 == null)
{
throw new ArgumentNullException("pkcs11");
}
List <NativeULong> matchingSlots = new List <NativeULong>();
// Get library information
CK_INFO libraryInfo = new CK_INFO();
CKR rv = pkcs11.C_GetInfo(ref libraryInfo);
if (rv != CKR.CKR_OK)
{
slotList = new NativeULong[0];
return(rv);
}
// Check whether library matches URI
if (!Matches(pkcs11Uri, libraryInfo))
{
slotList = new NativeULong[0];
return(CKR.CKR_OK);
}
// Get number of slots in first call
NativeULong slotCount = 0;
rv = pkcs11.C_GetSlotList(false, null, ref slotCount);
if (rv != CKR.CKR_OK)
{
slotList = new NativeULong[0];
return(rv);
}
if (slotCount < 1)
{
slotList = new NativeULong[0];
return(CKR.CKR_OK);
}
// Allocate array for slot IDs
NativeULong[] slots = new NativeULong[slotCount];
// Get slot IDs in second call
rv = pkcs11.C_GetSlotList(tokenPresent, slots, ref slotCount);
if (rv != CKR.CKR_OK)
{
slotList = new NativeULong[0];
return(rv);
}
// Shrink array if needed
if (slots.Length != ConvertUtils.UInt64ToInt32(slotCount))
{
Array.Resize(ref slots, ConvertUtils.UInt64ToInt32(slotCount));
}
// Match slots with Pkcs11Uri
foreach (NativeULong slot in slots)
{
CK_SLOT_INFO slotInfo = new CK_SLOT_INFO();
rv = pkcs11.C_GetSlotInfo(slot, ref slotInfo);
if (rv != CKR.CKR_OK)
{
slotList = new NativeULong[0];
return(rv);
}
// Check whether slot matches URI
if (Matches(pkcs11Uri, slotInfo, slot))
{
if ((slotInfo.Flags & CKF.CKF_TOKEN_PRESENT) == CKF.CKF_TOKEN_PRESENT)
{
CK_TOKEN_INFO tokenInfo = new CK_TOKEN_INFO();
rv = pkcs11.C_GetTokenInfo(slot, ref tokenInfo);
if (rv != CKR.CKR_OK)
{
slotList = new NativeULong[0];
return(rv);
}
// Check whether token matches URI
if (Matches(pkcs11Uri, tokenInfo))
{
matchingSlots.Add(slot);
}
}
else
{
if (!tokenPresent && Pkcs11UriSharedUtils.Matches(pkcs11Uri, null, null, null, null))
{
matchingSlots.Add(slot);
}
}
}
}
slotList = matchingSlots.ToArray();
return(CKR.CKR_OK);
}
/// <summary>
/// Checks whether object attributes match PKCS#11 URI
/// </summary>
/// <param name="pkcs11Uri">PKCS#11 URI</param>
/// <param name="objectAttributes">Object attributes</param>
/// <returns>True if object attributes match PKCS#11 URI</returns>
public static bool Matches(Pkcs11Uri pkcs11Uri, List <CK_ATTRIBUTE> objectAttributes)
{
if (pkcs11Uri == null)
{
throw new ArgumentNullException("pkcs11Uri");
}
if (objectAttributes == null)
{
throw new ArgumentNullException("objectAttributes");
}
NativeULong ckaClassType = ConvertUtils.UInt64FromCKA(CKA.CKA_CLASS);
CKO? ckaClassValue = null;
bool ckaClassFound = false;
NativeULong ckaLabelType = ConvertUtils.UInt64FromCKA(CKA.CKA_LABEL);
string ckaLabelValue = null;
bool ckaLabelFound = false;
NativeULong ckaIdType = ConvertUtils.UInt64FromCKA(CKA.CKA_ID);
byte[] ckaIdValue = null;
bool ckaIdFound = false;
foreach (CK_ATTRIBUTE objectAttribute in objectAttributes)
{
CK_ATTRIBUTE attribute = objectAttribute;
if (attribute.type == ckaClassType)
{
NativeULong nativeUlongValue = 0;
CkaUtils.ConvertValue(ref attribute, out nativeUlongValue);
ckaClassValue = ConvertUtils.UInt64ToCKO(nativeUlongValue);
ckaClassFound = true;
}
else if (attribute.type == ckaLabelType)
{
CkaUtils.ConvertValue(ref attribute, out ckaLabelValue);
ckaLabelFound = true;
}
else if (objectAttribute.type == ckaIdType)
{
CkaUtils.ConvertValue(ref attribute, out ckaIdValue);
ckaIdFound = true;
}
if (ckaClassFound && ckaLabelFound && ckaIdFound)
{
break;
}
}
if ((!ckaClassFound) && (pkcs11Uri.Type != null))
{
throw new Pkcs11UriException("CKA_CLASS attribute is not present in the list of object attributes");
}
if ((!ckaLabelFound) && (pkcs11Uri.Object != null))
{
throw new Pkcs11UriException("CKA_LABEL attribute is not present in the list of object attributes");
}
if ((!ckaIdFound) && (pkcs11Uri.Id != null))
{
throw new Pkcs11UriException("CKA_ID attribute is not present in the list of object attributes");
}
return(Pkcs11UriSharedUtils.Matches(pkcs11Uri, ckaClassValue, ckaLabelValue, ckaIdValue));
}
/// <summary>
/// Checks whether object attributes match PKCS#11 URI
/// </summary>
/// <param name="pkcs11Uri">PKCS#11 URI</param>
/// <param name="objectAttributes">Object attributes</param>
/// <returns>True if object attributes match PKCS#11 URI</returns>
public static bool Matches(Pkcs11Uri pkcs11Uri, List <ObjectAttribute> objectAttributes)
{
if (pkcs11Uri == null)
{
throw new ArgumentNullException("pkcs11Uri");
}
if (objectAttributes == null)
{
throw new ArgumentNullException("objectAttributes");
}
ulong ckaClassType = Convert.ToUInt64(CKA.CKA_CLASS);
CKO? ckaClassValue = null;
bool ckaClassFound = false;
ulong ckaLabelType = Convert.ToUInt64(CKA.CKA_LABEL);
string ckaLabelValue = null;
bool ckaLabelFound = false;
ulong ckaIdType = Convert.ToUInt64(CKA.CKA_ID);
byte[] ckaIdValue = null;
bool ckaIdFound = false;
foreach (ObjectAttribute objectAttribute in objectAttributes)
{
if (objectAttribute == null)
{
continue;
}
if (objectAttribute.Type == ckaClassType)
{
ckaClassValue = (CKO)Convert.ToUInt32(objectAttribute.GetValueAsUlong());
ckaClassFound = true;
}
else if (objectAttribute.Type == ckaLabelType)
{
ckaLabelValue = objectAttribute.GetValueAsString();
ckaLabelFound = true;
}
else if (objectAttribute.Type == ckaIdType)
{
ckaIdValue = objectAttribute.GetValueAsByteArray();
ckaIdFound = true;
}
if (ckaClassFound && ckaLabelFound && ckaIdFound)
{
break;
}
}
if ((!ckaClassFound) && (pkcs11Uri.Type != null))
{
throw new Pkcs11UriException("CKA_CLASS attribute is not present in the list of object attributes");
}
if ((!ckaLabelFound) && (pkcs11Uri.Object != null))
{
throw new Pkcs11UriException("CKA_LABEL attribute is not present in the list of object attributes");
}
if ((!ckaIdFound) && (pkcs11Uri.Id != null))
{
throw new Pkcs11UriException("CKA_ID attribute is not present in the list of object attributes");
}
return(Pkcs11UriSharedUtils.Matches(pkcs11Uri, ckaClassValue, ckaLabelValue, ckaIdValue));
}
