Return-Path: X-Original-To: apmail-hc-commits-archive@www.apache.org Delivered-To: apmail-hc-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id C49F617785 for ; Sat, 14 Mar 2015 20:23:20 +0000 (UTC) Received: (qmail 64653 invoked by uid 500); 14 Mar 2015 20:23:20 -0000 Delivered-To: apmail-hc-commits-archive@hc.apache.org Received: (qmail 64611 invoked by uid 500); 14 Mar 2015 20:23:20 -0000 Mailing-List: contact commits-help@hc.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: "HttpComponents Project" Delivered-To: mailing list commits@hc.apache.org Received: (qmail 64602 invoked by uid 99); 14 Mar 2015 20:23:20 -0000 Received: from eris.apache.org (HELO hades.apache.org) (140.211.11.105) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 14 Mar 2015 20:23:20 +0000 Received: from hades.apache.org (localhost [127.0.0.1]) by hades.apache.org (ASF Mail Server at hades.apache.org) with ESMTP id 62591AC0163 for ; Sat, 14 Mar 2015 20:23:20 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1666742 - /httpcomponents/httpclient/branches/HTTPCLIENT-1625/documentation.adoc Date: Sat, 14 Mar 2015 20:23:20 -0000 To: commits@hc.apache.org From: michaelo@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20150314202320.62591AC0163@hades.apache.org> Author: michaelo Date: Sat Mar 14 20:23:20 2015 New Revision: 1666742 URL: http://svn.apache.org/r1666742 Log: Documentation depicting the design of HTTPCLIENT-1625 Added: httpcomponents/httpclient/branches/HTTPCLIENT-1625/documentation.adoc Added: httpcomponents/httpclient/branches/HTTPCLIENT-1625/documentation.adoc URL: http://svn.apache.org/viewvc/httpcomponents/httpclient/branches/HTTPCLIENT-1625/documentation.adoc?rev=1666742&view=auto ============================================================================== --- httpcomponents/httpclient/branches/HTTPCLIENT-1625/documentation.adoc (added) +++ httpcomponents/httpclient/branches/HTTPCLIENT-1625/documentation.adoc Sat Mar 14 20:23:20 2015 @@ -0,0 +1,41 @@ +Designing HTTPCLIENT-1625 +========================= +Michael Osipov +:tabsize: 4 +:toc: +:icons: +:linkcss: +:homepage: http://people.apache.org/~michaelo/issues/HTTPCLIENT-1625/ + +This documents tracks the design goals of the completele redesign the GSS-based authentication in +HttpClient. Namely, implementation decisions, known issues, awkward stuff, test environments, etc. + +Implementation Decisions +------------------------ +Implemenation decisions are comprised of several blocks like interface implementations, exception +handling, logging. + +Interface Implementations +~~~~~~~~~~~~~~~~~~~~~~~~~ +* AuthSchemeBase implements ContextAwareAuthScheme: +* AuthSchemeProvider: +* Credentials +* `UserTokenHandler`: + + +Awkward Stuff +------------- +[qanda] +Why does MalformedChallengeException not extend AuthenticationException though it is documented for +authentication purposes?:: + OK: MalformedChallengeException signals syntax violation of some sort presenting the client from + understanding the challenge whereas AuthenticationException signals inability or unwillingness + to respond to the challenge. To me these are different type of issues, but I am open to changing + it in 5.0. +The name of ChallengeState is quite confusing. Where is the state? This is merely a ChallengeHostType: + OK: We can deprecate it and replace with AuthCounterpartType or some such in 4.5. + +Todos +----- + +* Update documentation of `DefaultUserTokenHandler`