/*
This file is part of PacketDotNet
PacketDotNet is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
PacketDotNet is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with PacketDotNet. If not, see .
*/
/*
* Copyright 2012 Alan Rushforth
*/
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using PacketDotNet.Utils;
using MiscUtil.Conversion;
using System.Net.NetworkInformation;
namespace PacketDotNet
{
namespace Ieee80211
{
///
/// Format of an 802.11 management authentication frame.
///
public class AuthenticationFrame : ManagementFrame
{
private class AuthenticationFields
{
public readonly static int AuthAlgorithmNumLength = 2;
public readonly static int AuthAlgorithmTransactionSequenceNumLength = 2;
public readonly static int StatusCodeLength = 2;
public readonly static int AuthAlgorithmNumPosition;
public readonly static int AuthAlgorithmTransactionSequenceNumPosition;
public readonly static int StatusCodePosition;
public readonly static int InformationElement1Position;
static AuthenticationFields ()
{
AuthAlgorithmNumPosition = MacFields.SequenceControlPosition + MacFields.SequenceControlLength;
AuthAlgorithmTransactionSequenceNumPosition = AuthAlgorithmNumPosition + AuthAlgorithmNumLength;
StatusCodePosition = AuthAlgorithmTransactionSequenceNumPosition + AuthAlgorithmTransactionSequenceNumLength;
InformationElement1Position = StatusCodePosition + StatusCodeLength;
}
}
///
/// Number used for selection of authentication algorithm
///
public UInt16 AuthenticationAlgorithmNumber { get; set; }
private UInt16 AuthenticationAlgorithmNumberBytes
{
get
{
if(header.Length >=
(AuthenticationFields.AuthAlgorithmNumPosition + AuthenticationFields.AuthAlgorithmNumLength))
{
return EndianBitConverter.Little.ToUInt16 (header.Bytes,
header.Offset + AuthenticationFields.AuthAlgorithmNumPosition);
}
else
{
return 0;
}
}
set
{
EndianBitConverter.Little.CopyBytes (value,
header.Bytes,
header.Offset + AuthenticationFields.AuthAlgorithmNumPosition);
}
}
///
/// Sequence number to define the step of the authentication algorithm
///
public UInt16 AuthenticationAlgorithmTransactionSequenceNumber { get; set; }
private UInt16 AuthenticationAlgorithmTransactionSequenceNumberBytes
{
get
{
if(header.Length >=
(AuthenticationFields.AuthAlgorithmTransactionSequenceNumPosition + AuthenticationFields.AuthAlgorithmTransactionSequenceNumLength))
{
return EndianBitConverter.Little.ToUInt16 (header.Bytes,
header.Offset + AuthenticationFields.AuthAlgorithmTransactionSequenceNumPosition);
}
else
{
return 0;
}
}
set
{
EndianBitConverter.Little.CopyBytes (value,
header.Bytes,
header.Offset + AuthenticationFields.AuthAlgorithmTransactionSequenceNumPosition);
}
}
///
/// Indicates the success or failure of the authentication operation
///
public AuthenticationStatusCode StatusCode { get; set; }
private AuthenticationStatusCode StatusCodeBytes
{
get
{
if(header.Length >= (AuthenticationFields.StatusCodePosition + AuthenticationFields.StatusCodeLength))
{
return (AuthenticationStatusCode)EndianBitConverter.Little.ToUInt16 (header.Bytes,
header.Offset + AuthenticationFields.StatusCodePosition);
}
else
{
//This seems the most sensible value to return when it is not possible
//to extract a meaningful value
return AuthenticationStatusCode.UnspecifiedFailure;
}
}
set
{
EndianBitConverter.Little.CopyBytes ((UInt16)value,
header.Bytes,
header.Offset + AuthenticationFields.StatusCodePosition);
}
}
///
/// The information elements included in the frame
///
public InformationElementList InformationElements { get; set; }
///
/// Gets the size of the frame.
///
///
/// The size of the frame.
///
public override int FrameSize
{
get
{
return (MacFields.FrameControlLength +
MacFields.DurationIDLength +
(MacFields.AddressLength * 3) +
MacFields.SequenceControlLength +
AuthenticationFields.AuthAlgorithmNumLength +
AuthenticationFields.AuthAlgorithmTransactionSequenceNumLength +
AuthenticationFields.StatusCodeLength +
InformationElements.Length);
}
}
///
/// Constructor
///
///
/// A
///
public AuthenticationFrame (ByteArraySegment bas)
{
header = new ByteArraySegment (bas);
FrameControl = new FrameControlField (FrameControlBytes);
Duration = new DurationField (DurationBytes);
DestinationAddress = GetAddress (0);
SourceAddress = GetAddress (1);
BssId = GetAddress (2);
SequenceControl = new SequenceControlField (SequenceControlBytes);
AuthenticationAlgorithmNumber = AuthenticationAlgorithmNumberBytes;
AuthenticationAlgorithmTransactionSequenceNumber = AuthenticationAlgorithmTransactionSequenceNumberBytes;
if(bas.Length > AuthenticationFields.InformationElement1Position)
{
//create a segment that just refers to the info element section
ByteArraySegment infoElementsSegment = new ByteArraySegment (bas.Bytes,
(bas.Offset + AuthenticationFields.InformationElement1Position),
(bas.Length - AuthenticationFields.InformationElement1Position));
InformationElements = new InformationElementList (infoElementsSegment);
}
else
{
InformationElements = new InformationElementList();
}
//cant set length until after we have handled the information elements
//as they vary in length
header.Length = FrameSize;
}
///
/// Initializes a new instance of the class.
///
///
/// Source address.
///
///
/// Destination address.
///
///
/// Bss identifier (MAC Address of Access Point).
///
///
/// Information elements.
///
public AuthenticationFrame (PhysicalAddress SourceAddress,
PhysicalAddress DestinationAddress,
PhysicalAddress BssId,
InformationElementList InformationElements)
{
this.FrameControl = new FrameControlField ();
this.Duration = new DurationField ();
this.DestinationAddress = DestinationAddress;
this.SourceAddress = SourceAddress;
this.BssId = BssId;
this.SequenceControl = new SequenceControlField ();
this.InformationElements = new InformationElementList (InformationElements);
this.FrameControl.SubType = FrameControlField.FrameSubTypes.ManagementAuthentication;
}
///
/// Writes the current packet properties to the backing ByteArraySegment.
///
public override void UpdateCalculatedValues ()
{
if ((header == null) || (header.Length > (header.BytesLength - header.Offset)) || (header.Length < FrameSize))
{
header = new ByteArraySegment (new Byte[FrameSize]);
}
this.FrameControlBytes = this.FrameControl.Field;
this.DurationBytes = this.Duration.Field;
SetAddress (0, DestinationAddress);
SetAddress (1, SourceAddress);
SetAddress (2, BssId);
this.SequenceControlBytes = this.SequenceControl.Field;
this.AuthenticationAlgorithmNumberBytes = this.AuthenticationAlgorithmNumber;
this.AuthenticationAlgorithmTransactionSequenceNumberBytes = this.AuthenticationAlgorithmTransactionSequenceNumber;
this.StatusCodeBytes = this.StatusCode;
//we now know the backing buffer is big enough to contain the info elements so we can safely copy them in
this.InformationElements.CopyTo (header, header.Offset + AuthenticationFields.InformationElement1Position);
header.Length = FrameSize;
}
}
}
}