Microsoft Information Protection (MIP) SDK for C++: Reference 1.15
Doxygen-generated documentation for MIP SDK written in C++
Loading...
Searching...
No Matches
http_request.h
Go to the documentation of this file.
1/*
2 *
3 * Copyright (c) Microsoft Corporation.
4 * All rights reserved.
5 *
6 * This code is licensed under the MIT License.
7 *
8 * Permission is hereby granted, free of charge, to any person obtaining a copy
9 * of this software and associated documentation files(the "Software"), to deal
10 * in the Software without restriction, including without limitation the rights
11 * to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
12 * copies of the Software, and to permit persons to whom the Software is
13 * furnished to do so, subject to the following conditions :
14 *
15 * The above copyright notice and this permission notice shall be included in
16 * all copies or substantial portions of the Software.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
21 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
24 * THE SOFTWARE.
25 *
26 */
27/**
28 * @brief Contains HttpRequest interface used by HttpDelegate
29 *
30 * @file http_request.h
31 */
32
33#ifndef API_MIP_HTTP_REQUEST_H_
34#define API_MIP_HTTP_REQUEST_H_
35
36#include <vector>
37
38#include "mip/common_types.h"
39#include "mip/mip_namespace.h"
40
41MIP_NAMESPACE_BEGIN
42
43/**
44 * @brief HTTP request type
45 */
46enum class HttpRequestType {
47 Get, /**< GET */
48 Post, /**< POST */
49};
50
51/**
52 * @brief Minimum TLS version
53 */
55 None = 0,
56 TLS1_2 = 1, /**< TLS version 1.2 **/
57 TLS1_3 = 2, /**< TLS version 1.3 **/
58};
59
60
61/**
62 * @brief Interface that describes a single HTTP request
63 */
65public:
66 /**
67 * @brief Gets request ID
68 *
69 * @return Request ID
70 *
71 * @note The corresponding HttpResponse will have the same ID
72 */
73 virtual const std::string& GetId() const = 0;
74
75 /**
76 * @brief Get request type
77 *
78 * @return Request type
79 */
80 virtual HttpRequestType GetRequestType() const = 0;
81
82 /**
83 * @brief Get request url
84 *
85 * @return Request url
86 */
87 virtual const std::string& GetUrl() const = 0;
88
89 /**
90 * @brief Get request body
91 *
92 * @return Request body
93 */
94 virtual const std::vector<uint8_t>& GetBody() const = 0;
95
96 /**
97 * @brief Get request headers
98 *
99 * @return Request headers
100 */
101 virtual const std::map<std::string, std::string, CaseInsensitiveComparator>& GetHeaders() const = 0;
102
103 /**
104 * @brief Get the minimum required TLS version for this request.
105 *
106 * @return The minimum required TLS version the Http transport provider should be secured with.
107 */
109
110 /** @cond DOXYGEN_HIDE */
111 virtual ~HttpRequest() {}
112 /** @endcond */
113};
114
115MIP_NAMESPACE_END
116#endif // API_MIP_HTTP_REQUEST_H_
117
Interface that describes a single HTTP request.
virtual const std::vector< uint8_t > & GetBody() const =0
Get request body.
virtual TransportLayerSecurityMinimumVersion GetTransportLayerSecurityMinimumVersion() const =0
Get the minimum required TLS version for this request.
virtual HttpRequestType GetRequestType() const =0
Get request type.
virtual const std::string & GetId() const =0
Gets request ID.
virtual const std::map< std::string, std::string, CaseInsensitiveComparator > & GetHeaders() const =0
Get request headers.
virtual const std::string & GetUrl() const =0
Get request url.
A file Containing the common types used by the upe, file and protection modules.
TransportLayerSecurityMinimumVersion
Minimum TLS version.
HttpRequestType
HTTP request type.
MIP namespace macros.