net/http/http_auth_challenge_tokenizer.h

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef NET_HTTP_HTTP_AUTH_CHALLENGE_TOKENIZER_
   6 #define NET_HTTP_HTTP_AUTH_CHALLENGE_TOKENIZER_
   7
   8 #include <string>
   9
  10 #include "net/base/net_export.h"
  11 #include "net/http/http_util.h"
  12
  13 namespace net {
  14
  15 // Breaks up a challenge string into the the auth scheme and parameter list,
  16 // according to RFC 2617 Sec 1.2:
  17 //     challenge = auth-scheme 1*SP 1#auth-param
  18 //
  19 // Depending on the challenge scheme, it may be appropriate to interpret the
  20 // parameters as either a base-64 encoded string or a comma-delimited list
  21 // of name-value pairs. param_pairs() and base64_param() methods are provided
  22 // to support either usage.
  23 class NET_EXPORT_PRIVATE HttpAuthChallengeTokenizer {
  24  public:
  25   HttpAuthChallengeTokenizer(std::string::const_iterator begin,
  26                              std::string::const_iterator end);
  27
  28   // Get the original text.
  29   std::string challenge_text() const {
  30     return std::string(begin_, end_);
  31   }
  32
  33   // Get the auth scheme of the challenge.
  34   std::string::const_iterator scheme_begin() const { return scheme_begin_; }
  35   std::string::const_iterator scheme_end() const { return scheme_end_; }
  36   std::string scheme() const {
  37     return std::string(scheme_begin_, scheme_end_);
  38   }
  39
  40   std::string::const_iterator params_begin() const { return params_begin_; }
  41   std::string::const_iterator params_end() const { return params_end_; }
  42   HttpUtil::NameValuePairsIterator param_pairs() const;
  43   std::string base64_param() const;
  44
  45  private:
  46   void Init(std::string::const_iterator begin,
  47             std::string::const_iterator end);
  48
  49   std::string::const_iterator begin_;
  50   std::string::const_iterator end_;
  51
  52   std::string::const_iterator scheme_begin_;
  53   std::string::const_iterator scheme_end_;
  54
  55   std::string::const_iterator params_begin_;
  56   std::string::const_iterator params_end_;
  57 };
  58
  59 }  // namespace net
  60
  61 #endif  // NET_HTTP_HTTP_AUTH_CHALLENGE_TOKENIZER_