Referer configuration (C++ SDK V2)

更新时间:
复制 MD 格式

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 as cn-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:PutBucketReferer permission. To get the referer configuration, you must have the oss:GetBucketReferer permission.

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