El SDK de Alibaba Cloud OSS para Python permite configurar reglas de acceso basadas en el encabezado de solicitud Referer. Entre las opciones disponibles se encuentran establecer una lista de permitidos de Referer, una lista de bloqueados de Referer y especificar si se permiten encabezados Referer vacíos. Esta configuración impide que encabezados Referer específicos accedan a sus archivos de OSS, evita el uso no autorizado de sus recursos y reduce costos de tráfico innecesarios.
Requisitos previos
Antes de configurar la protección contra hotlinking, asegúrese de comprender esta función. Para obtener más información, consulte Hotlink protection.
El código de ejemplo de este tema usa la región China (Hangzhou) (ID:
cn-hangzhou) como referencia. De forma predeterminada, se usa el endpoint público. Si desea acceder a OSS desde otros servicios de Alibaba Cloud en la misma región, utilice el endpoint interno. Para obtener más información sobre las regiones de OSS y sus endpoints correspondientes, consulte OSS regions and endpoints.Para establecer o eliminar configuraciones de protección contra hotlinking, debe contar con el permiso
oss:PutBucketReferer. Para recuperar dichas configuraciones, requiere el permisooss:GetBucketReferer. Para obtener más información, consulte Grant custom permissions to a RAM user.
Definiciones de métodos
Establecer la protección contra hotlinking
put_bucket_referer(request: PutBucketRefererRequest, **kwargs) → PutBucketRefererResult
Obtener la configuración de protección contra hotlinking
get_bucket_referer(request: GetBucketRefererRequest, **kwargs) → GetBucketRefererResult
Parámetros de solicitud
|
Parámetro |
Tipo |
Descripción |
|
request |
PutBucketRefererRequest |
Los parámetros de la solicitud. Para obtener más información, consulte PutBucketRefererRequest |
|
GetBucketRefererRequest |
Los parámetros de la solicitud. Para obtener más información, consulte GetBucketRefererRequest |
Valores de retorno
|
Tipo |
Descripción |
|
PutBucketRefererResult |
El valor de retorno. Para obtener más información, consulte PutBucketRefererResult |
|
GetBucketRefererResult |
El valor de retorno. Para obtener más información, consulte GetBucketRefererResult |
Para consultar la definición completa del método que establece la protección contra hotlinking, revise put_bucket_referer.
Para consultar la definición completa del método que recupera la configuración de protección contra hotlinking, revise get_bucket_referer.
Ejemplos
Establecer la protección contra hotlinking
Obtener la configuración de protección contra hotlinking
Referencias
Para obtener información sobre cómo solucionar errores comunes al configurar la protección contra hotlinking, consulte 33-REFERER.
Para consultar el código de ejemplo completo para establecer la protección contra hotlinking, revise put_bucket_referer.py.
Para consultar el código de ejemplo completo para recuperar la configuración de protección contra hotlinking, revise get_bucket_referer.py.