Use o Alibaba Cloud OSS SDK for Python para configurar regras de acesso com base no cabeçalho de requisição Referer, como definir uma lista de permissões de Referer, uma lista de bloqueios de Referer e especificar se cabeçalhos Referer vazios são permitidos. Essas configurações impedem que cabeçalhos Referer específicos acessem seus arquivos do OSS, evitando o uso não autorizado dos seus recursos e custos desnecessários de tráfego.
Pré-requisitos
Antes de configurar a proteção contra hotlink, certifique-se de entender este recurso. Para mais informações, consulte Hotlink protection.
O código de exemplo neste tópico usa a região China (Hangzhou) (ID:
cn-hangzhou) como exemplo. Por padrão, o SDK utiliza 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 obter mais informações sobre as regiões do OSS e seus respectivos endpoints, consulte OSS regions and endpoints.Para definir ou excluir configurações de proteção contra hotlink, você deve ter a permissão
oss:PutBucketReferer. Para obter as configurações de proteção contra hotlink, você deve ter a permissãooss:GetBucketReferer. Para saber mais, consulte Grant custom permissions to a RAM user.
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 |
Os parâmetros da requisição. Para mais detalhes, consulte PutBucketRefererRequest |
|
GetBucketRefererRequest |
Os parâmetros da requisição. Para mais detalhes, consulte GetBucketRefererRequest |
Valores de retorno
|
Tipo |
Descrição |
|
PutBucketRefererResult |
O valor de retorno. Para mais detalhes, consulte PutBucketRefererResult |
|
GetBucketRefererResult |
O valor de retorno. Para mais detalhes, consulte GetBucketRefererResult |
Para a definição completa do método para configurar a proteção contra hotlink, consulte put_bucket_referer.
Para a definição completa do método para obter as 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 obter informações sobre como solucionar erros comuns que ocorrem ao configurar a proteção contra hotlink, consulte 33-REFERER.
Para o código de exemplo completo para configurar a proteção contra hotlink, consulte put_bucket_referer.py.
Para o código de exemplo completo para obter as configurações de proteção contra hotlink, consulte get_bucket_referer.py.