Crow/include/crow/middlewares/cors.h

201 lines
5.8 KiB
C
Raw Normal View History

2022-02-20 19:42:31 +00:00
#pragma once
#include "crow/http_request.h"
#include "crow/http_response.h"
#include "crow/routing.h"
2022-02-20 19:42:31 +00:00
namespace crow
{
struct CORSHandler;
/// Used for tuning CORS policies
2022-02-20 19:42:31 +00:00
struct CORSRules
{
friend struct crow::CORSHandler;
/// Set Access-Control-Allow-Origin. Default is "*"
2022-02-20 19:42:31 +00:00
CORSRules& origin(const std::string& origin)
{
origin_ = origin;
return *this;
}
/// Set Access-Control-Allow-Methods. Default is "*"
2022-02-20 19:42:31 +00:00
CORSRules& methods(crow::HTTPMethod method)
{
add_list_item(methods_, crow::method_name(method));
return *this;
}
/// Set Access-Control-Allow-Methods. Default is "*"
2022-02-20 19:42:31 +00:00
template<typename... Methods>
CORSRules& methods(crow::HTTPMethod method, Methods... method_list)
{
add_list_item(methods_, crow::method_name(method));
methods(method_list...);
return *this;
}
/// Set Access-Control-Allow-Headers. Default is "*"
2022-02-20 19:42:31 +00:00
CORSRules& headers(const std::string& header)
{
add_list_item(headers_, header);
return *this;
}
/// Set Access-Control-Allow-Headers. Default is "*"
2022-02-20 19:42:31 +00:00
template<typename... Headers>
CORSRules& headers(const std::string& header, Headers... header_list)
{
add_list_item(headers_, header);
headers(header_list...);
return *this;
}
/// Set Access-Control-Max-Age. Default is none
2022-02-20 19:42:31 +00:00
CORSRules& max_age(int max_age)
{
max_age_ = std::to_string(max_age);
return *this;
}
/// Enable Access-Control-Allow-Credentials
2022-02-20 19:42:31 +00:00
CORSRules& allow_credentials()
{
allow_credentials_ = true;
return *this;
}
/// Ignore CORS and don't send any headers
2022-02-20 19:42:31 +00:00
void ignore()
{
ignore_ = true;
}
/// Handle CORS on specific prefix path
CORSRules& prefix(const std::string& prefix);
/// Handle CORS for specific blueprint
CORSRules& blueprint(const Blueprint& bp);
/// Global CORS policy
CORSRules& global();
2022-02-20 19:42:31 +00:00
private:
CORSRules() = delete;
CORSRules(CORSHandler* handler):
handler_(handler) {}
/// build comma separated list
2022-02-20 19:42:31 +00:00
void add_list_item(std::string& list, const std::string& val)
{
if (list == "*") list = "";
if (list.size() > 0) list += ", ";
list += val;
}
/// Set header `key` to `value` if it is not set
void set_header_no_override(const std::string& key, const std::string& value, crow::response& res)
2022-02-20 19:42:31 +00:00
{
if (value.size() == 0) return;
if (!get_header_value(res.headers, key).empty()) return;
res.add_header(key, value);
}
/// Set response headers
2022-02-20 19:42:31 +00:00
void apply(crow::response& res)
{
if (ignore_) return;
set_header_no_override("Access-Control-Allow-Origin", origin_, res);
set_header_no_override("Access-Control-Allow-Methods", methods_, res);
set_header_no_override("Access-Control-Allow-Headers", headers_, res);
set_header_no_override("Access-Control-Max-Age", max_age_, res);
if (allow_credentials_) set_header_no_override("Access-Control-Allow-Credentials", "true", res);
2022-02-20 19:42:31 +00:00
}
bool ignore_ = false;
2022-02-22 14:38:51 +00:00
// TODO: support multiple origins that are dynamically selected
2022-02-20 19:42:31 +00:00
std::string origin_ = "*";
std::string methods_ = "*";
std::string headers_ = "*";
std::string max_age_;
bool allow_credentials_ = false;
CORSHandler* handler_;
2022-02-20 19:42:31 +00:00
};
2022-02-22 14:38:51 +00:00
/// CORSHandler is a global middleware for setting CORS headers.
2022-02-22 14:38:51 +00:00
///
/// By default, it sets Access-Control-Allow-Origin/Methods/Headers to "*".
/// The default behaviour can be changed with the `global()` cors rule.
/// Additional rules for prexies can be added with `prefix()`.
2022-02-20 19:42:31 +00:00
struct CORSHandler
{
struct context
{};
void before_handle(crow::request& /*req*/, crow::response& /*res*/, context& /*ctx*/)
{}
void after_handle(crow::request& req, crow::response& res, context& /*ctx*/)
{
auto& rule = find_rule(req.url);
rule.apply(res);
}
/// Handle CORS on a specific prefix path
2022-02-20 19:42:31 +00:00
CORSRules& prefix(const std::string& prefix)
{
rules.emplace_back(prefix, CORSRules(this));
return rules.back().second;
}
/// Handle CORS for a specific blueprint
CORSRules& blueprint(const Blueprint& bp)
{
rules.emplace_back(bp.prefix(), CORSRules(this));
2022-02-20 19:42:31 +00:00
return rules.back().second;
}
/// Get the global CORS policy
2022-02-20 19:42:31 +00:00
CORSRules& global()
{
return default_;
}
private:
CORSRules& find_rule(const std::string& path)
{
// TODO: use a trie in case of many rules
2022-02-20 19:42:31 +00:00
for (auto& rule : rules)
{
// Check if path starts with a rules prefix
2022-02-20 19:42:31 +00:00
if (path.rfind(rule.first, 0) == 0)
{
return rule.second;
}
}
return default_;
}
std::vector<std::pair<std::string, CORSRules>> rules;
CORSRules default_ = CORSRules(this);
2022-02-20 19:42:31 +00:00
};
2022-04-08 11:00:17 +00:00
inline CORSRules& CORSRules::prefix(const std::string& prefix)
{
return handler_->prefix(prefix);
}
2022-04-08 11:00:17 +00:00
inline CORSRules& CORSRules::blueprint(const Blueprint& bp)
{
return handler_->blueprint(bp);
}
2022-04-08 11:00:17 +00:00
inline CORSRules& CORSRules::global()
{
return handler_->global();
}
2022-02-20 19:42:31 +00:00
} // namespace crow