1 /* 2 * Copyright 2004 The WebRTC Project Authors. All rights reserved. 3 * 4 * Use of this source code is governed by a BSD-style license 5 * that can be found in the LICENSE file in the root of the source 6 * tree. An additional intellectual property rights grant can be found 7 * in the file PATENTS. All contributing project authors may 8 * be found in the AUTHORS file in the root of the source tree. 9 */ 10 11 #ifndef RTC_BASE_HTTP_COMMON_H_ 12 #define RTC_BASE_HTTP_COMMON_H_ 13 14 #include <string> 15 16 #include "absl/strings/string_view.h" 17 18 namespace rtc { 19 20 class CryptString; 21 class SocketAddress; 22 23 ////////////////////////////////////////////////////////////////////// 24 // Http Authentication 25 ////////////////////////////////////////////////////////////////////// 26 27 struct HttpAuthContext { 28 std::string auth_method; HttpAuthContextHttpAuthContext29 HttpAuthContext(absl::string_view auth) : auth_method(auth) {} ~HttpAuthContextHttpAuthContext30 virtual ~HttpAuthContext() {} 31 }; 32 33 enum HttpAuthResult { HAR_RESPONSE, HAR_IGNORE, HAR_CREDENTIALS, HAR_ERROR }; 34 35 // 'context' is used by this function to record information between calls. 36 // Start by passing a null pointer, then pass the same pointer each additional 37 // call. When the authentication attempt is finished, delete the context. 38 // TODO(bugs.webrtc.org/8905): Change "response" to "ZeroOnFreeBuffer". 39 HttpAuthResult HttpAuthenticate(absl::string_view challenge, 40 const SocketAddress& server, 41 absl::string_view method, 42 absl::string_view uri, 43 absl::string_view username, 44 const CryptString& password, 45 HttpAuthContext*& context, 46 std::string& response, 47 std::string& auth_method); 48 49 ////////////////////////////////////////////////////////////////////// 50 51 } // namespace rtc 52 53 #endif // RTC_BASE_HTTP_COMMON_H_ 54