Comencemos con las API
Acerca de
las API de Infoblox
Las API del Portal de Infoblox son servicios web RESTful que permiten a los usuarios interactuar con la plataforma de servicios en la nube de Infoblox (CSP). Las API están disponibles para las dos aplicaciones principales impulsadas por la plataforma Infoblox e incluyen:
- API de Universal DDI: se utilizan para administrar y automatizar los servicios DDI de Infoblox en la nube
- API de Infoblox Threat Defense: permiten a las organizaciones gestionar el aspecto de seguridad de red en la infraestructura de Infoblox Threat Defense.
Siga estos pasos sencillos para empezar a usar las API en el Portal de Infoblox:
- Configure su cuenta en el Portal de Infoblox [obligatorio]
- Cree cuentas de servicio
- Comprenda la autenticación de solicitudes de API
- Cree su clave API
- Realice una llamada a la API
- Uso de Postman
- Uso de Curl
Configure su cuenta en el Portal de Infoblox [obligatorio]
Póngase en contacto con su representante de ventas en Infoblox para obtener una cuenta en el Portal de Infoblox.
Cree su clave API (consulte el paso 4).
Las API del Portal de Infoblox requieren que se proporcione una clave para la autenticación.
Establezca usuarios de cuenta de servicio
Para las integraciones, deberá permitir que las aplicaciones de terceros accedan al Portal de Infoblox a través de la API. Esto se logra estableciendo usuarios de cuentas de servicio. Por diseño, los usuarios de cuentas de servicio no pueden iniciar sesión en el Portal de Infoblox. En su lugar, deberá crear claves API para su uso que otorgan acceso. Cada clave de API de servicio está asociada a un usuario de cuenta de servicio. A un usuario de cuenta de servicio se le pueden asociar hasta 10 claves de API de servicio. Para obtener más información, consulte Configurar claves API de servicio.
Comprenda las claves de API y la autenticación
Una clave API es un token de autenticación que se pasa a la API del Portal de Infoblox para facilitar la autenticación de usuario (interactiva o de servicio) en una solicitud de API. La clave de API actúa como un token secreto para la autenticación y se le asigna un conjunto de acceso específico para un usuario. Todos los usuarios que tengan permiso para iniciar sesión en el Portal de Infoblox pueden crear claves de API de usuario por sí mismos. La clave de API de usuario se puede utilizar para rastrear y controlar el uso de la API, por ejemplo, para evitar el uso malintencionado o el abuso de la API.
Para autenticar las solicitudes de API, debe incluir un encabezado HTTP de «Autorización» con la clave de API y el prefijo «Token».
A continuación se muestra un ejemplo de solicitud de API utilizando comandos curl en formato JSON:
La URL base se actualizará automáticamente en función del Realm seleccionado (p. ej., csp.eu.infoblox.com para el Realm de la UE).
curl -k -i -H "Authorization: Token <YOUR API Key>" "https://csp.infoblox.com/api/dnsdata/v2/dns_event?source=rpz&t0=1483228800&t1=1514764799"
Cree claves de API
1. Abra Portal de Infoblox en un navegador.
2. Autentique con sus credenciales de usuario recién obtenidas/existentes.
3. Cuando llegue a la página de inicio, pase el cursor sobre su nombre en la parte inferior izquierda de la pantalla y seleccione User Profile.
4. Haga clic en la pestaña Claves de API de usuario y seleccione Crear.
5. En la ventana emergente, especifique el Nombre y la Fecha de caducidad. Asegúrese de que la fecha de caducidad es posterior a la fecha de creación de la clave API.
6. Seleccione Guardar y cerrar.
7. Verá su clave API en la parte superior de la pantalla. Asegúrese de copiarla y guardarla en una plataforma de confianza.
Realice su primera llamada API
Haremos una simple llamada a la API para obtener todos los espacios IP de su organización.
Uso de Postman:
Postman es una plataforma de colaboración para API que se utiliza para enviar solicitudes REST, SOAP o GraphQL. Si aún no tiene la aplicación, puede descargarla desde aquí.
1. Inicie Postman.
2. Seleccione Crear una solicitud.
3. Asegúrese de seleccionar GET en el menú desplegable.
4. Introduzca la siguiente URL en el cuadro de entrada:
La URL base se actualizará automáticamente en función del Realm seleccionado (p. ej., csp.eu.infoblox.com para el Realm de la UE).
https://csp.infoblox.com/api/ddi/v1/ipam/ip_space
5. En la pestaña Autorización, seleccione Clave API como Tipo.
6. Introduzca la autorización como clave.
7. Introduzca el token seguido de su clave API (formato: Token <api-key>) como Valor.
8. Configure el formato del Body a RAW > JSON al enviar datos en la llamada a la API. Este paso no es necesario para solicitudes de solo lectura.
9. Haga clic en Send para efectuar la llamada a la API.
10. Puede ver los resultados de la llamada en la sección Body según el ejemplo a continuación.
El resultado de la API GET devuelve una lista de todos los objetos existentes (en este ejemplo, Espacios IP) con todos los detalles asociados.
1. Abra un terminal.
2. Reemplace el valor api-key y ejecute el siguiente comando:
La URL base se actualizará automáticamente en función del Realm seleccionado (p. ej., csp.eu.infoblox.com para el Realm de la UE).
curl --location --request GET 'https://csp.infoblox.com/api/ddi/v1/ipam/ip_space' \ --header 'Authorization: Token <api-key>'
3. Puede ver los resultados según el ejemplo a continuación.
