/// <summary> /// Performs and/or continues the authentication cycle. /// </summary> /// <param name="clientToken">The most recent token from the client.</param> /// <returns>The client's next authentication token in the cycle.</returns> /// <exception cref="ArgumentNullException"><paramref name="clientToken" /> is null.</exception> /// <exception cref="SspiException"> /// This method was called after this context was fully initialized. /// <para>or</para> /// The underlying SSPI operation failed. /// </exception> /// <remarks> /// This method is performed iteratively to start, continue, and end the authentication cycle with the server. /// Each stage works by acquiring a token from one side and presenting it to the other side, which in turn may generate a new token. /// The cycle continues until the client and server both indicate that they are done. /// </remarks> public SspiToken AcceptToken(SspiToken clientToken) { if (clientToken == null) { throw new ArgumentNullException(nameof(clientToken)); } if (Disposed) { throw new ObjectDisposedException(nameof(SecurityContext)); } else if (Initialized) { throw new SspiException("Attempted to call Initialize on a server context that was already initialized."); } SecureBuffer clientBuffer = new SecureBuffer(clientToken.Token, SecureBufferType.Token); SecureBuffer outputBuffer = new SecureBuffer(new byte[Credential.PackageInfo.MaxTokenLength], SecureBufferType.Token); SecurityStatus status = Handle.AcceptSecurityContext(outputBuffer, clientBuffer, Credential.Handle, _requestedAttributes); if (!status.IsError()) { if (status == SecurityStatus.Ok) { Initialized = true; } return(new SspiToken(outputBuffer)); } else { throw new SspiException("Failed to initialize security context for a server."); } }
/// <summary> /// Performs and/or continues the authentication cycle. /// </summary> /// <param name="serverToken">The most recent token from the server, or null if beginning the authentication cycle.</param> /// <returns>The client's next authentication token in the cycle.</returns> /// <exception cref="ArgumentNullException"><paramref name="serverToken" /> is null.</exception> /// <exception cref="SspiException"> /// This method was called before the initial token was initialized. /// <para>or</para> /// This method was called after this context was fully initialized. /// <para>or</para> /// The underlying SSPI operation failed. /// </exception> /// <remarks> /// This method is performed iteratively to start, continue, and end the authentication cycle with the server. /// Each stage works by acquiring a token from one side and presenting it to the other side, which in turn may generate a new token. /// The cycle continues until the client and server both indicate that they are done. /// </remarks> public SspiToken Initialize(SspiToken serverToken) { if (serverToken == null) { throw new ArgumentNullException(nameof(serverToken)); } if (Handle.IsInvalid) { throw new SspiException("Out-of-order usage detected: server token provided with no previous client token."); } return(Initialize(serverToken.Token)); }