Object Storage Service:put-bucket-referer

Notas de uso

Por padrão, uma conta Alibaba Cloud tem permissão para configurar uma lista de permissões ou de bloqueios de Referer para um bucket do OSS. Para configurar essa lista usando um usuário do RAM ou o Security Token Service (STS), é necessária a permissão oss:PutBucketReferer. Para mais informações, consulte Attach a custom policy to a RAM user.

Sintaxe do comando

ossutil api put-bucket-referer --bucket value --referer-configuration value [flags]

--referer-configuration

A opção --referer-configuration aceita os formatos XML e JSON. Se o valor da opção contiver o prefixo file://, o ossutil lê as configurações a partir de um arquivo de configuração.

• Formato XML:

  <RefererConfiguration>
    <TruncatePath>boolean</TruncatePath>
    <RefererList>
      <Referer>string</Referer>
    </RefererList>
    <RefererBlacklist>
      <Referer>string</Referer>
    </RefererBlacklist>
    <AllowEmptyReferer>boolean</AllowEmptyReferer>
    <AllowTruncateQueryString>boolean</AllowTruncateQueryString>
  </RefererConfiguration>

• Formato JSON:

  {
    "AllowEmptyReferer": boolean,
    "AllowTruncateQueryString": boolean,
    "TruncatePath": boolean,
    "RefererList": {
      "Referer": ["string", ...]
    },
    "RefererBlacklist": {
      "Referer": ["string", ...]
    }
  }

Exemplos

Os exemplos a seguir mostram como configurar uma lista de permissões ou de bloqueios de Referer para um bucket chamado examplebucket:

• Crie um arquivo de configuração chamado referer-configuration.xml e adicione o seguinte código a ele:

  <?xml version="1.0" encoding="UTF-8"?>
  <RefererConfiguration>
      <AllowEmptyReferer>false</AllowEmptyReferer>
      <AllowTruncateQueryString>true</AllowTruncateQueryString>
      <TruncatePath>true</TruncatePath>
      <RefererList>
          <Referer>http://www.aliyun.com</Referer>
          <Referer>https://www.aliyun.com</Referer>
          <Referer>http://www.*.com</Referer>
          <Referer>https://www.?.aliyuncs.com</Referer>
      </RefererList>
      <RefererBlacklist>
          <Referer>http://www.refuse.com</Referer>
          <Referer>https://*.hack.com</Referer>
          <Referer>http://ban.*.com</Referer>
          <Referer>https://www.?.deny.com</Referer>
      </RefererBlacklist>
  </RefererConfiguration>

Comando de exemplo:

ossutil api put-bucket-referer --bucket examplebucket --referer-configuration file://referer-configuration.xml

• Crie um arquivo de configuração denominado referer-configuration.json e adicione o seguinte código a ele:

  {
      "AllowEmptyReferer": "false",
      "AllowTruncateQueryString": "true",
      "TruncatePath": "true",
      "RefererList": {
          "Referer": [
              "http://www.aliyun.com",
              "https://www.aliyun.com",
              "http://www.*.com",
              "https://www.?.aliyuncs.com"
          ]
      },
      "RefererBlacklist": {
          "Referer": [
              "http://www.refuse.com",
              "https://*.hack.com",
              "http://ban.*.com",
              "https://www.?.deny.com"
          ]
      }
  }

  Exemplo de comando:

  ossutil api put-bucket-referer --bucket examplebucket --referer-configuration file://referer-configuration.json

• Configure os parâmetros no comando a seguir usando o formato JSON:

  ossutil api put-bucket-referer --bucket examplebucket --referer-configuration "{\"AllowEmptyReferer\":\"false\",\"AllowTruncateQueryString\":\"true\",\"TruncatePath\":\"true\",\"RefererList\":{\"Referer\":[\"http://www.aliyun.com\",\"https://www.aliyun.com\",\"http://www.*.com\",\"https://www.?.aliyuncs.com\"]},\"RefererBlacklist\":{\"Referer\":[\"http://www.refuse.com\",\"https://*.hack.com\",\"http://ban.*.com\",\"https://www.?.deny.com\"]}}"