Skip to main content

Config a Referer Validation ACL

Create or modify a referer validation ACL for a delivery domain name.

Request

Request-Line

POST /lls/v1.0/authentication/referer

Request Parameters

Body Parameters

ParameterTypeRequiredDescription
domainStringMandatorydelivery domain name
enableValidationBooleanMandatorywhether referer validation is enabled.
enableBlackListBooleanOptionalwhether the black list or whitelist is enabled. default is false.
false: white list is enabled.
true: black list is enabled.
when enableValidation is true, this parameter is mandatory.
refererListArrayOptionalDomain name list.
when enableValidation is true, this parameter is mandatory.

Response

Response Body

Status Codes, Error Codes and Error Messages

Status CodeError CodeError Message
400LLS.Domain.InvalidDomain name invalid.

Examples

Create a Referer Validation ACL with white list

Request Body

{
"domain": "ingest.example.com",
"enableValidation": true,
"enableBlackList": false,
"refererList": ["1.example.com", "2.example.com"]
}

Create a Referer Validation ACL with black list

Request Body

{
"domain": "ingest.example.com",
"enableValidation": true,
"enableBlackList": true,
"refererList": ["a.leech.com", "b.leech.com"]
}

Disable a Referer Validation ACL with white list

Request Body

{
"domain": "ingest.example.com",
"enableValidation": false
}

Best Practices

Rate Limiting

Rate Limits

Rate limiting is posed upon the API, please kindly check your API calls to ensure complying with the rate limit below:

  • 100 requests per minute
  • 1000 requests per hour