Com o Alibaba Cloud OSS SDK for Python, você configura regras de acesso com base no cabeçalho de requisição Referer. Defina uma lista de permissões de Referer, uma lista de bloqueios de Referer e especifique se cabeçalhos Referer vazios são permitidos. Essas configurações impedem que cabeçalhos Referer específicos acessem seus arquivos do OSS, evitam o uso não autorizado dos recursos e reduzem custos desnecessários de tráfego.
Pré-requisitos
Antes de configurar a proteção contra hotlink, compreenda esse recurso. Para mais informações, consulte Proteção contra hotlink.
Os exemplos de código neste tópico usam a região China (Hangzhou) (ID:
cn-hangzhou) como referência. Por padrão, o sistema usa o endpoint público. Para acessar o OSS a partir de outros serviços da Alibaba Cloud na mesma região, use o endpoint interno. Para mais detalhes sobre as regiões do OSS e os respectivos endpoints, consulte Regiões e endpoints do OSS.Para definir ou excluir configurações de proteção contra hotlink, você precisa da permissão
oss:PutBucketReferer. Para obter as configurações de proteção contra hotlink, você precisa da permissãooss:GetBucketReferer. Para mais informações, consulte Conceder permissões personalizadas a um usuário RAM.
Definições de métodos
Definir proteção contra hotlink
put_bucket_referer(request: PutBucketRefererRequest, **kwargs) → PutBucketRefererResult
Obter configurações de proteção contra hotlink
get_bucket_referer(request: GetBucketRefererRequest, **kwargs) → GetBucketRefererResult
Parâmetros da requisição
|
Parâmetro |
Tipo |
Descrição |
|
request |
PutBucketRefererRequest |
Parâmetros da requisição. Para mais informações, consulte PutBucketRefererRequest |
|
GetBucketRefererRequest |
Parâmetros da requisição. Para mais informações, consulte GetBucketRefererRequest |
Valores de retorno
|
Tipo |
Descrição |
|
PutBucketRefererResult |
Valor de retorno. Para mais informações, consulte PutBucketRefererResult |
|
GetBucketRefererResult |
Valor de retorno. Para mais informações, consulte GetBucketRefererResult |
Para a definição completa do método de configuração de proteção contra hotlink, consulte put_bucket_referer.
Para a definição completa do método de obtenção das configurações de proteção contra hotlink, consulte get_bucket_referer.
Exemplos
Definir proteção contra hotlink
Obter configurações de proteção contra hotlink
Referências
Para solucionar erros comuns durante a configuração da proteção contra hotlink, consulte 33-REFERER.
O código de exemplo completo para definir a proteção contra hotlink está disponível em put_bucket_referer.py.
O código de exemplo completo para obter as configurações de proteção contra hotlink encontra-se em get_bucket_referer.py.