You can set and query the referer configuration (hotlink protection) for a bucket by using the OSS C++ SDK V2.
Usage notes
-
Before you run the sample code, replace
<region>with your region, such ascn-hangzhou. -
The sample code reads access credentials from environment variables. For more information, see Configure access credentials.
-
To set the referer configuration, you must have the
oss:PutBucketRefererpermission. To get the referer configuration, you must have theoss:GetBucketRefererpermission.
Sample code
Set referer configuration
The following code sets the referer configuration for a bucket:
#include <iostream>
#include "alibabacloud/oss2/ClientConfiguration.h"
#include "alibabacloud/oss2/OSSClient.h"
#include "alibabacloud/oss2/credentials/CredentialsProvider.h"
namespace oss = alibabacloud::oss2;
int main() {
auto conf = oss::ClientConfiguration::loadDefault();
conf.region = "<region>";
conf.credentialsProvider = std::make_shared<oss::EnvironmentVariableCredentialsProvider>();
oss::OSSClient client(conf);
oss::models::RefererList refererList;
refererList.referers.push_back("https://www.example.com");
refererList.referers.push_back("https://*.example.com");
oss::models::RefererConfiguration refConf;
refConf.allowEmptyReferer = true;
refConf.refererList = refererList;
auto outcome = client.putBucketReferer(
oss::models::PutBucketRefererRequest()
.setBucket("examplebucket")
.setRefererConfiguration(refConf));
if (!outcome.has_value()) {
auto& e = outcome.error();
std::cerr << "Failed to set the referer configuration"
<< ", code: " << e.getCode()
<< ", message: " << e.getMessage()
<< ", requestId: " << e.getRequestId() << std::endl;
return 1;
}
auto& result = outcome.value();
std::cout << "Successfully set the referer configuration"
<< ", status: " << result.getStatusCode()
<< ", requestId: " << result.getRequestId() << std::endl;
return 0;
}
Get referer configuration
The following code queries the referer configuration of a bucket:
#include <iostream>
#include "alibabacloud/oss2/ClientConfiguration.h"
#include "alibabacloud/oss2/OSSClient.h"
#include "alibabacloud/oss2/credentials/CredentialsProvider.h"
namespace oss = alibabacloud::oss2;
int main() {
auto conf = oss::ClientConfiguration::loadDefault();
conf.region = "<region>";
conf.credentialsProvider = std::make_shared<oss::EnvironmentVariableCredentialsProvider>();
oss::OSSClient client(conf);
auto outcome = client.getBucketReferer(
oss::models::GetBucketRefererRequest()
.setBucket("examplebucket"));
if (!outcome.has_value()) {
auto& e = outcome.error();
std::cerr << "Failed to get the referer configuration"
<< ", code: " << e.getCode()
<< ", message: " << e.getMessage()
<< ", requestId: " << e.getRequestId() << std::endl;
return 1;
}
auto& result = outcome.value();
auto& conf2 = result.getRefererConfiguration();
std::cout << "Successfully retrieved the referer configuration" << std::endl;
std::cout << "AllowEmptyReferer: " << conf2.allowEmptyReferer.value_or(false) << std::endl;
if (conf2.refererList) {
for (const auto& r : conf2.refererList->referers) {
std::cout << "Referer: " << r << std::endl;
}
}
return 0;
}
References
-
For the complete sample code for setting the referer configuration, visit PutBucketReferer.cpp.
-
For the complete sample code for querying the referer configuration, visit GetBucketReferer.cpp.