Wordpress check_admin_referer ()

Asegura la intención al verificar que un usuario fue remitido desde otra página de administración con el nonce de seguridad correcto.

Descripción

Esta función asegura que el usuario tiene la intención de realizar una acción determinada, lo que ayuda a protegerse contra ataques de estilo clickjacking. Verifica la intención, no la autorización, por lo tanto, no verifica las capacidades del usuario. Esto debe realizarse con current_user_can() o similar.

Si el valor de nonce no es válido, la función se cerrará con un “¿Está seguro?” mensaje de estilo.

Parámetros

$ acción

(En t|string)(Opcional)La acción nonce.

Valor predeterminado: -1

$ query_arg

(string)(Opcional) Clave para comprobar si hay nonce in $_REQUEST.

Valor predeterminado: ‘_wpnonce’

Regreso

(int |false) 1 si el nonce es válido y se generó entre 0-12 horas atrás, 2 si el nonce es válido y se generó entre 12-24 horas atrás. Falso si el nonce no es válido.

Más información

• Usar la función sin la $action argumento es obsoleto y, a partir de Versión 3.2, si WP_DEBUG se establece en true, la función morirá con un mensaje apropiado (“Debe especificar una acción nonce para verificar mediante el primer parámetro.”Es el predeterminado).
• A partir de 2.0.1, se comprueba el referente solamente Si el $action El argumento no se especifica (o se establece en el valor predeterminado -1) como un respaldo de compatibilidad con versiones anteriores para no usar un nonce. Se prefiere un nonce a los referentes no confiables y con $action especificado, la función se comporta de la misma manera que wp_verify_nonce () excepto que muere después de llamar a wp_nonce_ays () si el nonce no es válido o no se envió.

Fuente

Expediente: wp-includes / pluggable.php

functioncheck_admin_referer($action=-1,$query_arg='_wpnonce')if(-1===$action)_doing_it_wrong(__FUNCTION__,__('You should specify a nonce action to be verified by using the first parameter.'),'3.2.0');$adminurl=strtolower(admin_url());$referer=strtolower(wp_get_referer());$result=isset($_REQUEST[$query_arg])?wp_verify_nonce($_REQUEST[$query_arg],$action):false;/**
		 * Fires once the admin request has been validated or not.
		 *
		 * @since 1.5.1
		 *
		 * @param string    $action The nonce action.
		 * @param false

Relacionado

Usos

Usado por

Registro de cambios