ServerResponseHelper.cs 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298
  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.InitiatorName, connection.InitiatorEndPoint))
  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. string value = loginParameters.ValueOf("MaxRecvDataSegmentLength");
  168. if (value != null)
  169. {
  170. connectionParameters.InitiatorMaxRecvDataSegmentLength = Convert.ToInt32(value);
  171. }
  172. value = loginParameters.ValueOf("MaxConnections");
  173. if (value != null)
  174. {
  175. sessionParameters.MaxConnections = Math.Min(Convert.ToInt32(value), ISCSIServer.DesiredParameters.MaxConnections);
  176. }
  177. value = loginParameters.ValueOf("InitialR2T");
  178. if (value != null)
  179. {
  180. sessionParameters.InitialR2T = (value == "Yes") || ISCSIServer.DesiredParameters.InitialR2T;
  181. }
  182. value = loginParameters.ValueOf("ImmediateData");
  183. if (value != null)
  184. {
  185. sessionParameters.ImmediateData = (value == "Yes") && ISCSIServer.DesiredParameters.ImmediateData;
  186. }
  187. value = loginParameters.ValueOf("MaxBurstLength");
  188. if (value != null)
  189. {
  190. sessionParameters.MaxBurstLength = Math.Min(Convert.ToInt32(value), ISCSIServer.DesiredParameters.MaxBurstLength);
  191. }
  192. value = loginParameters.ValueOf("FirstBurstLength");
  193. if (value != null)
  194. {
  195. sessionParameters.FirstBurstLength = Math.Min(Convert.ToInt32(value), ISCSIServer.DesiredParameters.FirstBurstLength);
  196. }
  197. value = loginParameters.ValueOf("DataPDUInOrder");
  198. if (value != null)
  199. {
  200. sessionParameters.DataPDUInOrder = (value == "Yes") || ISCSIServer.DesiredParameters.DataPDUInOrder;
  201. }
  202. value = loginParameters.ValueOf("DataSequenceInOrder");
  203. if (value != null)
  204. {
  205. sessionParameters.DataSequenceInOrder = (value == "Yes") || ISCSIServer.DesiredParameters.DataSequenceInOrder;
  206. }
  207. value = loginParameters.ValueOf("DefaultTime2Wait");
  208. if (value != null)
  209. {
  210. sessionParameters.DefaultTime2Wait = Math.Max(Convert.ToInt32(value), ISCSIServer.DesiredParameters.DefaultTime2Wait);
  211. }
  212. value = loginParameters.ValueOf("DefaultTime2Retain");
  213. if (value != null)
  214. {
  215. sessionParameters.DefaultTime2Retain = Math.Min(Convert.ToInt32(value), ISCSIServer.DesiredParameters.DefaultTime2Retain);
  216. }
  217. value = loginParameters.ValueOf("MaxOutstandingR2T");
  218. if (value != null)
  219. {
  220. sessionParameters.MaxOutstandingR2T = Math.Min(Convert.ToInt32(value), ISCSIServer.DesiredParameters.MaxOutstandingR2T);
  221. }
  222. }
  223. public static KeyValuePairList<string, string> GetLoginOperationalParameters(SessionParameters sessionParameters, ConnectionParameters connectionParameters)
  224. {
  225. KeyValuePairList<string, string> loginParameters = new KeyValuePairList<string, string>();
  226. loginParameters.Add("HeaderDigest", "None");
  227. loginParameters.Add("DataDigest", "None");
  228. loginParameters.Add("MaxRecvDataSegmentLength", connectionParameters.TargetMaxRecvDataSegmentLength.ToString());
  229. if (!sessionParameters.IsDiscovery)
  230. {
  231. loginParameters.Add("MaxConnections", sessionParameters.MaxConnections.ToString());
  232. loginParameters.Add("InitialR2T", sessionParameters.InitialR2T ? "Yes" : "No"); // Microsoft iSCSI Target support InitialR2T = No
  233. loginParameters.Add("ImmediateData", sessionParameters.ImmediateData ? "Yes" : "No");
  234. loginParameters.Add("MaxBurstLength", sessionParameters.MaxBurstLength.ToString());
  235. loginParameters.Add("FirstBurstLength", sessionParameters.FirstBurstLength.ToString());
  236. loginParameters.Add("MaxOutstandingR2T", sessionParameters.MaxOutstandingR2T.ToString());
  237. loginParameters.Add("DataPDUInOrder", sessionParameters.DataPDUInOrder ? "Yes" : "No");
  238. loginParameters.Add("DataSequenceInOrder", sessionParameters.DataSequenceInOrder ? "Yes" : "No");
  239. loginParameters.Add("ErrorRecoveryLevel", sessionParameters.ErrorRecoveryLevel.ToString());
  240. }
  241. loginParameters.Add("DefaultTime2Wait", sessionParameters.DefaultTime2Wait.ToString());
  242. loginParameters.Add("DefaultTime2Retain", sessionParameters.DefaultTime2Retain.ToString());
  243. return loginParameters;
  244. }
  245. internal static TextResponsePDU GetTextResponsePDU(TextRequestPDU request, List<ISCSITarget> targets)
  246. {
  247. TextResponsePDU response = new TextResponsePDU();
  248. response.Final = true;
  249. response.InitiatorTaskTag = request.InitiatorTaskTag;
  250. KeyValuePairList<string, string> entries = new KeyValuePairList<string, string>();
  251. foreach (ISCSITarget target in targets)
  252. {
  253. entries.Add("TargetName", target.TargetName);
  254. }
  255. response.Text = KeyValuePairUtils.ToNullDelimitedString(entries);
  256. return response;
  257. }
  258. internal static LogoutResponsePDU GetLogoutResponsePDU(LogoutRequestPDU request)
  259. {
  260. LogoutResponsePDU response = new LogoutResponsePDU();
  261. response.Response = LogoutResponse.ClosedSuccessfully;
  262. response.Final = true;
  263. response.InitiatorTaskTag = request.InitiatorTaskTag;
  264. return response;
  265. }
  266. }
  267. }