Restricción de la API por IP
Para qué sirve la restricción por IP
Mientras la lista de direcciones permitidas esté vacía, la API acepta solicitudes desde
cualquier lugar; el portal lo indica con el texto The API is accessible from any IP address. En el momento en que añade la primera dirección a la lista, la API empieza a
atender solo las solicitudes que llegan desde las direcciones indicadas.
Ninguna de sus credenciales caduca por ello. Tanto el Application ID como el token de API siguen siendo válidos; simplemente no pueden utilizarse desde ningún lugar que no sea una dirección permitida.
Dónde configurar la restricción
- En el menú del portal, haga clic en
Módulos y APIs - En
Mis APIs y módulos, haga clic en la tarjeta de su aplicación - Permanezca en la pestaña
Ajustesy desplácese hasta la parteAPI access restrictions - En la tarjeta
Allowed IP addresses, haga clic enConfigurar - Escriba la dirección en el campo
Enter the IP addressy haga clic enAñadir
La ventana Add IP address lo advierte enseguida con el mensaje The API will only be accessible from the listed IP addresses!: la restricción se aplica en
cuanto se guarda la primera dirección.
Indique la dirección desde la que su aplicación llama a la API, no la dirección del ordenador desde el que realiza esta configuración. Tras guardarla, el portal no comprueba que realmente alguien se conecte desde la dirección indicada.
Qué direcciones acepta el portal
| Regla | Comportamiento |
|---|---|
| Una dirección concreta | Tanto IPv4 como IPv6; no se aceptan rangos ni la notación con máscara (/24) |
| Solo direcciones públicas | Los rangos locales y reservados terminan con el mensaje Enter a public IP address, local and reserved ranges cannot be used |
| Notación válida | Un valor sin sentido termina con el mensaje Invalid IP address |
| Sin duplicados | Una dirección que ya está en la lista no se puede añadir dos veces |
Entre los rangos no públicos están 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16,
127.0.0.0/8 y, en IPv6, fc00::/7 o fe80::/10. El botón Añadir permanece
desactivado hasta que el valor introducido es válido.
Una dirección escrita como IPv4 incrustada en IPv6, es decir, ::ffff:1.2.3.4 o la
forma 6to4 2002:…, el portal la convierte a la IPv4 correspondiente. El número de
direcciones de la lista no está limitado.
Cómo editar la lista o eliminar la restricción
En cuanto se añade la primera dirección, la tarjeta se convierte en una lista. El
botón Añadir añade otra dirección y el icono de la papelera de una fila la elimina;
la eliminación se confirma con el botón Borrar. La flecha junto a Añadir abre un
menú que vacía toda la lista de una vez.
En cuanto no queda ninguna dirección en la lista, la restricción se desactiva y la API vuelve a ser accesible desde cualquier lugar.
Qué ocurre con una solicitud desde otra dirección
Una solicitud desde una dirección que no está en la lista termina con una respuesta con
el código HTTP 401 y el tipo de error unknown_identity, el mismo que devuelve un
token no válido. Los demás errores se enumeran en la página
Tipos de error de la API.
Gracias por su opinión.