Edge Security Acceleration:Funções de processamento de requisições

• name: nome do cabeçalho de requisição a adicionar. Tipo de dado: string.
• value: valor do cabeçalho de requisição a adicionar. Tipo de dado: string.
• append: defina se deve anexar um cabeçalho de requisição com o value especificado caso já exista um cabeçalho com o mesmo nome. Valores válidos: true e false. Valor padrão: false. Tipo de dado: Booleano. Se definido como false, o valor especificado substituirá o valor do cabeçalho de requisição existente.

add_req_header('USER-DEFINED-REQ-1', '1')
add_req_header('USER-DEFINED-REQ-1', 'x', true)
add_req_header('USER-DEFINED-REQ-2', '2')
del_req_header('USER-DEFINED-REQ-2')

Note: The following request headers are added:
USER-DEFINED-REQ-1: 1
USER-DEFINED-REQ-1: x

The USER-DEFINED-REQ-2 header is added and then deleted. Therefore, the USER-DEFINED-REQ-2 request header is not included in requests that are redirected to the origin server.

add_req_header('USER-DEFINED-REQ-1', '1')
add_req_header('USER-DEFINED-REQ-1', 'x', true)
add_req_header('USER-DEFINED-REQ-2', '2')
del_req_header('USER-DEFINED-REQ-2')

Note: The following request headers are added:
USER-DEFINED-REQ-1: 1
USER-DEFINED-REQ-1: x

The USER-DEFINED-REQ-2 header is added and then deleted. Therefore, the USER-DEFINED-REQ-2 request header is not included in requests that are redirected to the origin server.

• name: nome do cabeçalho de resposta a adicionar. Tipo de dado: string.
• value: valor do cabeçalho de resposta a adicionar. Tipo de dado: string.
  É possível especificar uma das expressões a seguir para o parâmetro value para permitir a substituição dinâmica do valor durante a fase de resposta:

  • ${x}: substituído pelo valor de ngx.var.x.
  • @{y}: substituído pelo valor do response header y.
• append: defina se deve anexar um cabeçalho de resposta com o value especificado caso já exista um cabeçalho com o mesmo nome. Valores válidos: true e false. Valor padrão: false. Tipo de dado: Booleano. Se definido como false, o valor especificado substituirá o valor do cabeçalho de resposta existente.

add_rsp_header('USER-DEFINED-RSP-1', '1')
add_rsp_header('USER-DEFINED-RSP-1', 'x', true)
add_rsp_header('USER-DEFINED-RSP-2', '2')
del_rsp_header('USER-DEFINED-RSP-2')

Note: The following response headers are added:
USER-DEFINED-RSP-1: 1
USER-DEFINED-RSP-1: x

The USER-DEFINED-RSP-2 header is added and then deleted. Therefore, the USER-DEFINED-RSP-2 header is not included in the responses.

add_rsp_header('USER-DEFINED-RSP-1', '1')
add_rsp_header('USER-DEFINED-RSP-1', 'x', true)
add_rsp_header('USER-DEFINED-RSP-2', '2')
del_rsp_header('USER-DEFINED-RSP-2')

The following response headers are added:
USER-DEFINED-RSP-1: 1
USER-DEFINED-RSP-1: x

The USER-DEFINED-RSP-2 header is added and then deleted. Therefore, the USER-DEFINED-RSP-2 header is not included in the responses.

my_args = []
set(my_args, 'signature', 'da9dc4b7-87ae-4330-aaaf-e5454e2c2af1')
set(my_args, 'algo', 'private sign1')
my_args_str = encode_args(my_args)
add_rsp_header('X-DSL-ENCODE-ARGS', my_args_str)

to_args = decode_args(my_args_str)
if get(to_args, 'algo') {
    add_rsp_header('X-DSL-DECODE-ARGS-ALGO', get(to_args, 'algo'))
}
if get(to_args, 'signature') {
    add_rsp_header('X-DSL-DECODE-ARGS-SIGN', get(to_args, 'signature'))
}

Output: The following response headers are added:
X-DSL-ENCODE-ARGS: signature=da9dc4b7-87ae-4330-aaaf-e5454e2c2af1&algo=private%20sign1
X-DSL-DECODE-ARGS-ALGO: private sign1
X-DSL-DECODE-ARGS-SIGN: da9dc4b7-87ae-4330-aaaf-e5454e2c2af1

my_args = []
set(my_args, 'signature', 'da9dc4b7-87ae-4330-aaaf-e5454e2c2af1')
set(my_args, 'algo', 'private sign1')
my_args_str = encode_args(my_args)
add_rsp_header('X-DSL-ENCODE-ARGS', my_args_str)

to_args = decode_args(my_args_str)
if get(to_args, 'algo') {
    add_rsp_header('X-DSL-DECODE-ARGS-ALGO', get(to_args, 'algo'))
}
if get(to_args, 'signature') {
    add_rsp_header('X-DSL-DECODE-ARGS-SIGN', get(to_args, 'signature'))
}

Output: The following response headers are added:
X-DSL-ENCODE-ARGS: signature=da9dc4b7-87ae-4330-aaaf-e5454e2c2af1&algo=private%20sign1
X-DSL-DECODE-ARGS-ALGO: private sign1
X-DSL-DECODE-ARGS-SIGN: da9dc4b7-87ae-4330-aaaf-e5454e2c2af1

• url (string): A URL de destino da operação.
  • Quando flag é redirect ou break, apenas o caminho da URI é reescrito. O parâmetro url especifique a nova URI de destino.
  • Quando flag é enhance_redirect ou enhance_break, toda a URI (caminho e parâmetros de consulta) é substituída. O parâmetro url especifique a nova URI de destino e seus parâmetros.
• (string): O modo de reescrita.
  • code: Reescreve apenas o caminho da URI e executa um redirecionamento, preservando os parâmetros de consulta originais. Por padrão, usa o código de status HTTP 302. É possível especificar um código diferente (301, 303, 307 ou 308) com o parâmetro .
  • : Reescreve o caminho da URI para a url especificada, preservando os parâmetros de consulta originais.
  • redirect: Semelhante ao redirect, mas modifica toda a URI, incluindo o caminho e os parâmetros de consulta.
  • break: Semelhante ao break, mas modifica toda a URI, incluindo o caminho e os parâmetros de consulta.
• code (number, opcional): O código de status HTTP a usar para o redirecionamento. Este parâmetro se aplica apenas quando flag é redirect ou enhance_redirect.

• truePara uma operação de reescrita (, ), a função retorna .
• Para uma operação de redirecionamento (redirect, enhance_redirect), a função encerra o processamento da requisição atual e não retorna valor.

if and($arg_mode, eq($arg_mode, 'rewrite:enhance_break')) {
  rewrite('/a/example/examplefile.txt?k=v', 'enhance_break')
}
// Rewrites the URI and query parameters for the origin request and cache key to /a/example/examplefile.txt?k=v.

if and($arg_mode, eq($arg_mode, 'rewrite:enhance_redirect')) {
  rewrite('/a/example/examplefile.txt?k=v', 'enhance_redirect')
}
if and($arg_mode, eq($arg_mode, 'rewrite:enhance_redirect_301')) {
  rewrite('/a/example/examplefile.txt?k=v', 'enhance_redirect', 301)
}
// Redirects the client to /a/example/examplefile.txt?k=v with a 302 or 301 HTTP status code.

if and($arg_mode, eq($arg_mode, 'rewrite:break')) {
  rewrite('/a/example/examplefile.txt', 'break')
}
// Rewrites the URI path for the origin request and cache key to /a/example/examplefile.txt, preserving the original query parameters.

if and($arg_mode, eq($arg_mode, 'rewrite:redirect')) {
  rewrite('/a/example/examplefile.txt', 'redirect')
}
if and($arg_mode, eq($arg_mode, 'rewrite:redirect_301')) {
  rewrite('/a/example/examplefile.txt', 'redirect', 301)
}
// Redirects the client to /a/example/examplefile.txt with a 302 or 301 HTTP status code, preserving the original query parameters.

say('hello')
print('byebye')
print('byebye')

Output:
hello
byebyebyebye

say('hello')
print('byebye')
print('byebye')

Output:
hello
byebyebyebye

• code: o código de status HTTP a retornar.
• body: o corpo da resposta.

• Exemplo 1

  if not($arg_key) {
      exit(403)
  }
  Note: If a request does not include the key parameter, the request is denied and the HTTP 403 status code is returned. 
  
  if not($cookie_user) {
      exit(403, 'not cookie user')
  }
  Note: If a request does not include cookie_user, the request is denied and a response that contains the body "not cookie user" is returned with the HTTP 403 status code.
  
  if not(0) {
      exit(403)
  }
  Note: The not(0) function returns a value of false.
  
  if not(false) {
      exit(403)
  }
  Note: The not(false) function returns a value of true.

• Exemplo 2

  pcs = capture_re($request_uri,'^/([^/]+)/([^/]+)([^?]+)\?(.*)')
      sec1 = get(pcs, 1)
      sec2 = get(pcs, 2)
      sec3 = get(pcs, 3)
      if or(not(sec1), not(sec2), not(sec3)) {
         add_rsp_header('X-TENGINE-ERROR', 'auth failed - missing necessary uri set')
         exit(403)
      }
      digest = md5(concat(sec1, sec3))
      if ne(digest, sec2) {
          add_rsp_header('X-TENGINE-ERROR', 'auth failed - invalid digest')
          exit(403)
      }

• Se o cabeçalho de resposta especificado existir, ele será retornado. O tipo de dado do cabeçalho de resposta é dictionary ou string.
• Se o cabeçalho de resposta especificado não existir, o valor false será retornado.

ct = get_rsp_header('content-type')
if ct {
    add_rsp_header('origin-content-type', 'is')
} else {
      add_rsp_header('origin-content-type', 'no')
}

• k: o nome do cookie.
• v: o valor do cookie.
• properties: as propriedades do cookie. Este parâmetro é opcional. Para mais informações, consulte Set-Cookie.

add_rsp_cookie('user', 'edgescript')

add_rsp_cookie('login_time', tostring(now()), [
    'path' = '/'
])

expires = cookie_time(time())
add_rsp_cookie('psid', 'SDF93745HFSDF2934JKHG', [
    'path' = '/play',
    'domain' = 'foo.com',
    'secure' = true,
    'httponly' = true,
    'expires' = expires,
    'max_age' = 100,
    'samesite' = 'Strict',
    'extension' = 'xxt3s'
])

Set-Cookie: user=edgescript
    Set-Cookie: login_time=1582538968.912; Path=/
    Set-Cookie: psid=SDF93745HFSDF2934JKHG; Expires=Mon, 24-Feb-20 10:09:28 GMT; Max-Age=100; Domain=foo.com; Path=/play; Secure; HttpOnly; SameSite=Strict; xxt3s