La URL base es la URL a la que se dirige la solicitud, sin incluir ningún parámetro de cadena de consulta (
query string) ni de fragmento (hash). Es importante usar el protocolo correcto aquí, así que asegúrate de que la parte “https://” de la URL coincida con la solicitud real enviada a la API.
A continuación, recopila todos los parámetros incluidos en la solicitud. Hay dos ubicaciones posibles para estos parámetros adicionales: la URL (como parte de la cadena de consulta) y el cuerpo de la solicitud. La solicitud de ejemplo incluye un solo parámetro en ambas ubicaciones:
Estos valores deben codificarse en una sola cadena, que se utilizará más adelante. El proceso para construir la cadena es muy específico:
- Codifica mediante percent-encoding cada clave y valor que se vaya a firmar.
- Ordena la lista de parámetros alfabéticamente [1] por clave codificada [2].
- Para cada par clave/valor:
- Añade la clave codificada a la cadena de salida.
- Añade el carácter ‘=’ a la cadena de salida.
- Añade el valor codificado a la cadena de salida.
- Si quedan más pares clave/valor, añade un carácter ‘&’ a la cadena de salida.
Los tres valores recopilados hasta ahora deben unirse para formar una única cadena, a partir de la cual se generará la firma. Esto se denomina cadena base de firma según la especificación OAuth.
Para codificar el método HTTP, la URL base y la cadena de parámetros en una sola cadena:
- Convierte el método HTTP a mayúsculas y establece la cadena de salida igual a este valor.
- Añade el carácter ‘&’ a la cadena de salida.
- Codifica con percent-encoding la URL y añádela a la cadena de salida.
- Añade el carácter ‘&’ a la cadena de salida.
- Codifica con percent-encoding la cadena de parámetros y añádela a la cadena de salida.
El valor que identifica la cuenta en cuyo nombre actúa tu aplicación se llama OAuth token secret. Este valor se puede obtener de varias maneras, todas las cuales se describen en obtención de tokens de acceso.
Una vez más, es muy importante mantener estos valores privados dentro de tu aplicación. Si consideras que tus valores se han visto comprometidos, regenera tus tokens (los tokens de esta página se han marcado como inválidos para solicitudes reales).
Ambos valores deben combinarse para formar una clave de firma que se usará para generar la firma. La clave de firma es simplemente el token secret codificado en porcentaje:
Ten en cuenta que existen algunos flujos, como al obtener un request token, en los que el token secret aún no se conoce. En este caso, la clave de firma debe consistir en el consumer secret codificado en porcentaje seguido de un carácter ampersand ‘&’.
Finalmente, la firma se calcula pasando la cadena base de la firma y la clave de firmado al algoritmo de hash HMAC-SHA1. Los detalles del algoritmo se explican en la función hash_hmac.
La salida de la función de firmado HMAC es una cadena binaria. Esta debe codificarse en base64 para producir la cadena de firma. Por ejemplo, el resultado usando la cadena base y la clave de firmado proporcionadas en esta página es 2E CF 77 84 98 99 6D 0D DA 90 5D C7 17 7C 75 07 3F 3F CD 4E. Ese valor, cuando se convierte a base64, es la firma OAuth para esta solicitud: