ServerResponseHelper.cs 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309
  1. /* Copyright (C) 2012-2016 Tal Aloni <tal.aloni.il@gmail.com>. All rights reserved.
  2. *
  3. * You can redistribute this program and/or modify it under the terms of
  4. * the GNU Lesser Public License as published by the Free Software Foundation,
  5. * either version 3 of the License, or (at your option) any later version.
  6. */
  7. using System;
  8. using System.Collections.Generic;
  9. using System.Net;
  10. using System.Text;
  11. using Utilities;
  12. namespace ISCSI.Server
  13. {
  14. public class ServerResponseHelper
  15. {
  16. // CmdSN is session wide
  17. // StatSN is per connection
  18. internal static NOPInPDU GetNOPResponsePDU(NOPOutPDU request)
  19. {
  20. NOPInPDU response = new NOPInPDU();
  21. response.Data = request.Data;
  22. // When a target receives the NOP-Out with a valid Initiator Task Tag (not the reserved value 0xffffffff),
  23. // it MUST respond with a NOP-In with the same Initiator Task Tag that was provided in the NOP-Out request.
  24. // For such a response, the Target Transfer Tag MUST be 0xffffffff
  25. response.InitiatorTaskTag = request.InitiatorTaskTag;
  26. response.TargetTransferTag = 0xFFFFFFFF;
  27. return response;
  28. }
  29. internal static LoginResponsePDU GetLoginResponsePDU(LoginRequestPDU request, List<ISCSITarget> availableTargets, SessionParameters session, ConnectionParameters connection, ref ISCSITarget target, GetNextTSIH GetNextTSIH)
  30. {
  31. LoginResponsePDU response = new LoginResponsePDU();
  32. response.Transit = request.Transit;
  33. response.Continue = false;
  34. // The stage codes are:
  35. // 0 - SecurityNegotiation
  36. // 1 - LoginOperationalNegotiation
  37. // 3 - FullFeaturePhase
  38. response.CurrentStage = request.CurrentStage;
  39. response.NextStage = request.NextStage;
  40. response.VersionMax = request.VersionMax;
  41. response.VersionActive = request.VersionMin;
  42. response.ISID = request.ISID;
  43. response.Status = LoginResponseStatusName.Success;
  44. response.InitiatorTaskTag = request.InitiatorTaskTag;
  45. if (request.TSIH == 0)
  46. {
  47. // For a new session, the request TSIH is zero,
  48. // As part of the response, the target generates a TSIH.
  49. session.TSIH = GetNextTSIH();
  50. }
  51. response.TSIH = session.TSIH;
  52. if (request.Transit && request.Continue)
  53. {
  54. response.Status = LoginResponseStatusName.InitiatorError;
  55. return response;
  56. }
  57. else if (request.Continue)
  58. {
  59. response.Status = LoginResponseStatusName.Success;
  60. return response;
  61. }
  62. // RFC 3720: The login process proceeds in two stages - the security negotiation
  63. // stage and the operational parameter negotiation stage. Both stages are optional
  64. // but at least one of them has to be present.
  65. bool firstLoginRequest = (!session.IsDiscovery && target == null);
  66. if (firstLoginRequest)
  67. {
  68. connection.InitiatorName = request.LoginParameters.ValueOf("InitiatorName");
  69. if (String.IsNullOrEmpty(connection.InitiatorName))
  70. {
  71. // RFC 3720: InitiatorName: The initiator of the TCP connection MUST provide this key [..]
  72. // at the first Login of the Login Phase for every connection.
  73. response.Status = LoginResponseStatusName.InitiatorError;
  74. return response;
  75. }
  76. string sessionType = request.LoginParameters.ValueOf("SessionType");
  77. if (sessionType == "Discovery")
  78. {
  79. session.IsDiscovery = true;
  80. }
  81. else //sessionType == "Normal" or unspecified (default is Normal)
  82. {
  83. session.IsDiscovery = false;
  84. if (request.LoginParameters.ContainsKey("TargetName"))
  85. {
  86. string targetName = request.LoginParameters.ValueOf("TargetName");
  87. int targetIndex = GetTargetIndex(availableTargets, targetName);
  88. if (targetIndex >= 0)
  89. {
  90. target = availableTargets[targetIndex];
  91. if (!target.AuthorizeInitiator(connection.InitiatorEndPoint, connection.InitiatorName))
  92. {
  93. response.Status = LoginResponseStatusName.AuthorizationFailure;
  94. return response;
  95. }
  96. }
  97. else
  98. {
  99. response.Status = LoginResponseStatusName.NotFound;
  100. return response;
  101. }
  102. }
  103. else
  104. {
  105. // RFC 3720: For any connection within a session whose type is not "Discovery", the first Login Request MUST also include the TargetName key=value pair.
  106. response.Status = LoginResponseStatusName.InitiatorError;
  107. return response;
  108. }
  109. }
  110. }
  111. if (request.CurrentStage == 0)
  112. {
  113. response.LoginParameters.Add("AuthMethod", "None");
  114. if (target != null)
  115. {
  116. // RFC 3720: During the Login Phase the iSCSI target MUST return the TargetPortalGroupTag key with the first Login Response PDU with which it is allowed to do so
  117. response.LoginParameters.Add("TargetPortalGroupTag", "1");
  118. }
  119. if (request.Transit)
  120. {
  121. if (request.NextStage == 3)
  122. {
  123. session.IsFullFeaturePhase = true;
  124. }
  125. else if (request.NextStage != 1)
  126. {
  127. response.Status = LoginResponseStatusName.InitiatorError;
  128. }
  129. }
  130. }
  131. else if (request.CurrentStage == 1)
  132. {
  133. UpdateOperationalParameters(request.LoginParameters, session, connection);
  134. response.LoginParameters = GetLoginOperationalParameters(session, connection);
  135. if (request.Transit)
  136. {
  137. if (request.NextStage == 3)
  138. {
  139. session.IsFullFeaturePhase = true;
  140. }
  141. else
  142. {
  143. response.Status = LoginResponseStatusName.InitiatorError;
  144. }
  145. }
  146. }
  147. else
  148. {
  149. // Not valid
  150. response.Status = LoginResponseStatusName.InitiatorError;
  151. }
  152. return response;
  153. }
  154. private static int GetTargetIndex(List<ISCSITarget> targets, string targetName)
  155. {
  156. for (int index = 0; index < targets.Count; index++)
  157. {
  158. if (String.Equals(targets[index].TargetName, targetName, StringComparison.InvariantCultureIgnoreCase))
  159. {
  160. return index;
  161. }
  162. }
  163. return -1;
  164. }
  165. public static void UpdateOperationalParameters(KeyValuePairList<string, string> loginParameters, SessionParameters sessionParameters, ConnectionParameters connectionParameters)
  166. {
  167. sessionParameters.InitialR2T = ISCSIServer.OfferedInitialR2T;
  168. sessionParameters.ImmediateData = ISCSIServer.OfferedImmediateData;
  169. sessionParameters.MaxBurstLength = ISCSIServer.OfferedMaxBurstLength;
  170. sessionParameters.FirstBurstLength = ISCSIServer.OfferedFirstBurstLength;
  171. sessionParameters.MaxConnections = ISCSIServer.OfferedMaxConnections;
  172. sessionParameters.DataPDUInOrder = ISCSIServer.OfferedDataPDUInOrder;
  173. sessionParameters.DataSequenceInOrder = ISCSIServer.OfferedDataSequenceInOrder;
  174. sessionParameters.DefaultTime2Wait = ISCSIServer.OfferedDefaultTime2Wait;
  175. sessionParameters.DefaultTime2Retain = ISCSIServer.OfferedDefaultTime2Retain;
  176. sessionParameters.MaxOutstandingR2T = ISCSIServer.OfferedMaxOutstandingR2T;
  177. string value = loginParameters.ValueOf("MaxRecvDataSegmentLength");
  178. if (value != null)
  179. {
  180. connectionParameters.InitiatorMaxRecvDataSegmentLength = Convert.ToInt32(value);
  181. }
  182. value = loginParameters.ValueOf("InitialR2T");
  183. if (value != null)
  184. {
  185. sessionParameters.InitialR2T = (value == "Yes") || ISCSIServer.OfferedInitialR2T;
  186. }
  187. value = loginParameters.ValueOf("ImmediateData");
  188. if (value != null)
  189. {
  190. sessionParameters.ImmediateData = (value == "Yes") && ISCSIServer.OfferedImmediateData;
  191. }
  192. value = loginParameters.ValueOf("MaxBurstLength");
  193. if (value != null)
  194. {
  195. sessionParameters.MaxBurstLength = Math.Min(Convert.ToInt32(value), ISCSIServer.OfferedMaxBurstLength);
  196. }
  197. value = loginParameters.ValueOf("FirstBurstLength");
  198. if (value != null)
  199. {
  200. sessionParameters.FirstBurstLength = Math.Min(Convert.ToInt32(value), ISCSIServer.OfferedFirstBurstLength);
  201. }
  202. value = loginParameters.ValueOf("MaxConnections");
  203. if (value != null)
  204. {
  205. sessionParameters.MaxConnections = Math.Min(Convert.ToInt32(value), ISCSIServer.OfferedMaxConnections);
  206. }
  207. value = loginParameters.ValueOf("DataPDUInOrder");
  208. if (value != null)
  209. {
  210. sessionParameters.DataPDUInOrder = (value == "Yes") || ISCSIServer.OfferedDataPDUInOrder;
  211. }
  212. value = loginParameters.ValueOf("DataSequenceInOrder");
  213. if (value != null)
  214. {
  215. sessionParameters.DataSequenceInOrder = (value == "Yes") || ISCSIServer.OfferedDataSequenceInOrder;
  216. }
  217. value = loginParameters.ValueOf("DefaultTime2Wait");
  218. if (value != null)
  219. {
  220. sessionParameters.DefaultTime2Wait = Math.Max(Convert.ToInt32(value), ISCSIServer.OfferedDefaultTime2Wait);
  221. }
  222. value = loginParameters.ValueOf("DefaultTime2Retain");
  223. if (value != null)
  224. {
  225. sessionParameters.DefaultTime2Retain = Math.Min(Convert.ToInt32(value), ISCSIServer.OfferedDefaultTime2Retain);
  226. }
  227. value = loginParameters.ValueOf("MaxOutstandingR2T");
  228. if (value != null)
  229. {
  230. sessionParameters.MaxOutstandingR2T = Math.Min(Convert.ToInt32(value), ISCSIServer.OfferedMaxOutstandingR2T);
  231. }
  232. }
  233. public static KeyValuePairList<string, string> GetLoginOperationalParameters(SessionParameters sessionParameters, ConnectionParameters connectionParameters)
  234. {
  235. KeyValuePairList<string, string> loginParameters = new KeyValuePairList<string, string>();
  236. loginParameters.Add("HeaderDigest", "None");
  237. loginParameters.Add("DataDigest", "None");
  238. loginParameters.Add("MaxRecvDataSegmentLength", connectionParameters.TargetMaxRecvDataSegmentLength.ToString());
  239. if (!sessionParameters.IsDiscovery)
  240. {
  241. loginParameters.Add("ErrorRecoveryLevel", ISCSIServer.OfferedErrorRecoveryLevel.ToString());
  242. loginParameters.Add("InitialR2T", sessionParameters.InitialR2T ? "Yes" : "No"); // Microsoft iSCSI Target support InitialR2T = No
  243. loginParameters.Add("ImmediateData", sessionParameters.ImmediateData ? "Yes" : "No");
  244. loginParameters.Add("MaxBurstLength", sessionParameters.MaxBurstLength.ToString());
  245. loginParameters.Add("FirstBurstLength", sessionParameters.FirstBurstLength.ToString());
  246. loginParameters.Add("MaxConnections", sessionParameters.MaxConnections.ToString());
  247. loginParameters.Add("DataPDUInOrder", sessionParameters.DataPDUInOrder ? "Yes" : "No");
  248. loginParameters.Add("DataSequenceInOrder", sessionParameters.DataSequenceInOrder ? "Yes" : "No");
  249. loginParameters.Add("MaxOutstandingR2T", sessionParameters.MaxOutstandingR2T.ToString());
  250. }
  251. loginParameters.Add("DefaultTime2Wait", sessionParameters.DefaultTime2Wait.ToString());
  252. loginParameters.Add("DefaultTime2Retain", sessionParameters.DefaultTime2Retain.ToString());
  253. return loginParameters;
  254. }
  255. internal static TextResponsePDU GetTextResponsePDU(TextRequestPDU request, List<ISCSITarget> targets)
  256. {
  257. TextResponsePDU response = new TextResponsePDU();
  258. response.Final = true;
  259. response.InitiatorTaskTag = request.InitiatorTaskTag;
  260. KeyValuePairList<string, string> entries = new KeyValuePairList<string, string>();
  261. foreach (ISCSITarget target in targets)
  262. {
  263. entries.Add("TargetName", target.TargetName);
  264. }
  265. response.Text = KeyValuePairUtils.ToNullDelimitedString(entries);
  266. return response;
  267. }
  268. internal static LogoutResponsePDU GetLogoutResponsePDU(LogoutRequestPDU request)
  269. {
  270. LogoutResponsePDU response = new LogoutResponsePDU();
  271. response.Response = LogoutResponse.ClosedSuccessfully;
  272. response.Final = true;
  273. response.InitiatorTaskTag = request.InitiatorTaskTag;
  274. return response;
  275. }
  276. }
  277. }