put-bucket-referer - Object Storage Service - Centro de documentación de Alibaba Cloud

Configure una lista blanca o negra de Referer para un bucket de Object Storage Service (OSS). Permite especificar si se aceptan solicitudes con el campo Referer vacío y si se trunca la cadena de consulta en la URL.

Notas de uso

De forma predeterminada, una cuenta de Alibaba Cloud tiene los permisos necesarios para configurar una lista blanca o negra de Referer en un bucket de OSS. Si utiliza un usuario de RAM o Security Token Service (STS), debe contar con el permiso oss:PutBucketReferer. Para obtener más información, consulte Attach a custom policy to a RAM user.

Sintaxis del comando

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

Parámetro	Tipo	Descripción
--bucket	string	El nombre del bucket.
--referer-configuration	string	Contenedor que almacena las configuraciones de protección contra hotlinking.

Nota

El comando put-bucket-referer corresponde a la operación PutBucketReferer. Para obtener más información sobre los parámetros de esta operación, consulte PutBucketReferer.

--referer-configuration

La opción --referer-configuration es compatible con los formatos XML y JSON. Si el valor de la opción incluye el prefijo file://, ossutil lee la configuración desde un archivo de configuración.

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", ...]
  }
}

Nota

Para obtener más información sobre las opciones globales de línea de comandos compatibles, consulte Global command-line options.

Ejemplos

A continuación se muestran ejemplos de cómo configurar una lista blanca o negra de Referer para un bucket llamado examplebucket:

Cree un archivo de configuración llamado referer-configuration.xml y agregue el siguiente código:

<?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 ejemplo:

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

Cree un archivo de configuración llamado referer-configuration.json y agregue el siguiente código:

{
    "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"
        ]
    }
}

Comando de ejemplo:

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

Configure los parámetros del siguiente comando en 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\"]}}"